@bett3r-dev/blueprint-schema 1.6.0 → 1.8.0

package/build/esm/session-phase.d.ts

@@ -0,0 +1,80 @@
+import type { SessionStage } from './session.js';
+/**
+ * What a session is doing now, beside its lifecycle state (active / unanchored / frozen), which says only whether it
+ * is anchored. A phase is derived, never stored: the server reads the session's newest facts (its design job, its
+ * Design done chain, its implementation dispatch, its agent's commit signals, its branch's merge) and sessionPhaseOf picks
+ * the one that describes the present. `merged` is the end: the ticket branch landed and nothing waits on anyone.
+ */
+export declare const SESSION_PHASES: readonly ["designing", "design-done", "implementing", "review", "needs-human", "blocked", "merged"];
+export type SessionPhaseName = typeof SESSION_PHASES[number];
+/** Who the session waits on: its agent working, a person acting, a runner claiming a queued job, or nobody (it ended). */
+export declare const SESSION_PHASE_WAITING_ON: readonly ["agent", "you", "runner", "nobody"];
+export type SessionPhaseWaitingOn = typeof SESSION_PHASE_WAITING_ON[number];
+/**
+ * The precise situation, each code belonging to one phase (PHASE_OF_CODE). A view words the code; `reason`, `step` and
+ * `link` carry what the wording names.
+ */
+export declare const SESSION_PHASE_CODES: readonly ["design-queued", "design-running", "agent-replied", "map-ready", "design-ready", "design-failed", "design-finishing", "design-finish-failed", "design-done", "dispatch-queued", "dispatch-starting", "agent-working", "dispatch-failed", "dispatch-refused", "needs-human", "pr-ready", "merged"];
+export type SessionPhaseCode = typeof SESSION_PHASE_CODES[number];
+export declare const PHASE_OF_CODE: Record<SessionPhaseCode, SessionPhaseName>;
+/**
+ * A session's phase. `since` is when the deciding fact happened (ISO). `step` is the step a running job or the Design
+ * done chain is at; `reason` a failure reason, a refused dispatch's outcome or a signal commit's subject; `link` the
+ * implementation agent's live Claude Code session.
+ */
+export type SessionPhase = {
+    phase: SessionPhaseName;
+    code: SessionPhaseCode;
+    waitingOn: SessionPhaseWaitingOn;
+    since: string;
+    step?: string;
+    reason?: string;
+    link?: string;
+};
+type JobStatus = 'queued' | 'claimed' | 'done' | 'failed';
+/**
+ * The facts a phase is derived from, each the session's newest of its kind; `at` is when it last changed (ISO).
+ * `designJob.stage` is the stage the job was claimed in, when it recorded one. `merge` is the session's branch merging into
+ * `target`, as the runner's merge poll reported it.
+ */
+export type SessionPhaseFacts = {
+    ticket: boolean;
+    stage?: SessionStage;
+    designJob?: {
+        status: JobStatus;
+        step: string | null;
+        stage: string | null;
+        failureReason: string | null;
+        at: string;
+    };
+    completion?: {
+        step: 'bundle' | 'scaffold' | 'transition' | 'done';
+        failed: boolean;
+        failureReason: string | null;
+        at: string;
+    };
+    dispatch?: {
+        outcome: string;
+        status: JobStatus | null;
+        failureReason: string | null;
+        sessionUrl: string | null;
+        at: string;
+    };
+    signal?: {
+        value: 'done' | 'needs-human';
+        subject: string;
+        at: string;
+    };
+    merge?: {
+        target: string;
+        at: string;
+    };
+};
+/**
+ * The session's phase: of its facts, the newest decides. A finished design job (done) never outranks a later stage's
+ * fact, so a reply to a board comment during implementation does not read as the session designing again; a design job
+ * still queued or running does, while it runs. Undefined for a session with none of the facts.
+ */
+export declare const sessionPhaseOf: (facts: SessionPhaseFacts) => SessionPhase | undefined;
+export {};
+//# sourceMappingURL=session-phase.d.ts.map

