savant-code 0.0.19 → 0.0.21

package/docs/gravity-integration-starter.md

@@ -1,202 +0,0 @@
-# Gravity Integration Starter Kit — `savant-free` (ad-supported tier)
-
-> **STATUS: PARKED until 0.0.3 rebrand ships green.**
-> Do NOT wire Gravity into the codebase until the Savant rebrand gate is verified.
-> The active source gate is now green: no deprecated `FREEBUFF_*` identifiers remain in `cli/src`, `common/src`,
-> `sdk/src`, `packages`, `agents`, or `savant-free/cli`. Historical protocol documents, legal notices, migration records,
-> and the legacy `.freebuff/` state-directory ignore rule are explicitly retained and are not active runtime branding.
-
----
-
-## What Gravity is
-
-Gravity (trygravity.ai) is an **AI-native ad network** — contextual sponsored suggestions inside AI
-chat/assistant/conversational products. It's the revenue engine that makes `savant-free` free. The ad request fires **in
-parallel** with your LLM call (zero added latency), the SDK renders the ad + auto-logs impressions/clicks, and you earn
-**CPM (per impression) or CPC (per click)**.
-
-**Architecture fit:**
-
-- `savant-free` (ad-supported, free tier) → Gravity SDK wired in, `codebuff_cli` surface ID retained for attribution.
-- `savant-code` (paid tier) → **NO Gravity SDK. No ads.** Clean premium path.
-
----
-
-## DO-NOT-TOUCH (rebrand scope is separate)
-
-These strings are **wire-protocol / legacy-support identifiers**, NOT branding. They must survive the rebrand untouched
-OR be re-registered with Gravity under a new ID *after* signup:
-
-| String | Role | Action |
-|---|---|---|
-| `codebuff_tool_call` | XML tag LLMs output (breaks all tool execution if changed) | KEEP as-is |
-| `codebuff_cli` | **Gravity publisher surface identifier** (ad attribution + analytics) | KEEP until registered; then rename to your Gravity-registered surface ID (e.g. `savant-free_cli`) and update dashboard |
-| `codebuff_terminal_command` | Activity tracking key | KEEP as-is |
-| `manicode` config dir / `.manicodeignore` | Legacy config support | KEEP as-is (rename to `savant` is a separate, non-Gravity decision) |
-
-⚠️ **If you rename `codebuff_cli` before registering with Gravity, ad revenue attribution breaks.** Register first, get
-your publisher surface ID, then align the string.
-
----
-
-## Prerequisites (post-0.0.3)
-
-1. Rebrand gate verified: typecheck ×4 and SDK suite are green; active source contains no deprecated `FREEBUFF_*`
-   identifiers. Retained protocol/history/legal references are documented in the rebrand FID.
-2. Sign up at **app.trygravity.ai/publisher/signup**.
-3. Create an AI platform account for `savant-free`.
-4. Copy **API key** → save as `GRAVITY_API_KEY` (server env).
-5. Copy **Pixel ID** → used in web pixel script.
-
----
-
-## Step 1 — Install SDK (in `savant-free/` workspace only)
-
-```bash
-cd savant-free
-npm install @gravity-ai/api @gravity-ai/react
-```
-
-Do NOT install in `savant-code` or any shared workspace.
-
----
-
-## Step 2 — Client context (chat component in `savant-free`)
-
-```ts
-import { gravityContext } from '@gravity-ai/api';
-
-const gravity_context = gravityContext({
-  sessionId: chatSession.id,       // your conversation ID
-  user: { userId: currentUser.id } // your user ID
-});
-// gravity_context includes device: { ua, timezone, locale, ... }
-// SDK adds end-user IP from request headers automatically.
-
-fetch('/api/chat', {
-  method: 'POST',
-  body: JSON.stringify({ messages, gravity_context }),
-});
-```
-
-**CRITICAL:** Forward `gravity_context` all the way to the ad request. The `device.ua` + `device.ip` are **required** —
-requests missing them are rejected with HTTP 400. If your backend calls Gravity without forwarding `device`, the ad
-request carries your *server's* UA/IP, not the end user's.
-
----
-
-## Step 3 — Server ad fetch (parallel with LLM stream)
-
-```ts
-import { Gravity } from '@gravity-ai/api';
-
-const gravity = new Gravity();  // reads GRAVITY_API_KEY from env
-
-app.post('/api/chat', async (req, res) => {
-  const { messages } = req.body;
-
-  const adPromise = gravity.getAds(req, messages, [
-    { placement: 'below_response', placement_id: 'main' },
-  ]);
-
-  // Stream your LLM response in parallel...
-  for await (const token of streamYourLLM(messages)) {
-    res.write(`data: ${JSON.stringify({ type: 'chunk', content: token })}\n\n`);
-  }
-
-  const { ads } = await adPromise;
-  res.write(`data: ${JSON.stringify({ type: 'done', ads })}\n\n`);
-  res.end();
-});
-```
-
-- Never throws — failures return `[]`.
-- 3s timeout default (configurable).
-- Runs alongside LLM call = zero added latency.
-
----
-
-## Step 4 — Render ad (React, `savant-free` UI)
-
-```tsx
-import { GravityAd } from '@gravity-ai/react';
-
-function ChatResponse({ response, ads }) {
-  return (
-    <div>
-      <p>{response}</p>
-      {ads[0] && <GravityAd ad={ads[0]} variant="card" />}
-    </div>
-  );
-}
-```
-
-`GravityAd` auto-fires impression tracking (IntersectionObserver) + click attribution. 20+ variants: `card`, `minimal`,
-`inline`, `spotlight`, `pill`, `banner`, `hyperlink`, etc.
-
----
-
-## Step 5 — Web pixel (REQUIRED for payouts)
-
-Drop on every `savant-free` page:
-
-```html
-<script>
-  !function(w,d,t,u,n,a,m){w['GravityPixelObject']=n;w[n]=w[n]||function(){
-  (w[n].q=w[n].q||[]).push(arguments)},w[n].l=1*new Date();a=d.createElement(t),
-  m=d.getElementsByTagName(t)[0];a.async=1;a.src=u;m.parentNode.insertBefore(a,m)
-  }(window,document,'script','https://code.trygravity.ai/gr-pix.js','gravity');
-  gravity('init', 'YOUR_PIXEL_ID');
-</script>
-```
-
-Without the pixel, Gravity can't measure journeys or tie performance to payouts.
-
----
-
-## Step 6 — Go live
-
-Default `new Gravity()` = **test ads** (safe, no billing). When ready:
-
-```ts
-const gravity = new Gravity({ production: true });
-```
-
----
-
-## Going-live checklist (from Gravity docs)
-
-- [ ] `GRAVITY_API_KEY` in server env (not hardcoded).
-- [ ] `gravity_context` forwarded client → server → ad request (device signals intact).
-- [ ] Pixel installed on all `savant-free` pages.
-- [ ] `production: true` set after test-mode verification.
-- [ ] `codebuff_cli` surface ID aligned with Gravity dashboard (or re-registered).
-- [ ] `savant-code` (paid) has NO Gravity import.
-- [ ] Ad slot gracefully hides on empty array (`204 No Content` → `{ ads: [] }`).
-
----
-
-## Revenue loop (the "agent economy funds itself" model)
-
-```text
-Gravity ads → savant-free inference paid → savant-free is free
-                                    ↓
-              you register as Gravity publisher → revenue flows
-                                    ↓
-         Zero-cost infra + ad-funded free tier + paid premium = funded stack
-```
-
----
-
-## References
-
-- Quickstart: https://docs.trygravity.ai/ai-platforms/quickstart
-- Integration guide: https://docs.trygravity.ai/ai-platforms/integration-guide
-- Going-live: https://docs.trygravity.ai/ai-platforms/going-live
-- Publisher signup: https://app.trygravity.ai/publisher/signup
-- SDK: `@gravity-ai/api` (server), `@gravity-ai/react` (client)
-- Case study (infra credibility): https://inference.net/case-study/gravity-ads/
-
----
-
-*Drafted by Nova (2026-07-19) from Gravity's official quickstart + integration docs. Parked pending 0.0.3 rebrand completion.*

