@lannguyensi/harness 0.5.0

package/dist/policies/duration.js

@@ -0,0 +1,50 @@
+const SHORTHAND_RE = /^([0-9]+)(s|m|h|d)$/;
+const ISO_RE = /^P(?!$)(?:(\d+)Y)?(?:(\d+)M)?(?:(\d+)W)?(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?)?$/;
+const SECONDS = {
+    s: 1,
+    m: 60,
+    h: 60 * 60,
+    d: 24 * 60 * 60,
+};
+const ISO_SECONDS = {
+    year: 365 * 24 * 60 * 60,
+    month: 30 * 24 * 60 * 60,
+    week: 7 * 24 * 60 * 60,
+    day: 24 * 60 * 60,
+    hour: 60 * 60,
+    minute: 60,
+    second: 1,
+};
+export class InvalidDurationError extends Error {
+    value;
+    constructor(value) {
+        super(`invalid duration "${value}": expected shorthand like "24h" / "30m" / "7d" / "60s" or an ISO-8601 duration like "PT1H" / "P1D"`);
+        this.value = value;
+        this.name = "InvalidDurationError";
+    }
+}
+export function parseDurationSeconds(value) {
+    const trimmed = value.trim();
+    const short = SHORTHAND_RE.exec(trimmed);
+    if (short) {
+        const n = Number.parseInt(short[1], 10);
+        const unit = short[2];
+        return n * SECONDS[unit];
+    }
+    const iso = ISO_RE.exec(trimmed);
+    if (iso) {
+        const [, y, mo, w, d, h, mi, s] = iso;
+        const total = (Number(y ?? 0) * ISO_SECONDS.year) +
+            (Number(mo ?? 0) * ISO_SECONDS.month) +
+            (Number(w ?? 0) * ISO_SECONDS.week) +
+            (Number(d ?? 0) * ISO_SECONDS.day) +
+            (Number(h ?? 0) * ISO_SECONDS.hour) +
+            (Number(mi ?? 0) * ISO_SECONDS.minute) +
+            (Number(s ?? 0) * ISO_SECONDS.second);
+        if (total === 0)
+            throw new InvalidDurationError(value);
+        return total;
+    }
+    throw new InvalidDurationError(value);
+}
+//# sourceMappingURL=duration.js.map

package/dist/policies/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../../src/policies/duration.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAC3C,MAAM,MAAM,GACV,6FAA6F,CAAC;AAEhG,MAAM,OAAO,GAAG;IACd,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,EAAE;IACL,CAAC,EAAE,EAAE,GAAG,EAAE;IACV,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE;CACP,CAAC;AAEX,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IACxB,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IACxB,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IACtB,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE;IACjB,IAAI,EAAE,EAAE,GAAG,EAAE;IACb,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,CAAC;CACD,CAAC;AAEX,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACjB;IAA5B,YAA4B,KAAa;QACvC,KAAK,CACH,qBAAqB,KAAK,qGAAqG,CAChI,CAAC;QAHwB,UAAK,GAAL,KAAK,CAAQ;QAIvC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAyB,CAAC;QAC9C,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC;QACtC,MAAM,KAAK,GACT,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC;YACnC,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC;YACrC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC;YACnC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC;YAClC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC;YACnC,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC;YACtC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,KAAK,KAAK,CAAC;YAAE,MAAM,IAAI,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACvD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,oBAAoB,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/dist/policies/extract.d.ts

