@ashlr/hub 3.13.0 → 3.14.0

package/dist/core/vision/leader-goal-evidence.d.ts

@@ -0,0 +1,25 @@
+import { type GoalReadLike } from '../goals/open-goals.js';
+export interface LeaderGoalItem {
+    id: string;
+    objective: string;
+    status: string;
+    repo: string | null;
+    milestonesDone: number;
+    milestones: number;
+    updatedOn: string;
+}
+export interface LeaderGoalEvidence {
+    /** Open (active + planning) goals — a lower bound when `complete` is false. */
+    open: number;
+    total: number;
+    focusLimit: number;
+    /** False when some goal files could not be read: `open` / `total` are then lower bounds. */
+    complete: boolean;
+    /** Goal files that could not be read (null = the source did not say). */
+    unreadableGoalFiles: number | null;
+    /** Plain-language caveat for the model; null when the read was complete. */
+    note: string | null;
+    items: LeaderGoalItem[];
+}
+/** PURE: the Leader's goals block from one goal-store read. */
+export declare function buildLeaderGoalEvidence(read: GoalReadLike): LeaderGoalEvidence;

package/dist/core/vision/leader-goal-evidence.js

@@ -0,0 +1,36 @@
+import { summarizeOpenGoals } from '../goals/open-goals.js';
+import { LEADER_LIMITS } from './leader-types.js';
+import { cleanModelText } from './leader-memo.js';
+const MAX_ITEMS = 40;
+function day(iso) {
+    if (!iso)
+        return '';
+    const ms = Date.parse(iso);
+    return Number.isFinite(ms) ? new Date(ms).toISOString().slice(0, 10) : '';
+}
+/** PURE: the Leader's goals block from one goal-store read. */
+export function buildLeaderGoalEvidence(read) {
+    const summary = summarizeOpenGoals(read);
+    const shown = [...summary.openGoals, ...read.goals.filter((g) => g.status === 'paused')].slice(0, MAX_ITEMS);
+    const note = summary.complete
+        ? null
+        : `The goal store could not read ${summary.unreadable ?? 'some'} goal file(s): at least ${summary.open} goals are open (a lower bound, not the full count).`;
+    return {
+        open: summary.open,
+        total: summary.total,
+        focusLimit: LEADER_LIMITS.maxActiveGoals,
+        complete: summary.complete,
+        unreadableGoalFiles: summary.unreadable,
+        note,
+        items: shown.map((g) => ({
+            id: g.id,
+            objective: cleanModelText(g.objective, 200) ?? '',
+            status: g.status,
+            repo: g.project ? g.project.split(/[\\/]/).pop() ?? null : null,
+            milestonesDone: g.milestones.filter((m) => m.status === 'done').length,
+            milestones: g.milestones.length,
+            updatedOn: day(g.updatedAt),
+        })),
+    };
+}
+//# sourceMappingURL=leader-goal-evidence.js.map

package/dist/core/vision/leader-goal-evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leader-goal-evidence.js","sourceRoot":"","sources":["../../../src/core/vision/leader-goal-evidence.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,kBAAkB,EAAqB,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA0BlD,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB,SAAS,GAAG,CAAC,GAA8B;IACzC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,uBAAuB,CAAC,IAAkB;IACxD,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,KAAK,GAAW,CAAC,GAAG,OAAO,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACrH,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ;QAC3B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,iCAAiC,OAAO,CAAC,UAAU,IAAI,MAAM,2BAA2B,OAAO,CAAC,IAAI,sDAAsD,CAAC;IAC/J,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,aAAa,CAAC,cAAc;QACxC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,mBAAmB,EAAE,OAAO,CAAC,UAAU;QACvC,IAAI;QACJ,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE;YACjD,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI;YAC/D,cAAc,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM;YACtE,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM;YAC/B,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;SAC5B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/core/vision/leader-health.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Leader health (3.14) — PURE, from the run state only.
+ *
+ * "Leader: healthy / degraded (why)" for the Command surface and Telegram,
+ * served as the additive `health` field of GET /api/verse/leader (and
+ * `ashlr leader show`). No seat is probed and no model is called on the read
+ * path: seat viability is what the most recent run found (every seat it
+ * tried or passed over, with why), which is also what the next run will
+ * most likely find.
+ *
+ *   unknown  — the Leader has never run.
+ *   healthy  — the last run wrote a memo on the first seat it tried.
+ *   degraded — a memo was written only after a fallback, OR the last run
+ *              failed and a bounded retry is pending, OR the last memo is
+ *              more than 36 h old.
+ *   down     — no seat at all, or the retries are spent.
+ */
+import type { LeaderHealth, LeaderRunOutcome, LeaderSeatAttempt, LeaderTrigger } from './leader-types.js';
+import { type LeaderCadence } from './leader-cadence.js';
+export interface LeaderHealthInput {
+    lastRun: {
+        at: string;
+        outcome: LeaderRunOutcome;
+        reason: string | null;
+        trigger: LeaderTrigger;
+    } | null;
+    lastMemoAt: string | null;
+    lastCheckinEvalAt?: string | null;
+    lastSuccessAt?: string | null;
+    retry?: {
+        attempt: number;
+        at: string;
+    } | null;
+    consecutiveFailures?: number;
+    lastFailure?: {
+        at: string;
+        outcome: LeaderRunOutcome;
+        reason: string | null;
+    } | null;
+    lastAttempts?: LeaderSeatAttempt[];
+    lastAttemptsAt?: string | null;
+    lastServed?: {
+        seatId: string;
+        model: string | null;
+        at: string;
+    } | null;
+}
+export declare function buildLeaderHealth(state: LeaderHealthInput, nowMs: number, ctx: {
+    cadence: LeaderCadence;
+    nextScheduledAt: number;
+    runsToday: number;
+    checkinsToday: number;
+}): LeaderHealth;

