@codewithjuber/forgekit 0.8.0

package/global/settings.template.json

@@ -0,0 +1,183 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "model": "sonnet",
+  "includeCoAuthoredBy": false,
+  "cleanupPeriodDays": 30,
+  "statusLine": {
+    "type": "command",
+    "command": "bash ~/.forge/statusline.sh"
+  },
+  "permissions": {
+    "defaultMode": "default",
+    "allow": [
+      "Read",
+      "Glob",
+      "Grep",
+      "Bash(git status)",
+      "Bash(git status:*)",
+      "Bash(git diff)",
+      "Bash(git diff:*)",
+      "Bash(git log:*)",
+      "Bash(git show:*)",
+      "Bash(git branch:*)",
+      "Bash(git add:*)",
+      "Bash(git stash:*)",
+      "Bash(ls:*)",
+      "Bash(cat:*)",
+      "Bash(rg:*)",
+      "Bash(fd:*)",
+      "Bash(tree:*)",
+      "Bash(head:*)",
+      "Bash(tail:*)",
+      "Bash(wc:*)",
+      "Bash(npm run lint)",
+      "Bash(npm run lint:*)",
+      "Bash(npm run test)",
+      "Bash(npm run test:*)",
+      "Bash(npm run build)",
+      "Bash(npm run typecheck)",
+      "Bash(npm ci)",
+      "Bash(pnpm lint)",
+      "Bash(pnpm test:*)",
+      "Bash(pnpm build)",
+      "Bash(yarn lint)",
+      "Bash(yarn test:*)",
+      "Bash(node --version)",
+      "Bash(python -m pytest:*)",
+      "Bash(pytest:*)",
+      "Bash(ruff:*)",
+      "Bash(mypy:*)",
+      "Bash(gh pr view:*)",
+      "Bash(gh issue view:*)",
+      "Bash(gh pr diff:*)"
+    ],
+    "ask": [
+      "Bash(git push:*)",
+      "Bash(git commit:*)",
+      "Bash(gh pr create:*)",
+      "Bash(gh pr merge:*)"
+    ],
+    "deny": [
+      "Read(./.env)",
+      "Read(./.env.*)",
+      "Read(./**/.env)",
+      "Read(./**/.env.*)",
+      "Read(./**/*.pem)",
+      "Read(./**/id_rsa)",
+      "Read(./**/id_ed25519)",
+      "Read(./secrets/**)",
+      "Bash(rm -rf /:*)",
+      "Bash(rm -rf ~:*)",
+      "Bash(git push --force:*)",
+      "Bash(git push -f:*)",
+      "Bash(curl:* | sh)",
+      "Bash(curl:* | bash)",
+      "Bash(sudo:*)"
+    ]
+  },
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.forge/guards/cortex.sh prompt"
+          },
+          {
+            "type": "command",
+            "command": "bash ~/.forge/guards/cortex.sh preflight"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.forge/guards/recall-load.sh"
+          },
+          {
+            "type": "command",
+            "command": "bash ~/.forge/guards/cortex.sh session-start"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write|MultiEdit|Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.forge/guards/protect-paths.sh"
+          },
+          {
+            "type": "command",
+            "command": "bash ~/.forge/guards/cost-budget.sh"
+          },
+          {
+            "type": "command",
+            "command": "bash ~/.forge/guards/doom-loop.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.forge/guards/cortex.sh pre-edit"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.forge/guards/format-on-edit.sh"
+          },
+          {
+            "type": "command",
+            "command": "bash ~/.forge/guards/cortex.sh capture"
+          }
+        ]
+      },
+      {
+        "matcher": "Bash|Read|Grep",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.forge/guards/secret-redact.sh"
+          },
+          {
+            "type": "command",
+            "command": "bash ~/.forge/guards/cortex.sh capture"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.forge/guards/lean-guard.sh"
+          },
+          {
+            "type": "command",
+            "command": "bash ~/.forge/guards/session-learner.sh"
+          },
+          {
+            "type": "command",
+            "command": "bash ~/.forge/guards/cortex.sh stop"
+          }
+        ]
+      }
+    ]
+  }
+}

