halfcycle 0.3.31 → 0.3.33

package/dist/build-record/assemble.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../src/build-record/assemble.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,KAAK,EACX,MAAM,YAAY,CAAC;AAMpB;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,kBAAkB,CAAC,eAAe,CAAC,GAAG,KAAK,CAOrF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,GAAG,OAAO,CAOlG;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAErE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CAqB9E"}

package/dist/build-record/close-record.d.ts

@@ -1,124 +0,0 @@
-/**
- * The phase-close record — the commit a phase actually closed at, written down
- * at the close.
- *
- * WHY IT EXISTS. A Build Record says which commit its phase closed at. That
- * value used to be resolved when the record was ASSEMBLED, by asking git for the
- * working tree's CURRENT HEAD — so closing on Monday and assembling on Friday
- * produced a record naming Friday's commit while claiming to describe Monday's
- * close, and nothing in the system could tell the difference. The close now
- * writes the pair down and the assembler re-derives neither.
- *
- * ONE HOME FOR THE NAME, WHICH IS THE WHOLE RISK. The writer below and the
- * reader in `sources.ts` (`readPhaseClose`) both build the filename by calling
- * `closeRecordPath` here, which builds it by calling `renderPhaseSegment` — the
- * one renderer every other phase-scoped filename in this package goes through.
- * The two ends cannot disagree about the name because there is only one
- * expression of it; no caller concatenates a prefix of its own.
- *
- * THE IDENTITY IS ASSERTED BEFORE THE JOIN, and that is not a second copy of the
- * rule (INV-023). The DECISION is `isValidPhaseIdentity`, which has one home in
- * `@halfcycle/events`; what this site adds is the location the refusal owes its
- * reader, which the renderer's own refusal cannot name because it writes nothing
- * and has no opinion about where its caller's file lives. `close-phase` reaches
- * neither `validateNarrated` nor `writeBuildRecord`, so without this assertion
- * the close path would compose a client-repo filename from an unvalidated value.
- *
- * WHERE IT LANDS, AND WHY THAT PLACEMENT COSTS NOTHING. `.workbench` is the
- * declared Zone-B root (`install.ts`, `ZONE_B_DIR`); it is gitignored and the
- * egress gate excludes it. So the close record declares no client-tree artefact
- * kind, needs no allowlisted path, and cannot be delivered anywhere. It sits
- * beside the operator-authored assembler input, as its OWN file so that
- * machine-written and hand-written content stay apart.
- *
- * THE COMMIT AND THE DATE MOVE TOGETHER, on both paths. The writer records both
- * or writes nothing; the reader accepts both or refuses the file. A record
- * carrying one without the other would be a close half-described, and the
- * absence wording in the rendered record would have to speak for a pair it only
- * half covers.
- *
- * INV-001: `packages/bundle` is shippable and its import allowlist is exactly
- * {packages/core, packages/events}. This module imports `@halfcycle/events`,
- * Node builtins and its own package; the git call is `node:child_process`, as
- * the assembler's own git read always did.
- */
-import { type PhaseIdentity } from '@halfcycle/events';
-/** The close record's format string — a single literal, one home. */
-export declare const CLOSE_RECORD_FORMAT: "halfcycle-phase-close/v1";
-/**
- * The Zone-B directory the close record shares with the assembler's own input
- * file, relative to the repository root. One home, so the CLI's reader, the
- * close-side writer and the assembler-side reader all name one directory.
- */
-export declare const BUILD_RECORD_ZONE_B_DIR: string;
-/**
- * What a close wrote down about the repository, as it sits on disk.
- *
- * The file is local and machine-written. Nothing reconciles it against the
- * repository afterwards: if it is hand-edited, every later reader believes it,
- * exactly as for the assembler's other local inputs.
- */
-export interface PhaseCloseRecord {
-    /** Which version of this file's layout was written. */
-    format: typeof CLOSE_RECORD_FORMAT;
-    /** The phase that closed, as it was named. */
-    phase: PhaseIdentity;
-    /** The commit the repository was on when the phase closed. */
-    closeCommit: string;
-    /** The date of that commit, as YYYY-MM-DD. */
-    closedDate: string;
-}
-/** What writing the close record did, so the caller can say it plainly. */
-export type CloseRecordOutcome = {
-    /** The close was written down on this machine. */
-    recorded: true;
-    /** The file it was written to. */
-    path: string;
-    /** The commit the repository was on. */
-    closeCommit: string;
-    /** The date of that commit. */
-    closedDate: string;
-} | {
-    /** Nothing was written down about this close. */
-    recorded: false;
-    /** The file that would have been written, or null when even that could not be named. */
-    path: string | null;
-    /** Why nothing was written, in words that can be printed as-is. */
-    reason: string;
-};
-/**
- * Thrown when a close record is on disk but is not one this reader can trust.
- *
- * Deliberately NOT the assembler's missing-source error: the file is present, and
- * calling a present-but-broken input "missing" is the mislabelling that sends a
- * reader looking for something that is right there.
- */
-export declare class InvalidCloseRecordError extends Error {
-    constructor(path: string, detail: string);
-}
-/**
- * The file a phase's close is recorded in.
- *
- * Refuses an identity that cannot safely name a file BEFORE composing the path,
- * naming the only directory a close record is ever written into.
- */
-export declare function closeRecordPath(repoRoot: string, phase: PhaseIdentity): string;
-/**
- * Write down the commit a phase closed at.
- *
- * Never throws. Every way this can fail — an identity that cannot name a file, a
- * repository whose HEAD cannot be read, a directory that cannot be written — is
- * returned as a `recorded: false` outcome carrying a printable reason, because
- * the phase has already closed by the time this runs and a raise here would
- * report a successful close as a failure.
- */
-export declare function writeCloseRecord(repoRoot: string, phase: PhaseIdentity): CloseRecordOutcome;
-/**
- * Validate a parsed close record and return it, or throw naming what is wrong.
- *
- * Lives here rather than in the reader so the file's SHAPE has one home: the
- * writer above builds it and this checks it, and neither restates the other's
- * keys. The pair check is the read-side half of "both move together".
- */
-export declare function parseCloseRecord(path: string, parsed: unknown): PhaseCloseRecord;
-//# sourceMappingURL=close-record.d.ts.map

