@sriinnu/runic 1.0.0

package/docs/site.css

@@ -0,0 +1,505 @@
+:root {
+  color-scheme: light dark;
+  --bg: #070b12;
+  --panel: rgba(14, 18, 28, 0.78);
+  --panel-solid: #0e121c;
+  --text: rgba(241, 246, 255, 0.92);
+  --muted: rgba(187, 198, 218, 0.78);
+  --line: rgba(255, 255, 255, 0.1);
+  --accent: #3ff0d6;
+  --accent2: #2d5bff;
+  --shadow: rgba(0, 0, 0, 0.42);
+  --radius: 18px;
+  --radius-sm: 14px;
+}
+
+@media (prefers-color-scheme: light) {
+  :root {
+    --bg: #f8fbff;
+    --panel: rgba(255, 255, 255, 0.74);
+    --panel-solid: #ffffff;
+    --text: rgba(11, 16, 22, 0.92);
+    --muted: rgba(56, 70, 88, 0.75);
+    --line: rgba(11, 16, 22, 0.1);
+    --shadow: rgba(11, 16, 22, 0.12);
+  }
+}
+
+* {
+  box-sizing: border-box;
+}
+
+html,
+body {
+  min-height: 100%;
+}
+
+body {
+  margin: 0;
+  font: 16px/1.55 ui-sans-serif, "Avenir Next", Avenir, "Segoe UI", "Helvetica Neue", sans-serif;
+  color: var(--text);
+  background:
+    radial-gradient(1100px 800px at 15% 10%, rgba(63, 240, 214, 0.18), transparent 58%),
+    radial-gradient(950px 780px at 85% 20%, rgba(45, 91, 255, 0.18), transparent 60%),
+    radial-gradient(900px 700px at 40% 95%, rgba(63, 240, 214, 0.06), transparent 60%),
+    repeating-linear-gradient(90deg, rgba(255, 255, 255, 0.04), rgba(255, 255, 255, 0.04) 1px, transparent 1px, transparent 72px),
+    var(--bg);
+}
+
+html {
+  background: var(--bg);
+}
+
+a,
+a:visited {
+  color: inherit;
+}
+
+a {
+  text-decoration: none;
+}
+
+a:hover {
+  text-decoration: underline;
+}
+
+code {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
+  font-size: 0.95em;
+}
+
+.wrap {
+  max-width: 1020px;
+  margin: 0 auto;
+  padding: 46px 22px 34px;
+}
+
+.top {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 18px;
+  margin-bottom: 28px;
+}
+
+.brand {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  min-width: 240px;
+}
+
+.name {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+
+.title {
+  margin: 0;
+  font-family: ui-serif, "New York", "Iowan Old Style", Palatino, serif;
+  font-size: 22px;
+  letter-spacing: 0.1px;
+}
+
+.tagline {
+  margin: 0;
+  color: var(--muted);
+  font-size: 13.5px;
+}
+
+.mark {
+  width: 44px;
+  height: 44px;
+  border-radius: 13px;
+  border: 0;
+  box-shadow: none;
+  background: transparent;
+  object-fit: cover;
+  filter: drop-shadow(0 12px 24px rgba(0, 0, 0, 0.35));
+}
+
+.brand:hover .mark {
+  filter: drop-shadow(0 16px 34px rgba(0, 0, 0, 0.42));
+}
+
+.links {
+  display: flex;
+  gap: 10px;
+}
+
+.btn {
+  padding: 10px 14px;
+  border-radius: 13px;
+  border: 0;
+  background: color-mix(in srgb, var(--panel-solid) 32%, transparent);
+  box-shadow: 0 10px 28px var(--shadow);
+  transition: transform 160ms ease, background 160ms ease, box-shadow 160ms ease;
+  white-space: nowrap;
+}
+
+.btn:hover {
+  transform: translateY(-1px);
+  text-decoration: none;
+  background: color-mix(in srgb, var(--panel-solid) 52%, transparent);
+  box-shadow: 0 14px 34px var(--shadow);
+}
+
+.btn.primary {
+  background: linear-gradient(135deg, rgba(63, 240, 214, 0.65), rgba(45, 91, 255, 0.62));
+  background-clip: padding-box;
+  box-shadow: 0 12px 30px color-mix(in srgb, var(--accent) 25%, var(--shadow));
+}
+
+.btn.ghost {
+  background: transparent;
+  box-shadow: none;
+  color: color-mix(in srgb, var(--text) 86%, var(--muted));
+}
+
+.btn.ghost:hover {
+  background: color-mix(in srgb, var(--panel-solid) 28%, transparent);
+  box-shadow: 0 10px 24px var(--shadow);
+}
+
+.hero {
+  display: grid;
+  grid-template-columns: minmax(0, 1.05fr) minmax(0, 0.9fr);
+  gap: 26px;
+  align-items: center;
+  padding: 24px 26px;
+  border: 1px solid var(--line);
+  border-radius: var(--radius);
+  background: var(--panel);
+  backdrop-filter: blur(12px);
+  box-shadow: 0 18px 60px var(--shadow);
+  position: relative;
+  overflow: hidden;
+}
+
+.copy {
+  position: relative;
+  z-index: 1;
+}
+
+.hero-heading {
+  display: flex;
+  gap: 14px;
+  align-items: flex-start;
+}
+
+.hero-icon {
+  width: 40px;
+  height: 40px;
+  border-radius: 12px;
+  filter: drop-shadow(0 12px 24px rgba(0, 0, 0, 0.35));
+}
+
+.hero::before {
+  content: "";
+  position: absolute;
+  inset: -1px;
+  background:
+    radial-gradient(600px 320px at 10% 15%, rgba(63, 240, 214, 0.18), transparent 55%),
+    radial-gradient(520px 300px at 92% 18%, rgba(45, 91, 255, 0.18), transparent 55%);
+  pointer-events: none;
+  opacity: 0.9;
+}
+
+.copy h2 {
+  margin: 0 0 8px;
+  font-family: ui-serif, "New York", "Iowan Old Style", Palatino, serif;
+  font-size: 34px;
+  letter-spacing: -0.3px;
+  line-height: 1.12;
+  position: relative;
+}
+
+.copy p {
+  margin: 0 0 10px;
+  color: var(--muted);
+}
+
+.requirement {
+  margin: 6px 0 0;
+  color: color-mix(in srgb, var(--text) 92%, var(--muted));
+  font-size: 13.5px;
+}
+
+.badges {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin-bottom: 10px;
+  position: relative;
+}
+
+.badge {
+  font-size: 12px;
+  padding: 6px 10px;
+  border-radius: 999px;
+  border: 1px solid var(--line);
+  background: color-mix(in srgb, var(--panel-solid) 14%, transparent);
+  color: color-mix(in srgb, var(--text) 86%, var(--muted));
+  letter-spacing: 0.2px;
+}
+
+.cta {
+  display: flex;
+  gap: 10px;
+  flex-wrap: wrap;
+  margin-top: 14px;
+  position: relative;
+}
+
+.brew-line {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+
+.brew-line code {
+  background: color-mix(in srgb, var(--panel-solid) 40%, transparent);
+  padding: 4px 8px;
+  border-radius: 6px;
+  border: 1px solid var(--line);
+}
+
+.copy-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 28px;
+  height: 28px;
+  padding: 0;
+  border: 1px solid var(--line);
+  border-radius: 6px;
+  background: color-mix(in srgb, var(--panel-solid) 30%, transparent);
+  color: var(--muted);
+  cursor: pointer;
+  transition: background 160ms ease, color 160ms ease, border-color 160ms ease;
+}
+
+.copy-btn:hover {
+  background: color-mix(in srgb, var(--panel-solid) 60%, transparent);
+  color: var(--text);
+  border-color: color-mix(in srgb, var(--accent) 32%, var(--line));
+}
+
+.copy-btn .icon-check {
+  display: none;
+  color: var(--accent);
+}
+
+.copy-btn.copied .icon-copy {
+  display: none;
+}
+
+.copy-btn.copied .icon-check {
+  display: block;
+}
+
+.copy-btn.copied {
+  border-color: var(--accent);
+  color: var(--accent);
+}
+
+.bullets {
+  margin: 14px 0 0;
+  padding: 0 0 0 18px;
+  color: var(--muted);
+  font-size: 13.5px;
+  position: relative;
+}
+
+.bullets li {
+  margin: 6px 0;
+}
+
+.note {
+  margin: 10px 0 0;
+  color: var(--muted);
+  font-size: 13px;
+}
+
+.shot {
+  margin: 0;
+  position: relative;
+  z-index: 1;
+}
+
+.shot img {
+  width: 100%;
+  height: auto;
+  border-radius: var(--radius-sm);
+  border: 1px solid var(--line);
+  box-shadow: 0 18px 60px var(--shadow);
+  background: color-mix(in srgb, var(--panel-solid) 92%, transparent);
+  transform: perspective(900px) rotateY(-6deg) rotateX(2deg);
+  transition: transform 220ms ease, box-shadow 220ms ease;
+}
+
+.hero-shot {
+  margin: 0;
+  justify-self: end;
+}
+
+.hero-shot img {
+  max-width: 300px;
+  margin-left: auto;
+}
+
+.hero-shot figcaption {
+  max-width: 300px;
+  text-align: center;
+  margin-left: auto;
+}
+
+.shot figcaption {
+  margin-top: 8px;
+  color: var(--muted);
+  font-size: 12.5px;
+  text-align: center;
+}
+
+.shot img:hover {
+  transform: perspective(900px) rotateY(-2deg) rotateX(0deg) translateY(-2px);
+  box-shadow: 0 24px 80px var(--shadow);
+}
+
+.details {
+  display: grid;
+  grid-template-columns: repeat(3, 1fr);
+  gap: 14px;
+  margin-top: 14px;
+}
+
+.details.permissions {
+  grid-template-columns: 1fr;
+}
+
+.card {
+  border: 1px solid var(--line);
+  border-radius: var(--radius);
+  padding: 14px 14px 12px;
+  background: var(--panel);
+  backdrop-filter: blur(10px);
+  box-shadow: 0 14px 40px var(--shadow);
+}
+
+.card h3 {
+  margin: 0 0 6px;
+  font-size: 13px;
+  letter-spacing: 0.2px;
+  text-transform: uppercase;
+  color: color-mix(in srgb, var(--text) 88%, var(--muted));
+}
+
+.card p {
+  margin: 0;
+  color: var(--muted);
+  font-size: 13.5px;
+}
+
+.foot {
+  margin-top: 22px;
+  text-align: center;
+  color: var(--muted);
+  font-size: 13px;
+}
+
+.links-row {
+  margin-top: 14px;
+  display: flex;
+  gap: 10px;
+  flex-wrap: wrap;
+  justify-content: center;
+}
+
+.link-pill {
+  padding: 8px 12px;
+  border-radius: 999px;
+  border: 1px solid var(--line);
+  background: color-mix(in srgb, var(--panel-solid) 24%, transparent);
+  font-size: 13px;
+}
+
+.foot a {
+  text-decoration: underline;
+  text-decoration-color: color-mix(in srgb, var(--muted) 45%, transparent);
+}
+
+[data-animate] {
+  opacity: 0;
+  transform: translateY(10px);
+  animation: rise 680ms cubic-bezier(0.2, 0.9, 0.2, 1) forwards;
+  animation-delay: calc(var(--d, 0) * 90ms);
+}
+
+[data-animate="1"] {
+  --d: 1;
+}
+
+[data-animate="2"] {
+  --d: 2;
+}
+
+[data-animate="3"] {
+  --d: 3;
+}
+
+[data-animate="4"] {
+  --d: 4;
+}
+
+[data-animate="5"] {
+  --d: 5;
+}
+
+[data-animate="6"] {
+  --d: 6;
+}
+
+[data-animate="7"] {
+  --d: 7;
+}
+
+[data-animate="8"] {
+  --d: 8;
+}
+
+@keyframes rise {
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  [data-animate] {
+    animation: none;
+    opacity: 1;
+    transform: none;
+  }
+  .btn,
+  .shot img {
+    transition: none;
+  }
+}
+
+@media (max-width: 860px) {
+  .top {
+    flex-direction: column;
+    align-items: flex-start;
+  }
+  .hero {
+    grid-template-columns: 1fr;
+  }
+  .details {
+    grid-template-columns: 1fr;
+  }
+  .shot img {
+    transform: none;
+  }
+}

package/docs/sparkle.md

@@ -0,0 +1,28 @@
+---
+summary: "Sparkle integration details for Runic: updater config, keys, and release flow."
+read_when:
+  - Touching Sparkle settings, feed URL, or keys
+  - Generating or troubleshooting the Sparkle appcast
+  - Validating update toggles or updater UI
+---
+
+# Sparkle integration
+
+- Framework: Sparkle 2.8.1 via SwiftPM.
+- Updater: `SPUStandardUpdaterController` owned by `AppDelegate` (see `Sources/Runic/RunicApp.swift:1`).
+- Feed: `SUFeedURL` in Info.plist points to GitHub Releases appcast (`appcast.xml`).
+- Key: `SUPublicEDKey` set to `AGCY8w5vHirVfGGDGc8Szc5iuOqupZSh9pMj/Qs67XI=`. Keep the Ed25519 private key safe; use it when generating the appcast.
+- UI: auto-check toggle (About) enables auto-downloads; menu only shows “Update ready, restart now?” once an update is downloaded.
+- LSUIElement: works; updater window will show when checking. App is non-sandboxed.
+
+## Release flow
+1) Build & notarize as usual (`./Scripts/sign-and-notarize.sh`), producing notarized `Runic-<ver>.zip`.
+2) Generate appcast entry with Sparkle `generate_appcast` using the Ed25519 private key; HTML release notes come from `CHANGELOG.md` via `Scripts/changelog-to-html.sh`.
+3) Upload `appcast.xml` + zip to GitHub Releases (feed URL stays stable).
+4) Tag/release.
+
+## Notes
+- HTML release notes are embedded in the appcast entry; the Sparkle update dialog should show formatted bullets (not raw tags).
+- If you change the feed host or key, update Info.plist (`SUFeedURL`, `SUPublicEDKey`) and bump the app.
+- Auto-check toggle is persisted via Sparkle; manual “Check for Updates…” remains in About.
+- Runic disables Sparkle in Homebrew and unsigned builds; those installs should be updated via `brew` or reinstalling from Releases.

package/docs/status.md

@@ -0,0 +1,28 @@
+---
+summary: "Provider status checks, sources, and indicator mapping."
+read_when:
+  - Changing status sources or status UI
+  - Debugging status polling or incident parsing
+---
+
+# Status checks
+
+## Sources
+- OpenAI + Claude + Cursor + Factory + Copilot: Statuspage.io `api/v2/status.json`.
+- Gemini + Antigravity: Google Workspace incidents feed for the Gemini product.
+
+## Behavior
+- Toggle: Settings → Advanced → “Check provider status”.
+- `UsageStore` polls status and stores `ProviderStatus` for indicator/description.
+- Menu shows incident summary + freshness; icon overlays indicator.
+
+## Workspace incidents
+- Feed: `https://www.google.com/appsstatus/dashboard/incidents.json`.
+- Uses the Gemini product ID from provider metadata.
+- Chooses the most severe active incident for the provider.
+
+## Links
+- If `statusPageURL` is set, status polling uses it and the menu action opens it.
+- If only `statusLinkURL` exists, the menu action opens it without polling.
+
+See also: `docs/providers.md`.