ctxr-cli 0.33.0 → 0.34.0

package/dist/core/approval/session-group.d.ts

@@ -0,0 +1,156 @@
+import type { StoreConfig } from '../../config/schema.js';
+import type { ForgeCredentials } from '../forge/credentials.js';
+import { type ForgeClient, type PullRequest } from '../forge/github.js';
+import type { GitRunner } from '../git/exec.js';
+import { type Decision, type LandingMark, type PartRef, type ReviewStateName, type SessionDecision } from './decision.js';
+import { sessionKey, type SessionIdentity } from './session-marker.js';
+/**
+ * approve-sessions-across-stores: a session's pull requests across the home
+ * store and the stores it mounts, and the state of its one decision.
+ *
+ * Only pull requests carrying a well-formed session marker are grouped here.
+ * A pull request without one is a session of its own and keeps today's path
+ * (`sessions.ts`), so a store whose pull requests carry no marker behaves
+ * exactly as before.
+ */
+/** One store a session can reach: the home store, or a present mount. */
+export interface SessionStore {
+    /** The forge repository slug, `owner/repo`. */
+    slug: string;
+    /** null for the home store; the mount's name otherwise. */
+    mountName: string | null;
+    /** The clone's top level: the canonical clone for the home store, `shared/<name>` for a mount. */
+    root: string;
+    config: StoreConfig;
+    forge: ForgeClient;
+    /** The credential behind `forge`, for fetches and pushes against the store's remote; null keeps the transport's own. */
+    credentials: ForgeCredentials | null;
+}
+export interface StoreReach {
+    home: SessionStore;
+    /** Present mounts with a forge slug, in declared order. */
+    mounts: SessionStore[];
+    /** Declared mounts this run cannot read: absent, not a store, or without an `origin`. */
+    unavailable: {
+        name: string;
+        reason: string;
+    }[];
+}
+export type ForgeFor = (root: string, mount: boolean) => Promise<{
+    forge: ForgeClient;
+    credentials: ForgeCredentials | null;
+}>;
+/** The home store and every present mount, each with its own forge client. */
+export declare function storeReach(git: GitRunner, home: {
+    root: string;
+    canonical: string;
+    config: StoreConfig;
+    forge: ForgeClient;
+    credentials?: ForgeCredentials | null;
+}, forgeFor: ForgeFor): Promise<StoreReach | null>;
+export declare function allStores(reach: StoreReach): SessionStore[];
+/** A store's open pull requests, or why they could not be read. */
+export interface StoreListing {
+    store: SessionStore;
+    pulls: PullRequest[] | null;
+    error: string | null;
+}
+export declare function listOpen(reach: StoreReach, homePulls?: () => Promise<PullRequest[]>): Promise<StoreListing[]>;
+export interface OpenPart {
+    store: SessionStore;
+    pull: PullRequest;
+}
+export interface SessionGroup {
+    identity: SessionIdentity;
+    /** Whether this store is the session's home: only then is it decided and landed here. */
+    homedHere: boolean;
+    /** Its open pull requests, in landing order: mounted stores first (in declared order), the home store last. */
+    parts: OpenPart[];
+    /** Stores whose pull requests could not be read: the session may have parts there, so it is not decided. */
+    unreadable: string[];
+}
+/** Landing order: parts in mounted stores first, in declared order, then the home store's part. */
+export declare function landingOrder<T extends {
+    store: string;
+}>(parts: readonly T[], reach: StoreReach, homeSlug: string): T[];
+/**
+ * Whether a pull request is read as a part of a session rather than on its own:
+ * it carries a session marker, and the session is homed in another store or
+ * the reading store declares mounts. A store with no `shared_stores` keeps
+ * today's path for its own sessions (design.md D9: nothing changes for a store
+ * that has not declared mounts); a pull request homed elsewhere is always its
+ * home's, so a mounted store never lands it.
+ */
+export declare function readAsSessionPart(pull: PullRequest, homeSlug: string | null, config: StoreConfig): boolean;
+/**
+ * write-lifecycle spec ("Every pull request of a session carries the session"):
+ * every open pull request read as a session part, grouped by the session it
+ * names. A session homed elsewhere is grouped too, so a page can show it apart.
+ * `all` also groups this store's own sessions when it declares no mounts — for
+ * `ctxr land --session`, which names one explicitly.
+ */
+export declare function groupSessions(reach: StoreReach, listings: readonly StoreListing[], all?: boolean): SessionGroup[];
+/** Whether a pull request's body names a session homed in another store than `homeSlug`. */
+export declare function homedElsewhere(pull: PullRequest, homeSlug: string): boolean;
+export type SessionStateName = ReviewStateName | 'retrying';
+export interface PartState {
+    ref: PartRef | null;
+    store: SessionStore | null;
+    storeSlug: string;
+    number: number;
+    /** The pull request as the forge has it now; null when its store cannot be read. */
+    pull: PullRequest | null;
+    /** Whether the decision names this part. */
+    named: boolean;
+    /** What this part contributes: ok, merged, closed, moved (head no longer the one approved), unnamed, unknown, or a landing record. */
+    status: 'ok' | 'merged' | 'closed' | 'moved' | 'unnamed' | 'unknown' | 'landing-blocked' | 'landing-needs-reapproval' | 'pending';
+    /** Whether this part carries a review of the decision (the record, or a copy) by the recording login. */
+    hasCopy: boolean;
+    landing: LandingMark | null;
+}
+export interface SessionState {
+    identity: SessionIdentity;
+    state: SessionStateName;
+    /** The record's decision, as on the record part. */
+    decision: Decision | null;
+    session: SessionDecision | null;
+    /** Every part: the named ones in the decision's order, then any open part it does not name. */
+    parts: PartState[];
+    /** The part and the reason behind `blocked`, `needs-reapproval` or `retrying`. */
+    reason: string | null;
+    reasonPart: string | null;
+}
+export interface StateInput {
+    git: GitRunner;
+    reach: StoreReach;
+    identity: SessionIdentity;
+    /**
+     * Whether the session is homed in the reading store. A session homed elsewhere may name parts on stores out of
+     * this store's reach; those are left out of its state, and its decision is read from a copy when the record is
+     * out of reach. A session homed here never ignores a part: every store it can name is in reach.
+     */
+    homedHere: boolean;
+    /** The session's open parts, as grouped from the forge. */
+    open: readonly OpenPart[];
+    recordingLogin: string;
+}
+/**
+ * change-approval spec ("A session is decided only on its home store's page,
+ * for every part it names"): the session's decision is the latest one on its
+ * record part alone, and it counts only while every part it names keeps the
+ * head it gives (or one carried over from it) and no open part carrying the
+ * marker is missing from it. A named part closed without merging blocks the
+ * session; a named part already merged counts as landed, and a session with
+ * some named parts landed and others still open is `retrying` — its landing
+ * was left unfinished and the next run goes on with it.
+ */
+export declare function sessionState(input: StateInput): Promise<SessionState>;
+/**
+ * change-approval spec: a store's deciders, read from its `contexture.yaml` on its default branch on the forge at
+ * decision time (design.md D5) — never from a clone that can be behind. No `change_approval` means no deciders.
+ */
+export declare function decidersOnForge(git: GitRunner, store: SessionStore): Promise<string[]>;
+/** A display name for a store in a session: its mount name, or the home store's slug. */
+export declare function storeLabel(store: SessionStore): string;
+export { sessionKey };
+//# sourceMappingURL=session-group.d.ts.map

