@openrig/cli 0.6.14 → 0.7.1

package/daemon/dist/domain/gateway/human-quiet-windows.js

@@ -0,0 +1,217 @@
+import { randomUUID } from "node:crypto";
+export class QuietWindowError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "QuietWindowError";
+    }
+}
+const HHMM = /^([01]\d|2[0-3]):([0-5]\d)$/;
+const DAY_MS = 24 * 60 * 60 * 1000;
+export class HumanQuietStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    setDaily(entityId, input) {
+        assertTimezone(input.timezone);
+        for (const value of [input.start, input.end]) {
+            if (!HHMM.test(value))
+                throw new QuietWindowError("invalid_time", `"${value}" isn't a time: use 24-hour HH:MM, for example 22:00`);
+        }
+        if (input.start === input.end)
+            throw new QuietWindowError("empty_window", "the start and end are the same time, so the window would be empty");
+        return this.write(entityId, { kind: "daily", timezone: input.timezone, daily_start: input.start, daily_end: input.end, until_at: null }, input.setBy, input.now, input.source);
+    }
+    setUntil(entityId, input) {
+        assertTimezone(input.timezone);
+        if (Number.isNaN(input.until.getTime()))
+            throw new QuietWindowError("invalid_time", "the until-time isn't a valid time");
+        if (input.until.getTime() <= input.now.getTime()) {
+            throw new QuietWindowError("until_passed", `${input.until.toISOString()} has already passed`);
+        }
+        return this.write(entityId, { kind: "until", timezone: input.timezone, daily_start: null, daily_end: null, until_at: input.until.toISOString() }, input.setBy, input.now, input.source);
+    }
+    /** "I'm back": end the occurrence that is on now. Tomorrow's daily rule stays. */
+    end(entityId, input) {
+        const state = this.quietStateFor(entityId, input.now);
+        if (!state.active)
+            throw new QuietWindowError("not_quiet", `quiet isn't on now for ${entityId}, so there's nothing to end`);
+        this.db.prepare(`UPDATE human_quiet_windows SET ended_occurrence = ?, ended_by = ?, ended_at = ? WHERE entity_id = ? AND revision = ?`)
+            .run(state.occurrence, input.endedBy, input.now.toISOString(), entityId, state.revision);
+        return { windowId: state.windowId, revision: state.revision, occurrence: state.occurrence };
+    }
+    /** Put an occurrence's ended mark back on the current revision, as end() writes it (no new revision, no source change):
+     *  for a window restored over one whose occurrence the person had already ended, so restoring it doesn't start that
+     *  occurrence's quiet again. Applies only while the revision is still the given one. */
+    restoreEnded(entityId, revision, ended) {
+        this.db.prepare(`UPDATE human_quiet_windows SET ended_occurrence = ?, ended_by = ?, ended_at = ? WHERE entity_id = ? AND revision = ?`)
+            .run(ended.occurrence, ended.by, ended.at, entityId, revision);
+    }
+    /** Remove the rule. The row stays, with a new revision, so an older revision is still recognisably stale. */
+    clear(entityId, input) {
+        const row = this.row(entityId);
+        if (!row || row.cleared_at)
+            throw new QuietWindowError("no_window", `${entityId} has no quiet window to clear`);
+        const revision = row.revision + 1;
+        this.db.prepare(`UPDATE human_quiet_windows SET revision = ?, cleared_by = ?, cleared_at = ?,
+        ended_occurrence = NULL, ended_by = NULL, ended_at = NULL WHERE entity_id = ?`)
+            .run(revision, input.clearedBy, input.now.toISOString(), entityId);
+        return { windowId: row.window_id, revision };
+    }
+    /** The current window, or null when there is none (never set, or cleared). */
+    show(entityId) {
+        const row = this.row(entityId);
+        return row && !row.cleared_at ? toWindow(row) : null;
+    }
+    /** Whether quiet is on for this person now, for which occurrence and revision, and the next boundary. */
+    quietStateFor(entityId, now) {
+        const row = this.row(entityId);
+        if (!row)
+            return { active: false, nextBoundary: null };
+        const base = { windowId: row.window_id, revision: row.revision };
+        if (row.cleared_at)
+            return { active: false, ...base, nextBoundary: null };
+        const nowMs = now.getTime();
+        if (row.kind === "until") {
+            const untilMs = Date.parse(row.until_at);
+            if (nowMs < untilMs && row.ended_occurrence !== "until") {
+                return { active: true, ...base, occurrence: "until", occurrenceStart: row.set_at, nextBoundary: { kind: "end", at: new Date(untilMs).toISOString() } };
+            }
+            return { active: false, ...base, nextBoundary: null };
+        }
+        const start = row.daily_start, end = row.daily_end, tz = row.timezone;
+        const today = localDate(now, tz);
+        let nextStart = null;
+        // The occurrence that started yesterday can still be on (a window across midnight). The search runs two days ahead,
+        // so skipping one empty occurrence still finds the next real one.
+        for (const day of [addDays(today, -1), today, addDays(today, 1), addDays(today, 2)]) {
+            const startMs = zonedLocalToInstant(day, start, tz).getTime();
+            const endMs = zonedLocalToInstant(end > start ? day : addDays(day, 1), end, tz).getTime();
+            // A window wholly inside a skipped hour resolves both ends to the same instant: that night has no quiet at all.
+            if (endMs <= startMs)
+                continue;
+            if (startMs <= nowMs && nowMs < endMs && row.ended_occurrence !== day) {
+                return { active: true, ...base, occurrence: day, occurrenceStart: new Date(startMs).toISOString(), nextBoundary: { kind: "end", at: new Date(endMs).toISOString() } };
+            }
+            if (startMs > nowMs && (nextStart === null || startMs < nextStart))
+                nextStart = startMs;
+        }
+        return { active: false, ...base, nextBoundary: nextStart === null ? null : { kind: "start", at: new Date(nextStart).toISOString() } };
+    }
+    write(entityId, rule, setBy, now, source = "manual") {
+        const existing = this.row(entityId);
+        const windowId = existing?.window_id ?? randomUUID();
+        const revision = (existing?.revision ?? 0) + 1;
+        this.db.prepare(`INSERT INTO human_quiet_windows (entity_id, window_id, revision, kind, timezone, daily_start, daily_end, until_at,
+        source, set_by, set_at, ended_occurrence, ended_by, ended_at, cleared_by, cleared_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, NULL, NULL, NULL, NULL, NULL)
+      ON CONFLICT (entity_id) DO UPDATE SET revision = excluded.revision, kind = excluded.kind, timezone = excluded.timezone,
+        daily_start = excluded.daily_start, daily_end = excluded.daily_end, until_at = excluded.until_at, source = excluded.source,
+        set_by = excluded.set_by, set_at = excluded.set_at, ended_occurrence = NULL, ended_by = NULL, ended_at = NULL,
+        cleared_by = NULL, cleared_at = NULL`)
+            .run(entityId, windowId, revision, rule.kind, rule.timezone, rule.daily_start, rule.daily_end, rule.until_at, source, setBy, now.toISOString());
+        return toWindow(this.row(entityId));
+    }
+    row(entityId) {
+        return this.db.prepare(`SELECT * FROM human_quiet_windows WHERE entity_id = ?`).get(entityId);
+    }
+}
+function toWindow(row) {
+    return {
+        entityId: row.entity_id, windowId: row.window_id, revision: row.revision, kind: row.kind, timezone: row.timezone,
+        ...(row.kind === "daily" ? { start: row.daily_start, end: row.daily_end } : { until: row.until_at }),
+        source: row.source, setBy: row.set_by, setAt: row.set_at,
+        ...(row.ended_occurrence ? { ended: { occurrence: row.ended_occurrence, by: row.ended_by, at: row.ended_at } } : {}),
+    };
+}
+const formatters = new Map();
+function formatter(tz) {
+    let f = formatters.get(tz);
+    if (!f) {
+        f = new Intl.DateTimeFormat("en-US", { timeZone: tz, hourCycle: "h23", year: "numeric", month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit" });
+        formatters.set(tz, f);
+    }
+    return f;
+}
+export function assertTimezone(tz) {
+    try {
+        if (!tz || formatter(tz).resolvedOptions().timeZone === undefined)
+            throw new RangeError(tz);
+    }
+    catch {
+        throw new QuietWindowError("invalid_timezone", `unknown timezone "${tz}": use an IANA name, for example Europe/Berlin or America/New_York`);
+    }
+}
+/** The local wall-clock fields of an instant in a timezone, as a UTC-epoch number of the same fields. */
+function localFieldsMs(ms, tz) {
+    const parts = {};
+    for (const p of formatter(tz).formatToParts(new Date(ms)))
+        if (p.type !== "literal")
+            parts[p.type] = Number(p.value);
+    return Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute);
+}
+function localDate(now, tz) {
+    return new Date(localFieldsMs(now.getTime(), tz)).toISOString().slice(0, 10);
+}
+function addDays(day, n) {
+    return new Date(Date.parse(`${day}T00:00:00Z`) + n * DAY_MS).toISOString().slice(0, 10);
+}
+/** The instant a local date and time happen in a timezone: a skipped time gives the next valid minute, a repeated
+ *  time its first occurrence. */
+export function zonedLocalToInstant(day, hhmm, tz) {
+    const [h, m] = hhmm.split(":").map(Number);
+    const wanted = Date.parse(`${day}T00:00:00Z`) + (h * 60 + m) * 60_000;
+    for (let skip = 0; skip <= 24 * 60; skip++) {
+        const local = wanted + skip * 60_000;
+        const matches = new Set();
+        for (const probe of [local - DAY_MS, local, local + DAY_MS]) {
+            const offset = localFieldsMs(probe, tz) - probe;
+            const candidate = local - offset;
+            if (localFieldsMs(candidate, tz) === local)
+                matches.add(candidate);
+        }
+        if (matches.size > 0)
+            return new Date(Math.min(...matches));
+    }
+    throw new QuietWindowError("invalid_time", `${day} ${hhmm} doesn't occur in ${tz}`);
+}
+/** An until-time as a person gives it: an ISO instant with an offset, or a local "HH:MM" meaning its next occurrence
+ *  in the timezone (under the convention above). */
+export function resolveUntil(value, tz, now) {
+    assertTimezone(tz);
+    const text = value.trim();
+    if (HHMM.test(text)) {
+        const today = localDate(now, tz);
+        const todays = zonedLocalToInstant(today, text, tz);
+        return todays.getTime() > now.getTime() ? todays : zonedLocalToInstant(addDays(today, 1), text, tz);
+    }
+    if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})$/.test(text) || Number.isNaN(Date.parse(text))) {
+        throw new QuietWindowError("invalid_time", `"${value}" isn't a time: use HH:MM (the next such time in the timezone) or an ISO time with an offset, for example 2026-10-21T07:00:00+02:00`);
+    }
+    return new Date(text);
+}
+/** A daily rule as a person gives it: "HH:MM-HH:MM". */
+export function parseDailyRule(value) {
+    const m = /^\s*(\d{1,2}:\d{2})\s*-\s*(\d{1,2}:\d{2})\s*$/.exec(value);
+    if (!m)
+        throw new QuietWindowError("invalid_time", `"${value}" isn't a daily window: use HH:MM-HH:MM, for example 22:00-07:00`);
+    return { start: m[1], end: m[2] };
+}
+/** The person's quiet window when it's on now, as the delivery decision takes it; null when it's off. Only a database
+ *  without the quiet-hours table (an older schema) reads as off, which is today's behaviour. Any other failure to read
+ *  it throws: a caller must not take "can't tell" as "not quiet" and post. */
+export function quietHoldFor(db, entityId, now) {
+    let state;
+    try {
+        state = new HumanQuietStore(db).quietStateFor(entityId, now);
+    }
+    catch (error) {
+        if (/no such table: human_quiet_windows/.test(error.message))
+            return null;
+        throw error;
+    }
+    return state.active ? { windowId: state.windowId, occurrence: state.occurrence, revision: state.revision } : null;
+}
+//# sourceMappingURL=human-quiet-windows.js.map

