@vextlabs/theron-cli 0.1.0

package/dist/onboard.js

@@ -0,0 +1,234 @@
+// `theron onboard` — one-command migration wizard.
+//
+// Anna 2026-05-10: "Setup a full ready-to-come-over-to-Vext-Labs
+// integration walk-through. SUPER EASY — painless. Even me — going
+// from using Claude all day to only using Theron."
+//
+// The wizard handles every step a new-to-Theron user would otherwise
+// have to remember. Each step is opt-in (asks first), so re-running
+// the wizard is safe — it skips steps the user already finished.
+//
+// Steps (in order):
+//   1.  Sign in (or confirm existing credentials).
+//   2.  Pick top 3 specialists to pin (based on stated work focus).
+//   3.  Install the `cl` shell alias for muscle memory.
+//   4.  Connect Microsoft 365 OAuth.
+//   5.  Connect Google Workspace OAuth.
+//   6.  Install the Office add-in (sideload manifest).
+//   7.  Offer to import a Claude conversation export.
+import readline from "node:readline";
+import path from "node:path";
+import fs from "node:fs";
+import os from "node:os";
+import { spawnSync } from "node:child_process";
+import chalk from "chalk";
+import { listProfiles } from "./profiles/index.js";
+import { loadCredentials } from "./auth.js";
+const AMBER = "#FFAE00";
+const HOME = os.homedir();
+const SHELL_RC = path.join(HOME, ".zshrc");
+const BASH_RC = path.join(HOME, ".bashrc");
+export async function onboardCommand(opts = {}) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const ask = (q) => new Promise((res) => rl.question(q, res));
+    const yes = async (q, def = 'y') => {
+        const a = (await ask(`${q} ${def === 'y' ? '[Y/n]' : '[y/N]'} `)).trim().toLowerCase();
+        if (!a)
+            return def === 'y';
+        return a === 'y' || a === 'yes';
+    };
+    banner();
+    // ── Step 1 — Sign in ────────────────────────────────────────────
+    step(1, "Sign in");
+    const creds = await loadCredentials();
+    if (creds.api_key) {
+        info(`Already signed in. API key in ~/.theron/credentials.`);
+    }
+    else {
+        info("You're not signed in yet.");
+        if (await yes("Run `theron login` now?", 'y')) {
+            const r = spawnSync(process.execPath, [process.argv[1], "login"], { stdio: 'inherit' });
+            if (r.status !== 0) {
+                warn("Login was canceled or failed — anonymous mode works too, just with lower rate limits.");
+            }
+        }
+    }
+    // ── Step 2 — Pick top 3 specialists ────────────────────────────
+    step(2, "Pick your top 3 specialists");
+    info("Theron has 33 specialists in the chat picker. We'll pin 3 to the top of yours based on what kind of work you do most.");
+    const focusInput = await ask(`What kind of work fills your days? (e.g. "code, design, writing"): `);
+    const focus = focusInput.trim().toLowerCase();
+    const picked = pickSpecialists(focus, listProfiles());
+    if (picked.length > 0) {
+        info(`Pinning: ${picked.map((p) => `@${p.slug}`).join(", ")}`);
+        savePinnedSpecialists(picked.map((p) => p.slug));
+    }
+    else {
+        info("No specific focus — leaving your picker default.");
+    }
+    // ── Step 3 — `cl` shell alias ──────────────────────────────────
+    step(3, "Install the `cl` shell alias (same muscle memory)");
+    info("Type `cl <thing>` instead of `theron <thing>` — shorter to type, same effect.");
+    if (await yes("Add `alias cl=theron` to your shell config?", 'y')) {
+        installShellAlias();
+    }
+    else {
+        info("Skipped. Add it later with: echo 'alias cl=theron' >> ~/.zshrc");
+    }
+    // ── Step 4 — Microsoft 365 OAuth ──────────────────────────────
+    step(4, "Connect Microsoft 365");
+    info("Connecting MS unlocks the ms365.* Stoa caps — Excel, PowerPoint, Word, Outlook — auto-token-injected at every cap call.");
+    if (await yes("Open the Microsoft consent flow in your browser?", 'y')) {
+        const apiUrl = opts.apiUrl ?? "https://tryvext.com";
+        const url = `${apiUrl}/api/oauth/microsoft/start${creds.api_key ? `?apikey=${encodeURIComponent(creds.api_key)}` : ''}`;
+        openInBrowser(url);
+        info(`Opened: ${url}`);
+        info("After consent, the token persists server-side. No client-side state change needed.");
+    }
+    else {
+        info("Skipped. Run `theron onboard` again later to retry, or visit /api/oauth/microsoft/start.");
+    }
+    // ── Step 5 — Google Workspace OAuth ────────────────────────────
+    step(5, "Connect Google Workspace");
+    info("Connecting Google unlocks the gws.* Stoa caps — Sheets, Docs, Slides, Gmail, Calendar, Drive.");
+    if (await yes("Open the Google consent flow?", 'y')) {
+        const apiUrl = opts.apiUrl ?? "https://tryvext.com";
+        const url = `${apiUrl}/api/oauth/google/start${creds.api_key ? `?apikey=${encodeURIComponent(creds.api_key)}` : ''}`;
+        openInBrowser(url);
+        info(`Opened: ${url}`);
+    }
+    else {
+        info("Skipped.");
+    }
+    // ── Step 6 — Office add-in ────────────────────────────────────
+    step(6, "Install the Office 365 add-in");
+    info("Sideloads the Theron task pane into Excel + PowerPoint + Word. Microsoft Add-in Validator: GREEN.");
+    if (await yes("Open the sideload manifest now?", 'y')) {
+        openInBrowser("https://tryvext.com/office-addin/manifest.xml");
+        info("Sideload steps: https://learn.microsoft.com/office/dev/add-ins/testing/sideload-office-add-ins-for-testing");
+        info("Once sideloaded, look for the 'Open Theron' button in the ribbon.");
+    }
+    else {
+        info("Skipped.");
+    }
+    // ── Step 7 — Claude export import ─────────────────────────────
+    step(7, "Import your Claude history (optional)");
+    info("Drop a Claude data-export zip and Theron extracts your preferences (voice, project context, recurring decisions) and seeds long-term memory.");
+    info("Get the zip at: https://claude.ai → Settings → Privacy → Download Data → email arrives with a zip.");
+    const importPath = (await ask("Path to data-export.zip (or blank to skip): ")).trim();
+    if (importPath) {
+        const r = spawnSync(process.execPath, [process.argv[1], "import-claude", importPath], { stdio: 'inherit' });
+        if (r.status !== 0) {
+            warn("Claude import failed or was canceled.");
+        }
+    }
+    else {
+        info("Skipped. Run later with: theron import-claude <zip>");
+    }
+    // ── Done ──────────────────────────────────────────────────────
+    rl.close();
+    console.log();
+    console.log(chalk.hex(AMBER).bold("✓ You're on Theron."));
+    console.log();
+    console.log("  Try it now:");
+    console.log("    " + chalk.hex(AMBER)("cl") + " 'review the last PR I opened'");
+    console.log("    " + chalk.hex(AMBER)("cl") + " --mode legal 'draft an NDA between us and Acme'");
+    console.log("    " + chalk.hex(AMBER)("cl") + " --mode finance 'build a 3-year ARR model at 15% YoY'");
+    console.log();
+    console.log("  Surface picker:    https://theron.tryvext.com");
+    console.log("  Voice mode:        https://tryvext.com/voice");
+    console.log("  Office add-in:     already sideloaded — look for the ribbon button");
+    console.log("  /admin/stoa/pending — review caps the Hive agents propose (staff)");
+    console.log();
+    return 0;
+}
+// ── helpers ────────────────────────────────────────────────────────
+function banner() {
+    console.log();
+    console.log(chalk.hex(AMBER).bold("  Theron · onboarding wizard"));
+    console.log(chalk.dim("  Same muscle memory. Better loop. ~8 minutes."));
+    console.log();
+}
+function step(n, title) {
+    console.log();
+    console.log(chalk.dim(`─── Step ${n}/7 ───────────────────────────────────────────────`));
+    console.log(chalk.bold(title));
+}
+function info(s) {
+    console.log("  " + s);
+}
+function warn(s) {
+    console.log("  " + chalk.yellow(s));
+}
+// Pin top 3 specialists based on a free-text "what kind of work" answer.
+// Simple keyword match against profile slug + label + description; takes
+// the top 3 by score. Beats asking the user to pick from 33 by name.
+function pickSpecialists(focus, all) {
+    if (!focus)
+        return [];
+    const tokens = focus.split(/[\s,;]+/).map((t) => t.trim().toLowerCase()).filter(Boolean);
+    if (tokens.length === 0)
+        return [];
+    // Score: each token-in-slug = 5; in-label = 3; in-description = 1.
+    const scored = all.map((p) => {
+        let score = 0;
+        for (const t of tokens) {
+            if (p.slug.includes(t))
+                score += 5;
+            if (p.label.toLowerCase().includes(t))
+                score += 3;
+            if (p.description.toLowerCase().includes(t))
+                score += 1;
+        }
+        return { profile: p, score };
+    });
+    scored.sort((a, b) => b.score - a.score);
+    return scored.filter((s) => s.score > 0).slice(0, 3).map((s) => s.profile);
+}
+// Persist pinned specialists to ~/.theron/pinned.json — the REPL reads
+// this on launch and seeds the session pin list.
+function savePinnedSpecialists(slugs) {
+    const dir = path.join(HOME, ".theron");
+    try {
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { mode: 0o700 });
+        fs.writeFileSync(path.join(dir, "pinned.json"), JSON.stringify({ pinned: slugs }, null, 2), { mode: 0o600 });
+        info(`Saved to ~/.theron/pinned.json`);
+    }
+    catch (err) {
+        warn(`Couldn't save pinned specialists: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+// Add `alias cl=theron` to ~/.zshrc (or ~/.bashrc fallback). Idempotent
+// — won't duplicate the line on re-runs.
+function installShellAlias() {
+    const target = fs.existsSync(SHELL_RC) ? SHELL_RC : BASH_RC;
+    const line = "alias cl='theron'  # Theron — same muscle memory";
+    try {
+        const existing = fs.existsSync(target) ? fs.readFileSync(target, "utf8") : "";
+        if (existing.includes("alias cl=") || existing.includes("alias cl ")) {
+            info(`\`cl\` alias already in ${target} — skipping.`);
+            return;
+        }
+        fs.appendFileSync(target, `\n# Added by theron onboard\n${line}\n`);
+        info(`Added \`alias cl=theron\` to ${target}.`);
+        info(`Reload your shell or run: source ${target}`);
+    }
+    catch (err) {
+        warn(`Couldn't write to ${target}: ${err instanceof Error ? err.message : String(err)}`);
+        info("Manual install: echo \"alias cl='theron'\" >> ~/.zshrc");
+    }
+}
+function openInBrowser(url) {
+    // macOS / Linux / Windows shell open.
+    const opener = process.platform === "darwin" ? "open" :
+        process.platform === "win32" ? "start" :
+            "xdg-open";
+    try {
+        spawnSync(opener, [url], { stdio: 'ignore' });
+    }
+    catch {
+        info(`Open this in your browser: ${url}`);
+    }
+}
+//# sourceMappingURL=onboard.js.map

