@jinn-network/client 0.1.2 → 0.1.3-canary.24b69ea4

package/dist/templates/harnesses/forecaster/package.json.tmpl

@@ -0,0 +1,26 @@
+{
+  "name": "{{packageName}}",
+  "version": "0.1.0",
+  "description": "Jinn external harness impl for {{solverTypeString}}.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist/", "jinn.manifest.json", "README.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@jinn-network/sdk": "^0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "vitest": "^2.1.9"
+  }
+}

package/dist/templates/harnesses/forecaster/src/index.ts.tmpl

@@ -0,0 +1,33 @@
+import type {
+  Harness,
+  ExternalHarnessEnv,
+  HarnessContext,
+  Solution,
+} from '@jinn-network/sdk/harness';
+
+export default function createHarness(env: ExternalHarnessEnv): Harness {
+  return {
+    name: env.implName,
+    version: env.implVersion,
+    supports({ solverType, role }) {
+      return solverType === '{{solverTypeString}}' && role !== 'evaluation';
+    },
+    async isReady() {
+      return env.stub
+        ? { ready: false, reason: 'stub mode' }
+        : { ready: true };
+    },
+    async run(ctx: HarnessContext): Promise<Solution> {
+      env.log({
+        level: 'info',
+        msg: 'forecaster.run',
+        data: { taskId: ctx.task.id },
+      });
+      // TODO: call your existing forecasting pipeline here.
+      return {
+        venueRef: { name: '{{packageName}}' },
+        gating: { probability: 0.5 },
+      };
+    },
+  };
+}

package/dist/templates/harnesses/forecaster/test/unit.test.ts.tmpl

@@ -0,0 +1,42 @@
+import { describe, it, expect } from 'vitest';
+import createHarness from '../src/index.js';
+import type {
+  ExternalHarnessEnv,
+  HarnessContext,
+} from '@jinn-network/sdk/harness';
+
+const env: ExternalHarnessEnv = {
+  implName: '{{packageName}}',
+  implVersion: '0.1.0',
+  network: '{{network}}',
+  implStateDir: '/tmp/{{packageNameSlug}}',
+  secrets: Object.freeze({}),
+  log: () => {},
+  stub: false,
+};
+
+const ctx: HarnessContext = {
+  task: { id: 'test', description: 'test', solverType: '{{solverTypeString}}', spec: {} },
+  taskCid: undefined,
+  implStateDir: '/tmp/{{packageNameSlug}}',
+  workingDir: '/tmp/{{packageNameSlug}}-work',
+  log: () => {},
+  abort: new AbortController().signal,
+  msUntilEndTs: () => 60_000,
+  trajectory: { addSpan: () => ({}) },
+};
+
+describe('{{packageName}}', () => {
+  it('supports the configured SolverType', () => {
+    const impl = createHarness(env);
+    expect(impl.supports({ solverType: '{{solverTypeString}}' })).toBe(true);
+    expect(impl.supports({ solverType: 'other.v0' })).toBe(false);
+  });
+
+  it('produces a Solution with a probability', async () => {
+    const impl = createHarness(env);
+    const out = await impl.run(ctx);
+    expect(out.gating).toHaveProperty('probability');
+    expect(typeof out.gating.probability).toBe('number');
+  });
+});

package/dist/templates/harnesses/forecaster/tsconfig.json.tmpl

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "lib": ["ES2022", "DOM"],
+    "types": []
+  },
+  "include": ["src/**/*"]
+}

package/dist/trajectory/collector.d.ts