package/build/esm/session-phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-phase.d.ts","sourceRoot":"","sources":["../../src/session-phase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,qGAAwG,CAAC;AACpI,MAAM,MAAM,gBAAgB,GAAG,OAAO,cAAc,CAAE,MAAM,CAAE,CAAC;AAE/D,0HAA0H;AAC1H,eAAO,MAAM,wBAAwB,+CAAkD,CAAC;AACxF,MAAM,MAAM,qBAAqB,GAAG,OAAO,wBAAwB,CAAE,MAAM,CAAE,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,mBAAmB,6SAKtB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,OAAO,mBAAmB,CAAE,MAAM,CAAE,CAAC;AAEpE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,gBAAgB,EAAE,gBAAgB,CAkBpE,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,gBAAgB,CAAC;IACxB,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,qBAAqB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1D;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,SAAS,CAAC,EAAE;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACvH,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAChI,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;QAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9H,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC,CAAC;AAsCF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAK,OAAO,iBAAiB,KAAI,YAAY,GAAG,SAa1E,CAAC"}

package/build/esm/session-phase.js

@@ -0,0 +1,93 @@
+/**
+ * What a session is doing now, beside its lifecycle state (active / unanchored / frozen), which says only whether it
+ * is anchored. A phase is derived, never stored: the server reads the session's newest facts (its design job, its
+ * Design done chain, its implementation dispatch, its agent's commit signals, its branch's merge) and sessionPhaseOf picks
+ * the one that describes the present. `merged` is the end: the ticket branch landed and nothing waits on anyone.
+ */
+export const SESSION_PHASES = ['designing', 'design-done', 'implementing', 'review', 'needs-human', 'blocked', 'merged'];
+/** Who the session waits on: its agent working, a person acting, a runner claiming a queued job, or nobody (it ended). */
+export const SESSION_PHASE_WAITING_ON = ['agent', 'you', 'runner', 'nobody'];
+/**
+ * The precise situation, each code belonging to one phase (PHASE_OF_CODE). A view words the code; `reason`, `step` and
+ * `link` carry what the wording names.
+ */
+export const SESSION_PHASE_CODES = [
+    'design-queued', 'design-running', 'agent-replied', 'map-ready', 'design-ready', 'design-failed',
+    'design-finishing', 'design-finish-failed', 'design-done',
+    'dispatch-queued', 'dispatch-starting', 'agent-working', 'dispatch-failed', 'dispatch-refused',
+    'needs-human', 'pr-ready', 'merged'
+];
+export const PHASE_OF_CODE = {
+    'design-queued': 'designing',
+    'design-running': 'designing',
+    'agent-replied': 'designing',
+    'map-ready': 'designing',
+    'design-ready': 'designing',
+    'design-failed': 'blocked',
+    'design-finishing': 'designing',
+    'design-finish-failed': 'blocked',
+    'design-done': 'design-done',
+    'dispatch-queued': 'implementing',
+    'dispatch-starting': 'implementing',
+    'agent-working': 'implementing',
+    'dispatch-failed': 'blocked',
+    'dispatch-refused': 'blocked',
+    'needs-human': 'needs-human',
+    'pr-ready': 'review',
+    merged: 'merged'
+};
+const phase = (code, waitingOn, since, extra = {}) => ({
+    phase: PHASE_OF_CODE[code], code, waitingOn, since,
+    ...Object.fromEntries(Object.entries(extra).filter(([, value]) => value !== undefined && value !== null && value !== ''))
+});
+const designPhase = (facts, job) => {
+    const step = job.step ?? undefined;
+    if (job.status === 'queued')
+        return phase('design-queued', 'runner', job.at);
+    if (job.status === 'claimed')
+        return phase('design-running', 'agent', job.at, { step });
+    if (job.status === 'failed')
+        return phase('design-failed', 'you', job.at, { reason: job.failureReason ?? undefined });
+    if (!facts.ticket)
+        return phase('agent-replied', 'you', job.at);
+    return phase((job.stage ?? facts.stage) === 'program' ? 'design-ready' : 'map-ready', 'you', job.at);
+};
+const completionPhase = (completion) => {
+    if (completion.step === 'done')
+        return phase('design-done', 'you', completion.at);
+    if (completion.failed)
+        return phase('design-finish-failed', 'you', completion.at, { step: completion.step, reason: completion.failureReason ?? undefined });
+    return phase('design-finishing', 'runner', completion.at, { step: completion.step });
+};
+const dispatchPhase = (dispatch) => {
+    if (dispatch.outcome !== 'dispatched')
+        return phase('dispatch-refused', 'you', dispatch.at, { reason: dispatch.outcome });
+    if (dispatch.status === 'done')
+        return phase('agent-working', 'agent', dispatch.at, { link: dispatch.sessionUrl ?? undefined });
+    if (dispatch.status === 'failed')
+        return phase('dispatch-failed', 'you', dispatch.at, { reason: dispatch.failureReason ?? undefined });
+    if (dispatch.status === 'claimed')
+        return phase('dispatch-starting', 'runner', dispatch.at);
+    return phase('dispatch-queued', 'runner', dispatch.at);
+};
+const signalPhase = (signal) => signal.value === 'needs-human'
+    ? phase('needs-human', 'you', signal.at, { reason: signal.subject })
+    : phase('pr-ready', 'you', signal.at);
+const mergePhase = (merge) => phase('merged', 'nobody', merge.at, { reason: merge.target });
+/**
+ * The session's phase: of its facts, the newest decides. A finished design job (done) never outranks a later stage's
+ * fact, so a reply to a board comment during implementation does not read as the session designing again; a design job
+ * still queued or running does, while it runs. Undefined for a session with none of the facts.
+ */
+export const sessionPhaseOf = (facts) => {
+    const later = [
+        facts.completion && completionPhase(facts.completion),
+        facts.dispatch && dispatchPhase(facts.dispatch),
+        facts.signal && signalPhase(facts.signal),
+        facts.merge && mergePhase(facts.merge)
+    ].filter((candidate) => candidate !== undefined);
+    const job = facts.designJob;
+    const candidates = job === undefined || (job.status === 'done' && later.length > 0) ? later : [...later, designPhase(facts, job)];
+    return candidates.reduce((newest, candidate) => newest === undefined || Date.parse(candidate.since) > Date.parse(newest.since) ? candidate : newest, undefined);
+};
+//# sourceMappingURL=session-phase.js.map