package/dist/onboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.js","sourceRoot":"","sources":["../src/onboard.ts"],"names":[],"mappings":"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"}

package/dist/profile_match.d.ts

@@ -0,0 +1,15 @@
+import { type TheronProfile } from "./profiles/index.js";
+export interface ProfileMatch {
+    profile: TheronProfile;
+    score: number;
+}
+/**
+ * Score every profile against the user's prompt; return the top-N.
+ * The returned scores are NOT cosine-normalized — they're absolute
+ * TF-IDF sums. Useful for thresholding ("only suggest a switch if
+ * score > 0.05") and for the UI to show relative magnitudes.
+ *
+ * Empty / very-short prompts return [] — we don't want to suggest a
+ * profile switch on "hi".
+ */
+export declare function rankProfilesForPrompt(prompt: string, topN?: number): ProfileMatch[];

package/dist/profile_match.js

@@ -0,0 +1,107 @@
+// profile_match — pick the top-N most relevant profiles for a given prompt.
+//
+// Pattern lifted from jcode (MIT): instead of pre-loading all 33
+// profiles as system-prompt context every turn (token-heavy + noisy),
+// rank them by similarity to the user's actual prompt and inject only
+// the top-3. The profile registry stays small enough on disk that
+// we don't need a real embedding model — a TF-IDF over the title +
+// description + welcome blurb is enough signal to route correctly.
+//
+// When the user explicitly typed `/mode <slug>` they've made a
+// deterministic choice; this matcher is bypassed. It only fires when
+// the user is on the default profile and we want to softly suggest
+// "Theron-Legal would handle this better — try /mode legal".
+import { listProfiles } from "./profiles/index.js";
+// Cheap stopword filter — same shape jcode uses. Keeps domain terms
+// (api, contract, deck) but drops "the / and / what / how".
+const STOPWORDS = new Set([
+    "the", "a", "an", "and", "or", "but", "for", "of", "to", "in", "on",
+    "at", "by", "with", "is", "are", "was", "were", "be", "been", "being",
+    "have", "has", "had", "do", "does", "did", "will", "would", "should",
+    "could", "may", "might", "must", "can", "as", "from", "if", "this",
+    "that", "these", "those", "i", "you", "we", "they", "he", "she", "it",
+    "my", "your", "our", "their", "his", "her", "its", "what", "which",
+    "who", "whom", "whose", "where", "when", "why", "how", "not", "no",
+    "so", "than", "then", "into", "about", "up", "down", "out", "over",
+    "under", "again", "more", "most", "some", "such", "any", "all", "each",
+    "every", "both", "few", "many", "much", "other", "another", "either",
+    "neither", "one", "two", "make", "made", "get", "got", "go", "going",
+    "want", "need", "like", "just", "really", "very", "even",
+]);
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s_\-]/g, " ")
+        .split(/\s+/)
+        .filter((t) => t.length >= 3 && !STOPWORDS.has(t));
+}
+function vectorize(profile) {
+    // The descriptor we score against is title + description + welcome +
+    // any prompt-starters. These together capture what the profile is
+    // good at without leaking implementation details.
+    const corpus = [
+        profile.label,
+        profile.description,
+        profile.welcome ?? "",
+        ...(profile.promptStarters ?? []),
+    ].join(" ");
+    const tokens = tokenize(corpus);
+    const terms = new Map();
+    for (const t of tokens)
+        terms.set(t, (terms.get(t) ?? 0) + 1);
+    return { slug: profile.slug, terms, length: tokens.length };
+}
+// Inverse-document-frequency for the corpus of profiles. Computed once
+// per call — 33 profiles fit easily in memory.
+function computeIdf(docs) {
+    const N = docs.length;
+    const df = new Map();
+    for (const d of docs) {
+        for (const term of d.terms.keys()) {
+            df.set(term, (df.get(term) ?? 0) + 1);
+        }
+    }
+    const idf = new Map();
+    for (const [term, freq] of df.entries()) {
+        idf.set(term, Math.log(1 + N / freq));
+    }
+    return idf;
+}
+function tfIdfScore(promptTokens, doc, idf) {
+    let score = 0;
+    if (doc.length === 0)
+        return 0;
+    for (const t of promptTokens) {
+        const tf = (doc.terms.get(t) ?? 0) / doc.length;
+        const i = idf.get(t) ?? 0;
+        score += tf * i;
+    }
+    return score;
+}
+/**
+ * Score every profile against the user's prompt; return the top-N.
+ * The returned scores are NOT cosine-normalized — they're absolute
+ * TF-IDF sums. Useful for thresholding ("only suggest a switch if
+ * score > 0.05") and for the UI to show relative magnitudes.
+ *
+ * Empty / very-short prompts return [] — we don't want to suggest a
+ * profile switch on "hi".
+ */
+export function rankProfilesForPrompt(prompt, topN = 3) {
+    const t = prompt.trim();
+    if (t.length < 12)
+        return [];
+    const promptTokens = tokenize(t);
+    if (promptTokens.length === 0)
+        return [];
+    const profiles = listProfiles();
+    const docs = profiles.map(vectorize);
+    const idf = computeIdf(docs);
+    const scored = profiles.map((p, i) => ({
+        profile: p,
+        score: tfIdfScore(promptTokens, docs[i], idf),
+    }));
+    scored.sort((a, b) => b.score - a.score);
+    return scored.filter((m) => m.score > 0).slice(0, topN);
+}
+//# sourceMappingURL=profile_match.js.map

