santree 0.5.3 → 0.5.5

package/dist/lib/english-tutor.js

@@ -0,0 +1,125 @@
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+const MARKER = "english-tutor";
+export function getLogPath() {
+    const configDir = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config");
+    return path.join(configDir, "santree", "english-practice-log.md");
+}
+export function getHooksJson() {
+    const base = "santree helpers english-tutor";
+    // Synchronous hooks: Claude Code waits for completion and injects stdout into
+    // the model's context. `async: true` would fire-and-forget — stdout is
+    // discarded, so the instruction would never reach Claude. session-signal can
+    // use `async: true` because it only writes a state file; we cannot.
+    const opts = { timeout: 10 };
+    return {
+        UserPromptSubmit: [{ hooks: [{ type: "command", command: `${base} prompt`, ...opts }] }],
+        // No matcher: fires on all SessionStart sub-events (startup, resume,
+        // clear, compact). Restricting to "startup" silently skips resumed
+        // sessions, which is the common case when picking up yesterday's work.
+        SessionStart: [{ hooks: [{ type: "command", command: `${base} session-start`, ...opts }] }],
+    };
+}
+export function getPermissionEntry() {
+    return `Edit(${getLogPath()})`;
+}
+function readSettings(settingsPath) {
+    try {
+        if (fs.existsSync(settingsPath)) {
+            return JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+        }
+    }
+    catch {
+        // fall through
+    }
+    return {};
+}
+function writeSettings(settingsPath, settings) {
+    const dir = path.dirname(settingsPath);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+}
+function settingsPath() {
+    const home = process.env.HOME || os.homedir();
+    return path.join(home, ".claude", "settings.json");
+}
+function stripEnglishTutorHooks(existingHooks) {
+    const cleaned = {};
+    for (const [event, entries] of Object.entries(existingHooks)) {
+        if (!Array.isArray(entries)) {
+            cleaned[event] = entries;
+            continue;
+        }
+        const filtered = entries.filter((entry) => {
+            const inner = entry.hooks || [];
+            return !inner.some((h) => typeof h.command === "string" && h.command.includes(MARKER));
+        });
+        if (filtered.length > 0)
+            cleaned[event] = filtered;
+    }
+    return cleaned;
+}
+/**
+ * Create the practice log if it doesn't already exist. Empty log = Claude's
+ * Edit tool fails on first use (Edit can't operate on missing files), and
+ * appending corrections silently fails. Bootstrapping with a stub header
+ * means the very first correction succeeds.
+ */
+function ensureLogExists() {
+    const logPath = getLogPath();
+    if (fs.existsSync(logPath))
+        return logPath;
+    fs.mkdirSync(path.dirname(logPath), { recursive: true });
+    const stub = "# English Practice Log\n\n" +
+        "Tracks grammar/spelling mistakes spotted during Claude Code sessions.\n" +
+        "Generated and appended to by santree's english-tutor hook.\n";
+    fs.writeFileSync(logPath, stub);
+    return logPath;
+}
+export function installHooks() {
+    const settingsFile = settingsPath();
+    const settings = readSettings(settingsFile);
+    const existing = stripEnglishTutorHooks(settings.hooks || {});
+    const required = getHooksJson();
+    for (const [event, hookEntries] of Object.entries(required)) {
+        const current = existing[event];
+        existing[event] = Array.isArray(current)
+            ? [...current, ...hookEntries]
+            : hookEntries;
+    }
+    settings.hooks = existing;
+    const permissions = settings.permissions || {};
+    const allow = Array.isArray(permissions.allow) ? permissions.allow : [];
+    const entry = getPermissionEntry();
+    if (!allow.includes(entry))
+        allow.push(entry);
+    permissions.allow = allow;
+    settings.permissions = permissions;
+    writeSettings(settingsFile, settings);
+    const logPath = ensureLogExists();
+    return { settingsPath: settingsFile, logPath };
+}
+/**
+ * Remove hooks and permission entry. Intentionally does NOT delete the log
+ * file — that's the user's accumulated practice history.
+ */
+export function uninstallHooks() {
+    const settingsFile = settingsPath();
+    const settings = readSettings(settingsFile);
+    if (settings.hooks) {
+        settings.hooks = stripEnglishTutorHooks(settings.hooks);
+    }
+    if (settings.permissions && Array.isArray(settings.permissions.allow)) {
+        const entry = getPermissionEntry();
+        settings.permissions.allow = settings.permissions.allow.filter((e) => e !== entry);
+    }
+    writeSettings(settingsFile, settings);
+    return settingsFile;
+}
+export function getInstallSnippet() {
+    return {
+        hooks: getHooksJson(),
+        permissions: { allow: [getPermissionEntry()] },
+    };
+}

