thehood 0.1.0-preview.0

package/dist/runtime/remoteRepoContext.js

@@ -0,0 +1,316 @@
+import { spawn } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { writeRunArtifact } from "./artifacts.js";
+import { parseGitStatusPaths } from "./gitEvidence.js";
+import { newId, nowIso } from "./ids.js";
+import { resolveRepoPath } from "./paths.js";
+import { loadRun, saveRun } from "./store.js";
+const maxStatusPaths = 20;
+const runGit = async (repoPath, args) => new Promise((resolve) => {
+    const child = spawn("git", args, {
+        cwd: repoPath,
+        stdio: ["ignore", "pipe", "pipe"]
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (chunk) => {
+        stdout += chunk.toString();
+    });
+    child.stderr.on("data", (chunk) => {
+        stderr += chunk.toString();
+    });
+    child.on("close", (exitCode) => {
+        resolve({
+            exitCode: exitCode ?? 1,
+            stdout,
+            stderr
+        });
+    });
+});
+const stringFromGit = (result) => {
+    const value = result.stdout.trim();
+    return result.exitCode === 0 && value.length > 0 ? value : undefined;
+};
+export const parseGitHubRemoteUrl = (url) => {
+    const trimmed = url.trim();
+    const scpMatch = trimmed.match(/^git@github\.com:([^/\s]+)\/([^/\s]+?)(?:\.git)?$/);
+    if (scpMatch?.[1] && scpMatch[2]) {
+        return {
+            owner: scpMatch[1],
+            repo: scpMatch[2],
+            normalizedUrl: `https://github.com/${scpMatch[1]}/${scpMatch[2]}`
+        };
+    }
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+    if (parsed.hostname.toLowerCase() !== "github.com") {
+        return undefined;
+    }
+    const parts = parsed.pathname
+        .replace(/^\/+|\/+$/g, "")
+        .split("/")
+        .filter(Boolean);
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+        return undefined;
+    }
+    const repo = parts[1].replace(/\.git$/, "");
+    if (!repo) {
+        return undefined;
+    }
+    return {
+        owner: parts[0],
+        repo,
+        normalizedUrl: `https://github.com/${parts[0]}/${repo}`
+    };
+};
+const githubRemotesFromGitOutput = (stdout) => {
+    const remotes = [];
+    for (const line of stdout.split("\n")) {
+        const match = line.match(/^(\S+)\s+(\S+)\s+\((fetch)\)$/);
+        if (!match?.[1] || !match[2]) {
+            continue;
+        }
+        const parsed = parseGitHubRemoteUrl(match[2]);
+        if (!parsed) {
+            continue;
+        }
+        remotes.push({
+            name: match[1],
+            url: match[2],
+            ...parsed
+        });
+    }
+    return remotes.sort((left, right) => (left.name === "origin" ? 0 : 1) - (right.name === "origin" ? 0 : 1) ||
+        left.name.localeCompare(right.name));
+};
+const normalizeDelegate = (delegate) => delegate && typeof delegate === "object" && !Array.isArray(delegate) ? delegate : {};
+export const chatGptWebGitHubConnectorConfirmed = (env = process.env) => env.THEHOOD_CHATGPT_WEB_GITHUB_CONNECTOR_CONFIRMED === "1";
+export const chooseRepoContextRoute = (inspection) => {
+    const reasons = [...inspection.reasons];
+    if (inspection.provider !== "chatgpt-web") {
+        return {
+            route: "local_bundle",
+            reason: "provider_does_not_support_github_connector_context",
+            reasons: [...reasons, "provider_does_not_support_github_connector_context"]
+        };
+    }
+    if (!inspection.githubRemote) {
+        return {
+            route: "local_bundle",
+            reason: "no_github_remote",
+            reasons: [...reasons, "no_github_remote"]
+        };
+    }
+    if (!inspection.commit) {
+        return {
+            route: "local_bundle",
+            reason: "missing_head_commit",
+            reasons: [...reasons, "missing_head_commit"]
+        };
+    }
+    if (!inspection.clean) {
+        return {
+            route: "local_bundle",
+            reason: "dirty_checkout",
+            reasons: [...reasons, "dirty_checkout"]
+        };
+    }
+    if (!inspection.pushed) {
+        return {
+            route: "local_bundle",
+            reason: "head_not_pushed_to_upstream",
+            reasons: [...reasons, "head_not_pushed_to_upstream"]
+        };
+    }
+    if (!inspection.githubConnectorConfirmed) {
+        return {
+            route: "local_bundle",
+            reason: "chatgpt_web_github_connector_unconfirmed",
+            reasons: [...reasons, "chatgpt_web_github_connector_unconfirmed"]
+        };
+    }
+    return {
+        route: "github_connector",
+        reason: "clean_pushed_github_repo_with_confirmed_chatgpt_web_github_connector",
+        reasons: [...reasons, "chatgpt_web_github_connector_confirmed"]
+    };
+};
+export const inspectRemoteRepoContext = async (repoPathInput, assignment) => {
+    const repoPath = resolveRepoPath(repoPathInput);
+    const reasons = [];
+    const remoteOutput = await runGit(repoPath, ["remote", "-v"]);
+    const remotes = remoteOutput.exitCode === 0 ? githubRemotesFromGitOutput(remoteOutput.stdout) : [];
+    const githubRemote = remotes[0];
+    if (!githubRemote) {
+        reasons.push("no_github_remote");
+    }
+    const status = await runGit(repoPath, [
+        "status",
+        "--porcelain",
+        "--untracked-files=all",
+        "--",
+        ".",
+        ":(exclude).thehood"
+    ]);
+    const statusPaths = status.exitCode === 0 ? parseGitStatusPaths(status.stdout) : [];
+    const clean = status.exitCode === 0 && statusPaths.length === 0;
+    if (status.exitCode !== 0) {
+        reasons.push("git_status_unavailable");
+    }
+    else if (!clean) {
+        reasons.push("dirty_checkout");
+    }
+    const commit = stringFromGit(await runGit(repoPath, ["rev-parse", "HEAD"]));
+    if (!commit) {
+        reasons.push("missing_head_commit");
+    }
+    const branch = stringFromGit(await runGit(repoPath, ["branch", "--show-current"]));
+    const upstream = stringFromGit(await runGit(repoPath, [
+        "rev-parse",
+        "--abbrev-ref",
+        "--symbolic-full-name",
+        "@{u}"
+    ]));
+    const upstreamCommit = stringFromGit(await runGit(repoPath, ["rev-parse", "@{u}"]));
+    const pushed = Boolean(commit && upstreamCommit && commit === upstreamCommit);
+    if (!upstream || !upstreamCommit) {
+        reasons.push("missing_upstream_ref");
+    }
+    else if (!pushed) {
+        reasons.push("head_differs_from_upstream");
+    }
+    return {
+        provider: assignment.provider,
+        repoPath,
+        ...(githubRemote ? { githubRemote } : {}),
+        githubConnectorConfirmed: assignment.provider === "chatgpt-web" && chatGptWebGitHubConnectorConfirmed(),
+        ...(branch ? { branch } : {}),
+        ...(commit ? { commit } : {}),
+        ...(upstream ? { upstream } : {}),
+        ...(upstreamCommit ? { upstreamCommit } : {}),
+        clean,
+        pushed,
+        statusPathCount: statusPaths.length,
+        statusPaths: statusPaths.slice(0, maxStatusPaths),
+        reasons: Array.from(new Set(reasons))
+    };
+};
+const buildGitHubConnectorRepoContext = (run, delegate, inspection, routeDecision) => {
+    if (!inspection.githubRemote || !inspection.commit) {
+        throw new Error("Cannot build GitHub connector context without GitHub remote and HEAD commit.");
+    }
+    return {
+        schemaVersion: 1,
+        kind: "github_connector_repo_context",
+        generatedAt: nowIso(),
+        repoPath: inspection.repoPath,
+        runId: run.runId,
+        goal: run.userGoal,
+        delegate: normalizeDelegate(delegate),
+        route: "github_connector",
+        remote: {
+            provider: "github",
+            remoteName: inspection.githubRemote.name,
+            owner: inspection.githubRemote.owner,
+            repo: inspection.githubRemote.repo,
+            url: inspection.githubRemote.url,
+            normalizedUrl: inspection.githubRemote.normalizedUrl,
+            ...(inspection.branch ? { branch: inspection.branch } : {}),
+            commit: inspection.commit,
+            ...(inspection.upstream ? { upstream: inspection.upstream } : {}),
+            ...(inspection.upstreamCommit ? { upstreamCommit: inspection.upstreamCommit } : {})
+        },
+        localState: {
+            clean: inspection.clean,
+            pushed: inspection.pushed,
+            statusPathCount: inspection.statusPathCount,
+            statusPaths: inspection.statusPaths,
+            reasons: routeDecision.reasons
+        },
+        instructions: [
+            "Use ChatGPT Web's GitHub connector to inspect this repository at the exact commit and branch named here.",
+            "Do not assume provider chat history or project context is current; use TheHood runtime state and this remote ref as the source of truth.",
+            "Treat TheHood artifacts and local runtime state as authoritative if they conflict with connector-visible repository content.",
+            "Ask TheHood for a bounded local repo context pack if GitHub connector access is unavailable or the requested evidence is not visible at this commit."
+        ],
+        notes: [
+            "This refs-only context was selected because local git reported a clean checkout with HEAD matching the tracked upstream ref.",
+            "No local file excerpts are included in this artifact.",
+            "The runtime falls back to bounded local context packs for local-only, dirty, unpushed, or non-ChatGPT providers."
+        ]
+    };
+};
+export const captureRemoteRepoContext = async (run, assignment, delegate) => {
+    const inspection = await inspectRemoteRepoContext(run.repoPath, assignment);
+    const routeDecision = chooseRepoContextRoute(inspection);
+    if (routeDecision.route !== "github_connector") {
+        return {
+            selected: false,
+            run,
+            routeDecision,
+            inspection
+        };
+    }
+    const context = buildGitHubConnectorRepoContext(run, delegate, inspection, routeDecision);
+    const artifact = await writeRunArtifact({
+        repoPath: context.repoPath,
+        runId: run.runId,
+        kind: "remote_context",
+        name: `github-connector-context-${newId("remote-context")}.json`,
+        content: `${JSON.stringify(context, null, 2)}\n`,
+        summary: `GitHub connector context for ${context.remote.owner}/${context.remote.repo}@${context.remote.commit.slice(0, 12)}.`
+    });
+    const latestRun = await loadRun(context.repoPath, run.runId);
+    const updated = {
+        ...latestRun,
+        updatedAt: nowIso(),
+        artifacts: [...latestRun.artifacts, artifact],
+        events: [
+            ...latestRun.events,
+            {
+                id: newId("event"),
+                createdAt: nowIso(),
+                type: "remote_repo_context_selected",
+                message: `Selected GitHub connector context for ${context.remote.owner}/${context.remote.repo}.`,
+                data: {
+                    transport: "github_connector",
+                    provider: assignment.provider,
+                    model: assignment.model,
+                    owner: context.remote.owner,
+                    repo: context.remote.repo,
+                    normalizedUrl: context.remote.normalizedUrl,
+                    ...(context.remote.branch ? { branch: context.remote.branch } : {}),
+                    commit: context.remote.commit,
+                    ...(context.remote.upstream ? { upstream: context.remote.upstream } : {}),
+                    reason: routeDecision.reason,
+                    artifactRef: artifact.ref
+                }
+            }
+        ]
+    };
+    await saveRun(updated);
+    return {
+        selected: true,
+        run: updated,
+        routeDecision,
+        inspection,
+        artifact,
+        context
+    };
+};
+export const remoteRepoContextArtifacts = (run) => run.artifacts.filter((artifact) => artifact.kind === "remote_context");
+export const latestRemoteRepoContextArtifact = (run) => remoteRepoContextArtifacts(run).at(-1);
+export const readRemoteRepoContextArtifact = async (artifact) => {
+    const raw = await readFile(artifact.ref, "utf8");
+    return JSON.parse(raw);
+};
+export const readLatestRemoteRepoContext = async (run) => {
+    const artifact = latestRemoteRepoContextArtifact(run);
+    return artifact ? readRemoteRepoContextArtifact(artifact) : undefined;
+};
+//# sourceMappingURL=remoteRepoContext.js.map