package/dist/profile_match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_match.js","sourceRoot":"","sources":["../src/profile_match.ts"],"names":[],"mappings":"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"}

package/dist/profiles/index.d.ts

@@ -0,0 +1,20 @@
+import type { TheronProfile } from "./types.js";
+import { DEFAULT_PROFILE_SLUG } from "./seeds.js";
+/** Look up a profile by slug. Case-insensitive. Returns null if missing. */
+export declare function getProfile(slug: string | undefined | null): TheronProfile | null;
+/** Look up a profile, falling back to the default code profile. Used by
+ *  the REPL when the user hasn't named one. */
+export declare function getProfileOrDefault(slug: string | undefined | null): TheronProfile;
+/** List all profiles in registration order. Used by /mode list and the
+ *  help screen. */
+export declare function listProfiles(): TheronProfile[];
+/** Overlay a server-provided roster onto the local seed registry. Each
+ *  remote entry merges over the local one by slug. Called once at REPL
+ *  startup; the registry locks after the first overlay so a malicious
+ *  server can't rewrite the registry mid-session (e.g. via a tool
+ *  message that smuggles in a profile-update frame). */
+export declare function overlayRemoteProfiles(remote: TheronProfile[]): void;
+/** Convenience: profile slug → label, for compact log lines. */
+export declare function profileLabel(slug: string | undefined | null): string;
+export { DEFAULT_PROFILE_SLUG };
+export type { TheronProfile };