package/docs/launch/hn-first-comment.md

@@ -1,44 +0,0 @@
-# Hacker News First Comment
-
-This comment should be posted immediately after the submission.
-
----
-
-Hi HN. I built Savant Code because I kept spending more time debugging
-AI-generated code than it would have taken to write it myself.
-
-The core bet is that accuracy matters more than speed. Savant Code runs a
-9-agent ECHO loop before it writes anything to disk:
-
-1. **Detective** explores the codebase and finds relevant context.
-2. **Thinker** reasons about the approach.
-3. **Forge** writes the change.
-4. **Verifier** audits it.
-5. If the audit fails, the loop self-corrects up to a hard limit.
-
-Every step is transparent in the terminal. You can see which agent made which
-decision and why.
-
-Key trade-offs, because I think HN will ask:
-
-- **It is slower than Copilot/Cursor.** The loop takes extra time because it
-  audits before outputting. We think that is worth it for multi-file changes.
-- **It is local-first.** If you run Ollama, inference stays on your machine.
-  BYOK mode is also supported; when you choose a remote provider, it receives
-  the prompt and context you send it. The broader telemetry/privacy policy is
-  still an explicit pre-launch decision, not a claim this post resolves.
-- **It is opinionated.** The ECHO Protocol enforces a strict workflow. Some
-  developers will hate that. The ones who want correctness over speed will
-  probably love it.
-- **It is not perfect.** We have seen the loop get stuck in cycles on ambiguous
-  prompts. That is why there is a hard iteration cap and a permission mode
-  system (`safe` / `prompt` / `unsafe`).
-
-What is currently broken / we need help with:
-
-- Windows path handling in a few edge cases.
-- Ollama auto-detection on non-standard ports.
-- The TUI color scheme assumes a dark terminal.
-
-If you try it, please file issues with real reproductions. We will be here for
- the next few hours.

