thehood 0.1.0-preview.0

package/dist/runtime/commandRunner.d.ts

@@ -0,0 +1,18 @@
+import type { RunArtifact, RunRecord, ToolEvent } from "./types.js";
+export interface RunCommandInput {
+    repoPath: string;
+    runId: string;
+    command: string;
+    args: string[];
+    cwd?: string;
+    tool?: string;
+    allowRisky?: boolean;
+}
+export interface RunCommandResult {
+    run: RunRecord;
+    event: ToolEvent;
+    artifacts: RunArtifact[];
+    stdout: string;
+    stderr: string;
+}
+export declare const runRuntimeCommand: (input: RunCommandInput) => Promise<RunCommandResult>;

package/dist/runtime/commandRunner.js

@@ -0,0 +1,115 @@
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { writeRunArtifact } from "./artifacts.js";
+import { classifyCommand } from "./commandSafety.js";
+import { ApprovalRequiredError, InputError } from "./errors.js";
+import { newId, nowIso } from "./ids.js";
+import { resolveRepoPath } from "./paths.js";
+import { redactText } from "./redaction.js";
+import { loadRun, saveRun } from "./store.js";
+const resolveCommandCwd = (repoPath, cwd) => {
+    const root = resolveRepoPath(repoPath);
+    const resolved = path.resolve(root, cwd ?? ".");
+    const relative = path.relative(root, resolved);
+    if (relative.startsWith("..") || path.isAbsolute(relative)) {
+        throw new InputError(`Command cwd must stay inside repo path: ${resolved}`);
+    }
+    return resolved;
+};
+const commandLabel = (command, args) => [command, ...args].join(" ");
+const artifactBaseName = (tool, id, extension) => `${tool}-${id}.${extension}`;
+export const runRuntimeCommand = async (input) => {
+    const command = input.command.trim();
+    if (!command) {
+        throw new InputError("Command cannot be empty.");
+    }
+    const repoPath = resolveRepoPath(input.repoPath);
+    const cwd = resolveCommandCwd(repoPath, input.cwd);
+    const run = await loadRun(repoPath, input.runId);
+    const safety = classifyCommand(command, input.args);
+    if (safety.requiresApproval && !input.allowRisky) {
+        throw new ApprovalRequiredError(`${commandLabel(command, input.args)} requires approval: ${safety.reason ?? "risky command"}`);
+    }
+    const startedAt = Date.now();
+    const child = spawn(command, input.args, {
+        cwd,
+        shell: false,
+        env: process.env,
+        stdio: ["ignore", "pipe", "pipe"]
+    });
+    const stdoutChunks = [];
+    const stderrChunks = [];
+    child.stdout.on("data", (chunk) => stdoutChunks.push(chunk));
+    child.stderr.on("data", (chunk) => stderrChunks.push(chunk));
+    const exitCode = await new Promise((resolve, reject) => {
+        child.on("error", reject);
+        child.on("close", (code) => resolve(code ?? 1));
+    });
+    const durationMs = Date.now() - startedAt;
+    const stdout = redactText(Buffer.concat(stdoutChunks).toString("utf8"));
+    const stderr = redactText(Buffer.concat(stderrChunks).toString("utf8"));
+    const eventId = newId("tool");
+    const tool = input.tool ?? command;
+    const artifacts = [];
+    const stdoutArtifact = await writeRunArtifact({
+        repoPath,
+        runId: input.runId,
+        kind: "log",
+        name: artifactBaseName(tool, eventId, "stdout.txt"),
+        content: stdout,
+        summary: `stdout for ${commandLabel(command, input.args)}`
+    });
+    artifacts.push(stdoutArtifact);
+    const stderrArtifact = await writeRunArtifact({
+        repoPath,
+        runId: input.runId,
+        kind: "log",
+        name: artifactBaseName(tool, eventId, "stderr.txt"),
+        content: stderr,
+        summary: `stderr for ${commandLabel(command, input.args)}`
+    });
+    artifacts.push(stderrArtifact);
+    const event = {
+        id: eventId,
+        createdAt: nowIso(),
+        tool,
+        command,
+        args: input.args,
+        cwd,
+        exitCode,
+        durationMs,
+        safetyCategory: safety.category,
+        permissionDecision: safety.requiresApproval ? "allowed_explicit_user" : "allowed",
+        stdoutRef: stdoutArtifact.ref,
+        stderrRef: stderrArtifact.ref
+    };
+    const updated = {
+        ...run,
+        updatedAt: nowIso(),
+        artifacts: [...run.artifacts, ...artifacts],
+        toolEvents: [...run.toolEvents, event],
+        events: [
+            ...run.events,
+            {
+                id: newId("event"),
+                createdAt: nowIso(),
+                type: "command_executed",
+                message: `${commandLabel(command, input.args)} exited with ${exitCode}.`,
+                data: {
+                    tool,
+                    exitCode,
+                    safetyCategory: safety.category
+                }
+            }
+        ]
+    };
+    await saveRun(updated);
+    return {
+        run: updated,
+        event,
+        artifacts,
+        stdout,
+        stderr
+    };
+};
+//# sourceMappingURL=commandRunner.js.map

