@schnick371/devsteps-shared 1.1.0-next.3 → 2.0.0-next.1

package/dist/schemas/coord.d.ts

@@ -0,0 +1,246 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Coordination store records (TASK-957, BUG-153).
+ * One schema serves writing and reading: a record that fails it on read is quarantined.
+ * The server owns every field in `COORD_SERVER_FIELDS`; a caller that sends one is refused.
+ */
+import { z } from 'zod';
+export declare const COORD_SCHEMA_VERSION = 1;
+export declare const COORD_KINDS: readonly ['designation', 'handover', 'request', 'dispatch'];
+export type CoordKind = (typeof COORD_KINDS)[number];
+export declare const COORD_ID_PREFIX: Readonly<Record<CoordKind, string>>;
+export declare const COORD_ID_RE: RegExp;
+export declare const COORD_SERVER_FIELDS: readonly ['id', 'status', 'created_at', 'updated_at', 'version', 'expires_at', 'writer', 'schema_version'];
+export declare const COORD_ROLES: readonly ['coordinator', 'architect', 'engineer', 'liaison', 'consultant'];
+export declare const COORD_VERDICTS: readonly ['ACK', 'DONE', 'PASS', 'FAIL', 'BLOCKED', 'DECIDE'];
+export declare const COORD_OUTCOMES: readonly ['new-item', 'extends', 'answered', 'declined', 'deferred'];
+export declare const COORD_LIMITS: {
+    readonly handoverField: 4000;
+    readonly requestText: 4000;
+    readonly statusText: 1000;
+    readonly openDesignations: 50;
+    readonly openDispatches: 200;
+};
+/** Printable text on one line; designations travel in message headers. */
+export declare const CoordDesignationName: z.ZodString;
+/** Role plus optional area: `coordinator`, `engineer:customization`. */
+export declare const CoordRoleSlot: z.ZodString;
+export declare const CoordDesignationRecord: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    version: z.ZodNumber;
+    expires_at: z.ZodNullable<z.ZodString>;
+    writer: z.ZodObject<{
+        designation: z.ZodString;
+        client: z.ZodString;
+        retired: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strip>;
+    kind: z.ZodLiteral<"designation">;
+    status: z.ZodEnum<{
+        open: "open";
+        retired: "retired";
+    }>;
+    name: z.ZodString;
+    role: z.ZodEnum<{
+        architect: "architect";
+        consultant: "consultant";
+        coordinator: "coordinator";
+        engineer: "engineer";
+        liaison: "liaison";
+    }>;
+}, z.core.$strip>;
+export declare const CoordHandoverRecord: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    version: z.ZodNumber;
+    expires_at: z.ZodNullable<z.ZodString>;
+    writer: z.ZodObject<{
+        designation: z.ZodString;
+        client: z.ZodString;
+        retired: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strip>;
+    kind: z.ZodLiteral<"handover">;
+    status: z.ZodLiteral<"current">;
+    slot: z.ZodString;
+    state: z.ZodString;
+    assignments: z.ZodString;
+    queue: z.ZodString;
+    next_steps: z.ZodString;
+}, z.core.$strip>;
+export declare const CoordRequestRecord: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    version: z.ZodNumber;
+    expires_at: z.ZodNullable<z.ZodString>;
+    writer: z.ZodObject<{
+        designation: z.ZodString;
+        client: z.ZodString;
+        retired: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strip>;
+    kind: z.ZodLiteral<"request">;
+    status: z.ZodEnum<{
+        acknowledged: "acknowledged";
+        open: "open";
+    }>;
+    text: z.ZodString;
+    urgent: z.ZodBoolean;
+    outcome: z.ZodOptional<z.ZodEnum<{
+        answered: "answered";
+        declined: "declined";
+        deferred: "deferred";
+        extends: "extends";
+        "new-item": "new-item";
+    }>>;
+    target_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const CoordDispatchRecord: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    version: z.ZodNumber;
+    expires_at: z.ZodNullable<z.ZodString>;
+    writer: z.ZodObject<{
+        designation: z.ZodString;
+        client: z.ZodString;
+        retired: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strip>;
+    kind: z.ZodLiteral<"dispatch">;
+    status: z.ZodEnum<{
+        closed: "closed";
+        dispatched: "dispatched";
+        reported: "reported";
+    }>;
+    holder: z.ZodString;
+    item_id: z.ZodString;
+    status_text: z.ZodOptional<z.ZodString>;
+    verdict: z.ZodOptional<z.ZodEnum<{
+        ACK: "ACK";
+        BLOCKED: "BLOCKED";
+        DECIDE: "DECIDE";
+        DONE: "DONE";
+        FAIL: "FAIL";
+        PASS: "PASS";
+    }>>;
+    evidence_ref: z.ZodOptional<z.ZodString>;
+    closed_reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const CoordRecord: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    version: z.ZodNumber;
+    expires_at: z.ZodNullable<z.ZodString>;
+    writer: z.ZodObject<{
+        designation: z.ZodString;
+        client: z.ZodString;
+        retired: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strip>;
+    kind: z.ZodLiteral<"designation">;
+    status: z.ZodEnum<{
+        open: "open";
+        retired: "retired";
+    }>;
+    name: z.ZodString;
+    role: z.ZodEnum<{
+        architect: "architect";
+        consultant: "consultant";
+        coordinator: "coordinator";
+        engineer: "engineer";
+        liaison: "liaison";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    version: z.ZodNumber;
+    expires_at: z.ZodNullable<z.ZodString>;
+    writer: z.ZodObject<{
+        designation: z.ZodString;
+        client: z.ZodString;
+        retired: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strip>;
+    kind: z.ZodLiteral<"handover">;
+    status: z.ZodLiteral<"current">;
+    slot: z.ZodString;
+    state: z.ZodString;
+    assignments: z.ZodString;
+    queue: z.ZodString;
+    next_steps: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    version: z.ZodNumber;
+    expires_at: z.ZodNullable<z.ZodString>;
+    writer: z.ZodObject<{
+        designation: z.ZodString;
+        client: z.ZodString;
+        retired: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strip>;
+    kind: z.ZodLiteral<"request">;
+    status: z.ZodEnum<{
+        acknowledged: "acknowledged";
+        open: "open";
+    }>;
+    text: z.ZodString;
+    urgent: z.ZodBoolean;
+    outcome: z.ZodOptional<z.ZodEnum<{
+        answered: "answered";
+        declined: "declined";
+        deferred: "deferred";
+        extends: "extends";
+        "new-item": "new-item";
+    }>>;
+    target_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    version: z.ZodNumber;
+    expires_at: z.ZodNullable<z.ZodString>;
+    writer: z.ZodObject<{
+        designation: z.ZodString;
+        client: z.ZodString;
+        retired: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strip>;
+    kind: z.ZodLiteral<"dispatch">;
+    status: z.ZodEnum<{
+        closed: "closed";
+        dispatched: "dispatched";
+        reported: "reported";
+    }>;
+    holder: z.ZodString;
+    item_id: z.ZodString;
+    status_text: z.ZodOptional<z.ZodString>;
+    verdict: z.ZodOptional<z.ZodEnum<{
+        ACK: "ACK";
+        BLOCKED: "BLOCKED";
+        DECIDE: "DECIDE";
+        DONE: "DONE";
+        FAIL: "FAIL";
+        PASS: "PASS";
+    }>>;
+    evidence_ref: z.ZodOptional<z.ZodString>;
+    closed_reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "kind">;
+export type CoordDesignationRecord = z.infer<typeof CoordDesignationRecord>;
+export type CoordHandoverRecord = z.infer<typeof CoordHandoverRecord>;
+export type CoordRequestRecord = z.infer<typeof CoordRequestRecord>;
+export type CoordDispatchRecord = z.infer<typeof CoordDispatchRecord>;
+export type CoordRecord = z.infer<typeof CoordRecord>;
+/** Statuses after which a record only waits for its purge. */
+export declare const COORD_TERMINAL_STATUSES: ReadonlySet<string>;
+//# sourceMappingURL=coord.d.ts.map

package/dist/schemas/coord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coord.d.ts","sourceRoot":"","sources":["../../src/schemas/coord.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,eAAO,MAAM,WAAW,YAAI,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AACvF,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAK/D,CAAC;AAEF,eAAO,MAAM,WAAW,QAAsC,CAAC;AAE/D,eAAO,MAAM,mBAAmB,YAC9B,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,gBAAgB,CACR,CAAC;AAEX,eAAO,MAAM,WAAW,YACtB,aAAa,EACb,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,CACJ,CAAC;AACX,eAAO,MAAM,cAAc,YAAI,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAC5F,eAAO,MAAM,cAAc,YAAI,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;AAEnG,eAAO,MAAM,YAAY;aACvB,aAAa,EAAE,IAAK;aACpB,WAAW,EAAE,IAAK;aAClB,UAAU,EAAE,IAAK;aACjB,gBAAgB,EAAE,EAAE;aACpB,cAAc,EAAE,GAAG;CACX,CAAC;AAEX,0EAA0E;AAC1E,eAAO,MAAM,oBAAoB,aAKuC,CAAC;AAEzE,wEAAwE;AACxE,eAAO,MAAM,aAAa,aAKvB,CAAC;AAwBJ,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;iBAKjC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;iBAQ9B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO7B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU9B,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAKtB,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACpE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,8DAA8D;AAC9D,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAItD,CAAC"}

package/dist/schemas/coord.js

@@ -0,0 +1,122 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Coordination store records (TASK-957, BUG-153).
+ * One schema serves writing and reading: a record that fails it on read is quarantined.
+ * The server owns every field in `COORD_SERVER_FIELDS`; a caller that sends one is refused.
+ */
+import { z } from 'zod';
+export const COORD_SCHEMA_VERSION = 1;
+export const COORD_KINDS = ['designation', 'handover', 'request', 'dispatch'];
+export const COORD_ID_PREFIX = {
+    designation: 'DS',
+    handover: 'HO',
+    request: 'RQ',
+    dispatch: 'DP',
+};
+export const COORD_ID_RE = /^(DS|HO|RQ|DP)-([1-9][0-9]{0,8})$/;
+export const COORD_SERVER_FIELDS = [
+    'id',
+    'status',
+    'created_at',
+    'updated_at',
+    'version',
+    'expires_at',
+    'writer',
+    'schema_version',
+];
+export const COORD_ROLES = [
+    'coordinator',
+    'architect',
+    'engineer',
+    'liaison',
+    'consultant',
+];
+export const COORD_VERDICTS = ['ACK', 'DONE', 'PASS', 'FAIL', 'BLOCKED', 'DECIDE'];
+export const COORD_OUTCOMES = ['new-item', 'extends', 'answered', 'declined', 'deferred'];
+export const COORD_LIMITS = {
+    handoverField: 4_000,
+    requestText: 4_000,
+    statusText: 1_000,
+    openDesignations: 50,
+    openDispatches: 200,
+};
+/** Printable text on one line; designations travel in message headers. */
+export const CoordDesignationName = z
+    .string()
+    .trim()
+    .min(1)
+    .max(80)
+    .regex(/^[^\p{Cc}]+$/u, 'a designation is one line of printable text');
+/** Role plus optional area: `coordinator`, `engineer:customization`. */
+export const CoordRoleSlot = z
+    .string()
+    .regex(new RegExp(`^(${COORD_ROLES.join('|')})(:[a-z0-9][a-z0-9-]{0,39})?$`), 'a role slot is a role, optionally followed by ":<area>" in lowercase');
+const IsoTime = z.string().datetime();
+const ItemId = z.string().regex(/^[A-Z]+-[0-9]+$/);
+const Base = z.object({
+    schema_version: z.literal(COORD_SCHEMA_VERSION),
+    id: z.string().regex(COORD_ID_RE),
+    created_at: IsoTime,
+    updated_at: IsoTime,
+    version: z.number().int().positive(),
+    /** When the sweep purges the record; null while it is open, and for every handover. */
+    expires_at: IsoTime.nullable(),
+    /**
+     * Who wrote the current version: a registered designation (a label) and the MCP client;
+     * `retired` marks a handover its writer wrote after retiring (BUG-200).
+     */
+    writer: z.object({
+        designation: CoordDesignationName,
+        client: z.string().max(120),
+        retired: z.literal(true).optional(),
+    }),
+});
+export const CoordDesignationRecord = Base.extend({
+    kind: z.literal('designation'),
+    status: z.enum(['open', 'retired']),
+    name: CoordDesignationName,
+    role: z.enum(COORD_ROLES),
+});
+export const CoordHandoverRecord = Base.extend({
+    kind: z.literal('handover'),
+    status: z.literal('current'),
+    slot: CoordRoleSlot,
+    state: z.string().max(COORD_LIMITS.handoverField),
+    assignments: z.string().max(COORD_LIMITS.handoverField),
+    queue: z.string().max(COORD_LIMITS.handoverField),
+    next_steps: z.string().max(COORD_LIMITS.handoverField),
+});
+export const CoordRequestRecord = Base.extend({
+    kind: z.literal('request'),
+    status: z.enum(['open', 'acknowledged']),
+    text: z.string().min(1).max(COORD_LIMITS.requestText),
+    urgent: z.boolean(),
+    outcome: z.enum(COORD_OUTCOMES).optional(),
+    target_id: ItemId.optional(),
+});
+export const CoordDispatchRecord = Base.extend({
+    kind: z.literal('dispatch'),
+    status: z.enum(['dispatched', 'reported', 'closed']),
+    holder: CoordDesignationName,
+    item_id: ItemId,
+    status_text: z.string().max(COORD_LIMITS.statusText).optional(),
+    verdict: z.enum(COORD_VERDICTS).optional(),
+    evidence_ref: z.string().max(80).optional(),
+    /** Why the server closed it, when it did so from the item's status. */
+    closed_reason: z.string().max(80).optional(),
+});
+export const CoordRecord = z.discriminatedUnion('kind', [
+    CoordDesignationRecord,
+    CoordHandoverRecord,
+    CoordRequestRecord,
+    CoordDispatchRecord,
+]);
+/** Statuses after which a record only waits for its purge. */
+export const COORD_TERMINAL_STATUSES = new Set([
+    'retired',
+    'acknowledged',
+    'closed',
+]);
+//# sourceMappingURL=coord.js.map

package/dist/schemas/coord.js.map

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

package/dist/schemas/counters.schema.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Schema for `index/counters.json` — the highest ID number handed out per type prefix.
+ */
+import { z } from 'zod';
+export declare const CountersSchema: z.ZodRecord<z.ZodString, z.ZodNumber>;
+export declare function validateCounters(data: unknown): z.infer<typeof CountersSchema>;
+//# sourceMappingURL=counters.schema.d.ts.map

package/dist/schemas/counters.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counters.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/counters.schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc,uCAG1B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAE9E"}

package/dist/schemas/counters.schema.js

@@ -0,0 +1,13 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Schema for `index/counters.json` — the highest ID number handed out per type prefix.
+ */
+import { z } from 'zod';
+export const CountersSchema = z.record(z.string(), // type prefix, e.g. TASK
+z.number().int().nonnegative());
+export function validateCounters(data) {
+    return CountersSchema.parse(data);
+}
+//# sourceMappingURL=counters.schema.js.map

package/dist/schemas/counters.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counters.schema.js","sourceRoot":"","sources":["../../src/schemas/counters.schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CACpC,CAAC,CAAC,MAAM,EAAE,EAAE,yBAAyB;AACrC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAC/B,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/dist/schemas/expedition.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * The expedition record an epic carries in `metadata.expedition` (EPIC-059): the human
+ * baseline, the permissions an expedition added, and the harvest that closed the build.
+ */
+import { z } from 'zod';
+/** Rules `expedition permissions --apply` added to a settings file, so `--remove` takes exactly them. */
+export declare const ExpeditionPermissionsRecord: z.ZodObject<{
+    settings_file: z.ZodString;
+    added: z.ZodObject<{
+        allow: z.ZodArray<z.ZodString>;
+        deny: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    applied_at: z.ZodString;
+}, z.core.$strip>;
+export type ExpeditionPermissionsRecord = z.infer<typeof ExpeditionPermissionsRecord>;
+/** What the harvest read and wrote. */
+export declare const ExpeditionHarvestRecord: z.ZodObject<{
+    tip_commit: z.ZodString;
+    harvested_at: z.ZodString;
+    report: z.ZodString;
+}, z.core.$strip>;
+export type ExpeditionHarvestRecord = z.infer<typeof ExpeditionHarvestRecord>;
+/**
+ * Every key is optional because the record grows through the phases: the baseline keys are
+ * written together by the human baseline, `permissions` and `harvest` by their commands.
+ * Unknown keys are kept, so a newer writer's fields survive an older reader's patch.
+ */
+export declare const ExpeditionMetadata: z.ZodObject<{
+    baseline_commit: z.ZodOptional<z.ZodString>;
+    project_core_hash: z.ZodOptional<z.ZodString>;
+    epic_core_hash: z.ZodOptional<z.ZodString>;
+    baseline_date: z.ZodOptional<z.ZodString>;
+    based_on: z.ZodOptional<z.ZodString>;
+    permissions: z.ZodOptional<z.ZodObject<{
+        settings_file: z.ZodString;
+        added: z.ZodObject<{
+            allow: z.ZodArray<z.ZodString>;
+            deny: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        applied_at: z.ZodString;
+    }, z.core.$strip>>;
+    harvest: z.ZodOptional<z.ZodObject<{
+        tip_commit: z.ZodString;
+        harvested_at: z.ZodString;
+        report: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+export type ExpeditionMetadata = z.infer<typeof ExpeditionMetadata>;
+//# sourceMappingURL=expedition.d.ts.map

package/dist/schemas/expedition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expedition.d.ts","sourceRoot":"","sources":["../../src/schemas/expedition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yGAAyG;AACzG,eAAO,MAAM,2BAA2B;;;;;;;iBAQtC,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEtF,uCAAuC;AACvC,eAAO,MAAM,uBAAuB;;;;iBAMlC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;iBAYf,CAAC;AACjB,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/schemas/expedition.js

@@ -0,0 +1,45 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * The expedition record an epic carries in `metadata.expedition` (EPIC-059): the human
+ * baseline, the permissions an expedition added, and the harvest that closed the build.
+ */
+import { z } from 'zod';
+/** Rules `expedition permissions --apply` added to a settings file, so `--remove` takes exactly them. */
+export const ExpeditionPermissionsRecord = z.object({
+    /** Absolute path of the settings file the rules went into. */
+    settings_file: z.string().min(1),
+    added: z.object({
+        allow: z.array(z.string()),
+        deny: z.array(z.string()),
+    }),
+    applied_at: z.string().min(1),
+});
+/** What the harvest read and wrote. */
+export const ExpeditionHarvestRecord = z.object({
+    /** The commit the harvest read the git range up to. */
+    tip_commit: z.string().min(1),
+    harvested_at: z.string().min(1),
+    /** Attachment name of the report in the epic's item folder. */
+    report: z.string().min(1),
+});
+/**
+ * Every key is optional because the record grows through the phases: the baseline keys are
+ * written together by the human baseline, `permissions` and `harvest` by their commands.
+ * Unknown keys are kept, so a newer writer's fields survive an older reader's patch.
+ */
+export const ExpeditionMetadata = z
+    .object({
+    baseline_commit: z.string().min(1).optional(),
+    /** Core hash of the project compass at the baseline; absent when the project has none. */
+    project_core_hash: z.string().min(1).optional(),
+    epic_core_hash: z.string().min(1).optional(),
+    baseline_date: z.string().min(1).optional(),
+    /** Tip SHA of the `depends-on` epic this expedition was stacked on. */
+    based_on: z.string().min(1).optional(),
+    permissions: ExpeditionPermissionsRecord.optional(),
+    harvest: ExpeditionHarvestRecord.optional(),
+})
+    .passthrough();
+//# sourceMappingURL=expedition.js.map

package/dist/schemas/expedition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expedition.js","sourceRoot":"","sources":["../../src/schemas/expedition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yGAAyG;AACzG,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,8DAA8D;IAC9D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9B,CAAC,CAAC;AAGH,uCAAuC;AACvC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,uDAAuD;IACvD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,+DAA+D;IAC/D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1B,CAAC,CAAC;AAGH;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7C,0FAA0F;IAC1F,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC/C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3C,uEAAuE;IACvE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,WAAW,EAAE,2BAA2B,CAAC,QAAQ,EAAE;IACnD,OAAO,EAAE,uBAAuB,CAAC,QAAQ,EAAE;CAC5C,CAAC;KACD,WAAW,EAAE,CAAC"}