shadok-ai 0.1.0

package/dist/worktree.d.ts

@@ -0,0 +1,63 @@
+export interface Worktree {
+    /** Working directory of the isolated checkout. */
+    path: string;
+    /** Branch created for this session. */
+    branch: string;
+    /** Commit the branch forked from (diff baseline). */
+    baseSha: string;
+    /** The original repository the worktree belongs to. */
+    repo: string;
+}
+/** True if `cwd` is inside a git working tree. */
+export declare function isGitRepo(cwd: string): boolean;
+/**
+ * Creates an isolated git worktree off the repo's current HEAD, on a fresh
+ * branch, so an agent's edits stay contained until the user merges them.
+ * The checkout lives under ~/.shadok-ai/worktrees to avoid polluting the repo.
+ */
+export declare function createWorktree(repo: string, tag: string): Worktree;
+/**
+ * Removes a worktree only if it has no uncommitted changes (git refuses a
+ * dirty removal without --force, which we intentionally don't pass — work is
+ * never discarded automatically).
+ */
+export declare function removeWorktreeIfClean(wt: Worktree): void;
+/**
+ * Ensures a worktree checkout exists at `dir` for `branch`, recreating it
+ * from the branch if it was removed. Lets a past session be reopened even
+ * after its folder was reclaimed (the branch always survives).
+ */
+export declare function ensureWorktreeCheckout(repo: string, branch: string, dir: string): boolean;
+export interface PastSession {
+    branch: string;
+    /** Full session id (from the transcript), or null if none was recorded. */
+    sessionId: string | null;
+    /** Worktree checkout path (may not exist on disk). */
+    cwd: string;
+    dirExists: boolean;
+    /** First user prompt of the session, for recognition. */
+    preview: string;
+    /** Commits ahead of the base branch. */
+    commits: number;
+    /** Whether the branch has any diff vs the base. */
+    hasChanges: boolean;
+    /** Last activity (ms since epoch). */
+    mtime: number;
+}
+/**
+ * Lists every past shadok-ai worktree session of a repo — recoverable from
+ * their branch even if the checkout was reclaimed — newest first, so
+ * unfinished work can be reopened and continued.
+ */
+export declare function listPastSessions(repo: string): PastSession[];
+export interface DiffResult {
+    status: string;
+    diff: string;
+    branch: string | null;
+}
+/**
+ * Returns the changes made in `cwd`: `git status` plus the full diff. With a
+ * known baseline (worktree), diffs against the fork point so committed work
+ * shows too; otherwise diffs the working tree against HEAD.
+ */
+export declare function gitDiff(cwd: string, baseSha?: string | null): DiffResult;

package/dist/worktree.js