package/dist/profiles/index.js

@@ -0,0 +1,56 @@
+// Theron CLI profile registry.
+//
+// The CLI ships with a local baseline (SEED_PROFILES, 33 specs) and
+// can optionally overlay a server-fetched roster at launch. The server
+// always wins if both define the same slug — that lets us hot-update
+// the prompts and verifiers without a CLI reinstall.
+import { SEED_PROFILES, DEFAULT_PROFILE_SLUG } from "./seeds.js";
+const REGISTRY = new Map();
+for (const p of SEED_PROFILES)
+    REGISTRY.set(p.slug, p);
+let registryLocked = false;
+/** Look up a profile by slug. Case-insensitive. Returns null if missing. */
+export function getProfile(slug) {
+    if (!slug)
+        return null;
+    return REGISTRY.get(slug.toLowerCase()) ?? null;
+}
+/** Look up a profile, falling back to the default code profile. Used by
+ *  the REPL when the user hasn't named one. */
+export function getProfileOrDefault(slug) {
+    return getProfile(slug) ?? REGISTRY.get(DEFAULT_PROFILE_SLUG);
+}
+/** List all profiles in registration order. Used by /mode list and the
+ *  help screen. */
+export function listProfiles() {
+    return Array.from(REGISTRY.values());
+}
+/** Overlay a server-provided roster onto the local seed registry. Each
+ *  remote entry merges over the local one by slug. Called once at REPL
+ *  startup; the registry locks after the first overlay so a malicious
+ *  server can't rewrite the registry mid-session (e.g. via a tool
+ *  message that smuggles in a profile-update frame). */
+export function overlayRemoteProfiles(remote) {
+    if (registryLocked)
+        return;
+    for (const p of remote) {
+        if (!p?.slug)
+            continue;
+        // Shallow merge so remote can override any field while keeping the
+        // local baseline as a fallback for anything they omit.
+        const local = REGISTRY.get(p.slug.toLowerCase());
+        const merged = {
+            ...(local ?? p),
+            ...p,
+            slug: p.slug.toLowerCase(),
+        };
+        REGISTRY.set(merged.slug, merged);
+    }
+    registryLocked = true;
+}
+/** Convenience: profile slug → label, for compact log lines. */
+export function profileLabel(slug) {
+    return getProfile(slug)?.label ?? "General";
+}
+export { DEFAULT_PROFILE_SLUG };
+//# sourceMappingURL=index.js.map