@@ -0,0 +1,59 @@
+/**
+ * TrajectoryCollector — in-memory span accumulator.
+ *
+ * Invariants (enforced on add):
+ *   - span.traceId is shared across all spans in a run (set at construction)
+ *   - span.spanId is 16 hex chars unique per span
+ *   - span.attributes['jinn.prevSpanHash'] is set to genesis (for first span)
+ *     or the keccak256(JCS(previous finalized span)) on add — callers do NOT
+ *     set it.
+ *   - span.attributes['jinn.span.kind'] MUST be supplied by the caller.
+ *   - secrets are scrubbed from BOTH span.attributes AND span.events[*].attributes
+ *     before the span is appended; redacted keys are recorded against this
+ *     span's spanId in the redactionManifest.
+ */
+import type { SpanProcessor } from '@opentelemetry/sdk-trace-base';
+import type { Span, RedactionManifest } from './schema.js';
+export interface CollectorInit {
+    taskCid: string;
+    runId: string;
+    /** Override for tests. Defaults to randomBytes(16). */
+    traceId?: string;
+    /**
+     * Optional OpenTelemetry processor chain. The collector keeps the existing
+     * in-memory trajectory API, but finalized spans flow through these processors
+     * before being appended. This is the compatibility bridge while harnesses are
+     * migrated to native OTel emission.
+     */
+    processors?: SpanProcessor[];
+}
+/** Caller-supplied span input. Omits chain + id fields the collector assigns. */
+export interface SpanInput {
+    name: string;
+    kind: Span['kind'];
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes: Record<string, unknown>;
+    events: Span['events'];
+    status: Span['status'];
+    parentSpanId?: string | null;
+}
+export declare class TrajectoryCollector {
+    readonly runId: string;
+    readonly taskCid: string;
+    private readonly traceId;
+    private readonly spans;
+    private readonly redactionEntries;
+    private readonly processors;
+    private totalRedactions;
+    private lastSpanHash;
+    constructor(init: CollectorInit);
+    /** Append a span; returns the finalized span (with assigned ids + chain hash). */
+    addSpan(input: SpanInput): Span;
+    /** Immutable snapshot for emit / tests. */
+    snapshot(): {
+        spans: Span[];
+        redactionManifest: RedactionManifest;
+    };
+    private runProcessors;
+}

package/dist/trajectory/collector.js