package/daemon/dist/domain/gateway/human-quiet-windows.js.map

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

package/daemon/dist/domain/gateway/human-registry.d.ts

@@ -5,6 +5,34 @@ export declare const HUMAN_DELIVERY_CLASSES: Set<string>;
 export declare const ENTITY_ID_PATTERN: RegExp;
 export declare const ADDRESS_DOMAIN = "external";
 export declare const HANDLE_PATTERN: RegExp;
+/** Attention subscriptions: where a person's items go besides Steering and the TUI, each a saved filter plus a
+ *  destination. The first is Slack's, with two preset filters. Field filters and channel destinations extend these
+ *  objects later without a migration. */
+export declare const SUBSCRIPTION_PRESETS: readonly ["every-ask", "urgent-only"];
+export type SubscriptionPreset = (typeof SUBSCRIPTION_PRESETS)[number];
+/** With no Slack subscription authored, every ask posts, as before subscriptions existed, so nothing changes on upgrade. */
+export declare const DEFAULT_SLACK_PRESET: SubscriptionPreset;
+export interface AttentionSubscription {
+    /** Where matching items go: the person's Slack binding. */
+    destination: {
+        connector: "slack";
+    };
+    /** Which items: `every-ask` (every ask to them) or `urgent-only` (asks marked --alert, which carry HUMAN_ALERT_TAG). */
+    filter: {
+        preset: SubscriptionPreset;
+    };
+}
+/** The person's Slack subscription preset, and whether they authored it. */
+export declare function slackSubscriptionFor(human: Pick<HumanFragment, "subscriptions"> | undefined): {
+    preset: SubscriptionPreset;
+    source: "authored" | "default";
+};
+/** The tag an ask created or handed off with humanAlert (`--alert`) carries: it stands out in Slack, as an interrupt,
+ *  under every setting. */
+export declare const HUMAN_ALERT_TAG = "human-alert";
+/** The ask's tags, with HUMAN_ALERT_TAG exactly when this create or handoff is marked alert-worthy: an inherited one is
+ *  dropped, so `--alert` decides per item. */
+export declare function withHumanAlertTag(tags: string[] | null | undefined, humanAlert: boolean | undefined): string[] | null;
 export declare const HUMAN_AVAILABILITY_MODES: Set<string>;
 export interface HumanConnectorBinding {
     kind: "slack";
@@ -39,6 +67,8 @@ export interface HumanFragment {
     address: string;
     connectorBindings: HumanConnectorBinding[];
     prefs: HumanPrefs;
+    /** Attention subscriptions (one per connector for now); none means the default Slack subscription. */
+    subscriptions?: AttentionSubscription[];
 }
 export type ValidateResult = {
     ok: true;
@@ -134,6 +164,9 @@ export interface HumanSummary {
     deliveryClass: HumanPrefs["deliveryClass"];
     /** EFFECTIVE availability preset (default false when unauthored). */
     away: boolean;
+    /** The availability delivery acts on: the authored value, else legacy `away`, else available (the engine's
+     *  resolveAvailability rule). */
+    availability: NonNullable<HumanPrefs["availability"]>;
     bindings: HumanBindingsSummary;
     fragmentPath: string;
 }
@@ -162,6 +195,8 @@ export interface EffectiveHumanRecord {
         deliveryClass: ProvenancedValue<HumanPrefs["deliveryClass"]>;
         away: ProvenancedValue<boolean>;
     };
+    /** The Slack subscription's preset filter (`every-ask` unless authored). */
+    slackSubscription: ProvenancedValue<SubscriptionPreset>;
     connectorBindings: Array<HumanConnectorBinding & {
         inboundResolvable: boolean;
     }>;
@@ -173,13 +208,19 @@ export type ShowHumanResult = {
     ok: false;
     error: string;
 };
-export type SetHumanFieldResult = {
+export type SetHumanFieldResult = 
+/** changeId: the availability change record this write left, when it left one. */
+{
     ok: true;
     path: string;
     fragment: HumanFragment;
-} | {
+    changeId?: string;
+}
+/** changeId: set when the fragment and its change record were written but something after them failed. */
+ | {
     ok: false;
     error: string;
+    changeId?: string;
 };
 export type RemoveHumanResult = {
     ok: true;
@@ -210,6 +251,18 @@ export declare function parseBindingSpec(spec: string): {
 };
 export declare function listHumans(home?: string): ListHumansResult;
 export declare function showHuman(entityId: string, home?: string): ShowHumanResult;
+/** The availability a person's fragment authors (undefined when it authors none), and the id of the latest change
+ *  recorded through the writers (null when none has been): what a mode records as the prior value and checks is still
+ *  its own. */
+export declare function readHumanAvailability(entityId: string, home?: string): {
+    ok: true;
+    availability: string | undefined;
+    changeId: string | null;
+    away: boolean;
+} | {
+    ok: false;
+    error: string;
+};
 export declare function setHumanField(entityId: string, field: string, value: string, home?: string): SetHumanFieldResult;
 export declare function removeHumanFragment(entityId: string, opts: {
     force?: boolean;

package/daemon/dist/domain/gateway/human-registry.d.ts.map

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

package/daemon/dist/domain/gateway/human-registry.js

@@ -13,8 +13,8 @@
 // Validation is add-time == load-time (the hosts-registry entry pattern): the SAME
 // validateHumanFragment runs on `add` and on load, so a present-but-invalid fragment
 // is a loud error, never silently projected.
-import { createHash } from "node:crypto";
-import { existsSync, readFileSync, writeFileSync, renameSync, mkdirSync, readdirSync } from "node:fs";
+import { createHash, randomUUID } from "node:crypto";
+import { existsSync, readFileSync, writeFileSync, renameSync, mkdirSync, readdirSync, rmSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
 import { getOpenRigHome } from "../../openrig-compat.js";
@@ -33,13 +33,61 @@ export const ENTITY_ID_PATTERN = /^[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?$/;
 // (slack:U...@external) are one-off ADDRESSES, never registry entries.
 export const ADDRESS_DOMAIN = "external";
 // Closed key sets — a typo'd field must fail LOUD, never silently degrade behavior.
-const ALLOWED_FRAGMENT_KEYS = new Set(["entityId", "class", "displayName", "address", "connectorBindings", "prefs"]);
+const ALLOWED_FRAGMENT_KEYS = new Set(["entityId", "class", "displayName", "address", "connectorBindings", "prefs", "subscriptions"]);
 const ALLOWED_BINDING_KEYS = new Set(["kind", "connectorRef", "secretsRef", "role", "handle"]);
 // A connector handle (M1 A6 v3 schema 9e468b2f): the platform-native id of the human ON that
 // connector (e.g. a Slack user id). Constrained so it can never forge a session ref (no ':' / '@'
 // / whitespace) — it is compared to an inbound sender id and spliced into teaching text.
 export const HANDLE_PATTERN = /^[A-Za-z0-9._-]+$/;
 const ALLOWED_PREFS_KEYS = new Set(["deliveryClass", "away", "availability"]);
+/** Attention subscriptions: where a person's items go besides Steering and the TUI, each a saved filter plus a
+ *  destination. The first is Slack's, with two preset filters. Field filters and channel destinations extend these
+ *  objects later without a migration. */
+export const SUBSCRIPTION_PRESETS = ["every-ask", "urgent-only"];
+/** With no Slack subscription authored, every ask posts, as before subscriptions existed, so nothing changes on upgrade. */
+export const DEFAULT_SLACK_PRESET = "every-ask";
+const ALLOWED_SUBSCRIPTION_KEYS = new Set(["destination", "filter"]);
+/** The person's Slack subscription preset, and whether they authored it. */
+export function slackSubscriptionFor(human) {
+    const authored = human?.subscriptions?.find((sub) => sub.destination.connector === "slack");
+    return authored ? { preset: authored.filter.preset, source: "authored" } : { preset: DEFAULT_SLACK_PRESET, source: "default" };
+}
+function validateSubscriptions(value) {
+    if (!Array.isArray(value))
+        return { ok: false, error: "subscriptions must be a list of { destination, filter }" };
+    const subscriptions = [];
+    for (const [i, sub] of value.entries()) {
+        const where = `subscriptions[${i}]`;
+        if (!isObj(sub))
+            return { ok: false, error: `${where} must be a mapping { destination, filter }` };
+        const uk = unknownKey(sub, ALLOWED_SUBSCRIPTION_KEYS);
+        if (uk)
+            return { ok: false, error: `${where} has unknown key "${uk}" — allowed: destination, filter` };
+        const { destination, filter } = sub;
+        if (!isObj(destination) || unknownKey(destination, new Set(["connector"])) || destination.connector !== "slack") {
+            return { ok: false, error: `${where}.destination must be { connector: slack } (the person's Slack binding)` };
+        }
+        if (!isObj(filter) || unknownKey(filter, new Set(["preset"])) || typeof filter.preset !== "string"
+            || !SUBSCRIPTION_PRESETS.includes(filter.preset)) {
+            return { ok: false, error: `${where}.filter must be { preset: ${SUBSCRIPTION_PRESETS.join("|")} }` };
+        }
+        if (subscriptions.some((s) => s.destination.connector === "slack"))
+            return { ok: false, error: `${where}: one Slack subscription per person` };
+        subscriptions.push({ destination: { connector: "slack" }, filter: { preset: filter.preset } });
+    }
+    return { ok: true, subscriptions };
+}
+/** The tag an ask created or handed off with humanAlert (`--alert`) carries: it stands out in Slack, as an interrupt,
+ *  under every setting. */
+export const HUMAN_ALERT_TAG = "human-alert";
+/** The ask's tags, with HUMAN_ALERT_TAG exactly when this create or handoff is marked alert-worthy: an inherited one is
+ *  dropped, so `--alert` decides per item. */
+export function withHumanAlertTag(tags, humanAlert) {
+    const rest = (tags ?? []).filter((tag) => tag !== HUMAN_ALERT_TAG);
+    if (humanAlert === true)
+        return [...rest, HUMAN_ALERT_TAG];
+    return tags ? rest : null;
+}
 // OPR.0.5.6.1 — the availability enum the delivery rules engine consumes.
 // Legacy `away: true` reads as availability=away ONLY when availability is
 // whole-field-absent (the D1 convention); a present-but-conflicting pair is
@@ -63,7 +111,7 @@ export function validateHumanFragment(raw) {
     const uk = unknownKey(raw, ALLOWED_FRAGMENT_KEYS);
     if (uk)
         return { ok: false, error: `unknown fragment key "${uk}" — allowed: ${[...ALLOWED_FRAGMENT_KEYS].join(", ")} (a typo must not silently degrade)` };
-    const { entityId, class: cls, displayName, address, connectorBindings, prefs } = raw;
+    const { entityId, class: cls, displayName, address, connectorBindings, prefs, subscriptions: rawSubscriptions } = raw;
     if (typeof entityId !== "string" || !ENTITY_ID_PATTERN.test(entityId)) {
         return { ok: false, error: `entityId "${String(entityId)}" must be a lowercase slug (a-z0-9._- , no leading/trailing separator)` };
     }
@@ -162,9 +210,16 @@ export function validateHumanFragment(raw) {
         validatedPrefs.away = prefs.away;
     if (prefs.availability !== undefined)
         validatedPrefs.availability = prefs.availability;
+    let subscriptions;
+    if (rawSubscriptions !== undefined) {
+        const v = validateSubscriptions(rawSubscriptions);
+        if (!v.ok)
+            return v;
+        subscriptions = v.subscriptions;
+    }
     return {
         ok: true,
-        fragment: { entityId, class: "human", displayName, address, connectorBindings: bindings, prefs: validatedPrefs },
+        fragment: { entityId, class: "human", displayName, address, connectorBindings: bindings, prefs: validatedPrefs, ...(subscriptions ? { subscriptions } : {}) },
     };
 }
 // ── Paths (under getOpenRigHome(); `home` injectable for hermetic tests) ──
@@ -326,6 +381,10 @@ export function addHumanFragment(raw, home = getOpenRigHome(), opts = {}) {
     const w = atomicWrite(file, stringifyYaml(v.fragment));
     if (!w.ok)
         return { ok: false, error: w.error };
+    // A new or replaced record may author any availability: it's a change of its own.
+    const change = recordAvailabilityChange(v.fragment.entityId, home);
+    if (!change.ok)
+        return { ok: false, error: `fragment written but ${change.error}` };
     const proj = writeProjection(home);
     if (!proj.ok)
         return { ok: false, error: `fragment written but re-projection failed: ${proj.error}` };
@@ -386,6 +445,7 @@ export function listHumans(home = getOpenRigHome()) {
             address: e.address,
             deliveryClass: e.prefs.deliveryClass,
             away: e.prefs.away === true,
+            availability: e.prefs.availability ?? (e.prefs.away === true ? "away" : "available"),
             bindings: {
                 count: e.connectorBindings.length,
                 primary: { kind: primary.kind, connectorRef: primary.connectorRef },
@@ -432,11 +492,12 @@ export function showHuman(entityId, home = getOpenRigHome()) {
                     source: rawPrefs.away !== undefined ? "authored" : "default",
                 },
             },
+            slackSubscription: (({ preset, source }) => ({ value: preset, source }))(slackSubscriptionFor(f.fragment)),
             connectorBindings: f.fragment.connectorBindings.map((b) => ({ ...b, inboundResolvable: b.handle !== undefined })),
         },
     };
 }
-const SETTABLE_FIELDS_TEACHING = "settable fields: display-name, delivery-class, away, binding.<n> (binding.<n> takes a full kind:connectorRef:secretsRef:role[:handle=<id>] spec)";
+const SETTABLE_FIELDS_TEACHING = "settable fields: display-name, delivery-class, away, availability (available|focus|away|off, or unset), slack-subscription (every-ask|urgent-only, or unset for every-ask), binding.<n> (binding.<n> takes a full kind:connectorRef:secretsRef:role[:handle=<id>] spec)";
 /** Cross-fragment handle-uniqueness: the same pre-write check add runs (one platform id =
  *  one human), extracted so set enforces it identically. */
 function handleConflict(fragment, home) {
@@ -461,6 +522,42 @@ function handleConflict(fragment, home) {
     }
     return undefined;
 }
+// A person's availability change record: a sidecar beside the fragments (gateway/humans/.availability/<id>.json),
+// rewritten with a fresh change id by every write through these writers that can change availability (set availability
+// or away, add or replace). It lets a mode tell its own change from a later one that happens to have the same value. It
+// lives outside the fragment because the fragment's keys are a closed set every reader validates, and the fragment
+// loaders skip dot-entries, so older readers never see it.
+function availabilityChangePath(entityId, home) {
+    return join(humansDir(home), ".availability", `${entityId}.json`);
+}
+function recordAvailabilityChange(entityId, home) {
+    const changeId = randomUUID();
+    const w = atomicWrite(availabilityChangePath(entityId, home), JSON.stringify({ changeId, at: new Date().toISOString() }));
+    return w.ok ? { ok: true, changeId } : { ok: false, error: `availability change record not written: ${w.error}` };
+}
+/** The availability a person's fragment authors (undefined when it authors none), and the id of the latest change
+ *  recorded through the writers (null when none has been): what a mode records as the prior value and checks is still
+ *  its own. */
+export function readHumanAvailability(entityId, home = getOpenRigHome()) {
+    const f = readFragment(entityId, home);
+    if (!f.ok)
+        return f;
+    const prefs = isObj(f.raw.prefs) ? f.raw.prefs : {};
+    let changeId = null;
+    const path = availabilityChangePath(entityId, home);
+    if (existsSync(path)) {
+        try {
+            const record = JSON.parse(readFileSync(path, "utf8"));
+            if (typeof record.changeId !== "string")
+                throw new Error("it has no change id");
+            changeId = record.changeId;
+        }
+        catch (err) {
+            return { ok: false, error: `availability change record for ${entityId} is unreadable: ${err.message}` };
+        }
+    }
+    return { ok: true, availability: typeof prefs.availability === "string" ? prefs.availability : undefined, changeId, away: prefs.away === true };
+}
 export function setHumanField(entityId, field, value, home = getOpenRigHome()) {
     const f = readFragment(entityId, home);
     if (!f.ok)
@@ -485,6 +582,26 @@ export function setHumanField(entityId, field, value, home = getOpenRigHome()) {
         rawPrefs.away = value === "true";
         raw.prefs = rawPrefs;
     }
+    else if (field === "availability") {
+        // `unset` removes the authored field, so it reads as never authored (what restoring an absent value needs). Any
+        // other value goes through the add-time validator below: the closed enum, and agreement with legacy `away`.
+        if (value === "unset")
+            delete rawPrefs.availability;
+        else
+            rawPrefs.availability = value;
+        raw.prefs = rawPrefs;
+    }
+    else if (field === "slack-subscription") {
+        // The preset of the person's Slack subscription. `unset` removes it, so the default (DEFAULT_SLACK_PRESET) applies;
+        // the add-time validator checks any other value.
+        const others = (Array.isArray(raw.subscriptions) ? raw.subscriptions : [])
+            .filter((sub) => !(isObj(sub) && isObj(sub.destination) && sub.destination.connector === "slack"));
+        const next = value === "unset" ? others : [...others, { destination: { connector: "slack" }, filter: { preset: value } }];
+        if (next.length)
+            raw.subscriptions = next;
+        else
+            delete raw.subscriptions;
+    }
     else if (field.startsWith("binding.")) {
         const idxRaw = field.slice("binding.".length);
         const idx = /^\d+$/.test(idxRaw) ? Number.parseInt(idxRaw, 10) : NaN;
@@ -516,10 +633,20 @@ export function setHumanField(entityId, field, value, home = getOpenRigHome()) {
     const w = atomicWrite(f.path, stringifyYaml(raw));
     if (!w.ok)
         return { ok: false, error: w.error };
+    // A change to availability rotates the change record. Legacy `away` changes availability only while the fragment
+    // authors none: with availability authored, `away` must agree with it (true only when it's already away) or it's
+    // false, and either way availability is unchanged, so the record stays the latest real change's.
+    let changeId;
+    if (field === "availability" || (field === "away" && rawPrefs.availability === undefined)) {
+        const change = recordAvailabilityChange(entityId, home);
+        if (!change.ok)
+            return { ok: false, error: `fragment written but ${change.error}` };
+        changeId = change.changeId;
+    }
     const proj = writeProjection(home);
     if (!proj.ok)
-        return { ok: false, error: `fragment written but re-projection failed: ${proj.error}` };
-    return { ok: true, path: f.path, fragment: v.fragment };
+        return { ok: false, error: `fragment written but re-projection failed: ${proj.error}`, ...(changeId ? { changeId } : {}) };
+    return { ok: true, path: f.path, fragment: v.fragment, ...(changeId ? { changeId } : {}) };
 }
 export function removeHumanFragment(entityId, opts, home = getOpenRigHome()) {
     const path = fragmentPathFor(entityId, home);
@@ -548,6 +675,8 @@ export function removeHumanFragment(entityId, opts, home = getOpenRigHome()) {
         archivedPath = join(archiveDir, `${entityId}.${stamp}-${n}.yaml`);
     try {
         renameSync(path, archivedPath);
+        // A later re-add of the same id starts a fresh change record, never inheriting this one.
+        rmSync(availabilityChangePath(entityId, home), { force: true });
     }
     catch (err) {
         return { ok: false, error: `failed to archive ${path}: ${err.message}` };