instar 0.28.64 → 0.28.65

package/dist/core/InitiativeDigestJob.js

@@ -1,128 +0,0 @@
-/**
- * InitiativeDigestJob — periodic scan of the InitiativeTracker that
- * pushes a Telegram notification to the user when there are actionable
- * signals (stale / needs-user / next-check-due / ready-to-advance).
- *
- * Quiet by default: an empty digest sends nothing.
- * Idempotent by default: if the exact same digest would be sent again
- * within `resendSuppressionMs`, we skip it to avoid noise.
- *
- * Lives in-process (setInterval-based). Not a JobScheduler Job because
- * we don't want to spawn a fresh Claude session just to check the
- * tracker — this is a direct, deterministic read.
- */
-import { createHash } from 'node:crypto';
-const DEFAULT_INTERVAL_MS = 24 * 60 * 60 * 1000;
-const DEFAULT_RESEND_SUPPRESSION_MS = 23 * 60 * 60 * 1000;
-const DEFAULT_INITIAL_DELAY_MS = 60 * 1000;
-export class InitiativeDigestJob {
-    tracker;
-    sendMessage;
-    intervalMs;
-    resendSuppressionMs;
-    initialDelayMs;
-    now;
-    lastSend = null;
-    initialTimer = null;
-    intervalTimer = null;
-    running = false;
-    constructor(opts) {
-        this.tracker = opts.tracker;
-        this.sendMessage = opts.sendMessage;
-        this.intervalMs = opts.intervalMs ?? DEFAULT_INTERVAL_MS;
-        this.resendSuppressionMs = opts.resendSuppressionMs ?? DEFAULT_RESEND_SUPPRESSION_MS;
-        this.initialDelayMs = opts.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS;
-        this.now = opts.now ?? (() => new Date());
-    }
-    start() {
-        if (this.running)
-            return;
-        this.running = true;
-        this.initialTimer = setTimeout(() => {
-            void this.tick();
-            this.intervalTimer = setInterval(() => void this.tick(), this.intervalMs);
-        }, this.initialDelayMs);
-    }
-    stop() {
-        this.running = false;
-        if (this.initialTimer)
-            clearTimeout(this.initialTimer);
-        if (this.intervalTimer)
-            clearInterval(this.intervalTimer);
-        this.initialTimer = null;
-        this.intervalTimer = null;
-    }
-    /**
-     * Run one scan. Exposed for tests and for the manual-trigger API.
-     * Returns the digest that was scanned and whether a message was sent.
-     */
-    async tick() {
-        const digest = this.tracker.digest(this.now());
-        if (digest.items.length === 0) {
-            return { digest, sent: false, suppressedReason: 'no-items' };
-        }
-        const signature = this.signatureOf(digest);
-        if (this.lastSend && this.lastSend.signature === signature) {
-            const lastMs = Date.parse(this.lastSend.at);
-            const ageMs = this.now().getTime() - lastMs;
-            if (Number.isFinite(lastMs) && ageMs < this.resendSuppressionMs) {
-                return { digest, sent: false, suppressedReason: 'duplicate-within-window' };
-            }
-        }
-        const text = this.format(digest);
-        try {
-            await this.sendMessage(text);
-        }
-        catch (err) {
-            console.error(`[initiative-digest] send failed: ${err instanceof Error ? err.message : err}`);
-            return { digest, sent: false, suppressedReason: 'send-failed' };
-        }
-        this.lastSend = { signature, at: this.now().toISOString() };
-        return { digest, sent: true };
-    }
-    /**
-     * Stable hash of the digest (reason + initiativeId pairs, sorted) so
-     * that identical digests produce identical signatures regardless of
-     * map iteration order.
-     */
-    signatureOf(digest) {
-        const tokens = digest.items
-            .map((i) => `${i.reason}:${i.initiativeId}`)
-            .sort()
-            .join('|');
-        return createHash('sha256').update(tokens).digest('hex');
-    }
-    format(digest) {
-        const byReason = new Map();
-        for (const item of digest.items) {
-            if (!byReason.has(item.reason))
-                byReason.set(item.reason, []);
-            byReason.get(item.reason).push({ title: item.title, detail: item.detail, id: item.initiativeId });
-        }
-        const sections = [];
-        const order = [
-            'needs-user', 'next-check-due', 'ready-to-advance', 'stale',
-        ];
-        const labels = {
-            'needs-user': 'Needs you',
-            'next-check-due': 'Check-in due',
-            'ready-to-advance': 'Ready to advance',
-            'stale': 'Stale',
-        };
-        for (const reason of order) {
-            const items = byReason.get(reason);
-            if (!items || items.length === 0)
-                continue;
-            const lines = items.map((i) => `  • ${i.title} — ${i.detail}`);
-            sections.push(`*${labels[reason]}:*\n${lines.join('\n')}`);
-        }
-        const header = digest.items.length === 1
-            ? '1 initiative needs attention:'
-            : `${digest.items.length} initiatives need attention:`;
-        return `${header}\n\n${sections.join('\n\n')}`;
-    }
-    getLastSend() {
-        return this.lastSend;
-    }
-}
-//# sourceMappingURL=InitiativeDigestJob.js.map