@@ -0,0 +1,164 @@
+/**
+ * TrajectoryCollector — in-memory span accumulator.
+ *
+ * Invariants (enforced on add):
+ *   - span.traceId is shared across all spans in a run (set at construction)
+ *   - span.spanId is 16 hex chars unique per span
+ *   - span.attributes['jinn.prevSpanHash'] is set to genesis (for first span)
+ *     or the keccak256(JCS(previous finalized span)) on add — callers do NOT
+ *     set it.
+ *   - span.attributes['jinn.span.kind'] MUST be supplied by the caller.
+ *   - secrets are scrubbed from BOTH span.attributes AND span.events[*].attributes
+ *     before the span is appended; redacted keys are recorded against this
+ *     span's spanId in the redactionManifest.
+ */
+import { randomBytes } from 'node:crypto';
+import { SpanKind, SpanStatusCode } from '@opentelemetry/api';
+import { computeGenesisHash, computePrevSpanHash } from './hash-chain.js';
+import { scrubAttributes } from './secret-scrub.js';
+function hex(bytes) {
+    return randomBytes(bytes).toString('hex');
+}
+export class TrajectoryCollector {
+    runId;
+    taskCid;
+    traceId;
+    spans = [];
+    redactionEntries = [];
+    processors;
+    totalRedactions = 0;
+    lastSpanHash;
+    constructor(init) {
+        this.runId = init.runId;
+        this.taskCid = init.taskCid;
+        this.traceId = init.traceId ?? hex(16);
+        this.processors = init.processors ?? [];
+        this.lastSpanHash = computeGenesisHash(init.taskCid);
+    }
+    /** Append a span; returns the finalized span (with assigned ids + chain hash). */
+    addSpan(input) {
+        if (typeof input.attributes['jinn.span.kind'] !== 'string') {
+            throw new Error('TrajectoryCollector.addSpan: jinn.span.kind attribute required');
+        }
+        const { scrubbed, redactedKeys } = scrubAttributes(input.attributes);
+        // Scrub event attributes — raw subprocess output (and any other event data)
+        // can contain tokens, passwords, or private keys in their attribute values.
+        const scrubbedEvents = input.events.map((event) => {
+            if (!event.attributes || Object.keys(event.attributes).length === 0)
+                return event;
+            const { scrubbed: scrubbedAttrs, redactedKeys: eventRedacted } = scrubAttributes(event.attributes);
+            for (const k of eventRedacted) {
+                redactedKeys.push(k);
+            }
+            return { ...event, attributes: scrubbedAttrs };
+        });
+        const span = {
+            traceId: this.traceId,
+            spanId: hex(8),
+            parentSpanId: input.parentSpanId ?? null,
+            name: input.name,
+            kind: input.kind,
+            startTimeUnixNano: input.startTimeUnixNano,
+            endTimeUnixNano: input.endTimeUnixNano,
+            attributes: {
+                ...scrubbed,
+                'jinn.prevSpanHash': this.lastSpanHash,
+            },
+            events: scrubbedEvents,
+            status: input.status,
+        };
+        this.runProcessors(span);
+        this.spans.push(span);
+        this.lastSpanHash = computePrevSpanHash(span);
+        if (redactedKeys.length > 0) {
+            this.redactionEntries.push({ spanId: span.spanId, redactedKeys });
+            this.totalRedactions += redactedKeys.length;
+        }
+        return span;
+    }
+    /** Immutable snapshot for emit / tests. */
+    snapshot() {
+        return {
+            spans: this.spans.slice(),
+            redactionManifest: {
+                spans: this.redactionEntries.slice(),
+                totalRedactions: this.totalRedactions,
+            },
+        };
+    }
+    runProcessors(span) {
+        if (this.processors.length === 0)
+            return;
+        const readable = toReadableSpan(span);
+        for (const processor of this.processors) {
+            processor.onEnd(readable);
+        }
+    }
+}
+function toHrTime(ns) {
+    const n = BigInt(ns);
+    return [Number(n / 1000000000n), Number(n % 1000000000n)];
+}
+function toApiKind(kind) {
+    switch (kind) {
+        case 'CLIENT':
+            return SpanKind.CLIENT;
+        case 'SERVER':
+            return SpanKind.SERVER;
+        case 'PRODUCER':
+            return SpanKind.PRODUCER;
+        case 'CONSUMER':
+            return SpanKind.CONSUMER;
+        case 'INTERNAL':
+        default:
+            return SpanKind.INTERNAL;
+    }
+}
+function toApiStatus(code) {
+    switch (code) {
+        case 'OK':
+            return SpanStatusCode.OK;
+        case 'ERROR':
+            return SpanStatusCode.ERROR;
+        case 'UNSET':
+        default:
+            return SpanStatusCode.UNSET;
+    }
+}
+function toReadableSpan(span) {
+    const context = {
+        traceId: span.traceId,
+        spanId: span.spanId,
+        traceFlags: 0,
+    };
+    return {
+        name: span.name,
+        kind: toApiKind(span.kind),
+        spanContext: () => context,
+        parentSpanContext: span.parentSpanId
+            ? { traceId: span.traceId, spanId: span.parentSpanId, traceFlags: 0 }
+            : undefined,
+        startTime: toHrTime(span.startTimeUnixNano),
+        endTime: toHrTime(span.endTimeUnixNano),
+        status: {
+            code: toApiStatus(span.status.code),
+            message: span.status.message,
+        },
+        attributes: span.attributes,
+        events: span.events.map((event) => ({
+            name: event.name,
+            time: toHrTime(event.timeUnixNano),
+            attributes: event.attributes ?? {},
+            droppedAttributesCount: 0,
+        })),
+        links: [],
+        duration: toHrTime((BigInt(span.endTimeUnixNano) - BigInt(span.startTimeUnixNano)).toString()),
+        ended: true,
+        resource: { attributes: {} },
+        instrumentationScope: { name: '@jinn-network/trajectory-collector' },
+        droppedAttributesCount: 0,
+        droppedEventsCount: 0,
+        droppedLinksCount: 0,
+    };
+}
+//# sourceMappingURL=collector.js.map