package/docs/launch/hn-post.md

@@ -1,35 +0,0 @@
-# Show HN Post
-
-**Title:** Show HN: Savant Code – a local-first AI coding CLI with a 9-agent auditing loop
-
-**URL:** <https://github.com/savant0x/savant-code>
-
-**Body:**
-
-Savant Code is a terminal-native AI coding assistant built for developers who
-are tired of cleaning up hallucinated code. It runs locally with Ollama or
-connects to your own API keys (BYOK). With local Ollama, your code never leaves
-your machine.
-
-The core idea is a 9-agent "perfection loop" (we call it ECHO) that audits,
-critiques, and rewrites code before it ever reaches your codebase. Detective
-finds issues. Forge implements. Verifier audits. The loop repeats up to a hard
-cap, with explicit permission controls so you know exactly what is about to run.
-
-It is slower than Copilot. That is the point. We would rather ship code that
-actually works.
-
-Install the v0.0.18 release:
-
-```bash
-npm install -g savant-code
-```
-
-Then just run `savant-code` in any project. If you have Ollama running, it will
-auto-detect and use it. No account, no API key, no setup prompts.
-
-Built with TypeScript, Bun, and React for the TUI. Apache-2.0 licensed. We are
-opening it up for stress-testing before a wider launch.
-
-We would love feedback from anyone with a real codebase. Especially interested in
-edge cases on Windows and unusual Ollama setups.

package/docs/launch/incident-response.md

@@ -1,88 +0,0 @@
-# Launch Incident Response & Rollback Plan
-
-This document describes how to respond if the public launch triggers a bug
-flood, security issue, or reputational incident.
-
-## Severity Levels
-
-| Level | Trigger                                                       | Response Time |
-| ----- | ------------------------------------------------------------- | ------------- |
-| P0    | Install broken on a supported OS, data loss, security breach  | Immediate     |
-| P1    | Core feature broken (Ollama detection, permission mode, auth) | < 2 hours     |
-| P2    | UI bug, typo, non-critical docs issue                         | < 24 hours    |
-
-## Response Team
-
-- **Launch Captain:** Orchestrator
-- **Engineering:** who cut the release
-- **Community:** GitHub Issues triage until a public community channel exists
-- **Comms:** person who drafted launch copy
-
-## Communication Channels
-
-- Internal triage: GitHub Issues with `launch-incident` labels until a public
-  community channel and moderator schedule exist.
-- Public status: GitHub issue titled `[Launch Status] YYYY-MM-DD incident summary`
-- Rollback notice: reply to HN post and update Twitter/Mastodon; do not claim a
-  Discord announcement channel exists until it is created.
-
-## Rollback Procedures
-
-### npm Package Rollback
-
-```bash
-# Unpublish is only possible within 72 hours of publish
-npm unpublish savant-code@<bad-version>
-# Or deprecate if unpublish is not possible
-npm deprecate savant-code@<bad-version> \
-  "Critical issue, install <fixed-version> instead"
-```
-
-### GitHub Release Rollback
-
-1. Delete the bad release tag.
-2. Revert the problematic commit via a hotfix branch.
-3. Push a new patch release.
-4. Update `CHANGELOG.md` and `VERSION`.
-
-### Landing Page Rollback
-
-1. If a broken landing page is deployed, push a revert to the hosting branch.
-2. Verify DNS/cache invalidation (Cloudflare/GitHub Pages).
-
-### Social Amplification Pause
-
-1. Stop scheduled tweets/threads.
-2. Update the pinned HN comment with: "We are seeing reports of [issue]. We have
-   paused amplification and are cutting a patch."
-3. Do NOT delete the HN post; transparency is valued on HN.
-
-## Triage Workflow
-
-1. Collect reproductions in GitHub issues with a `launch-incident` label.
-2. Route Ollama and auth/BYOK issues to labeled GitHub Issues until dedicated
-   community channels exist.
-3. Reproduce locally on the target OS before declaring root cause.
-4. Cut a hotfix release and verify against the reproduction.
-5. Post a public incident summary in the GitHub issue and update only the
-   launch channels that actually exist.
-
-## Shadowban / Flagging Response
-
-If the HN post is flagged or domain shadowbanned:
-
-1. Do not coordinate upvotes.
-2. Post a factual, humble comment acknowledging any mistake.
-3. If the post is killed, use the blog/landing page as the primary link for
-   subsequent sharing.
-4. Do not create duplicate posts the same day.
-
-## Post-Mortem
-
-Within 48 hours of any P0/P1 incident, publish a post-mortem covering:
-
-- Timeline
-- Root cause
-- Fix applied
-- Prevention measures
-- Apology if users were affected