@@ -0,0 +1,50 @@
+declare const NAMESPACES: readonly ["toolArgs", "event", "session", "git"];
+type Namespace = (typeof NAMESPACES)[number];
+export declare class ExtractGrammarError extends Error {
+    readonly expression: string;
+    constructor(message: string, expression: string);
+}
+export type ExtractSegment = {
+    kind: "identifier";
+    key: string;
+} | {
+    kind: "bracket";
+    key: string;
+};
+export interface ExtractPath {
+    namespace: Namespace;
+    segments: ExtractSegment[];
+}
+export declare function parseExtractExpression(expr: string): ExtractPath;
+export declare function validateExtractGrammar(expr: string): void;
+export interface ExtractEventContext {
+    toolArgs?: unknown;
+    event?: unknown;
+    session?: unknown;
+    git?: unknown;
+}
+export interface ExtractBuiltins {
+    SESSION_ID: string;
+    REPO: string;
+    BRANCH: string;
+    TOOL_NAME: string;
+    CWD: string;
+}
+export type ExtractTraceSource = "extract" | "builtin" | "missing";
+export interface ExtractTraceEntry {
+    var: string;
+    expression: string;
+    resolved: string;
+    source: ExtractTraceSource;
+}
+export interface ExtractEvaluation {
+    values: Record<string, string>;
+    traceData: ExtractTraceEntry[];
+}
+export declare function evaluateExtract(extracts: Record<string, string>, ctx: ExtractEventContext, builtins: ExtractBuiltins): ExtractEvaluation;
+export interface SubstituteTemplateResult {
+    result: string;
+    missing: string[];
+}
+export declare function substituteTemplate(template: string, values: Record<string, string>): SubstituteTemplateResult;
+export {};

package/dist/policies/extract.js