package/dist/core/approval/session-group.d.ts.map

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

package/dist/core/approval/session-group.js

@@ -0,0 +1,359 @@
+import { parse as parseYaml } from 'yaml';
+import { storePrefix } from '../graph/tree.js';
+import { CONFIG_FILE_NAME } from '../root.js';
+import { ContextureError } from '../errors.js';
+import { ForgeRequestError } from '../forge/github.js';
+import { declaresSharedStores, resolveMounts } from '../shared-stores.js';
+import { parseDecision, parseLandingMark, partKey, recordPartOf } from './decision.js';
+import { parseSessionMarker, repositorySlug, sessionKey, sessionsEqual } from './session-marker.js';
+import { baseRef, carriesOver } from './sessions.js';
+/** The home store and every present mount, each with its own forge client. */
+export async function storeReach(git, home, forgeFor) {
+    const homeSlug = await repositorySlug(git, home.canonical);
+    if (homeSlug === null)
+        return null;
+    const mounts = [];
+    const unavailable = [];
+    for (const mount of await resolveMounts(home.root, home.config)) {
+        if (mount.state !== 'present') {
+            unavailable.push({ name: mount.name, reason: mount.state === 'absent' ? 'not cloned' : mount.reason });
+            continue;
+        }
+        const slug = await repositorySlug(git, mount.root);
+        if (slug === null) {
+            unavailable.push({ name: mount.name, reason: 'its clone has no "origin" remote' });
+            continue;
+        }
+        mounts.push({ slug, mountName: mount.name, root: mount.root, config: mount.config, ...(await forgeFor(mount.root, true)) });
+    }
+    return { home: { slug: homeSlug, mountName: null, root: home.canonical, config: home.config, forge: home.forge, credentials: home.credentials ?? null }, mounts, unavailable };
+}
+export function allStores(reach) {
+    return [...reach.mounts, reach.home];
+}
+export async function listOpen(reach, homePulls) {
+    return Promise.all(allStores(reach).map(async (store) => {
+        try {
+            const pulls = store === reach.home && homePulls !== undefined ? await homePulls() : await store.forge.openPulls();
+            return { store, pulls, error: null };
+        }
+        catch (err) {
+            // A mount the credential cannot reach (an App not installed there) is unreadable, like an unreachable forge.
+            if (!(err instanceof ForgeRequestError) && !(store !== reach.home && err instanceof ContextureError))
+                throw err;
+            return { store, pulls: null, error: err.message };
+        }
+    }));
+}
+/** Landing order: parts in mounted stores first, in declared order, then the home store's part. */
+export function landingOrder(parts, reach, homeSlug) {
+    const rank = (slug) => {
+        if (slug === homeSlug)
+            return Number.MAX_SAFE_INTEGER;
+        const i = reach.mounts.findIndex((m) => m.slug === slug);
+        return i === -1 ? Number.MAX_SAFE_INTEGER - 1 : i;
+    };
+    return [...parts].sort((x, y) => rank(x.store) - rank(y.store));
+}
+/**
+ * Whether a pull request is read as a part of a session rather than on its own:
+ * it carries a session marker, and the session is homed in another store or
+ * the reading store declares mounts. A store with no `shared_stores` keeps
+ * today's path for its own sessions (design.md D9: nothing changes for a store
+ * that has not declared mounts); a pull request homed elsewhere is always its
+ * home's, so a mounted store never lands it.
+ */
+export function readAsSessionPart(pull, homeSlug, config) {
+    const identity = parseSessionMarker(pull.body);
+    if (identity === null)
+        return false;
+    return identity.home !== homeSlug || declaresSharedStores(config);
+}
+/**
+ * write-lifecycle spec ("Every pull request of a session carries the session"):
+ * every open pull request read as a session part, grouped by the session it
+ * names. A session homed elsewhere is grouped too, so a page can show it apart.
+ * `all` also groups this store's own sessions when it declares no mounts — for
+ * `ctxr land --session`, which names one explicitly.
+ */
+export function groupSessions(reach, listings, all = false) {
+    const groups = new Map();
+    const unreadable = listings.filter((l) => l.pulls === null).map((l) => l.store.slug);
+    for (const listing of listings) {
+        for (const pull of listing.pulls ?? []) {
+            const identity = parseSessionMarker(pull.body);
+            if (identity === null)
+                continue;
+            if (!all && !readAsSessionPart(pull, reach.home.slug, reach.home.config))
+                continue;
+            const key = sessionKey(identity);
+            let group = groups.get(key);
+            if (group === undefined) {
+                group = { identity, homedHere: identity.home === reach.home.slug, parts: [], unreadable };
+                groups.set(key, group);
+            }
+            group.parts.push({ store: listing.store, pull });
+        }
+    }
+    for (const group of groups.values()) {
+        const ordered = landingOrder(group.parts.map((p) => ({ ...p, store: p.store.slug, part: p })), reach, group.identity.home);
+        group.parts = ordered.map((o) => o.part);
+    }
+    return [...groups.values()];
+}
+/** Whether a pull request's body names a session homed in another store than `homeSlug`. */
+export function homedElsewhere(pull, homeSlug) {
+    const identity = parseSessionMarker(pull.body);
+    return identity !== null && identity.home !== homeSlug;
+}
+function timeOf(value) {
+    const t = value === null ? Number.NaN : Date.parse(value);
+    return Number.isNaN(t) ? 0 : t;
+}
+/** The latest session decision for `identity` among a part's reviews by the recording login. */
+function latestSessionDecision(reviews, recordingLogin, identity, id) {
+    let found = null;
+    for (const review of reviews) {
+        if (review.author !== recordingLogin)
+            continue;
+        const decision = parseDecision(review.body);
+        const session = decision?.session ?? null;
+        if (decision === null || session === null || !sessionsEqual(session.session, identity))
+            continue;
+        if (id !== undefined && session.id !== id)
+            continue;
+        const time = timeOf(review.submittedAt);
+        if (found === null || time >= found.time)
+            found = { decision, session, time };
+    }
+    return found;
+}
+/**
+ * change-approval spec ("A session is decided only on its home store's page,
+ * for every part it names"): the session's decision is the latest one on its
+ * record part alone, and it counts only while every part it names keeps the
+ * head it gives (or one carried over from it) and no open part carrying the
+ * marker is missing from it. A named part closed without merging blocks the
+ * session; a named part already merged counts as landed, and a session with
+ * some named parts landed and others still open is `retrying` — its landing
+ * was left unfinished and the next run goes on with it.
+ */
+export async function sessionState(input) {
+    const { git, reach, identity, recordingLogin } = input;
+    const stores = allStores(reach);
+    const storeOf = (slug) => stores.find((s) => s.slug === slug) ?? null;
+    const reads = new Map();
+    const readPart = (store, number) => {
+        const key = partKey({ store: store.slug, number });
+        let read = reads.get(key);
+        if (read === undefined) {
+            read = Promise.all([store.forge.reviews(number), store.forge.comments(number)]).then(([reviews, comments]) => ({ reviews, comments }));
+            reads.set(key, read);
+        }
+        return read;
+    };
+    // The latest session decision on any open part points at the record part; the record alone decides.
+    const openReads = await Promise.all(input.open.map(async (p) => ({ part: p, reads: await readPart(p.store, p.pull.number) })));
+    let candidate = null;
+    for (const { reads: r } of openReads) {
+        const found = latestSessionDecision(r.reviews, recordingLogin, identity);
+        if (found !== null && (candidate === null || found.time >= candidate.time))
+            candidate = found;
+    }
+    let record = null;
+    let recordComments = [];
+    if (candidate !== null) {
+        const recordRef = recordPartOf(candidate.session);
+        const recordStore = storeOf(recordRef.store);
+        if (recordStore === null && !input.homedHere)
+            record = candidate;
+        if (recordStore !== null) {
+            try {
+                const recordReads = await readPart(recordStore, recordRef.number);
+                record = latestSessionDecision(recordReads.reviews, recordingLogin, identity);
+                recordComments = recordReads.comments;
+            }
+            catch (err) {
+                if (!(err instanceof ForgeRequestError))
+                    throw err;
+                record = null;
+            }
+        }
+    }
+    const openPart = (slug, number) => input.open.find((p) => p.store.slug === slug && p.pull.number === number);
+    const unnamedOpen = (named) => input.open.filter((p) => !named.some((n) => n.store === p.store.slug && n.number === p.pull.number));
+    if (record === null) {
+        const parts = input.open.map((p) => ({
+            ref: null,
+            store: p.store,
+            storeSlug: p.store.slug,
+            number: p.pull.number,
+            pull: p.pull,
+            named: false,
+            status: 'pending',
+            hasCopy: false,
+            landing: null,
+        }));
+        return { identity, state: 'awaiting', decision: null, session: null, parts, reason: null, reasonPart: null };
+    }
+    const decided = record.session;
+    const parts = [];
+    for (const ref of decided.parts) {
+        const store = storeOf(ref.store);
+        const base = { ref, store, storeSlug: ref.store, number: ref.number, named: true };
+        if (store === null) {
+            parts.push({ ...base, pull: null, status: 'unknown', hasCopy: false, landing: null });
+            continue;
+        }
+        let pull;
+        let reads;
+        try {
+            pull = openPart(ref.store, ref.number)?.pull ?? (await store.forge.pull(ref.number));
+            reads = await readPart(store, ref.number);
+        }
+        catch (err) {
+            if (!(err instanceof ForgeRequestError))
+                throw err;
+            parts.push({ ...base, pull: null, status: 'unknown', hasCopy: false, landing: null });
+            continue;
+        }
+        const copy = latestSessionDecision(reads.reviews, recordingLogin, identity, decided.id);
+        const hasCopy = copy !== null;
+        if (pull.merged) {
+            parts.push({ ...base, pull, status: 'merged', hasCopy, landing: null });
+            continue;
+        }
+        if (pull.state !== 'open') {
+            parts.push({ ...base, pull, status: 'closed', hasCopy, landing: null });
+            continue;
+        }
+        // A landing record about this head, posted after this part's review of the decision, overrides it — as for one pull request.
+        const since = copy?.time ?? record.time;
+        let landing = null;
+        let landingTime = -1;
+        for (const comment of reads.comments) {
+            if (comment.author !== recordingLogin)
+                continue;
+            const mark = parseLandingMark(comment.body);
+            if (mark === null || mark.state === 'retrying')
+                continue;
+            const t = timeOf(comment.createdAt);
+            if (t >= landingTime) {
+                landing = mark;
+                landingTime = t;
+            }
+        }
+        if (landing !== null && (landing.head !== pull.headSha || landingTime < since))
+            landing = null;
+        let current = pull.headSha === ref.head;
+        // A carry-over the lander recorded on this part, for this decision, names the head it carried the approval to.
+        if (!current && copy !== null && copy.decision.head === pull.headSha && copy.decision.carriedFrom !== null)
+            current = true;
+        if (!current) {
+            const base = await baseRef(git, store.root, store.config.git.default_branch);
+            current = await carriesOver(git, store.root, base, ref.head, pull.headSha);
+        }
+        const status = !current
+            ? 'moved'
+            : landing?.state === 'blocked'
+                ? 'landing-blocked'
+                : landing?.state === 'needs-reapproval'
+                    ? 'landing-needs-reapproval'
+                    : 'ok';
+        parts.push({ ...base, pull, status, hasCopy, landing });
+    }
+    for (const p of unnamedOpen(decided.parts)) {
+        parts.push({ ref: null, store: p.store, storeSlug: p.store.slug, number: p.pull.number, pull: p.pull, named: false, status: 'unnamed', hasCopy: false, landing: null });
+    }
+    const name = (p) => `${p.storeSlug}#${p.number}`;
+    const result = (state, reason, part) => ({
+        identity,
+        state,
+        decision: record.decision,
+        session: decided,
+        parts,
+        reason,
+        reasonPart: part === null ? null : name(part),
+    });
+    if (record.decision.decision === 'request-changes')
+        return result('changes-requested', null, null);
+    const closed = parts.find((p) => p.status === 'closed');
+    if (closed !== undefined)
+        return result('blocked', `${name(closed)} was closed without being merged`, closed);
+    const unnamed = parts.find((p) => p.status === 'unnamed');
+    if (unnamed !== undefined)
+        return result('needs-reapproval', `${name(unnamed)} carries the session's marker but the decision does not name it`, unnamed);
+    const moved = parts.find((p) => p.status === 'moved');
+    if (moved !== undefined)
+        return result('needs-reapproval', `${name(moved)} is no longer at the head the decision approved`, moved);
+    const reapprove = parts.find((p) => p.status === 'landing-needs-reapproval');
+    if (reapprove !== undefined)
+        return result('needs-reapproval', `${name(reapprove)}: ${reapprove.landing.reason}`, reapprove);
+    const blocked = parts.find((p) => p.status === 'landing-blocked');
+    if (blocked !== undefined)
+        return result('blocked', `${name(blocked)}: ${blocked.landing.reason}`, blocked);
+    const counted = parts.filter((p) => input.homedHere || p.store !== null);
+    // A landing left unfinished for a passing reason is recorded on the record part, naming the part and why. It
+    // holds until that part lands: a later run that merges it clears it.
+    const retry = latestRetrying(recordComments, recordingLogin, record.time);
+    if (retry !== null) {
+        const held = counted.find((p) => name(p) === retry.part && p.status !== 'merged');
+        if (held !== undefined)
+            return result('retrying', `${retry.part}: ${retry.why}`, held);
+    }
+    const unknown = counted.find((p) => p.status === 'unknown');
+    if (unknown !== undefined)
+        return result('retrying', `${name(unknown)} cannot be read from its store`, unknown);
+    const merged = counted.filter((p) => p.status === 'merged').length;
+    if (merged > 0 && merged < counted.length) {
+        const next = counted.find((p) => p.status === 'ok');
+        return result('retrying', `${merged} of ${counted.length} parts landed; ${name(next)} is next`, next);
+    }
+    return result('approved', null, null);
+}
+/** The latest `retrying` landing record by the recording login posted after the decision: the part, and why. */
+function latestRetrying(comments, recordingLogin, since) {
+    let found = null;
+    let foundTime = -1;
+    for (const comment of comments) {
+        if (comment.author !== recordingLogin)
+            continue;
+        const mark = parseLandingMark(comment.body);
+        if (mark === null || mark.state !== 'retrying')
+            continue;
+        const t = timeOf(comment.createdAt);
+        if (t < since || t < foundTime)
+            continue;
+        const at = mark.reason.lastIndexOf(':');
+        if (at <= 0)
+            continue;
+        found = { part: mark.reason.slice(0, at), why: mark.reason.slice(at + 1) };
+        foundTime = t;
+    }
+    return found;
+}
+/**
+ * change-approval spec: a store's deciders, read from its `contexture.yaml` on its default branch on the forge at
+ * decision time (design.md D5) — never from a clone that can be behind. No `change_approval` means no deciders.
+ */
+export async function decidersOnForge(git, store) {
+    const prefix = await storePrefix(git, store.root);
+    const text = await store.forge.fileAt(`${prefix}${CONFIG_FILE_NAME}`, store.config.git.default_branch);
+    if (text === null)
+        return [];
+    let parsed;
+    try {
+        parsed = parseYaml(text);
+    }
+    catch {
+        return [];
+    }
+    const deciders = parsed?.change_approval?.deciders;
+    return Array.isArray(deciders) ? deciders.filter((d) => typeof d === 'string') : [];
+}
+/** A display name for a store in a session: its mount name, or the home store's slug. */
+export function storeLabel(store) {
+    return store.mountName === null ? store.slug : `${store.mountName} (${store.slug})`;
+}
+export { sessionKey };
+//# sourceMappingURL=session-group.js.map