package/build/esm/session-phase.js.map

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

package/build/esm/session.d.ts

@@ -26,7 +26,17 @@ export type DesignSession = RealityPointer & {
     frozenFrom?: Exclude<SessionState, 'frozen'>;
     ticketRefs?: string[];
     prRef?: string;
+    /** ESAS-329 (F6): the stage the session's chain moved it to; absent until a `stage-advance` lands. Read it through stageOf. */
+    stage?: SessionStage;
+    /** ESAS-329: the Map agreed press that moved a ticket session to the program stage: its op seq, when and by whom. */
+    mapAgreed?: {
+        seq: number;
+        at: string;
+        by: ActorId;
+    };
 };
+/** ESAS-329 (F8): a ticket session's stages, in order; Map agreed moves it from the first to the second, irreversibly. */
+export type SessionStage = 'map' | 'program';
 export type SessionEvent = {
     type: 'attach';
     provider: ActorId;
@@ -42,4 +52,15 @@ export type SessionEvent = {
 };
 export declare function applySessionEvent(session: DesignSession, event: SessionEvent): DesignSession;
 export declare function isSessionFrozen(session: Pick<DesignSession, 'state'>): boolean;
+/**
+ * ESAS-326 (S1): a ticket session names at least one ticket in `ticketRefs`; a session with none, or an empty list,
+ * is not one. The Design done press refuses any other session NOT_A_TICKET_SESSION; it is exported for ESAS-329's
+ * stageOf and the web-app to read the same predicate.
+ */
+export declare function isTicketSession(session: Pick<DesignSession, 'ticketRefs'>): boolean;
+/**
+ * ESAS-329 (F1): the session's stage. The stored stage when a `stage-advance` moved it; otherwise `'map'` for a ticket
+ * session, created before ESAS-329 or not; otherwise undefined: a session with no ticket refs runs in no stage.
+ */
+export declare function stageOf(session: Pick<DesignSession, 'ticketRefs' | 'stage'>): SessionStage | undefined;
 //# sourceMappingURL=session.d.ts.map

package/build/esm/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAErC,eAAO,MAAM,sBAAsB,EAAE,oBAAwB,CAAC;AAE9D,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE9D,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAAyC,CAAC;AAE5F,wBAAgB,cAAc,CAAE,KAAK,EAAE,OAAO,GAAI,KAAK,IAAI,YAAY,CAEtE;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG;IAC3C,aAAa,EAAE,oBAAoB,CAAC;IACpC,EAAE,EAAE,SAAS,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAMvB,wBAAgB,iBAAiB,CAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,GAAI,aAAa,CAgC9F;AAED,wBAAgB,eAAe,CAAE,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,GAAI,OAAO,CAEhF"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAErC,eAAO,MAAM,sBAAsB,EAAE,oBAAwB,CAAC;AAE9D,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE9D,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAAyC,CAAC;AAE5F,wBAAgB,cAAc,CAAE,KAAK,EAAE,OAAO,GAAI,KAAK,IAAI,YAAY,CAEtE;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG;IAC3C,aAAa,EAAE,oBAAoB,CAAC;IACpC,EAAE,EAAE,SAAS,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+HAA+H;IAC/H,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,qHAAqH;IACrH,SAAS,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;CACtD,CAAC;AAEF,0HAA0H;AAC1H,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,SAAS,CAAC;AAE7C,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAMvB,wBAAgB,iBAAiB,CAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,GAAI,aAAa,CAgC9F;AAED,wBAAgB,eAAe,CAAE,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,GAAI,OAAO,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAE,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,GAAI,OAAO,CAErF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAE,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,GAAG,OAAO,CAAC,GAAI,YAAY,GAAG,SAAS,CAGxG"}

