npm - santree - Versions diffs - 0.5.3 → 0.5.5 - Mend

santree 0.5.3 → 0.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (80) hide show

package/README.md +156 -46
package/dist/commands/dashboard.d.ts +1 -1
package/dist/commands/dashboard.js +22 -18
package/dist/commands/doctor.js +97 -76
package/dist/commands/github/auth.d.ts +2 -0
package/dist/commands/github/auth.js +56 -0
package/dist/commands/github/index.d.ts +1 -0
package/dist/commands/github/index.js +1 -0
package/dist/commands/helpers/english-tutor/index.d.ts +1 -0
package/dist/commands/helpers/english-tutor/index.js +1 -0
package/dist/commands/helpers/english-tutor/install.d.ts +8 -0
package/dist/commands/helpers/english-tutor/install.js +24 -0
package/dist/commands/helpers/english-tutor/prompt.d.ts +2 -0
package/dist/commands/helpers/english-tutor/prompt.js +16 -0
package/dist/commands/helpers/english-tutor/session-start.d.ts +2 -0
package/dist/commands/helpers/english-tutor/session-start.js +34 -0
package/dist/commands/helpers/english-tutor/uninstall.d.ts +2 -0
package/dist/commands/helpers/english-tutor/uninstall.js +15 -0
package/dist/commands/helpers/template.d.ts +1 -0
package/dist/commands/helpers/template.js +13 -10
package/dist/commands/issue/index.d.ts +1 -0
package/dist/commands/issue/index.js +1 -0
package/dist/commands/issue/open.d.ts +2 -0
package/dist/commands/{linear → issue}/open.js +13 -11
package/dist/commands/issue/switch.d.ts +11 -0
package/dist/commands/issue/switch.js +38 -0
package/dist/commands/linear/auth.js +23 -10
package/dist/commands/linear/switch.js +7 -3
package/dist/commands/pr/create.js +7 -5
package/dist/commands/worktree/create.js +4 -6
package/dist/commands/worktree/work.js +1 -1
package/dist/lib/ai.d.ts +8 -6
package/dist/lib/ai.js +29 -15
package/dist/lib/dashboard/DetailPanel.d.ts +5 -2
package/dist/lib/dashboard/DetailPanel.js +6 -3
package/dist/lib/dashboard/data.js +17 -9
package/dist/lib/dashboard/types.d.ts +3 -16
package/dist/lib/english-tutor.d.ts +13 -0
package/dist/lib/english-tutor.js +125 -0
package/dist/lib/git.d.ts +16 -33
package/dist/lib/git.js +20 -74
package/dist/lib/metadata.d.ts +3 -0
package/dist/lib/metadata.js +27 -0
package/dist/lib/multiplexer/cmux.js +1 -1
package/dist/lib/multiplexer/index.js +5 -12
package/dist/lib/multiplexer/types.d.ts +1 -1
package/dist/lib/prompts.d.ts +4 -3
package/dist/lib/prompts.js +4 -3
package/dist/lib/session-signal.d.ts +2 -3
package/dist/lib/session-signal.js +3 -29
package/dist/lib/trackers/auth-store.d.ts +16 -0
package/dist/lib/trackers/auth-store.js +57 -0
package/dist/lib/trackers/config.d.ts +8 -0
package/dist/lib/trackers/config.js +21 -0
package/dist/lib/trackers/github/api.d.ts +3 -0
package/dist/lib/trackers/github/api.js +90 -0
package/dist/lib/trackers/github/auth.d.ts +5 -0
package/dist/lib/trackers/github/auth.js +27 -0
package/dist/lib/trackers/github/images.d.ts +2 -0
package/dist/lib/trackers/github/images.js +42 -0
package/dist/lib/trackers/github/index.d.ts +2 -0
package/dist/lib/trackers/github/index.js +78 -0
package/dist/lib/trackers/index.d.ts +12 -0
package/dist/lib/trackers/index.js +34 -0
package/dist/lib/trackers/linear/api.d.ts +4 -0
package/dist/lib/trackers/linear/api.js +128 -0
package/dist/lib/trackers/linear/auth.d.ts +11 -0
package/dist/lib/trackers/linear/auth.js +206 -0
package/dist/lib/trackers/linear/images.d.ts +2 -0
package/dist/lib/trackers/linear/images.js +44 -0
package/dist/lib/trackers/linear/index.d.ts +3 -0
package/dist/lib/trackers/linear/index.js +100 -0
package/dist/lib/trackers/types.d.ts +52 -0
package/dist/lib/trackers/types.js +1 -0
package/package.json +1 -1
package/prompts/english-tutor-prompt.njk +15 -0
package/prompts/ticket.njk +3 -3
package/dist/commands/linear/open.d.ts +0 -2
package/dist/lib/linear.d.ts +0 -83
package/dist/lib/linear.js +0 -482