package/dist/runtime/commandRunner.js.map

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

package/dist/runtime/commandSafety.d.ts

@@ -0,0 +1,7 @@
+import type { CommandSafetyCategory } from "./types.js";
+export interface CommandSafety {
+    category: CommandSafetyCategory;
+    requiresApproval: boolean;
+    reason?: string;
+}
+export declare const classifyCommand: (command: string, args: string[]) => CommandSafety;

package/dist/runtime/commandSafety.js

@@ -0,0 +1,61 @@
+import path from "node:path";
+const commandName = (command) => path.basename(command).toLowerCase();
+const firstArg = (args) => (args[0] ?? "").toLowerCase();
+export const classifyCommand = (command, args) => {
+    const name = commandName(command);
+    const subcommand = firstArg(args);
+    if (["rm", "rmdir", "unlink"].includes(name)) {
+        return {
+            category: "destructive",
+            requiresApproval: true,
+            reason: `${name} can delete files.`
+        };
+    }
+    if (name === "git" && ["reset", "clean", "checkout", "switch", "merge", "rebase"].includes(subcommand)) {
+        return {
+            category: "destructive",
+            requiresApproval: true,
+            reason: `git ${subcommand} can rewrite or replace local state.`
+        };
+    }
+    if ((name === "npm" && ["install", "i", "add"].includes(subcommand)) ||
+        (["pnpm", "yarn"].includes(name) && ["install", "add"].includes(subcommand)) ||
+        (name === "pip" && subcommand === "install") ||
+        (name === "cargo" && subcommand === "add")) {
+        return {
+            category: "dependency_install",
+            requiresApproval: true,
+            reason: `${name} ${subcommand} changes project dependencies.`
+        };
+    }
+    if (["curl", "wget", "gh", "fly", "vercel", "wrangler"].includes(name)) {
+        return {
+            category: "network",
+            requiresApproval: true,
+            reason: `${name} can perform network operations.`
+        };
+    }
+    if (name === "git" && ["status", "diff", "ls-files", "rev-parse", "show"].includes(subcommand)) {
+        return {
+            category: "read_only",
+            requiresApproval: false
+        };
+    }
+    if (name === "git" && subcommand === "apply") {
+        return {
+            category: "local_write",
+            requiresApproval: false
+        };
+    }
+    if (name === "npm" && subcommand === "run") {
+        return {
+            category: "local_write",
+            requiresApproval: false
+        };
+    }
+    return {
+        category: "unknown",
+        requiresApproval: false
+    };
+};
+//# sourceMappingURL=commandSafety.js.map

package/dist/runtime/commandSafety.js.map

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

package/dist/runtime/config.d.ts

@@ -0,0 +1,10 @@
+import { type LocalStateIgnoreResult } from "./localStateIgnore.js";
+import type { TheHoodConfig } from "./types.js";
+export interface InitConfigResult {
+    configPath: string;
+    created: boolean;
+    localStateIgnore: LocalStateIgnoreResult;
+}
+export declare const loadConfig: (repoPath: string) => Promise<TheHoodConfig>;
+export declare const writeConfig: (repoPath: string, config: TheHoodConfig) => Promise<string>;
+export declare const initConfig: (repoPath: string) => Promise<InitConfigResult>;

package/dist/runtime/config.js