package/build/esm/session.js

@@ -46,4 +46,21 @@ export function applySessionEvent(session, event) {
 export function isSessionFrozen(session) {
     return session.state === 'frozen';
 }
+/**
+ * ESAS-326 (S1): a ticket session names at least one ticket in `ticketRefs`; a session with none, or an empty list,
+ * is not one. The Design done press refuses any other session NOT_A_TICKET_SESSION; it is exported for ESAS-329's
+ * stageOf and the web-app to read the same predicate.
+ */
+export function isTicketSession(session) {
+    return (session.ticketRefs?.length ?? 0) > 0;
+}
+/**
+ * ESAS-329 (F1): the session's stage. The stored stage when a `stage-advance` moved it; otherwise `'map'` for a ticket
+ * session, created before ESAS-329 or not; otherwise undefined: a session with no ticket refs runs in no stage.
+ */
+export function stageOf(session) {
+    if (session.stage !== undefined)
+        return session.stage;
+    return isTicketSession(session) ? 'map' : undefined;
+}
 //# sourceMappingURL=session.js.map

package/build/esm/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,sBAAsB,GAAyB,CAAC,CAAC;AAQ9D,MAAM,CAAC,MAAM,cAAc,GAA4B,CAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAE,CAAC;AAE5F,MAAM,UAAU,cAAc,CAAE,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAM,cAAqC,CAAC,QAAQ,CAAE,KAAK,CAAE,CAAC;AAChG,CAAC;AA8BD,SAAS,eAAe,CAAE,YAAgC,EAAE,KAAc;IACxE,OAAO,YAAY,CAAC,QAAQ,CAAE,KAAK,CAAE,CAAC,CAAC,CAAC,CAAE,GAAG,YAAY,CAAE,CAAC,CAAC,CAAC,CAAE,GAAG,YAAY,EAAE,KAAK,CAAE,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAE,OAAsB,EAAE,KAAmB;IAC5E,QAAS,KAAK,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAK,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAAG,OAAO,OAAO,CAAC;YACjD,OAAO;gBACL,GAAG,OAAO;gBACV,KAAK,EAAE,QAAQ;gBACf,eAAe,EAAE,KAAK,CAAC,QAAQ;gBAC/B,UAAU,EAAE,KAAK,CAAC,GAAG;gBACrB,SAAS,EAAE,KAAK,CAAC,EAAE;gBACnB,YAAY,EAAE,eAAe,CAAE,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAE;aACtE,CAAC;QACJ,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAK,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAAG,OAAO,OAAO,CAAC;YACjD,OAAO,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QAClE,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAK,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAAG,OAAO,OAAO,CAAC;YACjD,OAAO,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QACpE,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAK,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAAG,OAAO,OAAO,CAAC;YACjD,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;YACxC,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,UAAU,IAAI,YAAY,EAAE,CAAC;QACxD,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,KAAK,CAAC;YACjC,KAAK,WAAW,CAAC;YACjB,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAE,OAAqC;IACpE,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC;AACpC,CAAC"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,sBAAsB,GAAyB,CAAC,CAAC;AAQ9D,MAAM,CAAC,MAAM,cAAc,GAA4B,CAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAE,CAAC;AAE5F,MAAM,UAAU,cAAc,CAAE,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAM,cAAqC,CAAC,QAAQ,CAAE,KAAK,CAAE,CAAC;AAChG,CAAC;AAqCD,SAAS,eAAe,CAAE,YAAgC,EAAE,KAAc;IACxE,OAAO,YAAY,CAAC,QAAQ,CAAE,KAAK,CAAE,CAAC,CAAC,CAAC,CAAE,GAAG,YAAY,CAAE,CAAC,CAAC,CAAC,CAAE,GAAG,YAAY,EAAE,KAAK,CAAE,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAE,OAAsB,EAAE,KAAmB;IAC5E,QAAS,KAAK,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAK,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAAG,OAAO,OAAO,CAAC;YACjD,OAAO;gBACL,GAAG,OAAO;gBACV,KAAK,EAAE,QAAQ;gBACf,eAAe,EAAE,KAAK,CAAC,QAAQ;gBAC/B,UAAU,EAAE,KAAK,CAAC,GAAG;gBACrB,SAAS,EAAE,KAAK,CAAC,EAAE;gBACnB,YAAY,EAAE,eAAe,CAAE,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAE;aACtE,CAAC;QACJ,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAK,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAAG,OAAO,OAAO,CAAC;YACjD,OAAO,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QAClE,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAK,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAAG,OAAO,OAAO,CAAC;YACjD,OAAO,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QACpE,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAK,OAAO,CAAC,KAAK,KAAK,QAAQ;gBAAG,OAAO,OAAO,CAAC;YACjD,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;YACxC,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,UAAU,IAAI,YAAY,EAAE,CAAC;QACxD,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,KAAK,CAAC;YACjC,KAAK,WAAW,CAAC;YACjB,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAE,OAAqC;IACpE,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAE,OAA0C;IACzE,OAAO,CAAE,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,CAAE,GAAG,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAE,OAAoD;IAC3E,IAAK,OAAO,CAAC,KAAK,KAAK,SAAS;QAAG,OAAO,OAAO,CAAC,KAAK,CAAC;IACxD,OAAO,eAAe,CAAE,OAAO,CAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC"}

