@open-agent-toolkit/cli 0.3.18 → 0.3.20

package/dist/commands/project/delivery/index.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+export { createProjectDeliveryCheckCommand, deliveryEffectiveScope, evaluateSubjectEvidence, loadGoalDeliveryProject, } from './check.js';
+export { applyObservationWrites, createProjectDeliveryRefreshCommand, endpointSatisfied, planDeliveryRefresh, } from './refresh.js';
+export { classifyPath, evaluateDeliveryReview, evaluateGateCarrier, evaluateSuccessor, type CarrierEvaluation, type CarrierExpectation, type EvidenceScope, type ReviewEvaluation, type SuccessorResult, } from './evidence.js';
+/** `oat project delivery`: the goal delivery registry's observation surface. */
+export declare function createProjectDeliveryCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/project/delivery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/delivery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,OAAO,EACL,iCAAiC,EACjC,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,sBAAsB,EACtB,mCAAmC,EACnC,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AAEpB,gFAAgF;AAChF,wBAAgB,4BAA4B,IAAI,OAAO,CAOtD"}

package/dist/commands/project/delivery/index.js

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+import { createProjectDeliveryCheckCommand } from './check.js';
+import { createProjectDeliveryRefreshCommand } from './refresh.js';
+export { createProjectDeliveryCheckCommand, deliveryEffectiveScope, evaluateSubjectEvidence, loadGoalDeliveryProject, } from './check.js';
+export { applyObservationWrites, createProjectDeliveryRefreshCommand, endpointSatisfied, planDeliveryRefresh, } from './refresh.js';
+export { classifyPath, evaluateDeliveryReview, evaluateGateCarrier, evaluateSuccessor, } from './evidence.js';
+/** `oat project delivery`: the goal delivery registry's observation surface. */
+export function createProjectDeliveryCommand() {
+    return new Command('delivery')
+        .description('Observe goal delivery registry members and check delivery evidence freshness')
+        .addCommand(createProjectDeliveryRefreshCommand())
+        .addCommand(createProjectDeliveryCheckCommand());
+}

package/dist/commands/project/delivery/refresh.d.ts