package/dist/lib/git.d.ts

@@ -1,3 +1,4 @@
+export { getSantreeDir, readAllMetadata, writeAllMetadata } from "./metadata.js";
 export interface SessionState {
     state: "waiting" | "idle" | "active" | "exited";
     message: string | null;
@@ -53,10 +54,6 @@ export declare function getDefaultBranch(): string;
  * Returns an empty array on failure.
  */
 export declare function listWorktrees(): Worktree[];
-/**
- * Get the path to the .santree directory inside a repo root.
- */
-export declare function getSantreeDir(repoRoot: string): string;
 /**
  * Get the path to the .santree/worktrees directory inside a repo root.
  */
@@ -82,9 +79,14 @@ export declare function removeWorktree(branchName: string, repoRoot: string, for
     error?: string;
 }>;
 /**
- * Extract a ticket ID (e.g. "TEAM-123") from a branch name.
- * Matches the first occurrence of LETTERS-DIGITS in the string.
- * Returns null if no ticket ID pattern is found.
+ * Extract an issue identifier from a branch name. Delegates to the active
+ * issue tracker (Linear: `[A-Z]+-\d+`; GitHub: explicit-prefix numeric),
+ * resolving the tracker from the main repo's config.
+ *
+ * This is the single shim that frees every caller from having to know which
+ * tracker is active or how it formats IDs. Returns null when the active
+ * tracker doesn't recognize the branch's ID shape, or when no main repo can
+ * be resolved (e.g. before a worktree is created).
  */
 export declare function extractTicketId(branch: string): string | null;
 /**
@@ -93,30 +95,6 @@ export declare function extractTicketId(branch: string): string | null;
  * Returns null if no worktree is checked out on that branch.
  */
 export declare function getWorktreePath(branchName: string): string | null;
-/**
- * Read all entries from .santree/metadata.json.
- * Returns an empty object if the file doesn't exist or can't be parsed.
- */
-export declare function readAllMetadata(repoRoot: string): Record<string, any>;
-/**
- * Write all entries to .santree/metadata.json.
- */
-export declare function writeAllMetadata(repoRoot: string, data: Record<string, any>): void;
-/**
- * Get the Linear org slug associated with this repo.
- * Stored as `_linear.org` in .santree/metadata.json.
- */
-export declare function getRepoLinearOrg(repoRoot: string): string | null;
-/**
- * Associate a Linear org slug with this repo.
- * Stored as `_linear.org` in .santree/metadata.json.
- */
-export declare function setRepoLinearOrg(repoRoot: string, orgSlug: string): void;
-/**
- * Remove the Linear org association from this repo.
- * Deletes the `_linear` key from .santree/metadata.json.
- */
-export declare function removeRepoLinearOrg(repoRoot: string): void;
 /**
  * Get the stored session ID for a given ticket from .santree/metadata.json.
  * Returns null if no session ID is stored.
@@ -191,8 +169,13 @@ export declare function getCommitsAhead(baseBranch: string): number;
  */
 export declare function getCommitsAheadAsync(cwd: string, baseBranch: string): Promise<number>;
 /**
- * Read the SANTREE_DIFF_TOOL env var, returning the configured pager command
- * (e.g. "delta", "diff-so-fancy") or null if unset/invalid.
+ * Read the SANTREE_DIFF_TOOL env var, returning the configured diff pager
+ * command (e.g. "delta", "diff-so-fancy") or null if unset/invalid.
+ *
+ * The CLI `worktree diff` flow lets the pager do its full job (render +
+ * scroll) via git's `core.pager`. The dashboard's `[v]` overlay only uses
+ * the rendering half — it captures the pager's stdout as a string and
+ * handles scrolling itself in Ink.
  *
  * The value is restricted to a safe shell-token character set since it ends
  * up in arguments passed to spawn() — even though we never use shell:true,

package/dist/lib/git.js

@@ -4,6 +4,9 @@ import * as path from "path";
 import * as fs from "fs";
 import { run, runAsync, spawnAsync } from "./exec.js";
 import { getMultiplexer } from "./multiplexer/index.js";
+import { getSantreeDir, readAllMetadata, writeAllMetadata } from "./metadata.js";
+import { getIssueTracker } from "./trackers/index.js";
+export { getSantreeDir, readAllMetadata, writeAllMetadata } from "./metadata.js";
 const execAsync = promisify(exec);
 /**
  * Find the toplevel directory of the current git repository.
@@ -114,12 +117,6 @@ export function listWorktrees() {
     }
     return worktrees;
 }
-/**
- * Get the path to the .santree directory inside a repo root.
- */
-export function getSantreeDir(repoRoot) {
-    return path.join(repoRoot, ".santree");
-}
 /**
  * Get the path to the .santree/worktrees directory inside a repo root.
  */
@@ -247,16 +244,18 @@ export async function removeWorktree(branchName, repoRoot, force = false) {
     }
 }
 /**
- * Extract a ticket ID (e.g. "TEAM-123") from a branch name.
- * Matches the first occurrence of LETTERS-DIGITS in the string.
- * Returns null if no ticket ID pattern is found.
+ * Extract an issue identifier from a branch name. Delegates to the active
+ * issue tracker (Linear: `[A-Z]+-\d+`; GitHub: explicit-prefix numeric),
+ * resolving the tracker from the main repo's config.
+ *
+ * This is the single shim that frees every caller from having to know which
+ * tracker is active or how it formats IDs. Returns null when the active
+ * tracker doesn't recognize the branch's ID shape, or when no main repo can
+ * be resolved (e.g. before a worktree is created).
  */
 export function extractTicketId(branch) {
-    const match = branch.match(/([a-zA-Z]+)-(\d+)/);
-    if (match) {
-        return `${match[1].toUpperCase()}-${match[2]}`;
-    }
-    return null;
+    const repoRoot = findMainRepoRoot();
+    return getIssueTracker(repoRoot).extractIdFromBranch(branch);
 }
 /**
  * Get the filesystem path for a worktree by its branch name.
@@ -278,64 +277,6 @@ export function getWorktreePath(branchName) {
     }
     return null;
 }
-/**
- * Get path to centralized metadata file: .santree/metadata.json in the repo root.
- */
-function getMetadataFilePath(repoRoot) {
-    return path.join(getSantreeDir(repoRoot), "metadata.json");
-}
-/**
- * Read all entries from .santree/metadata.json.
- * Returns an empty object if the file doesn't exist or can't be parsed.
- */
-export function readAllMetadata(repoRoot) {
-    const filePath = getMetadataFilePath(repoRoot);
-    if (!fs.existsSync(filePath))
-        return {};
-    try {
-        return JSON.parse(fs.readFileSync(filePath, "utf-8"));
-    }
-    catch {
-        return {};
-    }
-}
-/**
- * Write all entries to .santree/metadata.json.
- */
-export function writeAllMetadata(repoRoot, data) {
-    const filePath = getMetadataFilePath(repoRoot);
-    const dir = path.dirname(filePath);
-    if (!fs.existsSync(dir)) {
-        fs.mkdirSync(dir, { recursive: true });
-    }
-    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n");
-}
-/**
- * Get the Linear org slug associated with this repo.
- * Stored as `_linear.org` in .santree/metadata.json.
- */
-export function getRepoLinearOrg(repoRoot) {
-    const all = readAllMetadata(repoRoot);
-    return all._linear?.org ?? null;
-}
-/**
- * Associate a Linear org slug with this repo.
- * Stored as `_linear.org` in .santree/metadata.json.
- */
-export function setRepoLinearOrg(repoRoot, orgSlug) {
-    const all = readAllMetadata(repoRoot);
-    all._linear = { org: orgSlug };
-    writeAllMetadata(repoRoot, all);
-}
-/**
- * Remove the Linear org association from this repo.
- * Deletes the `_linear` key from .santree/metadata.json.
- */
-export function removeRepoLinearOrg(repoRoot) {
-    const all = readAllMetadata(repoRoot);
-    delete all._linear;
-    writeAllMetadata(repoRoot, all);
-}
 /**
  * Get the stored session ID for a given ticket from .santree/metadata.json.
  * Returns null if no session ID is stored.
@@ -469,8 +410,13 @@ export async function getCommitsAheadAsync(cwd, baseBranch) {
     return output ? parseInt(output, 10) || 0 : 0;
 }
 /**
- * Read the SANTREE_DIFF_TOOL env var, returning the configured pager command
- * (e.g. "delta", "diff-so-fancy") or null if unset/invalid.
+ * Read the SANTREE_DIFF_TOOL env var, returning the configured diff pager
+ * command (e.g. "delta", "diff-so-fancy") or null if unset/invalid.
+ *
+ * The CLI `worktree diff` flow lets the pager do its full job (render +
+ * scroll) via git's `core.pager`. The dashboard's `[v]` overlay only uses
+ * the rendering half — it captures the pager's stdout as a string and
+ * handles scrolling itself in Ink.
  *
  * The value is restricted to a safe shell-token character set since it ends
  * up in arguments passed to spawn() — even though we never use shell:true,

package/dist/lib/metadata.d.ts

@@ -0,0 +1,3 @@
+export declare function getSantreeDir(repoRoot: string): string;
+export declare function readAllMetadata(repoRoot: string): Record<string, any>;
+export declare function writeAllMetadata(repoRoot: string, data: Record<string, any>): void;

package/dist/lib/metadata.js

@@ -0,0 +1,27 @@
+import * as fs from "fs";
+import * as path from "path";
+export function getSantreeDir(repoRoot) {
+    return path.join(repoRoot, ".santree");
+}
+function getMetadataFilePath(repoRoot) {
+    return path.join(getSantreeDir(repoRoot), "metadata.json");
+}
+export function readAllMetadata(repoRoot) {
+    const filePath = getMetadataFilePath(repoRoot);
+    if (!fs.existsSync(filePath))
+        return {};
+    try {
+        return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+export function writeAllMetadata(repoRoot, data) {
+    const filePath = getMetadataFilePath(repoRoot);
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n");
+}

package/dist/lib/multiplexer/cmux.js

@@ -77,7 +77,7 @@ export const cmuxMultiplexer = {
         // follow-up sends to an existing workspace, which doesn't.
         return {
             ok: false,
-            reason: "unsupported",
+            reason: "failed",
             message: "blocked by manaflow-ai/cmux#1472",
         };
     },

package/dist/lib/multiplexer/index.js

@@ -1,19 +1,12 @@
 import { cmuxMultiplexer } from "./cmux.js";
 import { noneMultiplexer } from "./none.js";
 import { tmuxMultiplexer } from "./tmux.js";
+// Each adapter declares its own runtime detection in `isActive()`. Order matters:
+// if more than one adapter reports active (e.g. tmux running inside a cmux
+// workspace), the first match wins.
+const CANDIDATES = [tmuxMultiplexer, cmuxMultiplexer];
 export function getMultiplexer() {
-    const explicit = process.env["SANTREE_MULTIPLEXER"]?.toLowerCase();
-    if (explicit === "tmux")
-        return tmuxMultiplexer;
-    if (explicit === "cmux")
-        return cmuxMultiplexer;
-    if (explicit === "none")
-        return noneMultiplexer;
-    if (process.env["TMUX"])
-        return tmuxMultiplexer;
-    if (process.env["CMUX_SURFACE_ID"])
-        return cmuxMultiplexer;
-    return noneMultiplexer;
+    return CANDIDATES.find((m) => m.isActive()) ?? noneMultiplexer;
 }
 export function getMultiplexerKind() {
     return getMultiplexer().kind;

package/dist/lib/multiplexer/types.d.ts

@@ -3,7 +3,7 @@ export type SessionResult = {
     ok: true;
 } | {
     ok: false;
-    reason: "not-active" | "unsupported" | "failed";
+    reason: "not-active" | "failed";
     message?: string;
 };
 export interface CreateWindowOpts {

package/dist/lib/prompts.d.ts

@@ -1,4 +1,4 @@
-import type { LinearIssue } from "./linear.js";
+import type { Issue } from "./trackers/types.js";
 import type { PRCheck, PRReview, PRReviewComment, FailedCheckDetail, PRConversationComment } from "./github.js";
 /**
  * Render a nunjucks template from the prompts/ directory.
@@ -7,9 +7,10 @@ import type { PRCheck, PRReview, PRReviewComment, FailedCheckDetail, PRConversat
  */
 export declare function renderPrompt(template: string, context: Record<string, string | undefined>): string;
 /**
- * Render a LinearIssue into formatted markdown using the ticket template.
+ * Render an issue into formatted markdown using the ticket template.
+ * `trackerName` is injected for header/link text ("Linear" / "GitHub").
  */