package/dist/lib/linear.js DELETED Viewed

@@ -1,482 +0,0 @@
-import * as http from "http";
-import * as crypto from "crypto";
-import * as fs from "fs";
-import * as path from "path";
-import * as os from "os";
-import { exec } from "child_process";
-import { getRepoLinearOrg } from "./git.js";
-// ── Constants ──────────────────────────────────────────────────────────
-const CLIENT_ID = "4be2738749371d7d3401061aabe2d11b";
-const LINEAR_AUTHORIZE_URL = "https://linear.app/oauth/authorize";
-const LINEAR_TOKEN_URL = "https://api.linear.app/oauth/token";
-const LINEAR_REVOKE_URL = "https://api.linear.app/oauth/revoke";
-const LINEAR_GRAPHQL_URL = "https://api.linear.app/graphql";
-const OAUTH_PORT = 8420;
-const REDIRECT_URI = `http://localhost:${OAUTH_PORT}`;
-const CONFIG_DIR = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config");
-const AUTH_FILE_PATH = path.join(CONFIG_DIR, "santree", "auth.json");
-// ── Auth Store ─────────────────────────────────────────────────────────
-export function readAuthStore() {
-    if (!fs.existsSync(AUTH_FILE_PATH))
-        return {};
-    try {
-        return JSON.parse(fs.readFileSync(AUTH_FILE_PATH, "utf-8"));
-    }
-    catch {
-        return {};
-    }
-}
-function writeAuthStore(store) {
-    const dir = path.dirname(AUTH_FILE_PATH);
-    if (!fs.existsSync(dir)) {
-        fs.mkdirSync(dir, { recursive: true });
-    }
-    fs.writeFileSync(AUTH_FILE_PATH, JSON.stringify(store, null, 2) + "\n", {
-        mode: 0o600,
-    });
-}
-// ── PKCE Helpers ───────────────────────────────────────────────────────
-function generateCodeVerifier() {
-    return crypto.randomBytes(32).toString("base64url");
-}
-function generateCodeChallenge(verifier) {
-    return crypto.createHash("sha256").update(verifier).digest("base64url");
-}
-// ── OAuth Flow ─────────────────────────────────────────────────────────
-/**
- * Run the full OAuth PKCE flow:
- * 1. Start a temp HTTP server on an ephemeral port
- * 2. Open browser to Linear authorize URL
- * 3. Wait for callback with auth code
- * 4. Exchange code for tokens
- * 5. Fetch org info
- * 6. Store tokens
- * Returns the org slug on success, null on failure.
- */
-export async function startOAuthFlow() {
-    const codeVerifier = generateCodeVerifier();
-    const codeChallenge = generateCodeChallenge(codeVerifier);
-    const state = crypto.randomBytes(16).toString("hex");
-    return new Promise((resolve) => {
-        let handled = false;
-        const server = http.createServer(async (req, res) => {
-            const url = new URL(req.url, `http://localhost`);
-            const code = url.searchParams.get("code");
-            const returnedState = url.searchParams.get("state");
-            if (!code || returnedState !== state) {
-                // Ignore spurious requests (favicon, etc.)
-                res.writeHead(404);
-                res.end();
-                return;
-            }
-            if (handled) {
-                res.writeHead(200);
-                res.end();
-                return;
-            }
-            handled = true;
-            // Send success page immediately
-            res.writeHead(200, { "Content-Type": "text/html" });
-            res.end("<html><body><h2>Authentication successful!</h2><p>You can close this tab.</p></body></html>");
-            try {
-                // Exchange code for tokens
-                const tokens = await exchangeCode(code, REDIRECT_URI, codeVerifier);
-                // Fetch org info
-                const orgInfo = await fetchViewerOrg(tokens.access_token);
-                if (!orgInfo) {
-                    server.close();
-                    resolve(null);
-                    return;
-                }
-                // Store tokens
-                const store = readAuthStore();
-                store[orgInfo.urlKey] = {
-                    access_token: tokens.access_token,
-                    refresh_token: tokens.refresh_token,
-                    expires_at: tokens.expires_at,
-                    org_name: orgInfo.name,
-                };
-                writeAuthStore(store);
-                server.close();
-                resolve({ orgSlug: orgInfo.urlKey, orgName: orgInfo.name });
-            }
-            catch {
-                server.close();
-                resolve(null);
-            }
-        });
-        server.listen(OAUTH_PORT, () => {
-            const params = new URLSearchParams({
-                client_id: CLIENT_ID,
-                redirect_uri: REDIRECT_URI,
-                response_type: "code",
-                scope: "read",
-                state,
-                code_challenge: codeChallenge,
-                code_challenge_method: "S256",
-            });
-            const authUrl = `${LINEAR_AUTHORIZE_URL}?${params.toString()}`;
-            // Try to open browser, fall back to printing URL
-            const openCmd = process.platform === "darwin"
-                ? "open"
-                : process.platform === "win32"
-                    ? "start"
-                    : "xdg-open";
-            exec(`${openCmd} "${authUrl}"`, (err) => {
-                if (err) {
-                    console.error(`\nCouldn't open browser automatically. Open this URL manually:\n${authUrl}\n`);
-                }
-            });
-        });
-        // Timeout after 2 minutes
-        setTimeout(() => {
-            server.close();
-            resolve(null);
-        }, 120_000);
-    });
-}
-async function exchangeCode(code, redirectUri, codeVerifier) {
-    const res = await fetch(LINEAR_TOKEN_URL, {
-        method: "POST",
-        headers: { "Content-Type": "application/x-www-form-urlencoded" },
-        body: new URLSearchParams({
-            grant_type: "authorization_code",
-            client_id: CLIENT_ID,
-            code,
-            redirect_uri: redirectUri,
-            code_verifier: codeVerifier,
-        }),
-    });
-    if (!res.ok) {
-        throw new Error(`Token exchange failed: ${res.status}`);
-    }
-    const data = (await res.json());
-    return {
-        access_token: data.access_token,
-        refresh_token: data.refresh_token,
-        expires_at: Date.now() + data.expires_in * 1000,
-    };
-}
-async function fetchViewerOrg(accessToken) {
-    const result = await graphqlQuery(`query { viewer { organization { urlKey name } } }`, {}, accessToken);
-    if (!result?.viewer?.organization)
-        return null;
-    return result.viewer.organization;
-}
-// ── Token Management ───────────────────────────────────────────────────
-function isTokenExpired(tokens) {
-    // 5-minute buffer
-    return Date.now() >= tokens.expires_at - 5 * 60 * 1000;
-}
-async function refreshTokens(orgSlug, tokens) {
-    try {
-        const res = await fetch(LINEAR_TOKEN_URL, {
-            method: "POST",
-            headers: { "Content-Type": "application/x-www-form-urlencoded" },
-            body: new URLSearchParams({
-                grant_type: "refresh_token",
-                client_id: CLIENT_ID,
-                refresh_token: tokens.refresh_token,
-            }),
-        });
-        if (!res.ok)
-            return null;
-        const data = (await res.json());
-        const updated = {
-            access_token: data.access_token,
-            refresh_token: data.refresh_token,
-            expires_at: Date.now() + data.expires_in * 1000,
-            org_name: tokens.org_name,
-        };
-        // Persist refreshed tokens
-        const store = readAuthStore();
-        store[orgSlug] = updated;
-        writeAuthStore(store);
-        return updated;
-    }
-    catch {
-        return null;
-    }
-}
-export async function revokeTokens(orgSlug) {
-    const store = readAuthStore();
-    const tokens = store[orgSlug];
-    if (!tokens)
-        return false;
-    try {
-        await fetch(LINEAR_REVOKE_URL, {
-            method: "POST",
-            headers: { "Content-Type": "application/x-www-form-urlencoded" },
-            body: new URLSearchParams({
-                client_id: CLIENT_ID,
-                token: tokens.access_token,
-            }),
-        });
-    }
-    catch {
-        // Best effort revocation
-    }
-    delete store[orgSlug];
-    writeAuthStore(store);
-    return true;
-}
-/**
- * Get valid tokens for an org, auto-refreshing if expired.
- * Returns null if no tokens found or refresh fails.
- */
-export async function getValidTokens(orgSlug) {
-    const store = readAuthStore();
-    const tokens = store[orgSlug];
-    if (!tokens)
-        return null;
-    if (isTokenExpired(tokens)) {
-        return refreshTokens(orgSlug, tokens);
-    }
-    return tokens;
-}
-// ── GraphQL ────────────────────────────────────────────────────────────
-async function graphqlQuery(query, variables, accessToken) {
-    const res = await fetch(LINEAR_GRAPHQL_URL, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/json",
-            Authorization: `Bearer ${accessToken}`,
-        },
-        body: JSON.stringify({ query, variables }),
-    });
-    if (!res.ok)
-        return null;
-    const json = (await res.json());
-    if (json.errors) {
-        console.error("Linear GraphQL errors:", JSON.stringify(json.errors, null, 2));
-    }
-    return json.data ?? null;
-}
-const ISSUE_QUERY = `
-query GetIssue($id: String!) {
-  issue(id: $id) {
-    identifier
-    title
-    description
-    url
-    state { name }
-    priority
-    labels { nodes { name } }
-    comments {
-      nodes {
-        body
-        createdAt
-        parent { id }
-        user { displayName }
-        children {
-          nodes {
-            body
-            createdAt
-            user { displayName }
-          }
-        }
-      }
-    }
-  }
-}
-`;
-const PRIORITY_MAP = {
-    0: "No priority",
-    1: "Urgent",
-    2: "High",
-    3: "Medium",
-    4: "Low",
-};
-async function fetchIssue(ticketId, accessToken) {
-    const data = await graphqlQuery(ISSUE_QUERY, { id: ticketId }, accessToken);
-    if (!data?.issue)
-        return null;
-    const issue = data.issue;
-    return {
-        identifier: issue.identifier,
-        title: issue.title,
-        description: issue.description ?? null,
-        status: issue.state?.name ?? null,
-        priority: PRIORITY_MAP[issue.priority] ?? null,
-        labels: (issue.labels?.nodes ?? []).map((l) => l.name),
-        url: issue.url,
-        comments: (issue.comments?.nodes ?? [])
-            .filter((c) => !c.parent)
-            .sort((a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime())
-            .map((c) => ({
-            author: c.user?.displayName ?? "Unknown",
-            body: c.body,
-            createdAt: c.createdAt,
-            children: (c.children?.nodes ?? [])
-                .sort((a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime())
-                .map((r) => ({
-                author: r.user?.displayName ?? "Unknown",
-                body: r.body,
-                createdAt: r.createdAt,
-                children: [],
-            })),
-        })),
-    };
-}
-// ── Image Handling ─────────────────────────────────────────────────────
-function getTempImageDir(ticketId) {
-    return path.join(os.tmpdir(), `santree-images-${ticketId}`);
-}
-async function downloadImages(markdown, ticketId, accessToken) {
-    const imageRegex = /!\[([^\]]*)\]\((https:\/\/uploads\.linear\.app[^)]+)\)/g;
-    const matches = [...markdown.matchAll(imageRegex)];
-    if (matches.length === 0)
-        return markdown;
-    const tempDir = getTempImageDir(ticketId);
-    if (!fs.existsSync(tempDir)) {
-        fs.mkdirSync(tempDir, { recursive: true });
-    }
-    let result = markdown;
-    for (let i = 0; i < matches.length; i++) {
-        const match = matches[i];
-        const [fullMatch, altText, url] = match;
-        try {
-            const res = await fetch(url, {
-                headers: { Authorization: `Bearer ${accessToken}` },
-            });
-            if (!res.ok)
-                continue;
-            const buffer = Buffer.from(await res.arrayBuffer());
-            const ext = path.extname(new URL(url).pathname) || ".png";
-            const filename = `image-${i}${ext}`;
-            const filePath = path.join(tempDir, filename);
-            fs.writeFileSync(filePath, buffer);
-            result = result.replace(fullMatch, `![${altText}](${filePath})`);
-        }
-        catch {
-            // Keep original URL on failure
-        }
-    }
-    return result;
-}
-export function cleanupImages(ticketId) {
-    const tempDir = getTempImageDir(ticketId);
-    if (fs.existsSync(tempDir)) {
-        fs.rmSync(tempDir, { recursive: true, force: true });
-    }
-}
-/**
- * Get auth status for the current repo's Linear org (or any stored org).
- */
-export function getAuthStatus(repoRoot) {
-    const store = readAuthStore();
-    const orgs = Object.keys(store);
-    if (orgs.length === 0) {
-        return { authenticated: false };
-    }
-    // Check repo-specific org first
-    if (repoRoot) {
-        const repoOrg = getRepoLinearOrg(repoRoot);
-        if (repoOrg && store[repoOrg]) {
-            const tokens = store[repoOrg];
-            return {
-                authenticated: true,
-                orgSlug: repoOrg,
-                orgName: tokens.org_name,
-                expiresAt: tokens.expires_at,
-                repoLinked: true,
-            };
-        }
-    }
-    // Fall back to first stored org
-    const orgSlug = orgs[0];
-    const tokens = store[orgSlug];
-    return {
-        authenticated: true,
-        orgSlug,
-        orgName: tokens.org_name,
-        expiresAt: tokens.expires_at,
-        repoLinked: false,
-    };
-}
-// ── Assigned Issues Query ──────────────────────────────────────────────
-const ASSIGNED_ISSUES_QUERY = `
-query AssignedIssues {
-  viewer {
-    assignedIssues(
-      filter: { state: { type: { nin: ["completed", "canceled"] } } }
-      orderBy: updatedAt
-      first: 100
-    ) {
-      nodes {
-        identifier
-        title
-        description
-        url
-        priority
-        state { name type }
-        labels { nodes { name } }
-        project { id name }
-      }
-    }
-  }
-}
-`;
-/**
- * Fetch all active issues assigned to the current user.
- * Returns null if not authenticated or fetch fails.
- */
-export async function fetchAssignedIssues(repoRoot) {
-    const orgSlug = getRepoLinearOrg(repoRoot);
-    if (!orgSlug)
-        return null;
-    const tokens = await getValidTokens(orgSlug);
-    if (!tokens)
-        return null;
-    const data = await graphqlQuery(ASSIGNED_ISSUES_QUERY, {}, tokens.access_token);
-    if (!data?.viewer?.assignedIssues?.nodes)
-        return null;
-    return data.viewer.assignedIssues.nodes.map((issue) => ({
-        identifier: issue.identifier,
-        title: issue.title,
-        description: issue.description ?? null,
-        url: issue.url,
-        priority: issue.priority,
-        priorityLabel: PRIORITY_MAP[issue.priority] ?? "No priority",
-        state: {
-            name: issue.state?.name ?? "Unknown",
-            type: issue.state?.type ?? "unstarted",
-        },
-        labels: (issue.labels?.nodes ?? []).map((l) => l.name),
-        projectId: issue.project?.id ?? null,
-        projectName: issue.project?.name ?? null,
-    }));
-}
-// ── High-Level Entry Point ─────────────────────────────────────────────
-/**
- * Fetch full ticket content for a given ticket ID.
- * Looks up the repo's Linear org, gets valid tokens, fetches issue, downloads images.
- * Returns null if not authenticated or fetch fails.
- */
-export async function getTicketContent(ticketId, repoRoot) {
-    const orgSlug = getRepoLinearOrg(repoRoot);
-    if (!orgSlug)
-        return null;
-    const tokens = await getValidTokens(orgSlug);
-    if (!tokens)
-        return null;
-    const issue = await fetchIssue(ticketId, tokens.access_token);
-    if (!issue)
-        return null;
-    // Download images from description
-    if (issue.description) {
-        issue.description = await downloadImages(issue.description, ticketId, tokens.access_token);
-    }
-    // Download images from comments and replies
-    for (const comment of issue.comments) {
-        if (comment.body) {
-            comment.body = await downloadImages(comment.body, ticketId, tokens.access_token);
-        }
-        for (const child of comment.children) {
-            if (child.body) {
-                child.body = await downloadImages(child.body, ticketId, tokens.access_token);
-            }
-        }
-    }
-    return issue;
-}