package/build/esm/spec.d.ts

@@ -0,0 +1,140 @@
+import { type DesignFile } from './design.js';
+import type { MapEntryId, MapFile } from './map-structure.js';
+import type { Op } from './ops.js';
+export type SpecVersion = 1;
+export declare const SPEC_VERSION: SpecVersion;
+export type SpecEntryId = string;
+export declare const SPEC_SECTION_IDS: readonly ["problem", "solution", "userStories", "decisionTree", "implementationDecisions", "testingDecisions", "risks", "outOfScope", "provenance"];
+export type SpecSectionId = typeof SPEC_SECTION_IDS[number];
+/**
+ * F2: a typed entry with a markdown body. `kind` types it within its section (a `story`, a `rationale`, a
+ * `tracer-bullet`); `refs` name the map entries it anchors to (a story's impact and actor, a rationale's fork);
+ * `fields` hold the few named values its kind requires. The fold keeps what was posted; judging an entry's
+ * kind and fields is the completeness check's.
+ */
+export type SpecEntry = {
+    id: SpecEntryId;
+    section: SpecSectionId;
+    kind: string;
+    title?: string;
+    /** Markdown; the prose stays free (F2). */
+    body: string;
+    refs?: MapEntryId[];
+    fields?: Record<string, string>;
+    struck?: {
+        reason: string;
+    };
+};
+export type SpecFile = {
+    specVersion: SpecVersion;
+    entries: SpecEntry[];
+};
+/** A spec-post as the feed stores it: a batch of entries, each upserted by its id. */
+export type SpecPostOpPayload = {
+    entries: Array<Omit<SpecEntry, 'struck'>>;
+};
+export type SpecStrike = {
+    id: SpecEntryId;
+    reason: string;
+};
+export type SpecStrikeOpPayload = {
+    entries: SpecStrike[];
+};
+/** What one spec op folds: the entries it upserts and the ids it strikes. */
+export type SpecBatch = {
+    posted: SpecEntry[];
+    struck: SpecStrike[];
+};
+export declare function emptySpec(): SpecFile;
+export declare function isSpecSectionId(value: unknown): value is SpecSectionId;
+/** A spec-post's payload as a batch: every readable entry, in payload order. */
+export declare function specPostBatch(payload: unknown): SpecBatch;
+/** A spec-strike's payload as a batch: every readable id with its reason. */
+export declare function specStrikeBatch(payload: unknown): SpecBatch;
+/**
+ * The one spec fold, which both replay copies call (F5, F6). A post upserts by id in place, so a re-post keeps
+ * the entry's position and clears a strike; a strike of an id the spec does not hold changes nothing.
+ */
+export declare function foldSpecBatch(current: SpecFile, batch: SpecBatch): SpecFile;
+export type SpecGapCode = 'fork-open' | 'section-empty' | 'tracer-bullet' | 'element-unlinked' | 'impact-without-story' | 'rationale-missing' | 'ref-struck' | 'owner-changes-unread' | 'question-open' | 'scenario-proposed' | 'deliverable-without-element' | 'element-review-pending' | 'stage-not-program';
+export type SpecGap = {
+    code: SpecGapCode;
+    section?: SpecSectionId;
+    ref?: string;
+    message: string;
+};
+export type SpecCheckInput = {
+    ops: readonly Op[];
+    design: DesignFile;
+    map: MapFile;
+    spec: SpecFile;
+    agentSyncSeq: number | null;
+};
+/** The session a render names in its provenance header; a bundle manifest satisfies it. */
+export type SpecManifest = {
+    sessionId: string;
+    name: string;
+    ticketRefs: readonly string[];
+};
+/** The three folds one replay holds after folding a feed. */
+export type SpecReplayed = {
+    design: DesignFile;
+    map: MapFile;
+    spec: SpecFile;
+};
+/** A replay of the feed: blueprint-store's replayOps or the session engine's; the render folds through it. */
+export type SpecReplay = (ops: readonly Op[]) => SpecReplayed;
+export type SpecRenderInput = {
+    ops: readonly Op[];
+    manifest: SpecManifest;
+    replay: SpecReplay;
+};
+export declare function specSourceSeq(ops: readonly Op[]): number;
+/**
+ * F7, F8: blueprint.md, the written sections in spine order with the derived ones (decision tree, scenarios,
+ * observations, artifacts) read from the same fold, under a provenance header that prints the source seq.
+ * Specification v1: its normative parts, which an implementation agent parses, are the front matter's `key`, the
+ * `## Scenarios` (each `- <id> — <title> (<note>)` with its Given, When and Then) and the `## Artifacts` (each node and
+ * edge with its id, type and verb); every other section is prose for people.
+ */
+export declare function renderBlueprint(input: SpecRenderInput): string;
+/**
+ * decisions.md: per fork its question, the chosen option, who decided, why, and every rejected option with its
+ * rejectedBecause; an open, moot or locked fork says so instead.
+ */
+export declare function renderDecisions(input: SpecRenderInput): string;
+/**
+ * F13: the check takes a scope, not a stage. At `map` it asks only for what the map stage writes (the forks,
+ * Problem, Solution, the stories and rationales, freshness); at `design` it asks for everything.
+ */
+export type SpecCheckScope = 'map' | 'design';
+/** The written sections that must hold a live entry, per scope; User Stories and the rationales have their own codes. */
+export declare const SPEC_REQUIRED_SECTIONS: {
+    readonly [Scope in SpecCheckScope]: readonly SpecSectionId[];
+};
+/** The spine's Testing Decisions name exactly one tracer bullet. */
+export declare const TRACER_BULLET_KIND = "tracer-bullet";
+/**
+ * ESAS-331 F3, S5: every gap between the session's state and a handoff, in the order SpecGapCode lists the codes.
+ * ESAS-330's three codes read the map fold's own agreedAt and review, and joinMapLinks' unserved list.
+ */
+export declare function checkSpecCompleteness(input: SpecCheckInput, scope?: SpecCheckScope): {
+    complete: boolean;
+    gaps: SpecGap[];
+};
+export type BlueprintFiles = {
+    'blueprint.md': string;
+    'decisions.md': string;
+};
+/**
+ * F10, F14: the two files Design done's flush commits, or the gaps that refuse it. `replay` is the deviation D2
+ * names: blueprint-schema cannot fold design and map, so the caller passes the replay it holds.
+ */
+export declare function blueprintFileOf(ops: readonly Op[], manifest: SpecManifest, agentSyncSeq: number | null, replay: SpecReplay): {
+    ok: true;
+    files: BlueprintFiles;
+} | {
+    ok: false;
+    gaps: SpecGap[];
+};
+//# sourceMappingURL=spec.d.ts.map

package/build/esm/spec.d.ts.map

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