-export declare function renderTicket(issue: LinearIssue): string;
+export declare function renderTicket(issue: Issue, trackerName: string): string;
 export interface DiffData {
     base_branch: string;
     commit_log: string | null;

package/dist/lib/prompts.js

@@ -33,10 +33,11 @@ export function renderPrompt(template, context) {
     return promptsEnv.render(`${template}.njk`, context);
 }
 /**
- * Render a LinearIssue into formatted markdown using the ticket template.
+ * Render an issue into formatted markdown using the ticket template.
+ * `trackerName` is injected for header/link text ("Linear" / "GitHub").
  */
-export function renderTicket(issue) {
-    return promptsEnv.render("ticket.njk", issue);
+export function renderTicket(issue, trackerName) {
+    return promptsEnv.render("ticket.njk", { ...issue, trackerName });
 }
 /**
  * Render diff data into formatted markdown using the diff template.

package/dist/lib/session-signal.d.ts

@@ -4,11 +4,10 @@ export declare function extractRepoAndTicket(cwd: string): {
     repoRoot: string;
     ticketId: string;
 } | null;
-export declare function renameTmuxWindow(ticketId: string, state: SessionStateValue): void;
-export declare function runHookScript(repoRoot: string, state: SessionStateValue, env: Record<string, string>): void;
+export declare function renameSessionWindow(ticketId: string, state: SessionStateValue): void;
 /**
  * Unified helper: reads stdin, extracts repo/ticket, writes state file,
- * renames tmux window, runs hook script, then exits.
+ * renames the multiplexer window, then exits.
  */
 export declare function signalState(state: SessionStateValue): void;
 export declare function getHooksJson(): Record<string, unknown>;

package/dist/lib/session-signal.js

@@ -1,6 +1,5 @@
 import * as fs from "fs";
 import * as path from "path";
-import { spawn } from "child_process";
 import { getMultiplexer } from "./multiplexer/index.js";
 export function readStdin() {
     try {
@@ -22,7 +21,7 @@ export function extractRepoAndTicket(cwd) {
         return null;
     return { repoRoot, ticketId };
 }
-export function renameTmuxWindow(ticketId, state) {
+export function renameSessionWindow(ticketId, state) {
     const mux = getMultiplexer();
     if (!mux.isActive())
         return;
@@ -40,25 +39,9 @@ export function renameTmuxWindow(ticketId, state) {
     }
     mux.renameWindow("", name);
 }
-export function runHookScript(repoRoot, state, env) {
-    const script = path.join(repoRoot, ".santree", "hooks", `on-${state}.sh`);
-    try {
-        fs.accessSync(script, fs.constants.X_OK);
-    }
-    catch {
-        return;
-    }
-    const child = spawn(script, [], {
-        cwd: env.SANTREE_WORKTREE_PATH,
-        env: { ...process.env, ...env },
-        stdio: "ignore",
-        detached: true,
-    });
-    child.unref();
-}
 /**
  * Unified helper: reads stdin, extracts repo/ticket, writes state file,
- * renames tmux window, runs hook script, then exits.
+ * renames the multiplexer window, then exits.
  */
 export function signalState(state) {
     const input = readStdin();
@@ -85,16 +68,7 @@ export function signalState(state) {
         at: new Date().toISOString(),
     };
     fs.writeFileSync(stateFile, JSON.stringify(payload, null, 2) + "\n");
-    renameTmuxWindow(ticketId, state);
-    const worktreePath = path.join(repoRoot, ".santree", "worktrees", ticketId);
-    runHookScript(repoRoot, state, {
-        SANTREE_TICKET_ID: ticketId,
-        SANTREE_SESSION_STATE: state,
-        SANTREE_SESSION_ID: data.session_id ?? "",
-        SANTREE_WORKTREE_PATH: worktreePath,
-        SANTREE_REPO_ROOT: repoRoot,
-        SANTREE_MESSAGE: payload.message ?? "",
-    });
+    renameSessionWindow(ticketId, state);
     process.exit(0);
 }
 export function getHooksJson() {

package/dist/lib/trackers/auth-store.d.ts

@@ -0,0 +1,16 @@
+export interface LinearTokens {
+    access_token: string;
+    refresh_token: string;
+    expires_at: number;
+    org_name: string;
+}
+export interface AuthStoreV2 {
+    version: 2;
+    linear: Record<string, LinearTokens>;
+    github: Record<string, never>;
+}
+export declare function readAuthStore(): AuthStoreV2;
+export declare function writeAuthStore(store: AuthStoreV2): void;
+export declare function readLinearAuthStore(): Record<string, LinearTokens>;
+export declare function writeLinearTokens(orgSlug: string, tokens: LinearTokens): void;
+export declare function deleteLinearTokens(orgSlug: string): void;

package/dist/lib/trackers/auth-store.js

@@ -0,0 +1,57 @@
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+const CONFIG_DIR = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config");
+const AUTH_FILE_PATH = path.join(CONFIG_DIR, "santree", "auth.json");
+function emptyStore() {
+    return { version: 2, linear: {}, github: {} };
+}
+export function readAuthStore() {
+    if (!fs.existsSync(AUTH_FILE_PATH))
+        return emptyStore();
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(AUTH_FILE_PATH, "utf-8"));
+    }
+    catch {
+        return emptyStore();
+    }
+    if (raw && typeof raw === "object" && raw.version === 2) {
+        const v2 = raw;
+        return {
+            version: 2,
+            linear: v2.linear ?? {},
+            github: (v2.github ?? {}),
+        };
+    }
+    const migrated = emptyStore();
+    if (raw && typeof raw === "object") {
+        for (const [k, v] of Object.entries(raw)) {
+            if (v && typeof v === "object" && "access_token" in v) {
+                migrated.linear[k] = v;
+            }
+        }
+    }
+    writeAuthStore(migrated);
+    return migrated;
+}
+export 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 });
+}
+export function readLinearAuthStore() {
+    return readAuthStore().linear;
+}
+export function writeLinearTokens(orgSlug, tokens) {
+    const store = readAuthStore();
+    store.linear[orgSlug] = tokens;
+    writeAuthStore(store);
+}
+export function deleteLinearTokens(orgSlug) {
+    const store = readAuthStore();
+    delete store.linear[orgSlug];
+    writeAuthStore(store);
+}

package/dist/lib/trackers/config.d.ts

@@ -0,0 +1,8 @@
+import type { IssueTrackerKind } from "./types.js";
+export interface TrackerConfig {
+    kind: IssueTrackerKind | null;
+    legacyLinearOrg: string | null;
+}
+export declare function readTrackerConfig(repoRoot: string): TrackerConfig;
+export declare function setRepoTracker(repoRoot: string, kind: IssueTrackerKind): void;
+export declare function removeRepoTracker(repoRoot: string): void;

package/dist/lib/trackers/config.js

@@ -0,0 +1,21 @@
+import { readAllMetadata, writeAllMetadata } from "../metadata.js";
+export function readTrackerConfig(repoRoot) {
+    const all = readAllMetadata(repoRoot);
+    const tracker = all._tracker;
+    const linear = all._linear;
+    let kind = null;
+    if (tracker?.kind === "linear" || tracker?.kind === "github") {
+        kind = tracker.kind;
+    }
+    return { kind, legacyLinearOrg: linear?.org ?? null };
+}
+export function setRepoTracker(repoRoot, kind) {
+    const all = readAllMetadata(repoRoot);
+    all._tracker = { kind };
+    writeAllMetadata(repoRoot, all);
+}
+export function removeRepoTracker(repoRoot) {
+    const all = readAllMetadata(repoRoot);
+    delete all._tracker;
+    writeAllMetadata(repoRoot, all);
+}

package/dist/lib/trackers/github/api.d.ts

@@ -0,0 +1,3 @@
+import type { AssignedIssue, Issue } from "../types.js";
+export declare function fetchAssignedIssues(repoNwo: string): Promise<AssignedIssue[] | null>;
+export declare function fetchIssue(repoNwo: string, identifier: string): Promise<Issue | null>;