@@ -0,0 +1,110 @@
+import { type CommandContext, type GlobalOptions } from '../../../app/command-context.js';
+import { type GhRunner } from '../../project/links/refresh.js';
+import { type GitRunner } from '../../project/sync/git.js';
+import { type DeliveryMember, type DeliveryMemberStatus, type GoalDelivery } from '@open-agent-toolkit/control-plane';
+import { Command } from 'commander';
+import { type DeliveryProjectDependencies, type GoalDeliveryProject } from './check.js';
+import { type CarrierEvaluation, type ReviewEvaluation } from './evidence.js';
+/**
+ * `oat project delivery refresh` (design "Endpoint observation and
+ * refresh"). It observes every registered delivery member through `gh pr
+ * view <url> --json state,headRefOid,baseRefOid` and persists observations
+ * and derived freshness only:
+ *
+ * - member `observed_head`, `observed_base` and `status`;
+ * - delivery `status: at_endpoint` once the agreed endpoint is observed, and
+ *   the first observed attainment in `endpoint_attainment`;
+ * - `integrated_review.disposition: stale` and the milestone exit carrier's
+ *   `freshness: stale` with `freshness_reason` when the shared evaluator
+ *   finds the evidence no longer covers the observation.
+ *
+ * It never writes `oat_milestone_status` or `oat_goal_recovery`, never
+ * rewrites a reviewed revision, a member base or the first endpoint
+ * attainment, and never manufactures a passed review or a fresh carrier.
+ * Observation is atomic: if any member cannot be observed nothing is written.
+ */
+export interface MemberObservation {
+    head: string;
+    base: string;
+    status: DeliveryMemberStatus;
+}
+export type ObservationWriteMode = 'observe' | 'once';
+/**
+ * A path segment: a literal key or index, or a symbolic delivery/milestone
+ * reference resolved against the raw YAML when the write is applied.
+ */
+export type ObservationPathSegment = string | number | {
+    deliveryId: string;
+} | {
+    milestone: string;
+};
+/**
+ * One state write. `observe` writes may replace a stored observation; `once`
+ * writes apply only while the stored value is unset. The never-overwrite rule
+ * in `mayReplaceStoredValue` decides which stored values a write may replace.
+ */
+export interface ObservationWrite {
+    path: ObservationPathSegment[];
+    value: unknown;
+    mode: ObservationWriteMode;
+}
+export interface DeliveryRefreshResult {
+    deliveryId: string;
+    milestone: string | null;
+    status: GoalDelivery['status'];
+    endpointSatisfied: boolean;
+    members: {
+        url: string | null;
+        observed_head: string | null;
+        observed_base: string | null;
+        status: DeliveryMemberStatus | null;
+    }[];
+    review: ReviewEvaluation;
+}
+export interface RefreshReport {
+    deliveries: DeliveryRefreshResult[];
+    exitCarriers: {
+        milestone: string;
+        delivery: string;
+        evaluation: CarrierEvaluation;
+    }[];
+    writes: ObservationWrite[];
+    changed: boolean;
+}
+export declare function observeMember(gh: GhRunner, url: string): Promise<MemberObservation | string>;
+/** Endpoint satisfaction on observed member state (design "Endpoint satisfaction"). */
+export declare function endpointSatisfied(endpoint: GoalDelivery['endpoint'], members: readonly Pick<DeliveryMember, 'status'>[]): boolean;
+/**
+ * Compute the refresh for a loaded goal project: observe members, derive
+ * endpoint and freshness, and return the state writes. Pure apart from the
+ * injected `gh` and `git` runners.
+ */
+export declare function planDeliveryRefresh(project: GoalDeliveryProject, runners: {
+    gh: GhRunner;
+    git: GitRunner;
+    now: () => Date;
+}): Promise<RefreshReport | {
+    failures: string[];
+}>;
+/**
+ * Apply refresh writes to `state.md` under the never-overwrite rule
+ * (`mayReplaceStoredValue`). Returns the new content, or the original when
+ * nothing changed.
+ */
+export declare function applyObservationWrites(stateContent: string, writes: readonly ObservationWrite[]): {
+    content: string;
+    changed: boolean;
+    applied: ObservationWrite[];
+};
+export interface DeliveryRefreshDependencies extends DeliveryProjectDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    gh: GhRunner;
+    git: GitRunner;
+    writeFile: (path: string, content: string) => Promise<void>;
+    now: () => Date;
+}
+export declare function refreshDeliveries(projectArgument: string, cwd: string, dependencies: DeliveryRefreshDependencies): Promise<RefreshReport | {
+    failures: string[];
+}>;
+export declare function createProjectDeliveryRefreshCommand(overrides?: Partial<DeliveryRefreshDependencies>): Command;
+//# sourceMappingURL=refresh.d.ts.map

package/dist/commands/project/delivery/refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/delivery/refresh.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAK9E,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAIL,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACzB,MAAM,SAAS,CAAC;AACjB,OAAO,EAIL,KAAK,iBAAiB,EAEtB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,MAAM,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,MAAM,GACN;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GACtB;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1B;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,sBAAsB,EAAE,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,oBAAoB,CAAC;CAC5B;AA8DD,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;KACrC,EAAE,CAAC;IACJ,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,YAAY,EAAE;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,iBAAiB,CAAC;KAC/B,EAAE,CAAC;IACJ,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CAClB;AAUD,wBAAsB,aAAa,CACjC,EAAE,EAAE,QAAQ,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,GAAG,MAAM,CAAC,CA+BrC;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,EAClC,OAAO,EAAE,SAAS,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,EAAE,GACjD,OAAO,CAOT;AAOD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,IAAI,CAAA;CAAE,GACzD,OAAO,CAAC,aAAa,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA8LjD;AAgED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAkDpE;AAMD,MAAM,WAAW,2BAA4B,SAAQ,2BAA2B;IAC9E,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,EAAE,EAAE,QAAQ,CAAC;IACb,GAAG,EAAE,SAAS,CAAC;IACf,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAWD,wBAAsB,iBAAiB,CACrC,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,2BAA2B,GACxC,OAAO,CAAC,aAAa,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAejD;AAED,wBAAgB,mCAAmC,CACjD,SAAS,GAAE,OAAO,CAAC,2BAA2B,CAAM,GACnD,OAAO,CA2DT"}