package/dist/core/approval/session-group.js.map

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

package/dist/core/approval/session-marker.d.ts

@@ -0,0 +1,79 @@
+import type { StoreConfig } from '../../config/schema.js';
+import type { GitRunner } from '../git/exec.js';
+/**
+ * approve-sessions-across-stores (design.md D1, D2; the second critique's
+ * revisions 2 and 3): a session's identity is its home store's forge slug
+ * (`owner/repo`) and the home session's branch. It is derived from the
+ * session's own branch, worktree and repository alone — no identity file.
+ *
+ * A joined session (one started inside a mount with `ctxr session start
+ * --joins`) carries its home in its branch, `<prefix><owner>/<repo>/<home
+ * branch without its prefix>`, and in its worktree directory, where `/` cannot
+ * appear: `<prefix as a directory name><owner>--<repo>--<home branch without
+ * its prefix>`. A GitHub owner never contains `--`, and a generated session
+ * name never does, so the directory name splits back unambiguously. The
+ * directory keeps the identity after `ctxr session submit --branch` renames
+ * the branch.
+ *
+ * The pull request marker, appended by `ctxr session submit`, is what groups a
+ * session's pull requests across stores; branch names never are.
+ */
+export declare const SESSION_MARKER = "ctxr-session";
+export interface SessionIdentity {
+    /** The home store's forge repository slug, `owner/repo`. */
+    home: string;
+    /** The home session's branch, with the home store's prefix. */
+    branch: string;
+}
+/** One string per session, for grouping and comparison. Branches cannot contain `:`, so it is unambiguous. */
+export declare function sessionKey(identity: SessionIdentity): string;
+export declare function parseSessionKey(key: string): SessionIdentity | null;
+export declare function sessionsEqual(a: SessionIdentity | null, b: SessionIdentity | null): boolean;
+/** The marker `ctxr session submit` appends to a pull request body. */
+export declare function sessionMarker(identity: SessionIdentity): string;
+/**
+ * The session a pull request body names, or null — a body with no well-formed
+ * marker ending it is a session of its own (write-lifecycle spec). Like the
+ * decision marker, only a marker that ends the body counts.
+ */
+export declare function parseSessionMarker(body: string): SessionIdentity | null;
+/** Any session marker anywhere in `body`, well-formed or not — what `ctxr session submit` refuses in an agent's body. */
+export declare function findSessionMarker(body: string): string | null;
+/**
+ * The forge slug of a remote URL: GitHub's `owner/repo` for a github.com URL,
+ * and otherwise the URL's last two path segments without `.git` — the same
+ * shape for a mirror, a proxy, or a test's bare repository.
+ */
+export declare function forgeSlugOf(remoteUrl: string): string | null;
+/** The forge slug of the repository `cwd` is in, from its `origin`; null without one. */
+export declare function repositorySlug(git: GitRunner, cwd: string): Promise<string | null>;
+/** write-lifecycle spec: the joined session's branch — this store's prefix, the home slug, the home branch without its prefix. */
+export declare function joinedBranchName(prefix: string, home: SessionIdentity, homePrefix: string): string;
+/** The joined session's worktree directory name, which splits back into its home (see the module comment). */
+export declare function joinedWorktreeName(prefix: string, home: SessionIdentity, homePrefix: string): string;
+export interface IdentityInput {
+    /** The branch prefix of the store the session is in. */
+    prefix: string;
+    /** The branch prefix of the store that mounts it, when it is a mount; else the store's own. */
+    homePrefix: string;
+    /** This store's own forge slug; null without an `origin`. */
+    ownSlug: string | null;
+    /** The session worktree's directory name. */
+    worktreeName: string;
+    /** The session's current branch. */
+    branch: string;
+}
+/**
+ * A session's identity, derived from its worktree and branch alone. The
+ * worktree name decides first, because `ctxr session submit --branch` can
+ * rename the branch to anything, including a name shaped like a joined one,
+ * while the worktree keeps the name it was started with: a joined worktree
+ * name carries its home, and any other session worktree is its own home. Only
+ * a worktree whose name ctxr did not give falls back to the branch.
+ */
+export declare function sessionIdentityFor(input: IdentityInput): SessionIdentity | null;
+/** The identity of the session checked out in `worktreePath`, reading only its repository and, for a mount, the mounting store's configuration. */
+export declare function identityOfWorktree(git: GitRunner, config: StoreConfig, worktreePath: string, worktreeName: string, branch: string): Promise<SessionIdentity | null>;
+/** The approval route name of a session homed in a store: its home branch as a worktree directory name. */
+export declare function sessionRouteName(identity: SessionIdentity): string;
+//# sourceMappingURL=session-marker.d.ts.map

package/dist/core/approval/session-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-marker.d.ts","sourceRoot":"","sources":["../../../src/core/approval/session-marker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD,8GAA8G;AAC9G,wBAAgB,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAE5D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAMnE;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,EAAE,CAAC,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAE3F;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAMvE;AAED,yHAAyH;AACzH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY5D;AAED,yFAAyF;AACzF,wBAAsB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxF;AAMD,kIAAkI;AAClI,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAElG;AAED,8GAA8G;AAC9G,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGpG;AAED,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,eAAe,GAAG,IAAI,CAkB/E;AAED,mJAAmJ;AACnJ,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CASzK;AAED,2GAA2G;AAC3G,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAElE"}