package/dist/core/vision/leader-health.js

@@ -0,0 +1,92 @@
+import { LEADER_MAX_RETRY_ATTEMPTS, isWorkingHour, nextCheckinAt, } from './leader-cadence.js';
+const STALE_MS = 36 * 3_600_000;
+const FAILED = new Set(['failed', 'no-seat', 'parse-failed']);
+function nextWorkingStart(fromMs, wh) {
+    const d = new Date(fromMs);
+    let candidate = new Date(d.getFullYear(), d.getMonth(), d.getDate(), wh.start, 0, 0, 0).getTime();
+    if (candidate <= fromMs) {
+        const t = new Date(fromMs + 86_400_000);
+        candidate = new Date(t.getFullYear(), t.getMonth(), t.getDate(), wh.start, 0, 0, 0).getTime();
+    }
+    return candidate;
+}
+function seatLine(a) {
+    const what = a.outcome === 'timeout' ? 'timed out' : a.outcome === 'parse-failed' ? 'answered unparseably' : a.outcome;
+    return `${a.seatId} ${what}`;
+}
+export function buildLeaderHealth(state, nowMs, ctx) {
+    // A pre-3.14 state file has no failure counter: its last run still speaks.
+    const legacyFailure = state.consecutiveFailures === undefined && state.lastRun !== null && FAILED.has(state.lastRun.outcome);
+    const consecutiveFailures = legacyFailure ? 1 : state.consecutiveFailures ?? 0;
+    const lastFailure = legacyFailure && state.lastRun
+        ? { at: state.lastRun.at, outcome: state.lastRun.outcome, reason: state.lastRun.reason }
+        : state.lastFailure ?? null;
+    state = { ...state, lastFailure };
+    const seats = state.lastAttempts ?? [];
+    const retry = state.retry ? { attempt: state.retry.attempt, maxAttempts: LEADER_MAX_RETRY_ATTEMPTS, at: state.retry.at } : null;
+    // Next due: the earliest of the daily slot, a pending retry and the next check-in window.
+    const options = [{ at: ctx.nextScheduledAt, why: 'the daily 06:30 memo' }];
+    if (retry)
+        options.push({ at: Date.parse(retry.at), why: `retry ${retry.attempt} of ${retry.maxAttempts}` });
+    const checkin = nextCheckinAt({ lastMemoAt: state.lastMemoAt, lastCheckinEvalAt: state.lastCheckinEvalAt ?? null }, ctx.cadence);
+    if (checkin !== null && ctx.runsToday < ctx.cadence.maxRunsPerDayTotal) {
+        const earliest = Math.max(checkin, nowMs);
+        const at = isWorkingHour(earliest, ctx.cadence.workingHours) ? earliest : nextWorkingStart(earliest, ctx.cadence.workingHours);
+        options.push({ at, why: 'a check-in, if the evidence changed' });
+    }
+    const valid = options.filter((o) => Number.isFinite(o.at)).sort((a, b) => a.at - b.at);
+    const next = valid[0] ?? null;
+    const lastRunOutcome = state.lastRun?.outcome ?? null;
+    let status;
+    let summary;
+    const failedSeats = seats.filter((a) => a.outcome === 'failed' || a.outcome === 'timeout' || a.outcome === 'parse-failed');
+    const lastSuccessMs = state.lastSuccessAt ? Date.parse(state.lastSuccessAt) : NaN;
+    if (!state.lastRun) {
+        status = 'unknown';
+        summary = 'The Leader has not run yet.';
+    }
+    else if (consecutiveFailures > 0) {
+        const why = state.lastFailure?.reason ?? 'no reason recorded';
+        if (lastRunOutcome === 'no-seat' || (!retry && consecutiveFailures >= LEADER_MAX_RETRY_ATTEMPTS + 1)) {
+            status = 'down';
+            summary = lastRunOutcome === 'no-seat'
+                ? `No seat can serve the Leader: ${why}`
+                : `The last ${consecutiveFailures} runs failed and the retries are spent: ${why}`;
+        }
+        else {
+            status = 'degraded';
+            summary = `The last run failed (${why})${retry ? `; retry ${retry.attempt} of ${retry.maxAttempts} is scheduled` : ''}.`;
+        }
+    }
+    else if (failedSeats.length > 0 && state.lastServed) {
+        status = 'degraded';
+        summary = `Served by ${state.lastServed.seatId} after a fallback: ${failedSeats.map(seatLine).join('; ')}.`;
+    }
+    else if (Number.isFinite(lastSuccessMs) && nowMs - lastSuccessMs > STALE_MS) {
+        status = 'degraded';
+        summary = `The last memo is ${Math.round((nowMs - lastSuccessMs) / 3_600_000)} h old.`;
+    }
+    else {
+        status = 'healthy';
+        summary = state.lastServed ? `Serving on ${state.lastServed.seatId}.` : 'Nothing has failed since the last memo.';
+    }
+    return {
+        status,
+        summary: summary.slice(0, 400),
+        lastRunAt: state.lastRun?.at ?? null,
+        lastRunOutcome,
+        lastSuccessAt: state.lastSuccessAt ?? null,
+        lastFailure: consecutiveFailures > 0 ? state.lastFailure ?? null : null,
+        consecutiveFailures,
+        nextDueAt: next ? new Date(next.at).toISOString() : null,
+        nextDueReason: next?.why ?? null,
+        retry,
+        seats,
+        seatsObservedAt: state.lastAttemptsAt ?? null,
+        servedBy: state.lastServed ?? null,
+        runsToday: ctx.runsToday,
+        checkinsToday: ctx.checkinsToday,
+        checkinHours: ctx.cadence.checkinHours,
+    };
+}
+//# sourceMappingURL=leader-health.js.map