package/global/statusline.sh

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+# Custom status line: dir · git branch · model · session cost · cache hit%.
+# Surfaces context-cost AND prompt-cache health so you notice when to /clear,
+# /compact, or why a turn went uncached (model switch, MCP reconnect, upgrade).
+set -uo pipefail
+
+input="$(cat)"
+
+if command -v jq >/dev/null 2>&1; then
+  dir="$(printf '%s' "$input"  | jq -r '.workspace.current_dir // .cwd // empty')"
+  model="$(printf '%s' "$input"| jq -r '.model.display_name // .model.id // "?"')"
+  cost="$(printf '%s' "$input" | jq -r '.cost.total_cost_usd // empty')"
+  add="$(printf '%s' "$input"  | jq -r '.cost.total_lines_added // empty')"
+  del="$(printf '%s' "$input"  | jq -r '.cost.total_lines_removed // empty')"
+  over="$(printf '%s' "$input" | jq -r '.exceeds_200k_tokens // false')"
+  cread="$(printf '%s' "$input"| jq -r '.current_usage.cache_read_input_tokens // .cost.cache_read_input_tokens // empty')"
+  cwrite="$(printf '%s' "$input"|jq -r '.current_usage.cache_creation_input_tokens // .cost.cache_creation_input_tokens // empty')"
+else
+  dir="$PWD"; model="?"; cost=""; add=""; del=""; over="false"; cread=""; cwrite=""
+fi
+
+[ -n "${dir:-}" ] || dir="$PWD"
+short="${dir/#$HOME/~}"
+
+branch=""
+if git -C "$dir" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+  branch="$(git -C "$dir" branch --show-current 2>/dev/null)"
+  [ -n "$branch" ] && branch=" \033[35m⎇ $branch\033[0m"
+fi
+
+costp=""
+if [ -n "${cost:-}" ] && [ "$cost" != "null" ]; then
+  costp="$(printf ' \033[33m$%.3f\033[0m' "$cost" 2>/dev/null || echo " \$$cost")"
+fi
+
+diffp=""
+if [ -n "${add:-}" ] && [ "$add" != "null" ]; then
+  diffp="$(printf ' \033[32m+%s\033[0m/\033[31m-%s\033[0m' "${add:-0}" "${del:-0}")"
+fi
+
+# Cache hit rate: read / (read + creation). High = cache working; low = prefix busted.
+cachep=""
+if [ -n "${cread:-}" ] && [ "$cread" != "null" ] && command -v awk >/dev/null 2>&1; then
+  cachep="$(awk -v r="${cread:-0}" -v w="${cwrite:-0}" 'BEGIN{t=r+w; if(t>0){p=100*r/t; c=(p>=70)?32:(p>=30)?33:31; printf " \033[%dm⚡%d%%\033[0m", c, p}}')"
+fi
+
+warn=""
+[ "${over:-false}" = "true" ] && warn=" \033[41m ctx>200k — /clear \033[0m"
+
+printf "\033[36m%s\033[0m%b \033[90m·\033[0m \033[1m%s\033[0m%b%b%b%b" \
+  "$short" "$branch" "$model" "$costp" "$diffp" "$cachep" "$warn"

package/global/taste/brutalist.json

@@ -0,0 +1,9 @@
+{
+  "name": "brutalist",
+  "why": "Raw, honest, high-contrast (brutalist.md): pure #000/#FFF plus ONE loud accent -> max_hues 1 with chroma pinned high (chroma = HSL saturation/100 proxy, 0-1); 'DON'T round corners' -> radius_levels [0,0]; no SOFT shadows but a hard offset shadow is idiomatic brutalism -> shadow_levels [0,1]; visible size jumps -> wide geometric ratio; tau_slop is the highest of all profiles because brutalism must sit maximally far from the generic soft-template look.",
+  "palette": { "max_hues": 1, "chroma": [0.7, 1.0], "neutrals": "stark" },
+  "space": { "scale": "geometric", "ratio": [1.5, 2.0], "base": [4, 8] },
+  "type": { "max_families": 2 },
+  "shape": { "radius_levels": [0, 0], "shadow_levels": [0, 1] },
+  "gate": { "tau_slop": 0.45, "tau_conform": 0.5 }
+}

package/global/taste/brutalist.md

@@ -0,0 +1,19 @@
+# DESIGN.md — Brutalist
+
+One direction: raw, honest, high-contrast. The structure IS the style.
+
+## Color
+- Stark: pure #000 on #FFF (or inverted). One loud accent (#FF3B00 / #00E5FF).
+- Flat fills only — no gradients, no tints.
+
+## Type
+- Grotesk or monospace (Helvetica / Space Grotesk / JetBrains Mono).
+- Big, tight, often uppercase headings with visible size jumps.
+
+## Layout & motion
+- Thick solid borders (2–4px #000). Exposed grid; columns and rules visible.
+- Motion: instant or snappy (≤120ms). Nothing that reads as "polished".
+
+## Do / Don't
+- DO use borders as structure and oversize headers.
+- DON'T round corners, add soft shadows, or use pastels.

package/global/taste/corporate.json

@@ -0,0 +1,9 @@
+{
+  "name": "corporate",
+  "why": "Trustworthy, clear, accessible (corporate.md): one professional primary (#2563EB) plus three semantic states -> max_hues 4; mid-to-high but never neon chroma (chroma = HSL saturation/100 proxy, 0-1); cool slate neutrals; 'consistent 8px spacing' -> base [8], linear scale with modest ratio; one clean sans -> max_families 1; moderate rounding and subtle elevation -> radius [1,2] / shadow [0,2]; tau_slop is the LOWEST of all profiles because corporate deliberately stays near convention, and tau_conform is tight because consistency is the whole point.",
+  "palette": { "max_hues": 4, "chroma": [0.3, 0.9], "neutrals": "cool" },
+  "space": { "scale": "linear", "ratio": [1.25, 1.5], "base": [8] },
+  "type": { "max_families": 1 },
+  "shape": { "radius_levels": [1, 2], "shadow_levels": [0, 2] },
+  "gate": { "tau_slop": 0.2, "tau_conform": 0.4 }
+}

package/global/taste/corporate.md

@@ -0,0 +1,19 @@
+# DESIGN.md — Corporate
+
+One direction: trustworthy, clear, accessible. Calm and structured.
+
+## Color
+- Neutral base (#F8FAFC / #0F172A text) + a professional primary (#2563EB).
+- Semantic states (success / warn / error) at WCAG AA contrast.
+
+## Type
+- One clean sans (Inter / Source Sans), scale at 400 / 600 / 700.
+- Comfortable body (16px+, 1.6); never below AA contrast.
+
+## Layout & motion
+- Structured grid, consistent 8px spacing, obvious primary actions.
+- Motion: subtle and functional (150–250ms ease); reinforces state, never decorative.
+
+## Do / Don't
+- DO keep components consistent, labeled, and keyboard-accessible with focus states.
+- DON'T rely on color alone for meaning or surprise the user.

package/global/taste/editorial.json

@@ -0,0 +1,9 @@
+{
+  "name": "editorial",
+  "why": "Magazine-grade (editorial.md): warm paper + rich ink + ONE muted accent, but max_hues 2 because the HSL saturation/100 chroma proxy (0-1) counts warm paper itself (#FBFAF7-class, s well above the neutral cutoff) as a hue bin — one accent + the paper cast; low-to-mid chroma band (#7C6A4E sits near 0.23); warm neutrals; spacious geometric rhythm near the classic 1.4-1.62 ratios; 'exactly one serif + one sans', 'DON'T use more than two families' -> max_families 2; thin rules over boxes -> radius [0,1], shadow [0,1]; tau_slop 0.35 (the spec Section 3 example) because considered typography must clear the template look by a wide margin.",
+  "palette": { "max_hues": 2, "chroma": [0.1, 0.45], "neutrals": "warm" },
+  "space": { "scale": "geometric", "ratio": [1.4, 1.62], "base": [4, 8] },
+  "type": { "max_families": 2 },
+  "shape": { "radius_levels": [0, 1], "shadow_levels": [0, 1] },
+  "gate": { "tau_slop": 0.35, "tau_conform": 0.5 }
+}

package/global/taste/editorial.md

@@ -0,0 +1,19 @@
+# DESIGN.md — Editorial (high-end)
+
+One direction: magazine-grade. Typographic, spacious, considered.
+
+## Color
+- Warm paper (#FBFAF7), rich ink (#1A1A1A); one muted accent (deep teal / #7C6A4E).
+- Restrained — color signals meaning, never decoration.
+
+## Type
+- Serif display for headings (Fraunces / Georgia) + a clean sans body.
+- Generous leading (1.7), measured line length (~66ch), real hanging quotes.
+
+## Layout & motion
+- Asymmetric editorial grid; large hero type; captions and thin rules.
+- Motion: slow, graceful (250–400ms ease-out); subtle parallax at most.
+
+## Do / Don't
+- DO pair exactly one serif + one sans and respect the measure.
+- DON'T cramp text edge-to-edge or use more than two families.

package/global/taste/minimalist.json

@@ -0,0 +1,9 @@
+{
+  "name": "minimalist",
+  "why": "Restraint (minimalist.md): near-monochrome with exactly ONE saturated accent for the primary action -> max_hues 1, chroma band around a committed accent like #2563EB (chroma = HSL saturation/100 proxy, 0-1); neutral near-white/ink base; '8px spacing scale' -> base [8], calm linear-to-wide steps; one sans, 2 weights -> max_families 1; hairlines only, 'no bounce, no shadow' / 'DON'T add drop shadows' -> shadow_levels [0,0], radius [0,1]; tau_slop 0.3 because minimal surfaces are CLOSE to flat templates by construction yet must still avoid the default-blue-card centroid, tau_conform tight because a minimal system tolerates zero drift.",
+  "palette": { "max_hues": 1, "chroma": [0.4, 0.9], "neutrals": "neutral" },
+  "space": { "scale": "linear", "ratio": [1.5, 2.0], "base": [8] },
+  "type": { "max_families": 1 },
+  "shape": { "radius_levels": [0, 1], "shadow_levels": [0, 0] },
+  "gate": { "tau_slop": 0.3, "tau_conform": 0.4 }
+}

package/global/taste/minimalist.md

@@ -0,0 +1,20 @@
+# DESIGN.md — Minimalist
+
+One direction: restraint. Content leads; the UI recedes. When unsure, remove.
+
+## Color
+- Near-monochrome: near-white bg (#FAFAFA), ink text (#111).
+- Exactly ONE accent (e.g. #2563EB), used only for the primary action.
+- Hairline borders (#E5E7EB) — no boxes inside boxes.
+
+## Type
+- One sans family (system-ui / Inter), 2 weights max (400 / 600).
+- Large, calm headings; generous body line-height (1.6).
+
+## Layout & motion
+- Wide margins, single column where possible; 8px spacing scale.
+- Motion: 150–200ms ease, opacity/translate only. No bounce, no shadow.
+
+## Do / Don't
+- DO align to a strict grid and let space breathe.
+- DON'T add gradients, drop shadows, or a second accent.

package/global/taste/playful.json

@@ -0,0 +1,9 @@
+{
+  "name": "playful",
+  "why": "Friendly, energetic (playful.md): '2-3 saturated hues' -> max_hues 3, the most permissive palette of the five, with chroma pinned high but short of neon-on-neon (chroma = HSL saturation/100 proxy, 0-1); warm soft background neutrals; grid-aligned but generous -> geometric 1.25-1.5 on a 4/8 base; one rounded sans plus an optional display face -> max_families 2; 'rounded fills (radius 12-20px)' and soft shadows -> radius [1,3], shadow [1,2] (some rounding and lift is REQUIRED, not just allowed); default tau_slop 0.25 — playful legitimately lives nearer the card-and-radius territory templates also occupy.",
+  "palette": { "max_hues": 3, "chroma": [0.55, 1.0], "neutrals": "warm" },
+  "space": { "scale": "geometric", "ratio": [1.25, 1.5], "base": [4, 8] },
+  "type": { "max_families": 2 },
+  "shape": { "radius_levels": [1, 3], "shadow_levels": [1, 2] },
+  "gate": { "tau_slop": 0.25, "tau_conform": 0.5 }
+}

package/global/taste/playful.md

@@ -0,0 +1,19 @@
+# DESIGN.md — Playful
+
+One direction: friendly, energetic, human. Delight without clutter.
+
+## Color
+- Vibrant, warm palette: 2–3 saturated hues (#FF7A59, #5B8DEF, #FFC24B) on a soft bg.
+- Soft shadows and rounded fills (radius 12–20px).
+
+## Type
+- Rounded / geometric sans (Nunito / Poppins). Bold, friendly headings.
+- Slightly larger base size; comfortable spacing.
+
+## Layout & motion
+- Cards, pills, generous radius — playful but still aligned to a grid.
+- Motion: spring / bounce on interaction (200–300ms); hover lifts; gentle wiggle.
+
+## Do / Don't
+- DO add ONE delightful micro-interaction per key action.
+- DON'T animate everything or go neon-on-neon.

package/global/tools/atlas/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: atlas
+description: Forge's code-graph. Use to find where a symbol is defined (where-is-X), to discover reusable code before writing new, and to check a symbol actually exists before calling it (anti-hallucination). Backed by `forge atlas`.
+---
+
+# atlas — the code-graph
+
+A precomputed, portable symbol index at `.forge/atlas.json`. Any tool reads it via
+`forge atlas` or plain `jq` — no MCP required to consume.
+
+## Use it
+- `forge atlas build` — (re)build the index for this repo. Cheap; run once, and
+  again after large changes.
+- `forge atlas query <term>` — where is `<term>` defined? Returns file:line + kind.
+  Prefer this over grep-and-read-files (far fewer tokens).
+- `forge atlas has <symbol>` — is this symbol defined anywhere? Use before calling
+  an unfamiliar function/class: "not found" is a strong hallucinated-API signal.
+
+## When
+- Reuse-first: before writing a helper, `forge atlas query` for an existing one.
+- Verification: after generating code that calls project symbols, spot-check the
+  unfamiliar ones with `forge atlas has`.
+
+## Honest boundary
+v1 indexes symbol *definitions* + membership, not a full call graph ("what calls
+Z"). It flags likely-missing symbols; it does not certify correctness. The call
+graph is the documented upgrade (LSP / serena-backed export).