package/dist/build-record/close-record.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"close-record.d.ts","sourceRoot":"","sources":["../../src/build-record/close-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAKH,OAAO,EAAgD,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGrG,qEAAqE;AACrE,eAAO,MAAM,mBAAmB,EAAG,0BAAmC,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAmC,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,MAAM,EAAE,OAAO,mBAAmB,CAAC;IACnC,8CAA8C;IAC9C,KAAK,EAAE,aAAa,CAAC;IACrB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAC1B;IACE,kDAAkD;IAClD,QAAQ,EAAE,IAAI,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,iDAAiD;IACjD,QAAQ,EAAE,KAAK,CAAC;IAChB,wFAAwF;IACxF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN;;;;;;GAMG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAIzC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAG9E;AAmCD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,kBAAkB,CAgC3F;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAiChF"}

package/dist/build-record/sources.d.ts

@@ -1,111 +0,0 @@
-/**
- * Source loading + fail-loud validation for the Build-Record assembler.
- *
- * INV-001 (local by construction): every source is a LOCAL file. The guard-eval
- * log is a phase-scoped JSONL file the runner wrote locally (E2-T-03b) and the
- * close commit/date come from the phase's own close record — never a hosted
- * store call, and since `phase-close-commit` never a live git call either. This
- * module imports only @halfcycle/events (for the wire schema), Node builtins and
- * its own package.
- *
- * INV-007: the guard-eval log is parsed through `guardEvalRunSchema` from
- * @halfcycle/events, so only the FiredGuard-safe fields survive. A line
- * carrying an undeclared field rejects on parse (`.strict()`), so the asset
- * cannot enter the record even via a malformed log line.
- *
- * Fail-loud (AC2): a missing required source throws `MissingSourceError` naming
- * the input. Nothing is blanked or invented.
- */
-import { type GuardEvalRun, type PhaseIdentity } from '@halfcycle/events';
-import type { BuildRecordSources, NarratedSource, OrchestrationStateSource, PhaseCloseSource } from './types.js';
-import { type SeedGuard } from './types.js';
-/** Thrown when a required source artefact is missing — fail loud, never blank. */
-export declare class MissingSourceError extends Error {
-    constructor(sourceName: string, detail: string);
-}
-/**
- * Read the runner's LOCAL phase-scoped guard-eval log and project it to the
- * record's active-guard catalogue (`seedGuards`).
- *
- * The log is JSONL — one `GuardEvalRun` per line (E2-T-03b format). Every line
- * is validated through `guardEvalRunSchema`, so the guard rows are FiredGuard
- * (INV-007-safe) by construction. The catalogue is the deduped set of
- * `(patternRef, severity)` across every fired guard in the phase, sorted by
- * patternRef — deterministic (INV-009). `explanation` is dropped for the
- * catalogue (a catalogue entry is not a specific firing).
- *
- * A missing/empty log is NOT silently blanked — the caller decides whether an
- * empty guard set is legal for the phase (a phase with matchers should have
- * fired at least once). This function reports what it found; `readGuardEvalLog`
- * fails loud when the file is absent.
- */
-export declare function projectSeedGuards(runs: GuardEvalRun[]): SeedGuard[];
-/**
- * Read + parse the phase-scoped guard-eval log file, whose name comes from
- * `renderPhaseSegment` — the same renderer the writer uses, so the reader cannot
- * drift from it by inspection. The identity is a name or a number; an unsafe one
- * is refused by the renderer before any path is joined.
- *
- * Every line is legacy-normalised (see `normalizeLegacyLine`) then validated
- * through the strict `guardEvalRunSchema` — a mixed-era log (pre-amendment lines
- * with no `runId`/`outcome`, plus new-era `evaluated`/failure/`unconfigured`
- * lines) assembles cleanly, while an undeclared field still rejects. Fails loud
- * when the log file is absent (a required source per the field→source map).
- */
-export declare function readGuardEvalLog(logDir: string, phaseId: PhaseIdentity): GuardEvalRun[];
-/**
- * Load the orchestration-state task map; fail loud if the file is absent.
- * The filename is produced by `renderPhaseSegment`, so this reader and the
- * Build-Record writer name a phase the same way by construction.
- */
-export declare function readOrchestrationState(phasesDir: string, phaseId: PhaseIdentity): OrchestrationStateSource;
-/**
- * Read what the phase's close recorded about the repository.
- *
- * THIS REPLACED A GIT CALL, and the replacement is the feature. The assembler
- * used to run `git rev-parse --short HEAD` here, at ASSEMBLY time, so the commit
- * and date a record named were a function of when someone happened to assemble
- * it — close on Monday, assemble on Friday, and the record described Friday
- * while claiming to describe the close. Nothing re-derives either value now.
- *
- * The filename comes from `closeRecordPath` — the same function the close-side
- * writer calls, which builds it through the same renderer every other
- * phase-scoped filename here goes through. Writer and reader cannot drift.
- *
- * AN ABSENT FILE IS ABSENCE, not a failure, and it is the one required-source
- * reader here that does not fail loud. Closing a phase has never needed git, so
- * a close that recorded nothing is legitimate — as is a close made before this
- * file existed, whose commit is simply unrecoverable. Both read as `null` and
- * the record says so. A PRESENT file that cannot be trusted still fails loud,
- * because that is a broken input rather than an absent one.
- */
-export declare function readPhaseClose(repoRoot: string, phaseId: PhaseIdentity): PhaseCloseSource;
-/**
- * Validate that a caller-supplied narrated bundle has every required field.
- * The narrated fields are lifted from prose artefacts (phase doc, acceptance
- * report, COE notes, ENGAGEMENT ledger) by the loader; this guard makes the
- * "missing source fails loud" contract hold for them too.
- *
- * It also refuses an unsafe `phase.id` (INV-023). That field is not merely data:
- * it is copied into the assembled record and interpolated into the record's own
- * output filename, so it is the one narrated field that decides where the record
- * is written. It is validated here because this is where every route converges.
- */
-export declare function validateNarrated(narrated: NarratedSource): NarratedSource;
-/**
- * Assemble the complete `BuildRecordSources` bundle from a phase's local
- * artefacts. This is the local-by-construction (INV-001) loader: it reads the
- * orchestration state, the runner's local guard-eval log, the phase's own close
- * record, and the caller-lifted narrated + touched-invariants inputs. Every
- * required source is present or it throws — with one deliberate exception named
- * at `readPhaseClose`, whose absence is a legitimate answer rather than a gap.
- */
-export declare function loadSources(opts: {
-    repoRoot: string;
-    phasesDir: string;
-    guardEvalLogDir: string;
-    phaseId: PhaseIdentity;
-    narrated: NarratedSource;
-    touchedInvariants: string[];
-}): BuildRecordSources;
-//# sourceMappingURL=sources.d.ts.map

