@petepetrash/circuit 0.1.0

package/dist/memory/project-distill.js

@@ -0,0 +1,244 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { listCandidateRunFolders } from '../history/run-corpus.js';
+import { MemoryInputV0 as MemoryInputV0Schema, Ref as RefSchema, RunMemoryUpdateEvent as RunMemoryUpdateEventSchema, StepAbortedTraceEntry, } from '../schemas/index.js';
+import { sha256Hex } from '../shared/connector-relay.js';
+import { runsRoot } from '../shared/control-plane-paths.js';
+// The deterministic, propose-first project-fact distiller (Slice 5). It mines
+// the ONE grounded auto-signal the typed corpus supports today (D4): a
+// recurring failure cause, clustered as `(flow_id, normalized_reason)` over
+// `step.aborted` trace entries across runs of the project. When the same
+// normalized reason appears in two or more INDEPENDENT runs with fresh sources
+// and no contradiction, it emits a single `proposed` `prior_failure` proposal
+// plus a matching `RunMemoryUpdateEvent` that cites BOTH contributing runs.
+//
+// It is propose-first (D2): every fact is `action:"proposed"`, never recorded.
+// It is redacted at capture (D5): the proposal's `summary` and `hints[].text`
+// are composed from NORMALIZED typed fields only — the reason head, the flow
+// id, and the cited run ids — never the raw reason tail, an un-normalized
+// reason string, or raw stdout/stderr. A test asserts no stored hint contains
+// the raw reason tail.
+//
+// It is pure over the history corpus + run folders: it reads trace files and
+// writes nothing. The cold-start reality (section 5) is that the cluster does
+// not currently reach two independent runs, so on today's corpus this emits
+// nothing — by design.
+export const DEFAULT_MIN_DISTINCT_RUNS = 2;
+// D4 reason normalization: the head is the prefix before the first colon,
+// lowercased, whitespace-collapsed. This groups e.g.
+//   "relay step 'goal-run-build': connector result_body lacks a non-empty..."
+// by its stable head ("relay step 'goal-run-build'") while dropping the
+// run-specific tail. Exported so a contract test can pin it and a future
+// taxonomy can replace it without touching the cluster logic (the veto path).
+export function normalizeReasonHead(reason) {
+    const head = reason.split(':', 1)[0] ?? reason;
+    return head.toLowerCase().replace(/\s+/g, ' ').trim();
+}
+// The raw tail (everything after the first colon) is the primary leak vector
+// (D5): in the real corpus it inlines stdout/stderr fragments and session ids.
+// It NEVER reaches a hint; this helper exists only so the redaction test can
+// assert its absence in produced facts.
+export function reasonTail(reason) {
+    const colon = reason.indexOf(':');
+    return colon === -1 ? '' : reason.slice(colon + 1).trim();
+}
+function clusterKey(flowId, normalizedHead) {
+    return `${flowId}\u0000${normalizedHead}`;
+}
+// Build the trace source ref for an occurrence (kind:"trace", run_id, sequence;
+// carries NO ref.sha256 by the Ref schema — the trace branch keys on
+// run_id+sequence). The content hash lives on the MemoryInputV0 source.sha256.
+// Mirrors the history extractor's traceSourceRef shape.
+function traceRef(occurrence) {
+    return RefSchema.parse({
+        kind: 'trace',
+        ref: `trace.ndjson#sequence=${occurrence.sequence}`,
+        run_id: occurrence.runId,
+        flow_id: occurrence.flowId,
+        ...(occurrence.stepId === undefined ? {} : { step_id: occurrence.stepId }),
+        ...(occurrence.attempt === undefined ? {} : { attempt: occurrence.attempt }),
+        sequence: occurrence.sequence,
+    });
+}
+// A deterministic, path-safe memory id for a proposed cluster fact, derived
+// from the cluster key so re-running the distiller proposes the same id for the
+// same cluster (idempotent identity).
+function proposalMemoryId(flowId, normalizedHead) {
+    return `project-prior-failure-${sha256Hex(clusterKey(flowId, normalizedHead)).slice(0, 16)}`;
+}
+// Read one run folder's trace.ndjson once, returning the run's flow_id and its
+// (normalizedHead, occurrence) pairs. A run with no trace, no bootstrap, or no
+// aborts contributes nothing. A torn line never blinds the rest of the trace.
+function readRunCluster(runFolder) {
+    const tracePath = join(runFolder, 'trace.ndjson');
+    if (!existsSync(tracePath))
+        return undefined;
+    let raw;
+    try {
+        raw = readFileSync(tracePath, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+    const traceSha256 = sha256Hex(raw);
+    const values = [];
+    for (const line of raw.split('\n')) {
+        if (line.trim().length === 0)
+            continue;
+        try {
+            values.push(JSON.parse(line));
+        }
+        catch {
+            // skip a torn line
+        }
+    }
+    let flowId;
+    for (const value of values) {
+        if (value !== null && typeof value === 'object') {
+            const kind = value.kind;
+            if (kind === 'run.bootstrapped') {
+                const fid = value.flow_id;
+                if (typeof fid === 'string')
+                    flowId = fid;
+            }
+        }
+    }
+    if (flowId === undefined)
+        return undefined;
+    const aborts = [];
+    for (const value of values) {
+        const parsed = StepAbortedTraceEntry.safeParse(value);
+        if (!parsed.success)
+            continue;
+        const head = normalizeReasonHead(parsed.data.reason);
+        if (head.length === 0)
+            continue;
+        aborts.push({
+            head,
+            occurrence: {
+                runId: parsed.data.run_id,
+                flowId,
+                sequence: parsed.data.sequence,
+                ...(parsed.data.step_id === undefined
+                    ? {}
+                    : { stepId: parsed.data.step_id }),
+                attempt: parsed.data.attempt,
+                traceSha256,
+            },
+        });
+    }
+    return { flowId, aborts };
+}
+export function distillProjectFacts(options) {
+    const runsBase = options.runsBase ?? runsRoot(options.repoRoot);
+    const minDistinctRuns = options.minDistinctRuns ?? DEFAULT_MIN_DISTINCT_RUNS;
+    const now = options.now ?? (() => new Date());
+    const capturedAt = now().toISOString();
+    let runFolders;
+    try {
+        runFolders = listCandidateRunFolders(runsBase);
+    }
+    catch {
+        // No runs base yet (cold start): nothing to distill, fail-open.
+        return { proposals: [], events: [] };
+    }
+    const clusters = new Map();
+    for (const runFolder of runFolders) {
+        const run = readRunCluster(runFolder);
+        if (run === undefined)
+            continue;
+        if (options.flowId !== undefined && run.flowId !== options.flowId)
+            continue;
+        for (const { head, occurrence } of run.aborts) {
+            const key = clusterKey(run.flowId, head);
+            let cluster = clusters.get(key);
+            if (cluster === undefined) {
+                cluster = { flowId: run.flowId, normalizedHead: head, occurrencesByRun: new Map() };
+                clusters.set(key, cluster);
+            }
+            // Keep the lowest-sequence occurrence per run as that run's
+            // representative (deterministic head selection within a run).
+            const existing = cluster.occurrencesByRun.get(occurrence.runId);
+            if (existing === undefined || occurrence.sequence < existing.sequence) {
+                cluster.occurrencesByRun.set(occurrence.runId, occurrence);
+            }
+        }
+    }
+    const proposals = [];
+    const events = [];
+    // Deterministic cluster order so output is stable across runs.
+    const orderedClusters = [...clusters.values()].sort((left, right) => left.flowId.localeCompare(right.flowId) ||
+        left.normalizedHead.localeCompare(right.normalizedHead));
+    for (const cluster of orderedClusters) {
+        const runIds = [...cluster.occurrencesByRun.keys()].sort();
+        if (runIds.length < minDistinctRuns)
+            continue; // single isolated abort -> no proposal
+        // The head run (lowest run_id) is the proposal's single cited source ref;
+        // the matching event cites every contributing run's trace ref.
+        const contributingOccurrences = runIds.map((runId) => {
+            const occurrence = cluster.occurrencesByRun.get(runId);
+            if (occurrence === undefined)
+                throw new Error('unreachable: run id without occurrence');
+            return occurrence;
+        });
+        const headOccurrence = contributingOccurrences[0];
+        if (headOccurrence === undefined)
+            continue;
+        const memoryId = proposalMemoryId(cluster.flowId, cluster.normalizedHead);
+        // REDACTED composition (D5): head + flow id + cited run ids only.
+        const summary = `Recurring ${cluster.flowId} failure in ${options.projectId}: ${cluster.normalizedHead}`;
+        const hintText = `In flow ${cluster.flowId}, the failure cause "${cluster.normalizedHead}" recurred across ${runIds.length} runs (${runIds.join(', ')}). Re-verify whether this cause still applies before relying on it.`;
+        const proposal = MemoryInputV0Schema.parse({
+            schema_version: 1,
+            memory_id: memoryId,
+            kind: 'project',
+            source: {
+                ref: traceRef(headOccurrence),
+                captured_at: capturedAt,
+                // The trace file's content hash. The trace Ref carries no ref.sha256,
+                // so the MemoryInputV0 `source.sha256 === source.ref.sha256` refine
+                // simply does not fire (it guards only when both are present).
+                sha256: headOccurrence.traceSha256,
+            },
+            summary,
+            hints: [
+                {
+                    id: `prior-failure-${sha256Hex(memoryId).slice(0, 12)}`,
+                    text: hintText,
+                    applies_to: 'prior_failure',
+                },
+            ],
+            // Distilled facts enter `unknown` until re-verified at injection; the
+            // injection path re-checks freshness against the cited source.
+            staleness: {
+                status: 'unknown',
+                checked_at: capturedAt,
+                reason_codes: ['memory_unverified'],
+            },
+            authority: 'hint_only',
+        });
+        proposals.push(proposal);
+        const event = RunMemoryUpdateEventSchema.parse({
+            schema: 'run.memory-update-event@v0',
+            event_id: `mue-${memoryId}`,
+            scope: 'flow',
+            flow_id: cluster.flowId,
+            action: 'proposed',
+            reason: `recurring ${cluster.flowId} abort cause observed across ${runIds.length} independent runs`,
+            summary,
+            // The array is the schema-legal home for the two-run citation: it cites
+            // EVERY contributing run's trace ref (min 1, here >= 2).
+            source_refs: contributingOccurrences.map((occurrence) => traceRef(occurrence)),
+            authority: 'hint_only',
+            operator_indicator: `Memory (hint-only): proposed a recurring-failure fact for flow ${cluster.flowId} from ${runIds.length} runs; not recorded until you confirm it.`,
+            staleness: {
+                status: 'unknown',
+                checked_at: capturedAt,
+                reason_codes: ['memory_unverified'],
+            },
+        });
+        events.push(event);
+    }
+    return { proposals, events };
+}
+//# sourceMappingURL=project-distill.js.map

package/dist/memory/project-distill.js.map

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

package/dist/memory/project-identity.d.ts

@@ -0,0 +1,25 @@
+import { MEMORY_MANIFEST_FILE, type ProjectStoreOptions } from './project-store.js';
+export type ProjectIdSource = 'config' | 'git_remote' | 'runs_base';
+export interface ProjectIdWarning {
+    readonly code: 'project_id_unstable';
+    readonly message: string;
+}
+export interface ResolvedProjectId {
+    readonly projectId: string;
+    readonly source: ProjectIdSource;
+    readonly warnings: readonly ProjectIdWarning[];
+}
+export interface ResolveProjectIdOptions extends ProjectStoreOptions {
+    readonly configProjectId?: string;
+    readonly gitRemoteUrl?: string | null;
+}
+export declare function normalizeGitRemoteUrl(url: string): string;
+export declare function resolveProjectId(options?: ResolveProjectIdOptions): ResolvedProjectId;
+export interface MemoryManifest {
+    readonly project_id: string;
+    readonly source: ProjectIdSource;
+}
+export declare function stampMemoryManifest(resolved: ResolvedProjectId, options?: ProjectStoreOptions): string;
+export declare function readMemoryManifest(options?: ProjectStoreOptions): MemoryManifest | undefined;
+export { MEMORY_MANIFEST_FILE };
+//# sourceMappingURL=project-identity.d.ts.map

package/dist/memory/project-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-identity.d.ts","sourceRoot":"","sources":["../../src/memory/project-identity.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,oBAAoB,EACpB,KAAK,mBAAmB,EAEzB,MAAM,oBAAoB,CAAC;AAe5B,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAIlE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAGlC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAYD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYzD;AAgCD,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,iBAAiB,CAsCzF;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC;AAOD,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAMR;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,cAAc,GAAG,SAAS,CAUhG;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/memory/project-identity.js

@@ -0,0 +1,125 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { parse as parseYaml } from 'yaml';
+import { Config, ProjectId } from '../schemas/index.js';
+import { writeJsonAtomic } from '../shared/atomic-io.js';
+import { sha256Hex } from '../shared/connector-relay.js';
+import { projectConfigPath, runsRoot } from '../shared/control-plane-paths.js';
+import { MEMORY_MANIFEST_FILE, resolveProjectStorePaths, } from './project-store.js';
+// Hash a stable basis to a short, path-safe id. The git_remote and runs_base
+// ids share the same hashing so a future cross-worktree shared store keys
+// identically regardless of which fallback produced the id.
+function hashedId(prefix, basis) {
+    return `proj-${prefix}-${sha256Hex(basis).slice(0, 16)}`;
+}
+// Normalize a git remote URL so SSH and HTTPS clones of one repo hash to one
+// id: lowercase, strip a scheme + userinfo, strip a trailing `.git`, and
+// collapse the `git@host:owner/repo` SSH form to `host/owner/repo`.
+export function normalizeGitRemoteUrl(url) {
+    let normalized = url.trim().toLowerCase();
+    // SSH scp-like form: git@github.com:owner/repo.git
+    const scpMatch = normalized.match(/^[^@]+@([^:]+):(.+)$/);
+    if (scpMatch) {
+        normalized = `${scpMatch[1]}/${scpMatch[2]}`;
+    }
+    else {
+        // URL form: strip scheme and any userinfo before the host.
+        normalized = normalized.replace(/^[a-z][a-z0-9+.-]*:\/\//, '').replace(/^[^@/]+@/, '');
+    }
+    normalized = normalized.replace(/\.git$/, '').replace(/\/+$/, '');
+    return normalized;
+}
+function readConfigProjectId(repoRoot) {
+    const configPath = projectConfigPath(repoRoot);
+    if (!existsSync(configPath))
+        return undefined;
+    let raw;
+    try {
+        raw = parseYaml(readFileSync(configPath, 'utf8'));
+    }
+    catch {
+        // A malformed project config is the runtime config loader's problem to
+        // surface, not the identity resolver's; fall through to inference.
+        return undefined;
+    }
+    const parsed = Config.safeParse(raw);
+    if (!parsed.success)
+        return undefined;
+    return parsed.data.project_id;
+}
+function readGitRemoteUrl(repoRoot) {
+    try {
+        const url = execFileSync('git', ['remote', 'get-url', 'origin'], {
+            cwd: repoRoot,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return url.length === 0 ? null : url;
+    }
+    catch {
+        // No git, no remote, or a non-repo directory: fall through to runs-base.
+        return null;
+    }
+}
+export function resolveProjectId(options = {}) {
+    const paths = resolveProjectStorePaths(options);
+    const repoRoot = paths.repoRoot;
+    // 1. Explicit config override wins (operator authority; veto path).
+    const configProjectId = options.configProjectId ?? readConfigProjectId(repoRoot);
+    if (configProjectId !== undefined) {
+        return {
+            projectId: ProjectId.parse(configProjectId),
+            source: 'config',
+            warnings: [],
+        };
+    }
+    // 2. Git remote origin, normalized and hashed (stable across worktrees).
+    const gitRemoteUrl = options.gitRemoteUrl === undefined ? readGitRemoteUrl(repoRoot) : options.gitRemoteUrl;
+    if (gitRemoteUrl !== null && gitRemoteUrl.trim().length > 0) {
+        return {
+            projectId: hashedId('r', normalizeGitRemoteUrl(gitRemoteUrl)),
+            source: 'git_remote',
+            warnings: [],
+        };
+    }
+    // 3. Runs-base fallback, with a loud instability warning.
+    const runsBase = runsRoot(repoRoot);
+    return {
+        projectId: hashedId('p', runsBase),
+        source: 'runs_base',
+        warnings: [
+            {
+                code: 'project_id_unstable',
+                message: 'project identity falls back to the local runs-base path (no git remote, no project_id in .circuit/config.yaml); project memory will not be shared across worktrees or clones. Set project_id in .circuit/config.yaml to stabilize it.',
+            },
+        ],
+    };
+}
+// Stamp the resolved identity into `.circuit/memory/manifest.json` as provenance
+// (and as the key a future cross-worktree shared store would use). The projectId
+// is NOT stored per-record; it lives here once. Atomic tmp+rename + re-parse,
+// the Slice 1 write discipline. Idempotent: re-stamping the same identity is a
+// no-op rewrite.
+export function stampMemoryManifest(resolved, options = {}) {
+    const paths = resolveProjectStorePaths(options);
+    const manifest = { project_id: resolved.projectId, source: resolved.source };
+    // Re-read to confirm the bytes round-trip before the rename commits.
+    writeJsonAtomic(paths.manifestPath, manifest, { validate: (raw) => JSON.parse(raw) });
+    return paths.manifestPath;
+}
+export function readMemoryManifest(options = {}) {
+    const paths = resolveProjectStorePaths(options);
+    if (!existsSync(paths.manifestPath))
+        return undefined;
+    try {
+        const raw = JSON.parse(readFileSync(paths.manifestPath, 'utf8'));
+        if (typeof raw.project_id !== 'string' || typeof raw.source !== 'string')
+            return undefined;
+        return { project_id: raw.project_id, source: raw.source };
+    }
+    catch {
+        return undefined;
+    }
+}
+export { MEMORY_MANIFEST_FILE };
+//# sourceMappingURL=project-identity.js.map

package/dist/memory/project-identity.js.map

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

package/dist/memory/project-injection.d.ts

@@ -0,0 +1,12 @@
+import type { MemoryInputV0 } from '../schemas/index.js';
+import { type ReadProjectFactsOptions } from './project-store.js';
+export interface LoadProjectFactCandidatesOptions extends ReadProjectFactsOptions {
+    readonly repoRoot: string;
+    readonly runsBase?: string;
+    readonly now?: () => Date;
+}
+export interface LoadProjectFactCandidatesResult {
+    readonly candidates: readonly MemoryInputV0[];
+}
+export declare function loadProjectFactCandidates(options: LoadProjectFactCandidatesOptions): LoadProjectFactCandidatesResult;
+//# sourceMappingURL=project-injection.d.ts.map

package/dist/memory/project-injection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-injection.d.ts","sourceRoot":"","sources":["../../src/memory/project-injection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD,OAAO,EAAE,KAAK,uBAAuB,EAAoB,MAAM,oBAAoB,CAAC;AAiBpF,MAAM,WAAW,gCAAiC,SAAQ,uBAAuB;IAC/E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;CAC/C;AA6BD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,+BAA+B,CA2BjC"}

package/dist/memory/project-injection.js

@@ -0,0 +1,56 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { MemoryInputV0 as MemoryInputV0Schema } from '../schemas/index.js';
+import { sha256Hex } from '../shared/connector-relay.js';
+import { runsRoot } from '../shared/control-plane-paths.js';
+import { readProjectFacts } from './project-store.js';
+function reverifyStaleness(fact, runsBase, checkedAt) {
+    const sourceSha = fact.source.sha256 ?? fact.source.ref.sha256;
+    const runId = fact.source.ref.run_id;
+    if (sourceSha === undefined || runId === undefined) {
+        return { status: 'unknown', checked_at: checkedAt, reason_codes: ['memory_unverified'] };
+    }
+    try {
+        // The ref path is run-folder-relative (e.g. trace.ndjson#sequence=N or
+        // reports/result.json); strip a trace fragment to the file path.
+        const relPath = fact.source.ref.ref.split('#')[0] ?? fact.source.ref.ref;
+        const abs = join(runsBase, runId, relPath);
+        if (!existsSync(abs)) {
+            return { status: 'stale', checked_at: checkedAt, reason_codes: ['memory_stale'] };
+        }
+        const currentHash = sha256Hex(readFileSync(abs, 'utf8'));
+        return currentHash === sourceSha
+            ? { status: 'fresh', checked_at: checkedAt, reason_codes: ['source_hash_verified'] }
+            : { status: 'stale', checked_at: checkedAt, reason_codes: ['memory_stale'] };
+    }
+    catch {
+        return { status: 'unknown', checked_at: checkedAt, reason_codes: ['memory_unverified'] };
+    }
+}
+export function loadProjectFactCandidates(options) {
+    // Project-fact injection is (project, flow_id)-scoped (D6): a review run sees
+    // only review facts. With no flow there is no scope, so inject nothing rather
+    // than leak facts across flows. (readProjectFacts stays unfiltered for the
+    // `circuit memory list` surface, which legitimately shows every flow's facts.)
+    if (options.flowId === undefined) {
+        return { candidates: [] };
+    }
+    const runsBase = options.runsBase === undefined ? runsRoot(options.repoRoot) : resolve(options.runsBase);
+    const now = options.now ?? (() => new Date());
+    const checkedAt = now().toISOString();
+    const { facts } = readProjectFacts({
+        ...(options.memoryDir === undefined
+            ? { repoRoot: options.repoRoot }
+            : { memoryDir: options.memoryDir }),
+        ...(options.flowId === undefined ? {} : { flowId: options.flowId }),
+    });
+    const candidates = facts.map((fact) => 
+    // Re-parse with the freshly-verified staleness so the candidate carries the
+    // injection-time freshness (the stored staleness was capture-time).
+    MemoryInputV0Schema.parse({
+        ...fact,
+        staleness: reverifyStaleness(fact, runsBase, checkedAt),
+    }));
+    return { candidates };
+}
+//# sourceMappingURL=project-injection.js.map

package/dist/memory/project-injection.js.map

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

package/dist/memory/project-store.d.ts

@@ -0,0 +1,35 @@
+import { type MemoryInputV0 } from '../schemas/index.js';
+export declare const MEMORY_DIR_RELATIVE_PATH = ".circuit/memory";
+export declare const PROJECT_FACTS_FILE = "project.v1.jsonl";
+export declare const MEMORY_MANIFEST_FILE = "manifest.json";
+export interface ProjectStorePaths {
+    readonly repoRoot: string;
+    readonly memoryDir: string;
+    readonly factsPath: string;
+    readonly manifestPath: string;
+}
+export interface ProjectStoreOptions {
+    readonly repoRoot?: string;
+    readonly memoryDir?: string;
+}
+export interface ProjectStoreWarning {
+    readonly code: 'project_fact_invalid';
+    readonly message: string;
+    readonly line: number;
+}
+export interface ReadProjectFactsOptions extends ProjectStoreOptions {
+    readonly flowId?: string;
+}
+export interface ReadProjectFactsResult {
+    readonly facts: readonly MemoryInputV0[];
+    readonly warnings: readonly ProjectStoreWarning[];
+}
+export declare function resolveProjectStorePaths(options?: ProjectStoreOptions): ProjectStorePaths;
+export declare function readProjectFacts(options?: ReadProjectFactsOptions): ReadProjectFactsResult;
+export declare function rewriteProjectFacts(records: readonly MemoryInputV0[], options?: ProjectStoreOptions): string;
+export declare function appendProjectFact(record: MemoryInputV0, options?: ProjectStoreOptions): string;
+export declare function forgetProjectFact(memoryId: string, options?: ProjectStoreOptions): {
+    readonly removed: boolean;
+    readonly path: string;
+};
+//# sourceMappingURL=project-store.d.ts.map

package/dist/memory/project-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-store.d.ts","sourceRoot":"","sources":["../../src/memory/project-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAwC,MAAM,qBAAqB,CAAC;AAmB/F,eAAO,MAAM,wBAAwB,oBAA2B,CAAC;AACjE,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AACrD,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAG3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAKD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAGlE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACnD;AAED,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,mBAAwB,GAAG,iBAAiB,CAU7F;AAOD,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,sBAAsB,CA2D9F;AAMD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAqBR;AAWD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAKR;AAID,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,mBAAwB,GAChC;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAKtD"}