@@ -0,0 +1,153 @@
+import { execFileSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { listSessions } from "./extract.js";
+function git(cwd, args) {
+    return execFileSync("git", ["-C", cwd, ...args], {
+        encoding: "utf8",
+        timeout: 15_000,
+        maxBuffer: 16 * 1024 * 1024,
+        stdio: ["ignore", "pipe", "pipe"],
+    }).trimEnd();
+}
+/** True if `cwd` is inside a git working tree. */
+export function isGitRepo(cwd) {
+    try {
+        return git(cwd, ["rev-parse", "--is-inside-work-tree"]) === "true";
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Creates an isolated git worktree off the repo's current HEAD, on a fresh
+ * branch, so an agent's edits stay contained until the user merges them.
+ * The checkout lives under ~/.shadok-ai/worktrees to avoid polluting the repo.
+ */
+export function createWorktree(repo, tag) {
+    const baseSha = git(repo, ["rev-parse", "HEAD"]);
+    const repoName = path.basename(path.resolve(repo)).replace(/[^a-zA-Z0-9._-]/g, "-");
+    const branch = `shadok-ai/${tag}`;
+    const dir = path.join(os.homedir(), ".shadok-ai", "worktrees", `${repoName}-${tag}`);
+    fs.mkdirSync(path.dirname(dir), { recursive: true });
+    git(repo, ["worktree", "add", "-b", branch, dir, baseSha]);
+    return { path: dir, branch, baseSha, repo };
+}
+/**
+ * Removes a worktree only if it has no uncommitted changes (git refuses a
+ * dirty removal without --force, which we intentionally don't pass — work is
+ * never discarded automatically).
+ */
+export function removeWorktreeIfClean(wt) {
+    try {
+        git(wt.repo, ["worktree", "remove", wt.path]);
+    }
+    catch {
+        // Dirty or has commits: leave it in place for the user to merge/inspect.
+    }
+}
+/**
+ * Ensures a worktree checkout exists at `dir` for `branch`, recreating it
+ * from the branch if it was removed. Lets a past session be reopened even
+ * after its folder was reclaimed (the branch always survives).
+ */
+export function ensureWorktreeCheckout(repo, branch, dir) {
+    if (fs.existsSync(dir))
+        return true;
+    try {
+        fs.mkdirSync(path.dirname(dir), { recursive: true });
+        git(repo, ["worktree", "add", dir, branch]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Lists every past shadok-ai worktree session of a repo — recoverable from
+ * their branch even if the checkout was reclaimed — newest first, so
+ * unfinished work can be reopened and continued.
+ */
+export function listPastSessions(repo) {
+    let base = "main";
+    try {
+        base = git(repo, ["rev-parse", "--abbrev-ref", "HEAD"]);
+    }
+    catch {
+        return [];
+    }
+    let branches;
+    try {
+        branches = git(repo, ["branch", "--list", "shadok-ai/*", "--format=%(refname:short)"])
+            .split("\n")
+            .filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+    const repoName = path.basename(path.resolve(repo)).replace(/[^a-zA-Z0-9._-]/g, "-");
+    const out = [];
+    for (const branch of branches) {
+        const tag = branch.replace(/^shadok-ai\//, "");
+        const cwd = path.join(os.homedir(), ".shadok-ai", "worktrees", `${repoName}-${tag}`);
+        // The transcript lives in the worktree's project dir even if the checkout
+        // was removed — read the full session id and preview from there.
+        const sess = listSessions(cwd)[0] ?? null;
+        let commits = 0;
+        let hasChanges = false;
+        try {
+            commits = Number(git(repo, ["rev-list", "--count", `${base}..${branch}`]) || "0");
+            hasChanges = git(repo, ["diff", "--shortstat", base, branch]).trim() !== "";
+        }
+        catch {
+            // ignore
+        }
+        out.push({
+            branch,
+            sessionId: sess?.id ?? null,
+            cwd,
+            dirExists: fs.existsSync(cwd),
+            preview: sess?.preview ?? "",
+            commits,
+            hasChanges,
+            mtime: sess?.mtime ?? 0,
+        });
+    }
+    return out.sort((a, b) => b.mtime - a.mtime);
+}
+/**
+ * Returns the changes made in `cwd`: `git status` plus the full diff. With a
+ * known baseline (worktree), diffs against the fork point so committed work
+ * shows too; otherwise diffs the working tree against HEAD.
+ */
+export function gitDiff(cwd, baseSha) {
+    let status = "", diff = "", branch = null;
+    try {
+        branch = git(cwd, ["rev-parse", "--abbrev-ref", "HEAD"]);
+        status = git(cwd, ["status", "--short"]);
+        diff = git(cwd, ["diff", baseSha ?? "HEAD"]);
+        // Include untracked files (diff doesn't show them).
+        const untracked = git(cwd, ["ls-files", "--others", "--exclude-standard"])
+            .split("\n")
+            .filter(Boolean);
+        if (untracked.length) {
+            const shown = untracked.map((f) => {
+                try {
+                    const body = git(cwd, ["diff", "--no-index", "/dev/null", f]);
+                    return body;
+                }
+                catch (e) {
+                    // --no-index exits non-zero when files differ; its stdout has the diff.
+                    return e?.stdout ? String(e.stdout).trimEnd() : `+++ ${f} (untracked)`;
+                }
+            });
+            diff = [diff, ...shown].filter(Boolean).join("\n");
+        }
+    }
+    catch {
+        // not a repo, or git error — return whatever we gathered
+    }
+    return { status, diff, branch };
+}
+//# sourceMappingURL=worktree.js.map

package/dist/worktree.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "shadok-ai",
+  "version": "0.1.0",
+  "main": "dist/session.js",
+  "scripts": {
+    "test": "node --import tsx --test test/*.ts .claude/skills/shadok-ai-agents/test/",
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "postinstall": "chmod +x node_modules/node-pty/prebuilds/darwin-*/spawn-helper 2>/dev/null || true",
+    "prepublishOnly": "npm run build",
+    "web": "node dist/server.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "Web cockpit that drives multiple real Claude Code TUI sessions in parallel, with Telegram control",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "public"
+  ],
+  "dependencies": {
+    "@xterm/headless": "^6.0.0",
+    "express": "^5.2.1",
+    "marked": "^18.0.6",
+    "node-pty": "^1.1.0",
+    "ws": "^8.21.1"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^26.1.1",
+    "@types/ws": "^8.18.1",
+    "tsx": "^4.23.1",
+    "typescript": "^7.0.2"
+  },
+  "types": "dist/session.d.ts",
+  "bin": {
+    "shadok-ai": "dist/main.js",
+    "shadok-ai-run": "dist/cli.js"
+  }
+}