@lannguyensi/harness 0.5.0

package/dist/cli/doctor/index.js

@@ -0,0 +1,281 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { inspectMemory } from "../../probes/memory.js";
+import { RealMcpProbe, probeAll, } from "../../probes/mcp.js";
+import { loadManifest } from "../loader.js";
+const HOME_PLACEHOLDER = "~";
+function expandHome(p, home) {
+    if (p === HOME_PLACEHOLDER)
+        return home;
+    if (p.startsWith("~/"))
+        return path.join(home, p.slice(2));
+    return p;
+}
+function isExecutable(filePath) {
+    try {
+        fs.accessSync(filePath, fs.constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function checkCli(manifest, opts) {
+    const out = [];
+    const pathEnv = opts.pathEnv ?? process.env.PATH ?? "";
+    const versionProbe = opts.versionProbe ?? (() => null);
+    for (const cli of manifest.tools.cli) {
+        let resolved;
+        if (path.isAbsolute(cli.binary)) {
+            resolved = fs.existsSync(cli.binary) && isExecutable(cli.binary) ? cli.binary : null;
+        }
+        else {
+            resolved = null;
+            for (const seg of pathEnv.split(path.delimiter)) {
+                if (!seg)
+                    continue;
+                const candidate = path.join(seg, cli.binary);
+                if (fs.existsSync(candidate) && isExecutable(candidate)) {
+                    resolved = candidate;
+                    break;
+                }
+            }
+        }
+        if (!resolved) {
+            out.push({
+                name: cli.name,
+                status: cli.required ? "error" : "warn",
+                message: cli.required
+                    ? `required binary not found: ${cli.binary}`
+                    : `binary not found on PATH: ${cli.binary}`,
+            });
+            continue;
+        }
+        if (!cli.min_version) {
+            out.push({ name: cli.name, status: "ok", message: "(no min_version configured)" });
+            continue;
+        }
+        const versionCmd = cli.version_command ?? [resolved, "--version"];
+        const stdout = versionProbe(versionCmd);
+        if (stdout === null) {
+            out.push({
+                name: cli.name,
+                status: "warn",
+                message: `version probe failed for ${versionCmd.join(" ")}`,
+            });
+            continue;
+        }
+        const m = stdout.match(/(\d+(?:\.\d+){0,3})/);
+        if (!m || !m[1]) {
+            out.push({
+                name: cli.name,
+                status: "warn",
+                message: `could not parse a version from "${stdout.trim()}"`,
+            });
+            continue;
+        }
+        const actual = m[1];
+        const cmp = compareVersions(actual, cli.min_version);
+        if (cmp < 0) {
+            out.push({
+                name: cli.name,
+                status: "error",
+                message: `installed v${actual} < required ${cli.min_version}`,
+            });
+        }
+        else {
+            out.push({
+                name: cli.name,
+                status: "ok",
+                message: `v${actual} ≥ ${cli.min_version}`,
+            });
+        }
+    }
+    return out;
+}
+function compareVersions(a, b) {
+    const aa = a.split(".").map((n) => Number.parseInt(n, 10));
+    const bb = b.split(".").map((n) => Number.parseInt(n, 10));
+    const len = Math.max(aa.length, bb.length);
+    for (let i = 0; i < len; i++) {
+        const ai = aa[i] ?? 0;
+        const bi = bb[i] ?? 0;
+        if (Number.isNaN(ai) || Number.isNaN(bi))
+            return 0;
+        if (ai > bi)
+            return 1;
+        if (ai < bi)
+            return -1;
+    }
+    return 0;
+}
+function checkSkills(manifest, home) {
+    const enabled = manifest.tools.skills.enabled;
+    const required = manifest.tools.skills.required ?? [];
+    const missing = [];
+    for (const skill of required) {
+        let found = false;
+        for (const dir of manifest.tools.skills.source_dirs) {
+            const candidate = path.join(expandHome(dir, home), skill, "SKILL.md");
+            if (fs.existsSync(candidate)) {
+                found = true;
+                break;
+            }
+        }
+        if (!found)
+            missing.push(skill);
+    }
+    return { enabled, missing };
+}
+function checkHooks(manifest, home) {
+    return manifest.hooks.map((hook) => {
+        const blockingLabel = hook.blocking === false ? "false" : hook.blocking;
+        const first = hook.command.trim().split(/\s+/)[0] ?? "";
+        if (!path.isAbsolute(first) && first !== HOME_PLACEHOLDER && !first.startsWith("~/")) {
+            return {
+                name: hook.name,
+                event: hook.event,
+                blocking: blockingLabel,
+                status: "ok",
+            };
+        }
+        const resolved = expandHome(first, home);
+        if (!fs.existsSync(resolved)) {
+            return {
+                name: hook.name,
+                event: hook.event,
+                blocking: blockingLabel,
+                status: "error",
+                message: `path does not exist: ${resolved}`,
+            };
+        }
+        const stat = fs.statSync(resolved);
+        if (!stat.isFile()) {
+            return {
+                name: hook.name,
+                event: hook.event,
+                blocking: blockingLabel,
+                status: "error",
+                message: `not a regular file: ${resolved}`,
+            };
+        }
+        if (!isExecutable(resolved)) {
+            return {
+                name: hook.name,
+                event: hook.event,
+                blocking: blockingLabel,
+                status: "error",
+                message: `not executable: ${resolved}`,
+            };
+        }
+        return {
+            name: hook.name,
+            event: hook.event,
+            blocking: blockingLabel,
+            status: "ok",
+        };
+    });
+}
+function buildPolicies(manifest) {
+    return manifest.policies.map((p) => ({
+        name: p.name,
+        schemaValid: true,
+        caveat: "schema valid; last-evaluated tracking ships in Phase 4",
+    }));
+}
+function manifestSection(manifest) {
+    const topLevelKeys = ["grounding", "tools", "memory", "hooks", "policies"];
+    const present = topLevelKeys.filter((k) => manifest[k] !== undefined).length;
+    return {
+        syntaxValid: true,
+        schemaValid: true,
+        topLevelKeysPresent: present,
+        warnings: [],
+    };
+}
+function countDiagnostics(report) {
+    let errorCount = 0;
+    let warningCount = 0;
+    warningCount += report.manifest.warnings.length;
+    for (const m of report.tools.mcp) {
+        if (m.outcome.kind === "error")
+            errorCount++;
+    }
+    for (const c of report.tools.cli) {
+        if (c.status === "error")
+            errorCount++;
+        else if (c.status === "warn")
+            warningCount++;
+    }
+    errorCount += report.tools.skillsRequiredMissing.length;
+    for (const h of report.hooks) {
+        if (h.status === "error")
+            errorCount++;
+        else if (h.status === "warn")
+            warningCount++;
+    }
+    if (report.memory.routerExecutable && !report.memory.routerExecutable.exists)
+        errorCount++;
+    if (!report.memory.routerExecutable)
+        warningCount++;
+    for (const d of report.memory.directories) {
+        if (!d.exists)
+            warningCount++;
+    }
+    if (report.memory.staleMemories.length > 0)
+        warningCount++;
+    return { errorCount, warningCount };
+}
+export async function doctor(opts = {}) {
+    const { manifest, resolved } = loadManifest(opts);
+    const home = opts.homeOverride ?? opts.homeDir ?? os.homedir();
+    const probe = opts.mcpProbe ?? new RealMcpProbe();
+    const mcpResults = opts.shallow
+        ? manifest.tools.mcp.map((s) => ({
+            name: s.name,
+            outcome: s.enabled === false
+                ? { kind: "disabled" }
+                : s.health
+                    ? { kind: "healthy", latencyMs: 0 }
+                    : { kind: "missing-verb" },
+        }))
+        : await probeAll(manifest.tools.mcp.filter((s) => s.enabled !== false), probe).then((live) => {
+            const map = new Map(live.map((r) => [r.name, r]));
+            return manifest.tools.mcp.map((s) => map.get(s.name) ?? {
+                name: s.name,
+                outcome: { kind: "disabled" },
+            });
+        });
+    const cli = checkCli(manifest, opts);
+    const skills = checkSkills(manifest, home);
+    const tools = {
+        mcp: mcpResults,
+        cli,
+        skillsEnabled: skills.enabled,
+        skillsRequiredMissing: skills.missing,
+    };
+    const memory = inspectMemory(manifest, {
+        homeDir: home,
+        project: opts.project,
+        now: opts.now,
+    });
+    const hooks = checkHooks(manifest, home);
+    const policies = buildPolicies(manifest);
+    const manifestSec = manifestSection(manifest);
+    const partial = {
+        manifestPath: resolved.base,
+        manifestVersion: manifest.version,
+        project: opts.project ?? null,
+        shallow: !!opts.shallow,
+        manifest: manifestSec,
+        tools,
+        memory,
+        hooks,
+        policies,
+    };
+    const counts = countDiagnostics(partial);
+    return { ...partial, ...counts };
+}
+export { format } from "./format.js";
+//# sourceMappingURL=index.js.map

package/dist/cli/doctor/index.js.map

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

package/dist/cli/doctor/types.d.ts

@@ -0,0 +1,46 @@
+import type { McpProbeResult } from "../../probes/mcp.js";
+import type { MemoryReport, StaleMemory } from "../../probes/memory.js";
+import type { Manifest } from "../../schema/index.js";
+export interface ManifestSection {
+    syntaxValid: boolean;
+    schemaValid: boolean;
+    topLevelKeysPresent: number;
+    warnings: string[];
+}
+export interface CliEntryReport {
+    name: string;
+    status: "ok" | "warn" | "error";
+    message: string;
+}
+export interface ToolsSection {
+    mcp: McpProbeResult[];
+    cli: CliEntryReport[];
+    skillsEnabled: string[];
+    skillsRequiredMissing: string[];
+}
+export interface HookEntryReport {
+    name: string;
+    event: string;
+    blocking: string;
+    status: "ok" | "warn" | "error";
+    message?: string;
+}
+export interface PolicyEntryReport {
+    name: string;
+    schemaValid: boolean;
+    caveat: string;
+}
+export interface DoctorReport {
+    manifestPath: string;
+    manifestVersion: number;
+    project: string | null;
+    shallow: boolean;
+    manifest: ManifestSection;
+    tools: ToolsSection;
+    memory: MemoryReport;
+    hooks: HookEntryReport[];
+    policies: PolicyEntryReport[];
+    errorCount: number;
+    warningCount: number;
+}
+export type { Manifest, McpProbeResult, MemoryReport, StaleMemory };

package/dist/cli/doctor/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/doctor/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/doctor/types.ts"],"names":[],"mappings":""}

package/dist/cli/dry-run.d.ts

@@ -0,0 +1,46 @@
+import { type ExtractBuiltins } from "../policies/index.js";
+import type { Policy } from "../schema/index.js";
+import { type LoaderOptions } from "./loader.js";
+export interface DryRunOptions extends LoaderOptions {
+    json?: boolean;
+    /** Tool name to simulate; required for `PreToolUse` matching. */
+    tool?: string;
+    /** JSON string for `tool_input`. Parsed once and threaded into the extract context. */
+    toolArgs?: string;
+    /** Override builtins (tests). */
+    builtins?: Partial<ExtractBuiltins>;
+}
+export interface DryRunHookHit {
+    event: string;
+    name: string;
+}
+export interface DryRunPolicyHit {
+    name: string;
+    ledgerQuery: string;
+    requires: Policy["requires"];
+    enforcement: Policy["enforcement"];
+    triggerEvent: string;
+}
+export interface DryRunPolicyCouldHit {
+    name: string;
+    triggerEvent: string;
+    reason: string;
+}
+export interface DryRunMemoryDir {
+    path: string;
+    scope: string;
+}
+export interface DryRunReport {
+    prompt: string;
+    tool: string | null;
+    toolArgs: unknown;
+    hooks: DryRunHookHit[];
+    matchingPolicies: DryRunPolicyHit[];
+    couldMatchPolicies: DryRunPolicyCouldHit[];
+    memoryDirectories: DryRunMemoryDir[];
+}
+export interface DryRunResult {
+    output: string;
+    report: DryRunReport;
+}
+export declare function dryRun(prompt: string, opts?: DryRunOptions): DryRunResult;

package/dist/cli/dry-run.js

@@ -0,0 +1,168 @@
+import { stringify as stringifyYaml } from "yaml";
+import { evaluateExtract, substituteTemplate, } from "../policies/index.js";
+import { EX_USAGE, HarnessExitError } from "./exit-codes.js";
+import { loadManifest } from "./loader.js";
+const PROMPT_EVENTS = new Set(["UserPromptSubmit", "SessionStart"]);
+function builtinsFor(opts, tool) {
+    const fromOpts = opts.builtins ?? {};
+    return {
+        SESSION_ID: fromOpts.SESSION_ID ?? "dry-run",
+        REPO: fromOpts.REPO ?? "",
+        BRANCH: fromOpts.BRANCH ?? "",
+        TOOL_NAME: fromOpts.TOOL_NAME ?? (tool ?? ""),
+        CWD: fromOpts.CWD ?? process.cwd(),
+    };
+}
+function policyMatchesPrompt(policy, prompt) {
+    if (!PROMPT_EVENTS.has(policy.trigger.event))
+        return false;
+    if (policy.trigger.match !== undefined) {
+        return prompt.includes(policy.trigger.match);
+    }
+    return true;
+}
+function policyMatchesTool(policy, tool, toolInput) {
+    if (policy.trigger.event !== "PreToolUse") {
+        return { matched: false, reason: `trigger event is ${policy.trigger.event}, not PreToolUse` };
+    }
+    if (policy.trigger.match !== undefined && !tool.includes(policy.trigger.match)) {
+        return {
+            matched: false,
+            reason: `--tool "${tool}" does not contain trigger.match "${policy.trigger.match}"`,
+        };
+    }
+    if (policy.trigger.bash_match !== undefined) {
+        const args = toolInput;
+        if (!args || typeof args.command !== "string") {
+            return {
+                matched: false,
+                reason: "trigger.bash_match needs tool_input.command",
+            };
+        }
+        let re;
+        try {
+            re = new RegExp(policy.trigger.bash_match);
+        }
+        catch {
+            return { matched: false, reason: `trigger.bash_match is not a valid regex` };
+        }
+        if (!re.test(args.command)) {
+            return {
+                matched: false,
+                reason: `bash_match "${policy.trigger.bash_match}" did not match`,
+            };
+        }
+    }
+    return { matched: true };
+}
+function buildHookHits(manifest, tool) {
+    const hits = [];
+    for (const hook of manifest.hooks) {
+        if (PROMPT_EVENTS.has(hook.event)) {
+            hits.push({ event: hook.event, name: hook.name });
+            continue;
+        }
+        if (tool !== null && hook.event === "PreToolUse") {
+            hits.push({ event: hook.event, name: hook.name });
+        }
+    }
+    return hits;
+}
+function staticLedgerQuery(policy, ctx, builtins) {
+    const extract = evaluateExtract(policy.trigger.extract ?? {}, ctx, builtins);
+    const sub = substituteTemplate(policy.requires.ledger_tag, extract.values);
+    return sub.result;
+}
+function formatYaml(report) {
+    // Hide raw `null` from YAML output for the no-tool case.
+    const visible = {
+        prompt: report.prompt,
+        ...(report.tool !== null && { tool: report.tool }),
+        ...(report.tool !== null && report.toolArgs !== undefined && {
+            toolArgs: report.toolArgs,
+        }),
+        "Hooks that would fire": report.hooks.length === 0 ? "(none)" : report.hooks,
+        "Policies that match": report.matchingPolicies.length === 0 ? "(none)" : report.matchingPolicies,
+        "Policies that COULD match (need --tool)": report.couldMatchPolicies.length === 0 ? "(none)" : report.couldMatchPolicies,
+        "Memories that would route": report.memoryDirectories.length === 0 ? "(none)" : report.memoryDirectories,
+    };
+    return stringifyYaml(visible, { lineWidth: 0 });
+}
+export function dryRun(prompt, opts = {}) {
+    const { manifest } = loadManifest(opts);
+    const tool = opts.tool ?? null;
+    let toolArgs = undefined;
+    if (opts.toolArgs !== undefined) {
+        try {
+            toolArgs = JSON.parse(opts.toolArgs);
+        }
+        catch (err) {
+            throw new HarnessExitError(`--tool-args: ${err.message}`, EX_USAGE);
+        }
+    }
+    const builtins = builtinsFor(opts, tool);
+    const ctx = {
+        toolArgs,
+        event: { hook_event_name: tool ? "PreToolUse" : "UserPromptSubmit", tool_name: tool, prompt },
+        session: { id: builtins.SESSION_ID },
+        git: {},
+    };
+    const hooks = buildHookHits(manifest, tool);
+    const matching = [];
+    const couldMatch = [];
+    for (const policy of manifest.policies) {
+        if (PROMPT_EVENTS.has(policy.trigger.event)) {
+            if (policyMatchesPrompt(policy, prompt)) {
+                matching.push({
+                    name: policy.name,
+                    ledgerQuery: staticLedgerQuery(policy, ctx, builtins),
+                    requires: policy.requires,
+                    enforcement: policy.enforcement,
+                    triggerEvent: policy.trigger.event,
+                });
+            }
+            continue;
+        }
+        // PreToolUse and friends.
+        if (tool === null) {
+            couldMatch.push({
+                name: policy.name,
+                triggerEvent: policy.trigger.event,
+                reason: "no --tool supplied; dry-run can only statically match prompt-style events",
+            });
+            continue;
+        }
+        const verdict = policyMatchesTool(policy, tool, toolArgs);
+        if (verdict.matched) {
+            matching.push({
+                name: policy.name,
+                ledgerQuery: staticLedgerQuery(policy, ctx, builtins),
+                requires: policy.requires,
+                enforcement: policy.enforcement,
+                triggerEvent: policy.trigger.event,
+            });
+        }
+        else {
+            couldMatch.push({
+                name: policy.name,
+                triggerEvent: policy.trigger.event,
+                reason: verdict.reason,
+            });
+        }
+    }
+    const memoryDirectories = manifest.memory.directories.map((d) => ({ path: d.path, scope: d.scope }));
+    const report = {
+        prompt,
+        tool,
+        toolArgs,
+        hooks,
+        matchingPolicies: matching,
+        couldMatchPolicies: couldMatch,
+        memoryDirectories,
+    };
+    const output = opts.json
+        ? `${JSON.stringify(report, null, 2)}\n`
+        : formatYaml(report);
+    return { output, report };
+}
+//# sourceMappingURL=dry-run.js.map

package/dist/cli/dry-run.js.map

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

package/dist/cli/exit-codes.d.ts

@@ -0,0 +1,10 @@
+export declare const EX_OK = 0;
+export declare const EX_FAIL = 1;
+export declare const EX_USAGE = 64;
+export declare const EX_NOINPUT = 66;
+export declare const EX_UNAVAILABLE = 69;
+export declare const EX_SOFTWARE = 70;
+export declare class HarnessExitError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode: number);
+}

package/dist/cli/exit-codes.js

@@ -0,0 +1,15 @@
+export const EX_OK = 0;
+export const EX_FAIL = 1;
+export const EX_USAGE = 64;
+export const EX_NOINPUT = 66;
+export const EX_UNAVAILABLE = 69;
+export const EX_SOFTWARE = 70;
+export class HarnessExitError extends Error {
+    exitCode;
+    constructor(message, exitCode) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = "HarnessExitError";
+    }
+}
+//# sourceMappingURL=exit-codes.js.map

package/dist/cli/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../src/cli/exit-codes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC;AACvB,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AACzB,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC;AAC3B,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAC7B,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAE9B,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACI;IAA7C,YAAY,OAAe,EAAkB,QAAgB;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,aAAQ,GAAR,QAAQ,CAAQ;QAE3D,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}

package/dist/cli/explain.d.ts

@@ -0,0 +1,14 @@
+import { type LedgerQueryResult } from "../policies/index.js";
+import { type LoaderOptions } from "./loader.js";
+export interface ExplainOptions extends LoaderOptions {
+    json?: boolean;
+    trace?: boolean;
+    /** Session whose audit log to inspect for `--trace`. */
+    sessionId?: string;
+    /** Override the ledger fetcher (tests). */
+    fetchLedger?: (sessionId: string) => Promise<LedgerQueryResult>;
+}
+export interface ExplainResult {
+    output: string;
+}
+export declare function explain(policyName: string, opts?: ExplainOptions): Promise<ExplainResult>;