contextspin 0.3.0 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "contextspin",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Replace Claude Code spinner/statusline text with live org context (meetings, Slack, CI, incidents, PRs) aggregated from your existing MCP servers, CLIs, and HTTP endpoints.",
   "type": "module",
   "bin": {

package/src/config.js

@@ -56,6 +56,65 @@ export const CLAUDE_USER_CONFIG_PATH = path.join(HOME, ".claude.json");
 /** Suffix appended to a Claude install path to name its patcher backup. */
 export const PATCHER_BACKUP_SUFFIX = ".contextspin.backup";
 
+/**
+ * Built-in "prefilled" snippet texts. The statusline render script falls back to
+ * these (rotating through them) whenever there is no live snippet to show — so
+ * the status bar is NEVER empty, even immediately after install before the daemon
+ * has fetched anything, or when every source returns nothing. They double as
+ * onboarding hints pointing at the next useful thing to configure.
+ */
+export const DEFAULT_SNIPPETS = [
+  // Jokes — always available, even fully offline, so the bar is fun from second
+  // one. At least five so the rotation never feels repetitive.
+  "😄 Why do programmers prefer dark mode? Because light attracts bugs.",
+  "😄 A SQL query walks into a bar, sees two tables and asks: can I join you?",
+  "😄 Why did the developer go broke? He used up all his cache.",
+  "😄 There are 10 kinds of people: those who read binary and those who don't.",
+  "😄 I'd tell you a UDP joke, but you might not get it.",
+  "😄 To understand recursion, you must first understand recursion.",
+  // Live-context teasers + onboarding — what to try next.
+  "🌤️ Local weather appears here once the daemon warms up",
+  "📊 Run /contextspin-manage to see how many PRs you've closed to date",
+  "👀 Add a GitHub source to surface PRs awaiting your review",
+  "📅 Add a calendar source to see your next meeting here",
+  "🛠️ Run /contextspin-setup to wire up more live sources",
+];
+
+/**
+ * No-credentials starter sources seeded into the DEFAULT config on first install
+ * so the user sees REAL live context (weather, a fresh joke, the top HN story)
+ * immediately — not just static tips. All are public HTTP endpoints needing no
+ * auth. Combined with detected sources (e.g. review requests) by defaultConfig.
+ */
+export const STARTER_SOURCES = [
+  {
+    type: "http",
+    url: "https://wttr.in/?format=3",
+    format: "🌤️ {{text}}",
+    label: "weather",
+    cooldown: 1800,
+    maxSnippets: 1,
+  },
+  {
+    type: "http",
+    url: "https://icanhazdadjoke.com/",
+    headers: { Accept: "text/plain" },
+    format: "😄 {{text}}",
+    label: "joke",
+    cooldown: 1800,
+    maxSnippets: 1,
+  },
+  {
+    type: "http",
+    url: "https://hn.algolia.com/api/v1/search?tags=front_page&hitsPerPage=1",
+    jq: ".hits[0].title",
+    format: "📰 HN: {{value}}",
+    label: "hackernews",
+    cooldown: 600,
+    maxSnippets: 1,
+  },
+];
+
 /** Default top-level config sections. */
 export const DEFAULTS = {
   injection: { mode: "statusline", refresh: 30, maxVisible: 5 },
@@ -144,8 +203,16 @@ export function normalizeConfig(raw) {
  * @returns {object} A default config: { sources, injection, snippets }.
  */
 export function defaultConfig(sources) {
+  const detected = Array.isArray(sources) ? sources : [];
+  // Seed the no-credentials starter sources so a brand-new install shows REAL
+  // live context right away. Skip any starter whose label a detected source
+  // already provides, so we never double up.
+  const have = new Set(detected.map((s) => s && s.label).filter(Boolean));
+  const starters = STARTER_SOURCES.filter((s) => !have.has(s.label)).map((s) => ({
+    ...s,
+  }));
   return {
-    sources: Array.isArray(sources) ? sources : [],
+    sources: [...detected, ...starters],
     injection: { mode: "statusline", refresh: 30, maxVisible: 5 },
     snippets: {
       deduplication: true,
@@ -159,6 +226,9 @@ export function defaultConfig(sources) {
         "github",
         "gitlab",
         "jira",
+        "weather",
+        "joke",
+        "hackernews",
       ],
     },
   };

package/src/inject/statusline.js

@@ -32,6 +32,7 @@ import {
   CACHE_PATH,
   CONFIG_PATH,
   CLAUDE_SETTINGS_PATH,
+  DEFAULT_SNIPPETS,
 } from "../config.js";
 
 /**
@@ -72,6 +73,7 @@ function buildRenderScript(cachePath, configPath, prevPath) {
   const CACHE = JSON.stringify(cachePath);
   const CONFIG = JSON.stringify(configPath);
   const PREV = JSON.stringify(prevPath);
+  const DEFAULTS = JSON.stringify(DEFAULT_SNIPPETS);
   return `// contextspin statusline-render.js (generated) — composes any prior
 // statusline (looked up per-project) with one ContextSpin snippet line. MUST
 // always exit 0 and never lose the prior statusline's output, so the user's
@@ -82,6 +84,7 @@ import { spawn } from "node:child_process";
 const CACHE_PATH = ${CACHE};
 const CONFIG_PATH = ${CONFIG};
 const PREV_STATUSLINE_PATH = ${PREV};
+const DEFAULT_SNIPPETS = ${DEFAULTS};
 
 /** Buffer ALL of stdin into a Buffer. Resolves on end/close/error/timeout. */
 function readStdin() {
@@ -243,16 +246,41 @@ function writeJsonAtomic(filePath, data) {
   fs.renameSync(tmp, filePath);
 }
 
-/** Compute the ContextSpin snippet line (may be ""); bumps shownCount. */
+/**
+ * Pick a rotating built-in default snippet text. NEVER exhausts (defaults are
+ * always available) — this is the guarantee that the status bar is never empty.
+ * Persists a rotating index back into the cache object (caller writes it).
+ */
+function defaultLine(cache) {
+  if (!Array.isArray(DEFAULT_SNIPPETS) || DEFAULT_SNIPPETS.length === 0) return "";
+  const n = DEFAULT_SNIPPETS.length;
+  const idx = Number.isInteger(cache && cache._defaultIndex) ? cache._defaultIndex : 0;
+  const text = DEFAULT_SNIPPETS[((idx % n) + n) % n];
+  if (cache && typeof cache === "object") {
+    cache._defaultIndex = (idx + 1) % n;
+    try {
+      writeJsonAtomic(CACHE_PATH, cache);
+    } catch {
+      // best effort — still show the default this render
+    }
+  }
+  return String(text).replace(/\\r?\\n/g, " ");
+}
+
+/**
+ * Compute the ContextSpin snippet line. ALWAYS returns a non-empty string: a
+ * live snippet when one is eligible, otherwise a rotating built-in default so the
+ * status bar is never blank.
+ */
 function contextSpinLine() {
   let cache;
   try {
     cache = JSON.parse(fs.readFileSync(CACHE_PATH, "utf8"));
   } catch {
-    return "";
+    cache = {};
   }
-  const snippets = Array.isArray(cache && cache.snippets) ? cache.snippets : [];
-  if (snippets.length === 0) return "";
+  if (!cache || typeof cache !== "object") cache = {};
+  const snippets = Array.isArray(cache.snippets) ? cache.snippets : [];
 
   // cooldownAfterShown from config (fallback 3).
   let cooldownAfterShown = 3;
@@ -267,7 +295,8 @@ function contextSpinLine() {
   const eligible = snippets.filter(
     (s) => s && typeof s.text === "string" && (s.shownCount || 0) < cooldownAfterShown
   );
-  if (eligible.length === 0) return "";
+  // No live snippet to show -> fall back to a rotating built-in default.
+  if (eligible.length === 0) return defaultLine(cache);
 
   eligible.sort((a, b) => {
     const ca = a.shownCount || 0;
@@ -289,6 +318,28 @@ function contextSpinLine() {
   return String(chosen.text).replace(/\\r?\\n/g, " ");
 }
 
+/**
+ * Wrap the ContextSpin line in a compact, "boxed" ANSI style — bright italic
+ * text between cyan bars — so it stands out from the prior statusline. Honors
+ * \`injection.style: false\` in the config to opt out (plain text). Any error
+ * falls back to the plain text.
+ */
+function styleLine(text) {
+  if (!text) return text;
+  let enabled = true;
+  try {
+    const cfg = JSON.parse(fs.readFileSync(CONFIG_PATH, "utf8"));
+    if (cfg && cfg.injection && cfg.injection.style === false) enabled = false;
+  } catch {
+    // keep enabled
+  }
+  if (!enabled) return text;
+  const BAR = "\\x1b[36m"; // cyan
+  const BODY = "\\x1b[3;96m"; // italic + bright cyan
+  const RESET = "\\x1b[0m";
+  return BAR + "┃" + RESET + " " + BODY + text + RESET + " " + BAR + "┃" + RESET;
+}
+
 /** Write a string to stdout, awaiting the flush callback. */
 function writeOut(text) {
   return new Promise((resolve) => {
@@ -314,10 +365,10 @@ async function main() {
     prevOut = "";
   }
 
-  // (b) ContextSpin snippet line.
+  // (b) ContextSpin snippet line (always non-empty; styled).
   let line = "";
   try {
-    line = contextSpinLine();
+    line = styleLine(contextSpinLine());
   } catch {
     line = "";
   }