@@ -0,0 +1,190 @@
+// Phase 4 #2 — trigger.extract evaluator
+//
+// TODO(Phase 4 #4): replace `src/schema/extract.ts` EXTRACT_ROOT_RE with
+// a `parseExtractExpression`-backed `.refine`. The schema today rejects the
+// bracket-quoted form this parser supports; #4 is when validate enhancements
+// land and the two surfaces get unified.
+//
+// Implements the JSONPath-restricted DSL described in ARCHITECTURE.md §6
+// "trigger.extract: generic variable extraction":
+//
+//   <namespace>.<segment>(<segment>)*
+//
+// where namespace ∈ { toolArgs, event, session, git } and a segment is either
+// `.identifier` or `["quoted key"]` (single or double quotes). The grammar
+// deliberately rejects function calls, numeric/slice indices, and any other
+// JSON-Path constructs so validate-time analysis stays statically decidable.
+const NAMESPACES = ["toolArgs", "event", "session", "git"];
+const NAMESPACE_RE = /^(toolArgs|event|session|git)\b/;
+const IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*/;
+const NUMERIC_INDEX_RE = /^-?\d/;
+export class ExtractGrammarError extends Error {
+    expression;
+    constructor(message, expression) {
+        super(`extract expression "${expression}": ${message}`);
+        this.expression = expression;
+        this.name = "ExtractGrammarError";
+    }
+}
+export function parseExtractExpression(expr) {
+    if (typeof expr !== "string" || expr.length === 0) {
+        throw new ExtractGrammarError("expression must be a non-empty string", String(expr));
+    }
+    const rootMatch = NAMESPACE_RE.exec(expr);
+    if (!rootMatch) {
+        const ident = IDENTIFIER_RE.exec(expr);
+        if (ident) {
+            throw new ExtractGrammarError(`unknown namespace \`${ident[0]}\``, expr);
+        }
+        throw new ExtractGrammarError("expression must begin with one of toolArgs / event / session / git", expr);
+    }
+    const namespace = rootMatch[1];
+    let i = rootMatch[0].length;
+    const segments = [];
+    while (i < expr.length) {
+        const ch = expr[i];
+        if (ch === ".") {
+            i++;
+            const id = IDENTIFIER_RE.exec(expr.slice(i));
+            if (!id) {
+                throw new ExtractGrammarError(`expected identifier after '.'`, expr);
+            }
+            i += id[0].length;
+            if (expr[i] === "(") {
+                throw new ExtractGrammarError("function calls not allowed", expr);
+            }
+            segments.push({ kind: "identifier", key: id[0] });
+        }
+        else if (ch === "[") {
+            i++;
+            const next = expr[i];
+            if (next === undefined) {
+                throw new ExtractGrammarError("unterminated bracket accessor", expr);
+            }
+            if (NUMERIC_INDEX_RE.test(next)) {
+                throw new ExtractGrammarError("array indices not allowed", expr);
+            }
+            if (next !== '"' && next !== "'") {
+                throw new ExtractGrammarError("bracket accessor must be a quoted string key", expr);
+            }
+            const quote = next;
+            i++;
+            const end = expr.indexOf(quote, i);
+            if (end === -1) {
+                throw new ExtractGrammarError("unterminated quoted bracket key", expr);
+            }
+            const key = expr.slice(i, end);
+            if (key.length === 0) {
+                throw new ExtractGrammarError("empty bracket key", expr);
+            }
+            i = end + 1;
+            if (expr[i] !== "]") {
+                throw new ExtractGrammarError("expected ']' after bracket key", expr);
+            }
+            i++;
+            segments.push({ kind: "bracket", key });
+        }
+        else if (ch === "(") {
+            throw new ExtractGrammarError("function calls not allowed", expr);
+        }
+        else {
+            throw new ExtractGrammarError(`unexpected character '${ch}'`, expr);
+        }
+    }
+    if (segments.length === 0) {
+        throw new ExtractGrammarError("expression must include at least one segment after the namespace", expr);
+    }
+    return { namespace, segments };
+}
+export function validateExtractGrammar(expr) {
+    parseExtractExpression(expr);
+}
+function walkPath(path, ctx) {
+    let cursor = ctx[path.namespace];
+    for (const seg of path.segments) {
+        if (cursor === undefined || cursor === null)
+            return undefined;
+        if (typeof cursor !== "object" || Array.isArray(cursor))
+            return undefined;
+        cursor = cursor[seg.key];
+    }
+    return cursor;
+}
+/**
+ * Stringify a resolved extract value for substitution into a `${VAR}` template.
+ * Strings pass through; numbers/booleans/bigints get `String(...)`. Objects and
+ * arrays fall through to `JSON.stringify` — uncommon for v1 paths but stable
+ * enough that audit / `explain --trace` consumers can rely on the shape.
+ */
+function stringifyResolved(value) {
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    if (typeof value === "bigint")
+        return value.toString();
+    return JSON.stringify(value);
+}
+const BUILTIN_NAMES = [
+    "SESSION_ID",
+    "REPO",
+    "BRANCH",
+    "TOOL_NAME",
+    "CWD",
+];
+export function evaluateExtract(extracts, ctx, builtins) {
+    const values = {};
+    const traceData = [];
+    // Builtins first; an extract entry with the same name overrides both the
+    // value and the trace row so the trace stays one-row-per-variable.
+    for (const name of BUILTIN_NAMES) {
+        if (Object.prototype.hasOwnProperty.call(extracts, name))
+            continue;
+        const v = builtins[name];
+        values[name] = v;
+        traceData.push({
+            var: name,
+            expression: `<builtin:${name}>`,
+            resolved: v,
+            source: "builtin",
+        });
+    }
+    for (const [varName, expr] of Object.entries(extracts)) {
+        const path = parseExtractExpression(expr);
+        const raw = walkPath(path, ctx);
+        if (raw === undefined || raw === null) {
+            const placeholder = `\${${varName}}`;
+            values[varName] = placeholder;
+            traceData.push({
+                var: varName,
+                expression: expr,
+                resolved: placeholder,
+                source: "missing",
+            });
+            continue;
+        }
+        const resolved = stringifyResolved(raw);
+        values[varName] = resolved;
+        traceData.push({
+            var: varName,
+            expression: expr,
+            resolved,
+            source: "extract",
+        });
+    }
+    return { values, traceData };
+}
+const TEMPLATE_VAR_RE = /\$\{([A-Z][A-Z0-9_]*)\}/g;
+export function substituteTemplate(template, values) {
+    const missing = [];
+    const result = template.replace(TEMPLATE_VAR_RE, (whole, name) => {
+        if (Object.prototype.hasOwnProperty.call(values, name)) {
+            return values[name];
+        }
+        if (!missing.includes(name))
+            missing.push(name);
+        return whole;
+    });
+    return { result, missing };
+}
+//# sourceMappingURL=extract.js.map