package/dist/core/InitiativeDigestJob.js.map

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

package/upgrades/0.28.61.md

@@ -1,80 +0,0 @@
-# Upgrade Guide — Scheduler reports real exit code for gate skips
-
-## What Changed
-
-`JobScheduler.runGateAsync` previously surfaced `exit null` for every
-legitimate non-zero gate skip, because it was reading `.status` (the
-synchronous `spawnSync` shape) off an error from the asynchronous
-`util.promisify(child_process.execFile)` call, which exposes exit codes
-on `.code` instead. Every gate-skip event and activity-feed line ended
-up coalesced to `null`, indistinguishable from a process crash or
-signal kill.
-
-### Before
-
-```
-Job "degradation-digest" skipped — gate returned exit null after 3 attempts
-```
-
-Agents and operators reading this saw a null exit and assumed the gate
-process had crashed or been killed. This triggered unnecessary
-investigations — most recently, `degradation-digest` looking
-"permanently gated (62 skips, 0 runs)" when the gate was in fact
-exiting 1 by design (no degradation events to digest, nothing to run).
-
-### After
-
-The skip path now reads `.signal ?? .code ?? .status ?? null`, so:
-
-```
-Job "degradation-digest" skipped — gate returned exit 1 after 3 attempts
-Job "other-job"         skipped — gate returned exit SIGKILL after 3 attempts
-```
-
-Legitimate non-zero skips report their real exit code. Signal-terminated
-gates surface their signal. `metadata.exitCode` on the `job_gate_skip`
-event is now a `number | string | null` (was `number | null`); consumers
-doing display or non-arithmetic comparisons continue to work unchanged.
-
-No decision-point change. The gate still retries up to `gateRetries`
-times, still records to the skip ledger, still emits the same event
-shape. Only the exit-code field is now truthful.
-
-## What to Tell Your User
-
-Your activity feed will stop saying "gate returned exit null" for
-healthy skips — it will show the real exit code instead, so a legitimate
-skip stops looking like a crash. Nothing changes about when jobs run or
-skip; we just stopped hiding why.
-
-## Summary of New Capabilities
-
-| Capability | How it shows up |
-|-----------|-----------------|
-| Truthful gate exit codes | Activity feed and `job_gate_skip` events show the real exit code (e.g. `exit 1`) or signal (e.g. `exit SIGKILL`), never `exit null` for non-zero gates |
-| Easier triage of stuck jobs | A job that "keeps skipping" now shows WHY (exit 1 = intentional skip; exit SIGKILL = runtime kill), so operators know whether to investigate |
-
-## Evidence
-
-- `JobScheduler` unit tests: 35/35 passing before and after the change.
-- Error shape captured in the feedback cluster
-  (`cluster-jobscheduler-reports-gate-exit-code-as-null-for-every-legiti`):
-  `err.code: 1`, `err.status: undefined` — confirming the root cause.
-- Side-effects review:
-  `upgrades/side-effects/scheduler-gate-exit-code.md` covers
-  over/under-block (n/a — no block surface), level-of-abstraction fit
-  (right layer, pure diagnostic signal), signal-vs-authority compliance
-  (pure signal quality, no authority change), interactions,
-  external surfaces (activity-feed strings + `metadata.exitCode` type
-  widening), and rollback cost (one-line revert).
-
-## Deployment Notes
-
-No operator action required. Agents pick this up automatically on the
-next AutoUpdater cycle.
-
-## Rollback
-
-Revert the single commit. `metadata.exitCode` returns to being a
-`number | null`, activity feed returns to showing `exit null` for
-legitimate non-zero skips. No schema or state-file changes.