package/dist/trajectory/collector.js.map

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

package/dist/trajectory/emit.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Emit a signed jinn.trajectory.v1 blob and upload it to IPFS.
+ *
+ * Signing mirrors envelope-assembly.ts (§4.2a mechanics):
+ *   hash = keccak256(JCS(trajectory minus signature))
+ *   → signed with agent EOA key
+ *   → signed blob uploaded to IPFS
+ *   → { cid, sha256 } returned for the envelope.
+ */
+import { type Hex } from 'viem';
+import { type ArtifactScrubConfig } from '../harnesses/engine/artifact-scrub.js';
+import type { TrajectoryCollector } from './collector.js';
+import type { JinnTrajectoryV1 } from './schema.js';
+export interface EmitTrajectoryParams {
+    collector: TrajectoryCollector;
+    runId: string;
+    /** Set to the parent restoration envelope CID for a verdict trajectory; null otherwise. */
+    parentEnvelopeCid?: string | null;
+    signerPrivateKey: Hex;
+    signerAddress: `0x${string}`;
+    ipfsRegistryUrl: string;
+    scrub?: ArtifactScrubConfig;
+}
+export interface EmitTrajectoryResult {
+    cid: string;
+    sha256: string;
+    signed: JinnTrajectoryV1;
+}
+export declare function emitTrajectory(p: EmitTrajectoryParams): Promise<EmitTrajectoryResult>;

package/dist/trajectory/emit.js

@@ -0,0 +1,81 @@
+/**
+ * Emit a signed jinn.trajectory.v1 blob and upload it to IPFS.
+ *
+ * Signing mirrors envelope-assembly.ts (§4.2a mechanics):
+ *   hash = keccak256(JCS(trajectory minus signature))
+ *   → signed with agent EOA key
+ *   → signed blob uploaded to IPFS
+ *   → { cid, sha256 } returned for the envelope.
+ */
+import { createHash } from 'node:crypto';
+import { signCanonical } from '../harnesses/engine/signing.js';
+import { uploadToIpfs } from '../adapters/mech/ipfs.js';
+import { scrubArtifactBytes, } from '../harnesses/engine/artifact-scrub.js';
+function sha256Hex(bytes) {
+    return createHash('sha256').update(bytes, 'utf8').digest('hex');
+}
+function scrubSpan(span, scrub) {
+    const result = scrubArtifactBytes(Buffer.from(JSON.stringify(span), 'utf8'), scrub);
+    if (result.bytes.length === 0)
+        return { span, redactedKeys: [] };
+    try {
+        return {
+            span: JSON.parse(result.bytes.toString('utf8')),
+            redactedKeys: result.redactedKeys,
+        };
+    }
+    catch {
+        return { span, redactedKeys: [] };
+    }
+}
+function scrubSnapshot(spans, redactionManifest, scrub) {
+    if (!scrub)
+        return { spans, redactionManifest };
+    const scrubbedSpans = [];
+    const extraManifestEntries = [];
+    let extraRedactions = 0;
+    for (const span of spans) {
+        const result = scrubSpan(span, scrub);
+        scrubbedSpans.push(result.span);
+        if (result.redactedKeys.length > 0) {
+            extraManifestEntries.push({
+                spanId: span.spanId,
+                redactedKeys: result.redactedKeys.map((key) => `trajectory.${key}`),
+            });
+            extraRedactions += result.redactedKeys.length;
+        }
+    }
+    return {
+        spans: scrubbedSpans,
+        redactionManifest: {
+            spans: [...redactionManifest.spans, ...extraManifestEntries],
+            totalRedactions: redactionManifest.totalRedactions + extraRedactions,
+        },
+    };
+}
+export async function emitTrajectory(p) {
+    const snap = p.collector.snapshot();
+    const scrubbed = scrubSnapshot(snap.spans, snap.redactionManifest, p.scrub);
+    const unsigned = {
+        schemaVersion: 'jinn.trajectory.v1',
+        runId: p.runId,
+        parentEnvelopeCid: p.parentEnvelopeCid ?? null,
+        spans: scrubbed.spans,
+        redactionManifest: scrubbed.redactionManifest,
+    };
+    const sig = await signCanonical(unsigned, p.signerPrivateKey, p.signerAddress);
+    const signed = {
+        ...unsigned,
+        signature: {
+            algo: 'secp256k1',
+            signer: p.signerAddress,
+            hash: sig.hash,
+            sig: sig.sig,
+        },
+    };
+    const serialized = JSON.stringify(signed);
+    const sha256 = sha256Hex(serialized);
+    const cid = await uploadToIpfs(p.ipfsRegistryUrl, signed);
+    return { cid, sha256, signed };
+}
+//# sourceMappingURL=emit.js.map