package/dist/policies/extract.js.map

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

package/dist/policies/index.d.ts

@@ -0,0 +1,5 @@
+export { evaluateRequires, RequiresEvaluationError, type EvaluateRequiresOptions, type LedgerEntry, type RequiresEvaluation, type RequiresTrace, } from "./requires.js";
+export { parseDurationSeconds, InvalidDurationError } from "./duration.js";
+export { parseLedgerTimestamp } from "./timestamp.js";
+export { queryLedgerByTag, type LedgerClientOptions, type LedgerQueryResult, type QueryLedgerOptions, } from "./ledger-client.js";
+export { validateExtractGrammar, parseExtractExpression, evaluateExtract, substituteTemplate, ExtractGrammarError, type ExtractBuiltins, type ExtractEventContext, type ExtractEvaluation, type ExtractPath, type ExtractSegment, type ExtractTraceEntry, type ExtractTraceSource, type SubstituteTemplateResult, } from "./extract.js";

package/dist/policies/index.js

@@ -0,0 +1,6 @@
+export { evaluateRequires, RequiresEvaluationError, } from "./requires.js";
+export { parseDurationSeconds, InvalidDurationError } from "./duration.js";
+export { parseLedgerTimestamp } from "./timestamp.js";
+export { queryLedgerByTag, } from "./ledger-client.js";
+export { validateExtractGrammar, parseExtractExpression, evaluateExtract, substituteTemplate, ExtractGrammarError, } from "./extract.js";
+//# sourceMappingURL=index.js.map

package/dist/policies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/policies/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,GAKxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EACL,gBAAgB,GAIjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,GASpB,MAAM,cAAc,CAAC"}

package/dist/policies/ledger-client.d.ts

@@ -0,0 +1,39 @@
+import type { LedgerEntry } from "./requires.js";
+export interface LedgerClientOptions {
+    /** argv[0..]: the grounding-mcp binary + flags. e.g. `["node", "/path/to/grounding-mcp/dist/server.js"]`. */
+    mcpCommand: string[];
+    /** Extra env merged onto process.env. */
+    mcpEnv?: Record<string, string>;
+    /** Working dir for the spawned server. */
+    cwd?: string;
+    /** Per-call timeout. Default 5 000 ms. */
+    timeoutMs?: number;
+}
+export interface QueryLedgerOptions extends LedgerClientOptions {
+    /** Required: grounding session whose entries should be returned. */
+    sessionId: string;
+    /**
+     * Phase 5 #5 — optional ISO-8601 UTC cutoff. When the connected
+     * grounding-mcp advertises support for `sinceIso` on `ledger_summary`
+     * (detected via tools/list), the filter is pushed server-side and
+     * the wire payload is narrowed to rows newer than the cutoff. Old
+     * servers silently ignore the option and the full session is
+     * returned, so consumers must continue to apply their own client-
+     * side window filter (this only ever reduces wire bytes).
+     */
+    sinceIso?: string;
+    /**
+     * Phase 5 #5 — optional content-prefix filter. Same shape as
+     * `sinceIso`: server-side narrowing only when supported, no
+     * contract change for client-side post-filtering.
+     */
+    contentPrefix?: string;
+}
+export type LedgerQueryResult = {
+    kind: "ok";
+    entries: LedgerEntry[];
+} | {
+    kind: "degraded";
+    reason: string;
+};
+export declare function queryLedgerByTag(opts: QueryLedgerOptions): Promise<LedgerQueryResult>;