package/dist/build-record/sources.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../src/build-record/sources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAI9D,kFAAkF;AAClF,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI/C;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,SAAS,EAAE,CAwBnE;AAwED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,YAAY,EAAE,CAoBvF;AAMD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,GACrB,wBAAwB,CAsB1B;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,gBAAgB,CAyBzF;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,CA2BzE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,GAAG,kBAAkB,CAerB"}

package/dist/build-record/template.d.ts

@@ -1,29 +0,0 @@
-/**
- * The v1 Build-Record markdown renderer.
- *
- * The FIXED PROSE (headings, the format note, section captions) is the
- * vault-canonical v1 template — method content, not authored per-record. Every
- * DATA SLOT is projected from the assembled JSON record, so the `.md` and the
- * `.json` cannot disagree on data (AC1): there is no independent data source for
- * the markdown. This function is a pure `BuildRecordV1 -> string`.
- *
- * INV-007: it renders only record fields — the record already excludes the
- * asset, so the markdown cannot leak it.
- *
- * EVERY STRING BELOW IS WRITTEN INTO THE CLIENT'S OWN REPOSITORY and read by
- * them as prose, so none of it may carry Halfcycle-internal vocabulary: no
- * invariant id, no `packages/*` path, no issue number, no org name. An invariant
- * id is not openable by a client — it points into a register they do not have —
- * so in the record it reads as an unexplained code beside a claim about their
- * own build. The rule the id names goes into the prose in client-safe words and
- * the id itself stays here, in this docblock, where the mechanism belongs.
- * `packages/bundle/test/published-entry-vocabulary.test.ts` scans the published
- * entry for exactly these tokens, and `build-record.test.ts` checks the EMITTED
- * markdown rather than this source.
- */
-import type { BuildRecordV1 } from './types.js';
-/**
- * Render the v1 markdown companion. Fixed prose + projected data slots only.
- */
-export declare function renderBuildRecordMarkdown(record: BuildRecordV1): string;
-//# sourceMappingURL=template.d.ts.map