package/dist/commands/project/delivery/refresh.js

@@ -0,0 +1,441 @@
+import { writeFile } from 'node:fs/promises';
+import { buildCommandContext, } from '../../../app/command-context.js';
+import { defaultGhRunner, } from '../../project/links/refresh.js';
+import { defaultGitRunner } from '../../project/sync/git.js';
+import { getFrontmatterBlock } from '../../shared/frontmatter.js';
+import { replaceFrontmatter } from '../../shared/frontmatter-write.js';
+import { readGlobalOptions } from '../../shared/shared.utils.js';
+import { CliError } from '../../../errors/cli-error.js';
+import { normalizeMilestoneId, } from '@open-agent-toolkit/control-plane';
+import { Command } from 'commander';
+import YAML, { isMap, isScalar, isSeq } from 'yaml';
+import { DEFAULT_DELIVERY_PROJECT_DEPENDENCIES, deliveryEffectiveScope, loadGoalDeliveryProject, } from './check.js';
+import { deliveryEvidenceScope, evaluateDeliveryReview, evaluateGateCarrier, } from './evidence.js';
+/** The only frontmatter keys a refresh writes under. */
+const REFRESH_WRITE_ROOTS = new Set(['oat_deliveries', 'oat_milestone_gates']);
+const MEMBER_OBSERVATION_LEAVES = new Set([
+    'observed_head',
+    'observed_base',
+    'status',
+]);
+const CARRIER_FRESHNESS_LEAVES = new Set(['freshness', 'freshness_reason']);
+/**
+ * The never-overwrite rule (A4), structural rather than by leaf name: a
+ * stored value may be replaced only by an `observe` write at one of the
+ * observation paths —
+ *
+ * - `oat_deliveries[d].members[i].{observed_head, observed_base, status}`;
+ * - `oat_deliveries[d].status`, only while the stored value is `open`;
+ * - `oat_deliveries[d].integrated_review.disposition`;
+ * - `oat_milestone_gates[m].{plan, exit}.{freshness, freshness_reason}`.
+ *
+ * Every other path — reviewed revisions, member bases, frozen scopes, review
+ * identities, carrier outcomes and the first endpoint attainment — is
+ * historical evidence and is written only while unset.
+ */
+function mayReplaceStoredValue(write, stored) {
+    if (write.mode !== 'observe')
+        return false;
+    const [root, , ...rest] = write.path;
+    if (root === 'oat_deliveries') {
+        if (rest.length === 3 &&
+            rest[0] === 'members' &&
+            typeof rest[1] === 'number' &&
+            typeof rest[2] === 'string' &&
+            MEMBER_OBSERVATION_LEAVES.has(rest[2])) {
+            return true;
+        }
+        if (rest.length === 1 && rest[0] === 'status') {
+            return stored === 'open';
+        }
+        return (rest.length === 2 &&
+            rest[0] === 'integrated_review' &&
+            rest[1] === 'disposition');
+    }
+    if (root === 'oat_milestone_gates') {
+        return (rest.length === 2 &&
+            (rest[0] === 'exit' || rest[0] === 'plan') &&
+            typeof rest[1] === 'string' &&
+            CARRIER_FRESHNESS_LEAVES.has(rest[1]));
+    }
+    return false;
+}
+const PR_STATES = {
+    OPEN: 'open',
+    MERGED: 'merged',
+    CLOSED: 'closed',
+};
+const SHA_PATTERN = /^[0-9a-f]{40}$/;
+export async function observeMember(gh, url) {
+    const viewed = await gh.run([
+        'pr',
+        'view',
+        url,
+        '--json',
+        'state,headRefOid,baseRefOid',
+    ]);
+    if (viewed.code !== 0) {
+        return viewed.missing
+            ? 'the GitHub CLI is unavailable'
+            : `gh pr view failed: ${viewed.stderr || viewed.stdout || `exit ${viewed.code}`}`;
+    }
+    try {
+        const parsed = JSON.parse(viewed.stdout);
+        const status = PR_STATES[String(parsed['state'] ?? '')];
+        const head = parsed['headRefOid'];
+        const base = parsed['baseRefOid'];
+        if (status === undefined ||
+            typeof head !== 'string' ||
+            typeof base !== 'string' ||
+            !SHA_PATTERN.test(head) ||
+            !SHA_PATTERN.test(base)) {
+            return 'gh returned an incomplete observation';
+        }
+        return { head, base, status };
+    }
+    catch {
+        return 'gh returned output that is not JSON';
+    }
+}
+/** Endpoint satisfaction on observed member state (design "Endpoint satisfaction"). */
+export function endpointSatisfied(endpoint, members) {
+    if (members.length === 0 || endpoint === null)
+        return false;
+    return endpoint === 'merged'
+        ? members.every((member) => member.status === 'merged')
+        : members.every((member) => member.status === 'open' || member.status === 'merged');
+}
+/** Deliveries a refresh observes: registered and not replaced. */
+function isObservable(delivery) {
+    return delivery.status === 'open' || delivery.status === 'at_endpoint';
+}
+/**
+ * Compute the refresh for a loaded goal project: observe members, derive
+ * endpoint and freshness, and return the state writes. Pure apart from the
+ * injected `gh` and `git` runners.
+ */
+export async function planDeliveryRefresh(project, runners) {
+    const deliveries = project.state.deliveries ?? [];
+    const observations = new Map();
+    const failures = [];
+    for (const delivery of deliveries.filter(isObservable)) {
+        const observed = [];
+        for (const member of delivery.members) {
+            if (member.url === null) {
+                failures.push(`${delivery.delivery_id}: a member has no URL to observe`);
+                observed.push(null);
+                continue;
+            }
+            const result = await observeMember(runners.gh, member.url);
+            if (typeof result === 'string') {
+                failures.push(`${delivery.delivery_id} ${member.url}: ${result}`);
+                observed.push(null);
+            }
+            else {
+                observed.push(result);
+            }
+        }
+        observations.set(delivery.delivery_id, observed);
+    }
+    if (failures.length > 0) {
+        // Failure to observe a required member is never endpoint success, and a
+        // partial refresh would mix observations from different moments.
+        return { failures };
+    }
+    const writes = [];
+    const results = [];
+    const observedById = new Map();
+    const deliveryPath = (delivery) => [
+        'oat_deliveries',
+        { deliveryId: delivery.delivery_id },
+    ];
+    for (const delivery of deliveries.filter(isObservable)) {
+        const observed = observations.get(delivery.delivery_id) ?? [];
+        const members = delivery.members.map((member, index) => {
+            const observation = observed[index];
+            return observation
+                ? {
+                    ...member,
+                    observed_head: observation.head,
+                    observed_base: observation.base,
+                    status: observation.status,
+                }
+                : member;
+        });
+        for (const [index, observation] of observed.entries()) {
+            if (!observation)
+                continue;
+            const memberPath = [...deliveryPath(delivery), 'members', index];
+            writes.push({
+                path: [...memberPath, 'observed_head'],
+                value: observation.head,
+                mode: 'observe',
+            }, {
+                path: [...memberPath, 'observed_base'],
+                value: observation.base,
+                mode: 'observe',
+            }, {
+                path: [...memberPath, 'status'],
+                value: observation.status,
+                mode: 'observe',
+            });
+        }
+        const satisfied = endpointSatisfied(delivery.endpoint, members);
+        let status = delivery.status;
+        if (satisfied) {
+            if (status === 'open') {
+                status = 'at_endpoint';
+                writes.push({
+                    path: [...deliveryPath(delivery), 'status'],
+                    value: 'at_endpoint',
+                    mode: 'observe',
+                });
+            }
+            writes.push({
+                path: [...deliveryPath(delivery), 'endpoint_attainment'],
+                value: {
+                    observed_at: runners.now().toISOString(),
+                    members: members.map((member) => ({
+                        url: member.url,
+                        head: member.observed_head,
+                        base: member.observed_base,
+                        status: member.status,
+                    })),
+                },
+                mode: 'once',
+            });
+        }
+        const observedDelivery = { ...delivery, members, status };
+        observedById.set(delivery.delivery_id, observedDelivery);
+        const review = await evaluateDeliveryReview(runners.git, evidenceScope(project, observedDelivery), observedDelivery, deliveryEffectiveScope(deliveries, observedDelivery));
+        if (delivery.integrated_review !== null &&
+            !review.fresh &&
+            delivery.integrated_review.disposition === 'passed') {
+            writes.push({
+                path: [...deliveryPath(delivery), 'integrated_review', 'disposition'],
+                value: 'stale',
+                mode: 'observe',
+            });
+        }
+        results.push({
+            deliveryId: delivery.delivery_id,
+            milestone: delivery.milestone,
+            status,
+            endpointSatisfied: satisfied,
+            members: members.map((member) => ({
+                url: member.url,
+                observed_head: member.observed_head,
+                observed_base: member.observed_base,
+                status: member.status,
+            })),
+            review,
+        });
+    }
+    // The milestone exit carrier is judged for each milestone's latest
+    // registered delivery. Refresh records only staleness: it never upgrades a
+    // carrier to fresh, which only implement's scoped closeout writes.
+    const exitCarriers = [];
+    const latestByMilestone = new Map();
+    for (const delivery of deliveries) {
+        const observed = observedById.get(delivery.delivery_id);
+        if (observed && observed.milestone !== null) {
+            latestByMilestone.set(observed.milestone, observed);
+        }
+    }
+    for (const [milestone, delivery] of latestByMilestone) {
+        const carrier = project.state.milestoneGates?.[milestone]?.exit ?? null;
+        if (carrier === null)
+            continue;
+        const scope = evidenceScope(project, delivery);
+        const evaluation = await evaluateGateCarrier(carrier, {
+            kind: 'code',
+            scope: deliveryEffectiveScope(deliveries, delivery),
+            match: 'covers',
+            overrideDisabled: project.exitGateDisabled,
+        }, {
+            git: runners.git,
+            scope,
+            publishedHeads: delivery.members.map((member) => member.observed_head),
+        });
+        exitCarriers.push({
+            milestone,
+            delivery: delivery.delivery_id,
+            evaluation,
+        });
+        if (evaluation.freshness === 'stale') {
+            const carrierPath = [
+                'oat_milestone_gates',
+                { milestone },
+                'exit',
+            ];
+            writes.push({
+                path: [...carrierPath, 'freshness'],
+                value: 'stale',
+                mode: 'observe',
+            }, {
+                path: [...carrierPath, 'freshness_reason'],
+                value: `delivery refresh (${delivery.delivery_id}): ${evaluation.reason ?? 'stale'}`,
+                mode: 'observe',
+            });
+        }
+    }
+    return { deliveries: results, exitCarriers, writes, changed: false };
+}
+function evidenceScope(project, delivery) {
+    return deliveryEvidenceScope(project, project.state.deliveries ?? [], delivery);
+}
+// ---------------------------------------------------------------------------
+// Applying writes to state.md frontmatter
+// ---------------------------------------------------------------------------
+function isUnsetNode(value) {
+    return (value === undefined ||
+        value === null ||
+        (isScalar(value) && (value.value === null || value.value === '')));
+}
+/**
+ * Resolve the symbolic path segments (`{ deliveryId }`, `{ milestone }`) to
+ * the raw YAML indices and keys, so a write lands on the entry the reader
+ * parsed even when the raw list holds unparseable entries or `m1` spelling.
+ */
+function resolvePath(document, path) {
+    const resolved = [];
+    for (const segment of path) {
+        if (typeof segment !== 'object') {
+            resolved.push(segment);
+            continue;
+        }
+        const parent = document.getIn(resolved, true);
+        if ('deliveryId' in segment) {
+            if (!isSeq(parent))
+                return null;
+            const index = parent.items.findIndex((item) => isMap(item) && String(item.get('delivery_id')) === segment.deliveryId);
+            if (index < 0)
+                return null;
+            resolved.push(index);
+        }
+        else {
+            if (!isMap(parent))
+                return null;
+            const key = parent.items
+                .map((pair) => (isScalar(pair.key) ? String(pair.key.value) : null))
+                .find((raw) => raw !== null && normalizeMilestoneId(raw) === segment.milestone);
+            if (key === undefined || key === null)
+                return null;
+            resolved.push(key);
+        }
+    }
+    return resolved;
+}
+/**
+ * Apply refresh writes to `state.md` under the never-overwrite rule
+ * (`mayReplaceStoredValue`). Returns the new content, or the original when
+ * nothing changed.
+ */
+export function applyObservationWrites(stateContent, writes) {
+    const block = getFrontmatterBlock(stateContent);
+    if (block === null) {
+        throw new CliError('state.md has no frontmatter to refresh', 1);
+    }
+    const document = YAML.parseDocument(block, { uniqueKeys: true });
+    if (document.errors.length > 0) {
+        throw new CliError(`state.md frontmatter is malformed: ${document.errors[0]?.message ?? 'YAML error'}`, 1);
+    }
+    const applied = [];
+    for (const write of writes) {
+        const [root] = write.path;
+        if (typeof root !== 'string' || !REFRESH_WRITE_ROOTS.has(root)) {
+            // Refresh never writes milestone status, recovery or any other key.
+            throw new CliError(`delivery refresh may not write ${String(root)}; it records delivery observations and derived freshness only`, 2);
+        }
+        const path = resolvePath(document, write.path);
+        if (path === null)
+            continue;
+        const current = document.getIn(path, true);
+        if (!isUnsetNode(current) &&
+            !mayReplaceStoredValue(write, isScalar(current) ? current.value : document.getIn(path))) {
+            continue;
+        }
+        const previous = document.getIn(path);
+        if (JSON.stringify(previous) === JSON.stringify(write.value))
+            continue;
+        document.setIn(path, document.createNode(write.value, { flow: false }));
+        applied.push({ ...write, path });
+    }
+    if (applied.length === 0) {
+        return { content: stateContent, changed: false, applied };
+    }
+    const nextBlock = document.toString({ lineWidth: 0 }).replace(/\n$/, '');
+    return {
+        content: replaceFrontmatter(stateContent, nextBlock),
+        changed: true,
+        applied,
+    };
+}
+const DEFAULT_REFRESH_DEPENDENCIES = {
+    ...DEFAULT_DELIVERY_PROJECT_DEPENDENCIES,
+    buildCommandContext,
+    gh: defaultGhRunner,
+    git: defaultGitRunner,
+    writeFile: (path, content) => writeFile(path, content, 'utf8'),
+    now: () => new Date(),
+};
+export async function refreshDeliveries(projectArgument, cwd, dependencies) {
+    const project = await loadGoalDeliveryProject(projectArgument, cwd, dependencies);
+    const planned = await planDeliveryRefresh(project, dependencies);
+    if ('failures' in planned) {
+        return planned;
+    }
+    const result = applyObservationWrites(project.stateContent, planned.writes);
+    if (result.changed) {
+        await dependencies.writeFile(project.statePath, result.content);
+    }
+    return { ...planned, writes: result.applied, changed: result.changed };
+}
+export function createProjectDeliveryRefreshCommand(overrides = {}) {
+    const dependencies = { ...DEFAULT_REFRESH_DEPENDENCIES, ...overrides };
+    return new Command('refresh')
+        .description('Observe registered goal delivery members with gh and persist observations, endpoint attainment and derived staleness in state.md')
+        .requiredOption('--project <path>', 'Goal project path')
+        .action(async (options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        try {
+            const report = await refreshDeliveries(options.project, context.cwd, dependencies);
+            if ('failures' in report) {
+                const message = `Delivery refresh observed nothing: ${report.failures.join('; ')}`;
+                if (context.json) {
+                    context.logger.json({
+                        status: 'failed',
+                        failures: report.failures,
+                        message,
+                    });
+                }
+                else {
+                    context.logger.error(message);
+                }
+                process.exitCode = 1;
+                return;
+            }
+            if (context.json) {
+                context.logger.json({ status: 'ok', ...report });
+            }
+            else {
+                context.logger.info([
+                    `Refreshed ${report.deliveries.length} delivery(ies)${report.changed ? '' : '; state.md unchanged'}.`,
+                    ...report.deliveries.map((delivery) => `  ${delivery.deliveryId}: ${delivery.status ?? 'unknown'}${delivery.endpointSatisfied ? ' (endpoint observed)' : ''}; review ${delivery.review.fresh ? 'fresh' : `stale: ${delivery.review.reason ?? 'unknown'}`}`),
+                    ...report.exitCarriers.map((carrier) => `  ${carrier.milestone} exit carrier: ${carrier.evaluation.freshness}${carrier.evaluation.reason ? ` (${carrier.evaluation.reason})` : ''}`),
+                ].join('\n'));
+            }
+            process.exitCode = 0;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (context.json) {
+                context.logger.json({ status: 'error', message });
+            }
+            else {
+                context.logger.error(message);
+            }
+            process.exitCode = error instanceof CliError ? error.exitCode : 1;
+        }
+    });
+}