package/dist/trajectory/emit.js.map

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

package/dist/trajectory/harness-bundle-rules/aider.d.ts

@@ -0,0 +1,13 @@
+import { type SnapshotRule } from './types.js';
+/**
+ * Aider harness-bundle snapshot rule.
+ *
+ * Files (per spec §3.2):
+ *   - <repoRoot>/.aider.conf.yml  (project-level config; takes precedence)
+ *   - ~/.aider.conf.yml           (user-level config)
+ *
+ * Aider has no skills/prompts directory analogue — the conf.yml drives
+ * model + read-only files + pre/post commands; that's the whole knob set
+ * a replayable bundle needs.
+ */
+export declare const aiderSnapshotRule: SnapshotRule;

package/dist/trajectory/harness-bundle-rules/aider.js

@@ -0,0 +1,26 @@
+import * as path from 'node:path';
+import { registerRule } from './types.js';
+/**
+ * Aider harness-bundle snapshot rule.
+ *
+ * Files (per spec §3.2):
+ *   - <repoRoot>/.aider.conf.yml  (project-level config; takes precedence)
+ *   - ~/.aider.conf.yml           (user-level config)
+ *
+ * Aider has no skills/prompts directory analogue — the conf.yml drives
+ * model + read-only files + pre/post commands; that's the whole knob set
+ * a replayable bundle needs.
+ */
+export const aiderSnapshotRule = {
+    tool: 'aider',
+    async candidatePaths(input) {
+        const out = [];
+        out.push(path.join(input.home, '.aider.conf.yml'));
+        if (input.repoRoot) {
+            out.push(path.join(input.repoRoot, '.aider.conf.yml'));
+        }
+        return out;
+    },
+};
+registerRule(aiderSnapshotRule);
+//# sourceMappingURL=aider.js.map

package/dist/trajectory/harness-bundle-rules/aider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aider.js","sourceRoot":"","sources":["../../../src/trajectory/harness-bundle-rules/aider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,YAAY,EAAqB,MAAM,YAAY,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAiB;IAC7C,IAAI,EAAE,OAAO;IACb,KAAK,CAAC,cAAc,CAAC,KAA0C;QAC7D,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACnD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF,CAAC;AAEF,YAAY,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/trajectory/harness-bundle-rules/claude-code.d.ts

@@ -0,0 +1,16 @@
+import { type SnapshotRule } from './types.js';
+/**
+ * Claude Code harness-bundle snapshot rule.
+ *
+ * Files (per spec §3.2):
+ *   - ~/.claude/CLAUDE.md
+ *   - <repoRoot>/CLAUDE.md (when repoRoot supplied)
+ *   - ~/.claude/settings.json (subset filtering — model + hooks + mcpServers —
+ *     happens at content-canonicalisation time downstream of the assembler;
+ *     this rule returns the raw file path)
+ *   - every file under ~/.claude/skills/
+ *   - every file under ~/.claude/plugins/<plugin>/skills/
+ *
+ * Existence and allowedDirectories filtering are applied by the assembler.
+ */
+export declare const claudeCodeSnapshotRule: SnapshotRule;