package/docs/launch/landing/index.html

@@ -1,233 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>Savant Code — Local-first AI coding assistant</title>
-    <meta
-      name="description"
-      content="A terminal-native AI coding assistant that audits every change before it touches your repo. Local-first with Ollama. BYOK. Open source."
-    />
-    <style>
-      :root {
-        --bg: #0b0d10;
-        --fg: #e8eef4;
-        --muted: #9aa5b1;
-        --accent: #00fbff;
-        --accent-dim: rgba(0, 251, 255, 0.12);
-        --border: #1f2937;
-      }
-      * {
-        box-sizing: border-box;
-      }
-      body {
-        margin: 0;
-        background: var(--bg);
-        color: var(--fg);
-        font-family:
-          ui-sans-serif,
-          system-ui,
-          -apple-system,
-          BlinkMacSystemFont,
-          'Segoe UI',
-          Roboto,
-          sans-serif;
-        line-height: 1.6;
-        -webkit-font-smoothing: antialiased;
-      }
-      .container {
-        max-width: 720px;
-        margin: 0 auto;
-        padding: 4rem 1.5rem 6rem;
-      }
-      .badge {
-        display: inline-block;
-        padding: 0.25rem 0.75rem;
-        border-radius: 9999px;
-        background: var(--accent-dim);
-        color: var(--accent);
-        font-size: 0.75rem;
-        font-weight: 600;
-        letter-spacing: 0.05em;
-        text-transform: uppercase;
-      }
-      h1 {
-        font-size: clamp(2.5rem, 7vw, 4rem);
-        line-height: 1.05;
-        margin: 1.5rem 0 1rem;
-        font-weight: 800;
-      }
-      .lead {
-        font-size: 1.25rem;
-        color: var(--muted);
-        max-width: 600px;
-      }
-      .cta {
-        display: flex;
-        flex-wrap: wrap;
-        gap: 1rem;
-        margin: 2rem 0;
-      }
-      .btn {
-        display: inline-flex;
-        align-items: center;
-        gap: 0.5rem;
-        padding: 0.875rem 1.5rem;
-        border-radius: 0.5rem;
-        font-weight: 600;
-        text-decoration: none;
-        transition:
-          transform 0.1s ease,
-          opacity 0.15s ease;
-      }
-      .btn:hover {
-        transform: translateY(-2px);
-      }
-      .btn-primary {
-        background: var(--accent);
-        color: var(--bg);
-      }
-      .btn-secondary {
-        border: 1px solid var(--border);
-        color: var(--fg);
-      }
-      .demo {
-        margin: 3rem 0;
-        border: 1px solid var(--border);
-        border-radius: 0.75rem;
-        overflow: hidden;
-        background: #11151c;
-      }
-      .demo img,
-      .demo video {
-        display: block;
-        width: 100%;
-        height: auto;
-      }
-      .demo-note {
-        margin: 3rem 0;
-        color: var(--muted);
-        font-size: 0.95rem;
-      }
-      .features {
-        display: grid;
-        gap: 1.5rem;
-        margin: 3rem 0;
-      }
-      .feature {
-        padding: 1.25rem;
-        border: 1px solid var(--border);
-        border-radius: 0.5rem;
-      }
-      .feature h3 {
-        margin: 0 0 0.5rem;
-        color: var(--accent);
-        font-size: 1rem;
-      }
-      .feature p {
-        margin: 0;
-        color: var(--muted);
-        font-size: 0.95rem;
-      }
-      .install {
-        margin: 3rem 0;
-        padding: 1.5rem;
-        border: 1px solid var(--border);
-        border-radius: 0.5rem;
-        background: #11151c;
-      }
-      .install pre {
-        margin: 0.75rem 0 0;
-        padding: 1rem;
-        border-radius: 0.375rem;
-        background: #0b0d10;
-        color: var(--accent);
-        overflow-x: auto;
-        font-size: 0.9rem;
-      }
-      footer {
-        margin-top: 4rem;
-        padding-top: 2rem;
-        border-top: 1px solid var(--border);
-        color: var(--muted);
-        font-size: 0.875rem;
-      }
-      footer a {
-        color: var(--accent);
-        text-decoration: none;
-      }
-      footer a:hover {
-        text-decoration: underline;
-      }
-    </style>
-  </head>
-  <body>
-    <div class="container">
-      <span class="badge">Open Source · Apache-2.0</span>
-      <span class="badge" style="margin-left: 0.5rem">v0.0.17</span>
-      <h1>Code that actually works.</h1>
-      <p class="lead">
-        Savant Code is a terminal-native AI coding assistant that runs a 9-agent
-        auditing loop before any change touches your repo. Local-first with
-        Ollama. BYOK when you choose a remote provider.
-      </p>
-
-      <div class="cta">
-        <a
-          class="btn btn-primary"
-          href="https://github.com/savant0x/savant-code"
-          >View on GitHub</a
-        >
-        <a
-          class="btn btn-secondary"
-          href="https://github.com/savant0x/savant-code/blob/main/ECHO.md"
-          >Read ECHO Protocol</a
-        >
-      </div>
-
-      <p class="demo-note">
-        A terminal demo asset is not yet available. Install the current package
-        or inspect the open-source CLI and ECHO Protocol from the links above.
-      </p>
-
-      <div class="features">
-        <div class="feature">
-          <h3>9-Agent Perfection Loop</h3>
-          <p>
-            Detective, Thinker, Forge, Verifier, and five more agents coordinate
-            under the ECHO Protocol. The writer never audits its own work.
-          </p>
-        </div>
-        <div class="feature">
-          <h3>Local-first with Ollama</h3>
-          <p>
-            Auto-detects a running Ollama daemon and routes inference locally.
-            No API key. No account. Your code stays on your machine.
-          </p>
-        </div>
-        <div class="feature">
-          <h3>Permission Mode Sandbox</h3>
-          <p>
-            Run in <code>safe</code>, <code>prompt</code>, or
-            <code>unsafe</code> mode. Destructive commands and network access
-            are gated by your chosen permission level.
-          </p>
-        </div>
-      </div>
-
-      <div class="install">
-        <strong>Install in one command</strong>
-        <pre>npm install -g savant-code</pre>
-      </div>
-
-      <footer>
-        <p>
-          Built with TypeScript, Bun, and React for the terminal UI. A public
-          Discord community is not yet available; please open an issue on
-          <a href="https://github.com/savant0x/savant-code">GitHub</a>.
-        </p>
-        <p>© 2026 Savant Code contributors.</p>
-      </footer>
-    </div>
-  </body>
-</html>