package/dist/commands/project/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyBpC,wBAAgB,oBAAoB,IAAI,OAAO,CAyB9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0BpC,wBAAgB,oBAAoB,IAAI,OAAO,CA0B9C"}

package/dist/commands/project/index.js

@@ -3,6 +3,7 @@ import { createProjectArchiveCommand } from './archive/index.js';
 import { createProjectCloseoutCheckCommand } from './closeout-check/index.js';
 import { createProjectCompleteDiscoveryCommand } from './complete-discovery/index.js';
 import { createProjectCompleteStateCommand } from './complete-state/index.js';
+import { createProjectDeliveryCommand } from './delivery/index.js';
 import { createProjectDispatchCommand } from './dispatch/index.js';
 import { createProjectDispatchCeilingCommand } from './dispatch-ceiling/index.js';
 import { createProjectLinksCommand } from './links/index.js';
@@ -28,6 +29,7 @@ export function createProjectCommand() {
         .addCommand(createProjectCloseoutCheckCommand())
         .addCommand(createProjectCompleteDiscoveryCommand())
         .addCommand(createProjectCompleteStateCommand())
+        .addCommand(createProjectDeliveryCommand())
         .addCommand(createProjectDispatchCommand())
         .addCommand(createProjectDispatchCeilingCommand())
         .addCommand(createProjectListCommand())

package/dist/commands/project/log/append.d.ts

@@ -4,6 +4,12 @@ import { type ResolvedConfig } from '../../../config/resolve.js';
 import { Command } from 'commander';
 import { type ProjectLogSeal } from './check.js';
 export declare const PROJECT_LOG_FILENAME = "project-log.md";
+/**
+ * Where `appendEntry` inserts: entries go before the end-of-run synthesis
+ * section, so an append is not a byte-suffix of the previous log. The
+ * delivery-evidence evaluator reads the same marker to recognize an append.
+ */
+export declare const SYNTHESIS_HEADING_PREFIX = "\n## End-of-run synthesis";
 /**
  * Directory, relative to a project, that holds gate partial-finalization
  * receipts. Ignored by the repository so a receipt never dirties the tree.

package/dist/commands/project/log/append.d.ts.map

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

package/dist/commands/project/log/append.js

@@ -16,7 +16,12 @@ import { Command } from 'commander';
 import { findProjectLogAmbiguity, findProjectLogSeal, unreachableProjectLogSealError, } from './check.js';
 import { composeJudgmentHeading, composeStructuralHeading, containsAmbiguousProjectLogMarker, isProjectLogEntryMarker, findProjectLogSealHeadingLine, isProjectLogSealHeading, isProjectLogSectionMarker, PROJECT_LOG_AREA_MAX_LENGTH, PROJECT_LOG_HEADING_DELIMITER, PROJECT_LOG_LINE_TERMINATOR_RE, PROJECT_LOG_LONE_TERMINATOR_RE, PROJECT_LOG_SCOPES, PROJECT_LOG_TYPES, normalizeProjectLogLineEndings, splitProjectLogLines, } from './grammar.js';
 export const PROJECT_LOG_FILENAME = 'project-log.md';
-const SYNTHESIS_HEADING_PREFIX = '\n## End-of-run synthesis';
+/**
+ * Where `appendEntry` inserts: entries go before the end-of-run synthesis
+ * section, so an append is not a byte-suffix of the previous log. The
+ * delivery-evidence evaluator reads the same marker to recognize an append.
+ */
+export const SYNTHESIS_HEADING_PREFIX = '\n## End-of-run synthesis';
 /**
  * Directory, relative to a project, that holds gate partial-finalization
  * receipts. Ignored by the repository so a receipt never dirties the tree.