package/dist/profiles/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/profiles/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,oEAAoE;AACpE,uEAAuE;AACvE,qEAAqE;AACrE,qDAAqD;AAGrD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;AAClD,KAAK,MAAM,CAAC,IAAI,aAAa;IAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAEvD,IAAI,cAAc,GAAG,KAAK,CAAC;AAE3B,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CAAC,IAA+B;IACxD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;AAClD,CAAC;AAED;+CAC+C;AAC/C,MAAM,UAAU,mBAAmB,CAAC,IAA+B;IACjE,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,oBAAoB,CAAE,CAAC;AACjE,CAAC;AAED;mBACmB;AACnB,MAAM,UAAU,YAAY;IAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;;wDAIwD;AACxD,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IAC3D,IAAI,cAAc;QAAE,OAAO;IAC3B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,EAAE,IAAI;YAAE,SAAS;QACvB,mEAAmE;QACnE,uDAAuD;QACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACjD,MAAM,MAAM,GAAkB;YAC5B,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;YACf,GAAG,CAAC;YACJ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE;SAC3B,CAAC;QACF,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,IAA+B;IAC1D,OAAO,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,SAAS,CAAC;AAC9C,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/profiles/seeds.d.ts

@@ -0,0 +1,4 @@
+import type { TheronProfile } from "./types.js";
+export declare const SEED_PROFILES: TheronProfile[];
+/** Default profile slug used when the user hasn't picked one. */
+export declare const DEFAULT_PROFILE_SLUG = "code";