package/dist/runtime/remoteRepoContext.js.map

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

package/dist/runtime/repoContext.d.ts

@@ -0,0 +1,50 @@
+import type { JsonObject, JsonValue, RunArtifact, RunRecord } from "./types.js";
+export interface RepoContextFile {
+    path: string;
+    bytes: number;
+    maxBytes: number;
+    startByte: number;
+    endByte: number;
+    truncated: boolean;
+    excerpt: string;
+}
+export interface RepoContextPack {
+    schemaVersion: 1;
+    kind: "repo_context";
+    generatedAt: string;
+    repoPath: string;
+    runId: string;
+    goal: string;
+    delegate: JsonObject;
+    limits: {
+        maxTreePaths: number;
+        maxFiles: number;
+        maxBytesPerFile: number;
+        maxBytesPerRequestedFile: number;
+        maxTotalBytes: number;
+    };
+    tree: string[];
+    omittedTreePathCount: number;
+    files: RepoContextFile[];
+    notes: string[];
+    sourceArtifacts?: RunArtifact[];
+}
+export interface CaptureRepoContextResult {
+    run: RunRecord;
+    artifact: RunArtifact;
+    context: RepoContextPack;
+}
+export interface RepoContextRequestAnalysis {
+    requestedPaths: string[];
+    alreadyCapturedPaths: string[];
+    incompleteCapturedPaths: string[];
+    newRequestedPaths: string[];
+}
+export declare const repoContextArtifacts: (run: RunRecord) => RunArtifact[];
+export declare const analyzeRepoContextRequest: (run: RunRecord, delegate: JsonValue | undefined) => Promise<RepoContextRequestAnalysis>;
+export declare const captureRepoContext: (run: RunRecord, delegate: JsonValue | undefined, options?: {
+    preferredPaths?: string[];
+}) => Promise<CaptureRepoContextResult>;
+export declare const latestRepoContextArtifact: (run: RunRecord) => RunArtifact | undefined;
+export declare const readLatestRepoContext: (run: RunRecord) => Promise<RepoContextPack | undefined>;
+export declare const readCombinedRepoContext: (run: RunRecord) => Promise<RepoContextPack | undefined>;