package/docs/launch/mastodon-thread.md

@@ -1,52 +0,0 @@
-# Mastodon Launch Thread
-
-Post 1/4 — intro
-
-```text
-Launching Savant Code, a local-first AI coding CLI.
-
-The pitch: instead of generating code as fast as possible, a 9-agent ECHO loop
-audits, critiques, and rewrites every change before it reaches your codebase.
-
-Built with TypeScript/Bun. Apache-2.0.
-```
-
-Post 2/4 — architecture
-
-```text
-The ECHO Protocol is the single bootstrap file that governs all 9 agents:
-
-- Detective: explores the codebase
-- Thinker: reasons about approach
-- Forge: implements
-- Verifier: audits
-- Recorder: tracks FIDs
-- Scout: gathers context
-- Researcher: web/docs lookup
-- Scribe: documentation
-- Orchestrator: routes work
-
-Separation of duties is enforced: the agent that writes code cannot verify it.
-```
-
-Post 3/4 — privacy / self-hosting
-
-```text
-Savant Code supports local Ollama and BYOK provider selection. If Ollama is
-running, `savant-code` auto-detects it and routes inference locally; a remote
-provider receives the prompt and context you choose to send it. No API key or
-account is required for a local Ollama daemon. The broader telemetry/privacy
-policy remains an explicit pre-launch decision and is not resolved by this post.
-```
-
-Post 4/4 — call to action
-
-```text
-We are doing a soft launch on r/LocalLLaMA and r/ChatGPTCoding this week before
-a wider HN launch.
-
-If you care about code correctness and privacy, we would love your feedback.
-
-GitHub: https://github.com/savant0x/savant-code
-Discord: not yet available; please use GitHub Issues for feedback.
-```