@@ -0,0 +1,107 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { createDefaultConfig } from "./defaults.js";
+import { InputError } from "./errors.js";
+import { ensureLocalStateIgnored } from "./localStateIgnore.js";
+import { getProjectPaths } from "./paths.js";
+const readJsonFile = async (filePath) => {
+    const raw = await fs.readFile(filePath, "utf8");
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new InputError(`Invalid JSON in ${filePath}: ${message}`);
+    }
+};
+const mergeRoles = (base, override) => ({
+    ...base,
+    ...(override ?? {})
+});
+const unique = (values) => [...new Set(values)];
+const mergeProvider = (base, override) => base
+    ? {
+        ...base,
+        ...override,
+        models: unique([...base.models, ...override.models]),
+        accessModes: unique([...(base.accessModes ?? []), ...(override.accessModes ?? [])])
+    }
+    : override;
+const mergeProviders = (base, override) => {
+    if (!override) {
+        return base;
+    }
+    const merged = { ...base };
+    for (const [providerId, provider] of Object.entries(override)) {
+        merged[providerId] = mergeProvider(base[providerId], provider);
+    }
+    return merged;
+};
+const mergeConfig = (base, override) => ({
+    version: 1,
+    defaults: {
+        ...base.defaults,
+        ...(override.defaults ?? {}),
+        protectedTestPaths: override.defaults?.protectedTestPaths ?? base.defaults.protectedTestPaths
+    },
+    approvalPolicy: {
+        mode: override.approvalPolicy?.mode ??
+            override.approvalPolicy?.externalTransfers?.mode ??
+            base.approvalPolicy.mode,
+        externalTransfers: {
+            ...base.approvalPolicy.externalTransfers,
+            ...(override.approvalPolicy?.externalTransfers ?? {}),
+            rules: override.approvalPolicy?.externalTransfers?.rules ??
+                base.approvalPolicy.externalTransfers.rules
+        }
+    },
+    providers: mergeProviders(base.providers, override.providers),
+    roles: mergeRoles(base.roles, override.roles)
+});
+export const loadConfig = async (repoPath) => {
+    const paths = getProjectPaths(repoPath);
+    const defaults = createDefaultConfig();
+    try {
+        const loaded = await readJsonFile(paths.configPath);
+        return mergeConfig(defaults, loaded);
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return defaults;
+        }
+        throw error;
+    }
+};
+export const writeConfig = async (repoPath, config) => {
+    const paths = getProjectPaths(repoPath);
+    await ensureLocalStateIgnored(repoPath);
+    await fs.mkdir(path.dirname(paths.configPath), { recursive: true });
+    await fs.writeFile(paths.configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+    return paths.configPath;
+};
+export const initConfig = async (repoPath) => {
+    const paths = getProjectPaths(repoPath);
+    const localStateIgnore = await ensureLocalStateIgnored(repoPath);
+    try {
+        await fs.access(paths.configPath);
+        return {
+            configPath: paths.configPath,
+            created: false,
+            localStateIgnore
+        };
+    }
+    catch (error) {
+        if (error.code !== "ENOENT") {
+            throw error;
+        }
+    }
+    const configPath = await writeConfig(repoPath, createDefaultConfig());
+    await fs.mkdir(paths.runsDir, { recursive: true });
+    await fs.mkdir(paths.artifactsDir, { recursive: true });
+    return {
+        configPath,
+        created: true,
+        localStateIgnore
+    };
+};
+//# sourceMappingURL=config.js.map

package/dist/runtime/config.js.map

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

package/dist/runtime/crewLanes.d.ts

@@ -0,0 +1,2 @@
+import type { CrewLaneTrail, RunRecord } from "./types.js";
+export declare const deriveCrewLaneTrail: (run: RunRecord) => CrewLaneTrail;

package/dist/runtime/crewLanes.js

@@ -0,0 +1,123 @@
+import { nowIso } from "./ids.js";
+import { deriveLoopResponsibilitySchedule } from "./loopResponsibilities.js";
+import { deriveReviewLanes } from "./reviewLanes.js";
+const readonlyRoleKinds = new Set([
+    "plan",
+    "test",
+    "verify",
+    "critique",
+    "reconcile"
+]);
+const unique = (values, key) => {
+    const seen = new Set();
+    const result = [];
+    for (const value of values) {
+        const id = key(value);
+        if (!seen.has(id)) {
+            seen.add(id);
+            result.push(value);
+        }
+    }
+    return result;
+};
+const uniqueStrings = (values) => [...new Set(values.filter((value) => value.trim().length > 0))];
+const sourceKey = (source) => [source.kind, source.runId, source.id ?? "", source.ref ?? "", source.eventType ?? ""].join(":");
+const sourceRefsForResponsibility = (run, responsibility, reviewLane) => {
+    const refs = [
+        ...responsibility.eventRefs.map((id) => ({
+            kind: "run_event",
+            runId: run.runId,
+            id
+        })),
+        ...responsibility.artifactRefs.map((ref) => ({
+            kind: "run_artifact",
+            runId: run.runId,
+            ref
+        })),
+        ...(reviewLane?.sourceRefs ?? [])
+    ];
+    return refs.length > 0
+        ? unique(refs, sourceKey)
+        : [{ kind: "run_record", runId: run.runId }];
+};
+const reviewLaneForResponsibility = (responsibility, reviewLanes) => {
+    switch (responsibility.kind) {
+        case "qa":
+            return reviewLanes.find((lane) => lane.kind === "qa");
+        case "test":
+            return reviewLanes.find((lane) => lane.kind === "tester" && lane.role === "qa");
+        case "verify":
+            return reviewLanes.find((lane) => lane.role === "verifier");
+        case "critique":
+            return reviewLanes.find((lane) => lane.role === "critic");
+        default:
+            return undefined;
+    }
+};
+const laneAuthority = (responsibility) => {
+    if (responsibility.kind === "operator_approval") {
+        return "operator";
+    }
+    if (responsibility.owner.kind === "runtime") {
+        return "runtime";
+    }
+    if (responsibility.owner.readOnly || readonlyRoleKinds.has(responsibility.kind)) {
+        return "read_only";
+    }
+    return "edit";
+};
+const laneSourceKind = (reviewLane) => reviewLane ? "review_lane" : "loop_responsibility";
+const satisfiesRequired = (responsibility, reviewLane) => {
+    if (reviewLane) {
+        return reviewLane.satisfiesRequired;
+    }
+    return responsibility.required && responsibility.status === "satisfied" && responsibility.canSatisfyGate;
+};
+const crewLaneFromResponsibility = (run, responsibility, reviewLane) => {
+    const artifactRefs = uniqueStrings([
+        ...responsibility.artifactRefs,
+        ...(reviewLane?.artifactRefs ?? [])
+    ]);
+    const eventRefs = uniqueStrings([
+        ...responsibility.eventRefs,
+        ...(reviewLane?.eventRefs ?? [])
+    ]);
+    const sidecarOnly = Boolean(responsibility.sidecarOnly || reviewLane?.sourceKind === "summon_evidence");
+    return {
+        id: `crew-lane-${responsibility.kind}`,
+        kind: responsibility.kind,
+        label: responsibility.label,
+        owner: responsibility.owner,
+        authority: laneAuthority(responsibility),
+        required: responsibility.required,
+        blocking: responsibility.blocking,
+        status: responsibility.status,
+        state: responsibility.state,
+        sourceKind: laneSourceKind(reviewLane),
+        summary: responsibility.reason,
+        responsibilityId: responsibility.id,
+        ...(reviewLane ? { reviewLaneId: reviewLane.id } : {}),
+        canSatisfyGate: responsibility.canSatisfyGate,
+        satisfiesRequired: satisfiesRequired(responsibility, reviewLane),
+        artifactRefs,
+        eventRefs,
+        handoffRefs: responsibility.handoffRefs,
+        sourceRefs: sourceRefsForResponsibility(run, responsibility, reviewLane),
+        ...(sidecarOnly ? { sidecarOnly: true } : {})
+    };
+};
+export const deriveCrewLaneTrail = (run) => {
+    const schedule = deriveLoopResponsibilitySchedule(run);
+    const reviewLanes = deriveReviewLanes(run);
+    const lanes = schedule.responsibilities.map((responsibility) => crewLaneFromResponsibility(run, responsibility, reviewLaneForResponsibility(responsibility, reviewLanes)));
+    return {
+        schemaVersion: 1,
+        kind: "crew_lane_trail",
+        runId: run.runId,
+        generatedAt: nowIso(),
+        phase: run.state,
+        lanes,
+        blockers: lanes.filter((lane) => lane.blocking)
+    };
+};
+//# sourceMappingURL=crewLanes.js.map

package/dist/runtime/crewLanes.js.map

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

package/dist/runtime/criticPolicy.d.ts

@@ -0,0 +1,17 @@
+import type { AgentResponse } from "../providers/types.js";
+import type { RuntimeRole } from "./types.js";
+export type CriticTriggerReasonCode = "qa_failed" | "qa_inconclusive" | "verifier_failed" | "verifier_inconclusive" | "validation_mismatch";
+export interface CriticTriggerDecision {
+    callCritic: boolean;
+    reasonCode?: CriticTriggerReasonCode;
+    reason?: string;
+    sourceRoles: RuntimeRole[];
+    evidenceRefs: string[];
+}
+export interface CriticTriggerInput {
+    qaResponse?: AgentResponse;
+    verifierResponse?: AgentResponse;
+    validationFailureCount?: number;
+    evidenceRefs?: string[];
+}
+export declare const decideCriticTrigger: (input: CriticTriggerInput) => CriticTriggerDecision;

package/dist/runtime/criticPolicy.js

@@ -0,0 +1,50 @@
+const isJsonObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const stringField = (value) => typeof value === "string" && value.trim().length > 0 ? value : undefined;
+const trigger = (reasonCode, reason, sourceRoles, evidenceRefs) => ({
+    callCritic: true,
+    reasonCode,
+    reason,
+    sourceRoles,
+    evidenceRefs
+});
+const noTrigger = (evidenceRefs) => ({
+    callCritic: false,
+    sourceRoles: [],
+    evidenceRefs
+});
+const qaVerdict = (response) => isJsonObject(response?.data.qaResult) ? stringField(response.data.qaResult.verdict) : undefined;
+const verifierVerdict = (response) => isJsonObject(response?.data.verificationResult) ? stringField(response.data.verificationResult.verdict) : undefined;
+export const decideCriticTrigger = (input) => {
+    const evidenceRefs = input.evidenceRefs ?? [];
+    if (input.verifierResponse?.status === "failed") {
+        return trigger("verifier_failed", "Verifier response failed before work could be accepted.", ["verifier"], evidenceRefs);
+    }
+    if (input.verifierResponse?.status === "blocked") {
+        return trigger("verifier_inconclusive", "Verifier response was blocked and needs an advisory critic review.", ["verifier"], evidenceRefs);
+    }
+    const verifier = verifierVerdict(input.verifierResponse);
+    if (verifier === "revise" || verifier === "abort") {
+        return trigger("verifier_failed", `Verifier returned ${verifier}; critic should review the revision risk.`, ["verifier"], evidenceRefs);
+    }
+    if (verifier === "ask_user") {
+        return trigger("verifier_inconclusive", "Verifier asked for user input; critic should review the unresolved evidence.", ["verifier"], evidenceRefs);
+    }
+    if ((input.validationFailureCount ?? 0) > 0) {
+        return trigger("validation_mismatch", "Runtime validation captured failing command evidence.", ["qa", "verifier"], evidenceRefs);
+    }
+    if (input.qaResponse?.status === "failed") {
+        return trigger("qa_failed", "QA tester response failed before verifier review.", ["qa"], evidenceRefs);
+    }
+    if (input.qaResponse?.status === "blocked") {
+        return trigger("qa_inconclusive", "QA tester response was blocked and could not confirm risk.", ["qa"], evidenceRefs);
+    }
+    const qa = qaVerdict(input.qaResponse);
+    if (qa === "needs_revision") {
+        return trigger("qa_failed", "QA tester requested revision before verifier review.", ["qa"], evidenceRefs);
+    }
+    if (qa === "needs_more_evidence" || qa === "blocked") {
+        return trigger("qa_inconclusive", "QA tester requested more evidence before verifier review.", ["qa"], evidenceRefs);
+    }
+    return noTrigger(evidenceRefs);
+};
+//# sourceMappingURL=criticPolicy.js.map

package/dist/runtime/criticPolicy.js.map

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

package/dist/runtime/defaults.d.ts

@@ -0,0 +1,5 @@
+import type { ProviderConfig, RoleMap, TheHoodConfig } from "./types.js";
+export declare const defaultProtectedTestPaths: string[];
+export declare const builtinProviders: Record<string, ProviderConfig>;
+export declare const defaultRoles: RoleMap;
+export declare const createDefaultConfig: () => TheHoodConfig;