package/dist/core/vision/leader-health.js.map

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

package/dist/core/vision/leader-operator.d.ts

@@ -0,0 +1,176 @@
+import type { OperatorChannel, OperatorDirective, OperatorDirectiveKind } from './leader-thread-types.js';
+export type { OperatorChannel, OperatorDirective, OperatorDirectiveKind } from './leader-thread-types.js';
+export declare const OPERATOR_DIRECTIVE_KINDS: readonly OperatorDirectiveKind[];
+/** Where an operator input came from (the thread's channels). */
+export declare const OPERATOR_CHANNELS: readonly OperatorChannel[];
+export declare const OPERATOR_LIMITS: Readonly<{
+    /** Active directives at once — more than this is not "standing guidance", it is noise. */
+    maxActiveDirectives: 20;
+    /** Directive records kept (retired ones are trimmed oldest first). */
+    keepDirectives: 200;
+    directiveMaxChars: 300;
+    keepQuestions: 300;
+    answerMaxChars: 2000;
+    questionMaxChars: 500;
+    keepApprovals: 200;
+    /** Answers / approvals older than this stop feeding the memo prompt. */
+    answerFeedDays: 30;
+    approvalFeedDays: 14;
+    feedMax: 10;
+}>;
+export declare function isOperatorDirectiveKind(value: unknown): value is OperatorDirectiveKind;
+export declare function isOperatorChannel(value: unknown): value is OperatorChannel;
+export interface LeaderQuestionRecord {
+    v: 1;
+    /** `<memoId>:<index>` — derived from the memo, so stable (= the Needs-you item id's tail). */
+    questionId: string;
+    memoId: string;
+    index: number;
+    /** The Leader's question (UNTRUSTED model text, scrubbed). */
+    text: string;
+    askedAt: string;
+    /** The thread message that asked it; null until posted. */
+    messageId: string | null;
+    answer: {
+        text: string;
+        at: string;
+        channel: OperatorChannel;
+        messageId: string | null;
+    } | null;
+}
+export type OperatorApprovalOutcome = 'applied' | 'recorded-dry-run' | 'recorded-outside-grant' | 'refused';
+export interface OperatorApproval {
+    v: 1;
+    actionId: string;
+    memoId: string;
+    kind: string;
+    /** The action's summary (UNTRUSTED model text, scrubbed). */
+    summary: string;
+    at: string;
+    channel: OperatorChannel;
+    outcome: OperatorApprovalOutcome;
+    detail: string;
+}
+export declare const OPERATOR_DIRECTIVE_ID_RE: RegExp;
+export declare const LEADER_QUESTION_ID_RE: RegExp;
+export declare function newOperatorId(prefix: string, nowMs: number): string;
+/**
+ * The stable id of a memo's `index`-th question: `<memoId>:<index>` — exactly
+ * the tail of its Needs-you item id (`leader:leader-question:<memoId>:<index>`).
+ * Null for a malformed memo id.
+ */
+export declare function questionIdFor(memoId: string, index: number): string | null;
+/**
+ * Scrub + normalise operator text: control characters (except newline / tab)
+ * out, secrets / home paths / emails redacted, trimmed, capped. Null when
+ * nothing is left.
+ */
+export declare function cleanOperatorText(value: unknown, max: number): string | null;
+export declare function operatorDirectivesPath(): string;
+export declare function operatorQuestionsPath(): string;
+export declare function operatorApprovalsPath(): string;
+/** Newest first. Retired directives only when asked for. */
+export declare function listOperatorDirectives(opts?: {
+    includeRetired?: boolean;
+}): OperatorDirective[];
+export type AddDirectiveResult = {
+    ok: true;
+    directive: OperatorDirective;
+    duplicate: boolean;
+} | {
+    ok: false;
+    code: 400 | 409;
+    reason: string;
+};
+export declare function addOperatorDirective(input: {
+    kind: OperatorDirectiveKind;
+    text: string;
+    source: OperatorDirective['source'];
+    channel: OperatorChannel;
+    messageId?: string | null;
+}, nowMs?: number): AddDirectiveResult;
+export type RetireDirectiveResult = {
+    ok: true;
+    directive: OperatorDirective;
+} | {
+    ok: false;
+    code: 400 | 404 | 409;
+    reason: string;
+};
+export declare function retireOperatorDirective(id: string, via: OperatorChannel, nowMs?: number): RetireDirectiveResult;
+/** Every recorded question, oldest first. */
+export declare function listLeaderQuestions(): LeaderQuestionRecord[];
+export declare function findLeaderQuestion(questionId: string): LeaderQuestionRecord | null;
+/**
+ * Record a memo's questions (idempotent — a question already on file keeps
+ * its record, answer included). Returns the records for this memo, in order.
+ */
+export declare function registerLeaderQuestions(memo: {
+    id: string;
+    at: string;
+    questionsForMason: readonly string[];
+}, nowMs?: number): LeaderQuestionRecord[];
+/** Link a question to the thread message that asked it. */
+export declare function setLeaderQuestionMessage(questionId: string, messageId: string, nowMs?: number): void;
+export type RecordAnswerResult = {
+    ok: true;
+    question: LeaderQuestionRecord;
+} | {
+    ok: false;
+    code: 400 | 404;
+    reason: string;
+};
+/**
+ * Record Mason's answer. A second answer replaces the first (he may refine
+ * it); the memo run always reads the latest.
+ */
+export declare function recordLeaderAnswer(questionId: string, input: {
+    text: string;
+    channel: OperatorChannel;
+    messageId: string | null;
+}, nowMs?: number): RecordAnswerResult;
+/** Newest first. */
+export declare function listOperatorApprovals(limit?: number): OperatorApproval[];
+export declare function recordOperatorApproval(input: Omit<OperatorApproval, 'v' | 'at' | 'summary' | 'detail'> & {
+    summary: string;
+    detail: string;
+}, nowMs?: number): OperatorApproval;
+/**
+ * The operator section of the Leader's evidence. `trusted` is Mason's own
+ * words and his decisions (rendered as a trusted block); `untrusted` is the
+ * Leader's earlier wording those decisions refer to (rendered as UNTRUSTED
+ * DATA). Both are keyed by id so the model can join them.
+ */
+export interface LeaderOperatorContext {
+    trusted: {
+        directives: {
+            id: string;
+            kind: OperatorDirectiveKind;
+            text: string;
+            since: string;
+        }[];
+        answers: {
+            questionId: string;
+            answer: string;
+            answeredOn: string;
+        }[];
+        approvals: {
+            actionId: string;
+            kind: string;
+            outcome: OperatorApprovalOutcome;
+            on: string;
+        }[];
+    };
+    untrusted: {
+        answeredQuestions: {
+            questionId: string;
+            question: string;
+        }[];
+        approvedActions: {
+            actionId: string;
+            summary: string;
+        }[];
+    };
+}
+/** Null when Mason has given the Leader nothing (keeps the evidence digest as it was). */
+export declare function readLeaderOperatorContext(nowMs: number): LeaderOperatorContext | null;