package/dist/trajectory/harness-bundle-rules/claude-code.js

@@ -0,0 +1,71 @@
+import { readdir } from 'node:fs/promises';
+import * as path from 'node:path';
+import { registerRule } from './types.js';
+/**
+ * Recursively list all regular files beneath `dir`. Returns absolute paths.
+ * Returns [] if the directory does not exist (no throw).
+ */
+async function listFilesRecursive(dir) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            out.push(...(await listFilesRecursive(full)));
+        }
+        else if (entry.isFile()) {
+            out.push(full);
+        }
+    }
+    return out;
+}
+/**
+ * Claude Code harness-bundle snapshot rule.
+ *
+ * Files (per spec §3.2):
+ *   - ~/.claude/CLAUDE.md
+ *   - <repoRoot>/CLAUDE.md (when repoRoot supplied)
+ *   - ~/.claude/settings.json (subset filtering — model + hooks + mcpServers —
+ *     happens at content-canonicalisation time downstream of the assembler;
+ *     this rule returns the raw file path)
+ *   - every file under ~/.claude/skills/
+ *   - every file under ~/.claude/plugins/<plugin>/skills/
+ *
+ * Existence and allowedDirectories filtering are applied by the assembler.
+ */
+export const claudeCodeSnapshotRule = {
+    tool: 'claude-code',
+    async candidatePaths(input) {
+        const out = [];
+        out.push(path.join(input.home, '.claude', 'CLAUDE.md'));
+        if (input.repoRoot) {
+            out.push(path.join(input.repoRoot, 'CLAUDE.md'));
+        }
+        out.push(path.join(input.home, '.claude', 'settings.json'));
+        // ~/.claude/skills/**
+        out.push(...(await listFilesRecursive(path.join(input.home, '.claude', 'skills'))));
+        // ~/.claude/plugins/<plugin>/skills/**
+        const pluginsDir = path.join(input.home, '.claude', 'plugins');
+        let plugins;
+        try {
+            plugins = await readdir(pluginsDir, { withFileTypes: true });
+        }
+        catch {
+            plugins = [];
+        }
+        for (const plugin of plugins) {
+            if (!plugin.isDirectory())
+                continue;
+            out.push(...(await listFilesRecursive(path.join(pluginsDir, plugin.name, 'skills'))));
+        }
+        return out;
+    },
+};
+registerRule(claudeCodeSnapshotRule);
+//# sourceMappingURL=claude-code.js.map

package/dist/trajectory/harness-bundle-rules/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../src/trajectory/harness-bundle-rules/claude-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,YAAY,EAAqB,MAAM,YAAY,CAAC;AAE7D;;;GAGG;AACH,KAAK,UAAU,kBAAkB,CAAC,GAAW;IAC3C,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAiB;IAClD,IAAI,EAAE,aAAa;IACnB,KAAK,CAAC,cAAc,CAAC,KAA0C;QAC7D,MAAM,GAAG,GAAa,EAAE,CAAC;QAEzB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QACxD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;QACnD,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;QAE5D,sBAAsB;QACtB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAEpF,uCAAuC;QACvC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC/D,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;gBAAE,SAAS;YACpC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACxF,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;CACF,CAAC;AAEF,YAAY,CAAC,sBAAsB,CAAC,CAAC"}

package/dist/trajectory/harness-bundle-rules/codex.d.ts

@@ -0,0 +1,13 @@
+import { type SnapshotRule } from './types.js';
+/**
+ * Codex harness-bundle snapshot rule.
+ *
+ * Files (per spec §3.2):
+ *   - ~/.codex/config.toml
+ *   - custom prompt/instruction files referenced from config.toml
+ *
+ * Pragmatic v0 additions:
+ *   - every file under ~/.codex/prompts/ (Codex's conventional prompt-snippet
+ *     directory). Paths missing on disk are silently ignored downstream.
+ */
+export declare const codexSnapshotRule: SnapshotRule;