package/dist/build-record/template.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/build-record/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,YAAY,CAAC;AAsD3D;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAiFvE"}

package/dist/build-record/types.d.ts

@@ -1,200 +0,0 @@
-/**
- * Build-Record v1 types — the shape the assembler emits and the typed source
- * bundle it projects from.
- *
- * INV-001: this module imports ONLY from @halfcycle/events (the INV-007-safe
- * FiredGuard / GuardEvalRun shapes) — no hosted package, no guard-engine, no
- * GuardRecord. The guard input can therefore not carry the asset even in
- * principle: the wire types physically lack matcher/channel/version/scope/
- * addedFrom/generalisedFrom.
- *
- * INV-007: `SeedGuard` is a strict subset of FiredGuard (`patternRef` +
- * `severity`, optional per-firing `explanation`). It is the ONLY guard-derived
- * shape in the record. There is no path from a `GuardRecord` to this file.
- */
-import type { FiredGuard, GuardEvalRun, PhaseIdentity } from '@halfcycle/events';
-/** The v1 format string — a single literal, one home. */
-export declare const BUILD_RECORD_FORMAT: "halfcycle-build-record/v1";
-/**
- * The one and only guard-derived shape in a Build Record (INV-007-safe).
- *
- * `patternRef` + `severity` are the active-guard catalogue projection; a
- * specific firing may additionally carry a plain-language `explanation`. This
- * type is a strict *subset* of the wire `FiredGuard` — it drops `guardId`
- * (not a record field) and cannot express `matcher`/`channel`/`version`/
- * `scope`/`addedFrom`/`generalisedFrom` because those do not exist on
- * `FiredGuard` either. The subset relationship is asserted at compile time by
- * `projectSeedGuard` below.
- */
-export interface SeedGuard {
-    patternRef: string;
-    severity: FiredGuard['severity'];
-    explanation?: string;
-}
-/**
- * Project a wire FiredGuard down to the record's INV-007-safe SeedGuard.
- *
- * This is the ONLY constructor of a SeedGuard from guard data. It reads exactly
- * three fields; the wire type has no others of interest and physically cannot
- * carry the asset. `includeExplanation` distinguishes a specific firing (keep
- * the plain-language `explanation`) from the active-guard catalogue projection
- * (drop it — a catalogue entry is not a firing).
- */
-export declare function projectSeedGuard(fired: Pick<FiredGuard, 'patternRef' | 'severity' | 'explanation'>, includeExplanation: boolean): SeedGuard;
-/** `delivered` block — what the phase shipped (from orchestration state + phase doc). */
-export interface Delivered {
-    packages: string[];
-    services: string[];
-    tools: string[];
-    deployment: Record<string, unknown>;
-    dogfood: string;
-}
-/** A Done-when result slot. */
-export interface DoneWhenResult {
-    result: string;
-    detail: string;
-}
-/** The acceptance-walk projection (walker ≠ builder, INV-009). */
-export interface Acceptance {
-    walker: string;
-    verdict: string;
-    findings: number;
-    doneWhen: Record<string, DoneWhenResult>;
-    inv002ProdBypassProbe?: DoneWhenResult;
-}
-export interface GatesEarnedKeep {
-    defectsCaughtPreHuman: number;
-    named: string[];
-    bugsReachingHumanWalk: number;
-}
-export interface Instruments {
-    marginalCostSelfAccounting: string;
-    coeAddRate: {
-        seamNew: number;
-        seamRepeat: number;
-        modelLimitation: number;
-        notes: string;
-    };
-}
-export interface Tasks {
-    planned: number;
-    landed: number;
-    cancelled: string[];
-}
-/**
- * The v1 Build Record — the JSON companion. Field order matters for the seed.
- *
- * `phase.id` is a `PhaseIdentity` — a name OR a number — because a phase is
- * identified by whatever the client called it, and three of this repo's own
- * phases are numbered while twenty-four are named. The widening is deliberately
- * NOT a narrowing to `string`: `docs/build-records/phase-0.json` carries the
- * JSON number `0`, the assembler copies the identity through untransformed, and
- * `packages/bundle/test/build-record-phase0.test.ts` deep-equals the two. Under
- * the union that conformance seed passes with no fixture edit; under `string`
- * alone it would have needed a re-conform and a second operator approval.
- *
- * `closeCommit` and `closedDate` ADMIT ABSENCE, which is the v1 shape moving
- * rather than a field being added. Both were required strings, on the premise
- * that a record could always be given them because they were derived from git at
- * assembly time. They are now captured at the close, and a client with no git
- * closes successfully — so the pair has a legitimate "not recorded" state, and a
- * required string could only have been satisfied by inventing one or by
- * refusing to assemble the record at all. The conformance seed carries strings
- * in both and is unaffected: widening a field admits the value it already held.
- */
-export interface BuildRecordV1 {
-    format: typeof BUILD_RECORD_FORMAT;
-    engagement: string;
-    engagementType: string;
-    phase: {
-        id: PhaseIdentity;
-        name: string;
-    };
-    status: string;
-    /** The date the phase closed, or null when the close recorded none. */
-    closedDate: string | null;
-    /** The commit the phase closed at, or null when the close recorded none. */
-    closeCommit: string | null;
-    thesis: string;
-    thesisHeld: boolean;
-    delivered: Delivered;
-    seedGuards: SeedGuard[];
-    acceptance: Acceptance;
-    gatesEarnedKeep: GatesEarnedKeep;
-    instruments: Instruments;
-    invariantsExercised: string[];
-    deviations: string[];
-    tasks: Tasks;
-}
-/**
- * Orchestration-state projection: task terminal states + engagement identity.
- * Loaded from the phase-scoped orchestration-state file, whose name is produced
- * by `renderPhaseSegment` and never spelled out here (Zone-B process artefact).
- * Terminal states: `merged`/`done` → landed; `cancelled` → cancelled.
- */
-export interface OrchestrationStateSource {
-    tasks: Record<string, {
-        status: string;
-    }>;
-}
-/** Narrated-artefact source — the fields lifted verbatim from prose artefacts.
- *
- * These are NOT re-derived by the assembler; they are lifted from the phase
- * doc (thesis, phase name), the acceptance-walk report (verdict/findings/
- * done-when results), the COE pass notes (gates/instruments) and the ENGAGEMENT
- * ledger (status/close row/deviations). The assembler's job is projection +
- * derivation, not prose parsing; the loader layer supplies these already-lifted
- * so the invariant-bearing core stays testable and prose-format-agnostic.
- */
-export interface NarratedSource {
-    engagement: string;
-    engagementType: string;
-    phase: {
-        id: PhaseIdentity;
-        name: string;
-    };
-    status: string;
-    thesis: string;
-    delivered: Delivered;
-    acceptance: Acceptance;
-    gatesEarnedKeep: GatesEarnedKeep;
-    instruments: Instruments;
-    deviations: string[];
-}
-/**
- * What the phase's close recorded about the repository.
- *
- * NOT resolved at assembly time, which is the change this type carries. Both
- * values are captured when the phase closes and read back from the local close
- * record (`close-record.ts`), so assembling the same phase twice returns the
- * same document however much work has happened since.
- *
- * `null` on both is a close that recorded neither — a client with no git, no
- * repository or no commit yet closes successfully and this reads as absence
- * rather than as a blank or a value derived later. The pair moves together on
- * both paths, so one is never null while the other is a string.
- */
-export interface PhaseCloseSource {
-    /** The commit the repository was on when the phase closed, or null if none was recorded. */
-    closeCommit: string | null;
-    /** The date of that commit, or null if none was recorded. */
-    closedDate: string | null;
-}
-/**
- * The complete typed source bundle. Every required source is present or the
- * assembler fails loudly (see `assembleBuildRecord`). The guard-eval log is
- * supplied as already-read `GuardEvalRun` records (INV-007-safe by type).
- */
-export interface BuildRecordSources {
-    orchestration: OrchestrationStateSource;
-    narrated: NarratedSource;
-    close: PhaseCloseSource;
-    /** The runner's LOCAL guard-eval log for the phase (INV-007-safe wire records). */
-    guardEvalRuns: GuardEvalRun[];
-    /**
-     * The delivered feature specs' `Touches` invariant IDs, per spec — the raw
-     * union input for `invariantsExercised` (deduped + sorted by the assembler).
-     */
-    touchedInvariants: string[];
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/build-record/types.d.ts.map

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