instar 0.28.102 → 0.28.103

package/dist/core/MigratorStepEngine.js

@@ -0,0 +1,352 @@
+/**
+ * MigratorStepEngine — atomic-step primitive for post-update migrations.
+ *
+ * Implements F-7 of `docs/specs/SELF-HEALING-REMEDIATOR-V2-SPEC.md`
+ * (§R1 Upgrade invariants + §A35 + §A50 + §A57 Tier-2). Provides:
+ *
+ *   1. `MigratorStepEngine` — registers named, idempotent, run-once-per-
+ *      version atomic steps that fire at release boundaries. Each step is
+ *      self-contained; one step failing does NOT roll back prior steps or
+ *      prevent subsequent steps from running. Persisted state lives at
+ *      `<stateDir>/migrator-steps-completed.json` keyed by
+ *      `<version>:<step-name>`.
+ *
+ *   2. `AnnouncementManager` — `announceOnce` primitive for "show this
+ *      message to the user exactly once and then never again". Used for
+ *      surfacing migration completions, structural changes, or any other
+ *      one-shot user-facing notice. Persisted state lives at
+ *      `<stateDir>/announcements-shown.json` keyed by announcementId.
+ *
+ * Design notes:
+ *
+ *   - Atomic: each step records outcome (completed | skipped | failed)
+ *     atomically (temp-file → fsync → rename). A crash mid-step leaves
+ *     the ledger consistent — either the step is recorded or it isn't,
+ *     never partial.
+ *
+ *   - Version-gated: a step `version: "1.2.3"` runs only when the engine
+ *     is invoked with `toVersion >= "1.2.3"` (semver compare). Steps for
+ *     versions strictly newer than `toVersion` are skipped without being
+ *     recorded — they will run on the next update boundary that catches
+ *     up to them.
+ *
+ *   - Once-per-version-step pair: a successful step is recorded with key
+ *     `<version>:<step-name>`. Re-runs of `runPendingSteps()` short-circuit
+ *     on that key. A FAILED step IS also recorded (with outcome `failed`)
+ *     so the same broken step doesn't re-run unbounded on every update —
+ *     operators see the failure in the report and decide whether to retry.
+ *
+ *   - No rollback. Each step must be self-contained and atomic on its
+ *     own. The spec deliberately rejects step ordering / dependency /
+ *     rollback semantics — those couplings are what made v1's migrator
+ *     unmaintainable.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+// ── Semver comparison (minimal, sufficient for this engine) ─────────
+const VERSION_RE = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
+function parseVersion(v) {
+    const m = VERSION_RE.exec(v.trim());
+    if (!m)
+        return null;
+    return [parseInt(m[1], 10), parseInt(m[2], 10), parseInt(m[3], 10), m[4] ?? ''];
+}
+/**
+ * Compare two semver strings. Returns -1 / 0 / 1. Pre-release strings are
+ * compared lexically when major.minor.patch match (good-enough for our
+ * "run on version >= X" usage). Unparseable inputs sort as -Infinity so
+ * a malformed `fromVersion` never blocks step execution.
+ */
+export function compareSemver(a, b) {
+    const pa = parseVersion(a);
+    const pb = parseVersion(b);
+    if (!pa && !pb)
+        return 0;
+    if (!pa)
+        return -1;
+    if (!pb)
+        return 1;
+    for (let i = 0; i < 3; i++) {
+        if (pa[i] < pb[i])
+            return -1;
+        if (pa[i] > pb[i])
+            return 1;
+    }
+    // major.minor.patch equal — compare pre-release. Absent pre-release
+    // outranks any pre-release (e.g. 1.0.0 > 1.0.0-rc1).
+    const preA = pa[3];
+    const preB = pb[3];
+    if (preA === '' && preB === '')
+        return 0;
+    if (preA === '')
+        return 1;
+    if (preB === '')
+        return -1;
+    if (preA < preB)
+        return -1;
+    if (preA > preB)
+        return 1;
+    return 0;
+}
+// ── MigratorStepEngine ───────────────────────────────────────────────
+export class MigratorStepEngine {
+    stateDir;
+    steps = [];
+    /** Path to the step-completion ledger. */
+    ledgerPath;
+    constructor(stateDir) {
+        this.stateDir = path.resolve(stateDir);
+        this.ledgerPath = path.join(this.stateDir, 'migrator-steps-completed.json');
+    }
+    /**
+     * Register an atomic step. Steps run in registration order on each
+     * invocation of `runPendingSteps()`, subject to the version gate and
+     * the per-version-per-step idempotency guard.
+     *
+     * Duplicate `name` values are rejected at registration time — names
+     * are global identifiers in the ledger.
+     */
+    registerStep(step) {
+        if (!step.name || typeof step.name !== 'string') {
+            throw new Error('MigratorStepEngine.registerStep: step.name is required');
+        }
+        if (!step.version || typeof step.version !== 'string') {
+            throw new Error(`MigratorStepEngine.registerStep: step.version is required (step=${step.name})`);
+        }
+        if (typeof step.run !== 'function') {
+            throw new Error(`MigratorStepEngine.registerStep: step.run must be a function (step=${step.name})`);
+        }
+        for (const existing of this.steps) {
+            if (existing.name === step.name) {
+                throw new Error(`MigratorStepEngine.registerStep: duplicate step name "${step.name}"`);
+            }
+        }
+        this.steps.push(step);
+    }
+    /**
+     * Run every pending step. A step is "pending" when:
+     *   - its `version <= toVersion` (semver compare), AND
+     *   - no ledger entry exists for `<version>:<name>`.
+     *
+     * Steps for versions strictly newer than `toVersion` are reported as
+     * `skipped` (with details: `future-version`) but NOT recorded — they
+     * will run on a later update boundary that crosses their threshold.
+     *
+     * Steps whose ledger entry already exists are reported as `skipped`
+     * (with details: `already-recorded:<previous-outcome>`).
+     *
+     * Each step is executed under a try/catch; thrown errors are converted
+     * to `outcome: 'failed'` and recorded. The engine never propagates
+     * step failures to the caller — one broken step cannot block subsequent
+     * steps.
+     */
+    async runPendingSteps(fromVersion, toVersion) {
+        if (!fs.existsSync(this.stateDir)) {
+            fs.mkdirSync(this.stateDir, { recursive: true });
+        }
+        const ledger = this.readLedger();
+        const report = { steps: [] };
+        for (const step of this.steps) {
+            const key = `${step.version}:${step.name}`;
+            // Already recorded — skip.
+            if (ledger[key]) {
+                report.steps.push({
+                    name: step.name,
+                    outcome: 'skipped',
+                    details: `already-recorded:${ledger[key].outcome}`,
+                });
+                continue;
+            }
+            // Future-version — skip without recording.
+            if (compareSemver(step.version, toVersion) > 0) {
+                report.steps.push({
+                    name: step.name,
+                    outcome: 'skipped',
+                    details: `future-version:${step.version} > ${toVersion}`,
+                });
+                continue;
+            }
+            // Execute.
+            const ctx = {
+                stateDir: this.stateDir,
+                fromVersion,
+                toVersion,
+                logger: (_msg) => {
+                    /* default no-op; callers wire a real logger via wrapping */
+                },
+            };
+            let result;
+            try {
+                result = await step.run(ctx);
+                if (!result || typeof result.outcome !== 'string') {
+                    result = { outcome: 'failed', details: 'step returned malformed result' };
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                result = { outcome: 'failed', details: `threw: ${msg}` };
+            }
+            // Record outcome (including failures — see class docstring).
+            ledger[key] = {
+                outcome: result.outcome,
+                details: result.details,
+                recordedAt: new Date().toISOString(),
+            };
+            this.writeLedger(ledger);
+            report.steps.push({
+                name: step.name,
+                outcome: result.outcome,
+                details: result.details,
+            });
+        }
+        return report;
+    }
+    /**
+     * Look up whether `<version>:<name>` is recorded. Returns the ledger
+     * entry or `undefined`. Intended for callers that want to render a
+     * migration report.
+     */
+    getRecorded(version, name) {
+        const ledger = this.readLedger();
+        return ledger[`${version}:${name}`];
+    }
+    // ── Ledger I/O ─────────────────────────────────────────────────────
+    readLedger() {
+        try {
+            if (!fs.existsSync(this.ledgerPath))
+                return {};
+            const raw = fs.readFileSync(this.ledgerPath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                return parsed;
+            }
+            return {};
+        }
+        catch {
+            // Corrupt ledger — treat as empty rather than blocking. The crash
+            // recovery path is: subsequent run records its results into a
+            // fresh ledger. Lost history of past runs is acceptable; blocked
+            // upgrades are not.
+            return {};
+        }
+    }
+    writeLedger(ledger) {
+        const tmpPath = `${this.ledgerPath}.tmp-${process.pid}-${Date.now()}`;
+        const serialized = JSON.stringify(ledger, null, 2) + '\n';
+        const fd = fs.openSync(tmpPath, 'w', 0o600);
+        try {
+            fs.writeSync(fd, serialized);
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        fs.renameSync(tmpPath, this.ledgerPath);
+    }
+}
+/**
+ * AnnouncementManager — "show this message to the user once, then never
+ * again" primitive. Used for one-shot migration completions, structural-
+ * change notices, etc.
+ *
+ * The default sink writes to stderr with an `[announcement]` prefix.
+ * Callers can pass a custom sink (e.g. routed to Telegram or the
+ * dashboard's attention queue) via the constructor.
+ *
+ * Persisted state at `<stateDir>/announcements-shown.json`. The ledger
+ * survives across instances and across agent restarts.
+ */
+export class AnnouncementManager {
+    stateDir;
+    ledgerPath;
+    sink;
+    constructor(stateDir, sink) {
+        this.stateDir = path.resolve(stateDir);
+        this.ledgerPath = path.join(this.stateDir, 'announcements-shown.json');
+        this.sink = sink ?? defaultSink;
+    }
+    /**
+     * Emit the announcement exactly once per `announcementId`.
+     *
+     * Returns `true` if the announcement was emitted this call; `false`
+     * if a prior call (in this process or a previous run) already
+     * emitted it.
+     *
+     * Caller-side idempotency: the ledger is consulted BEFORE the sink
+     * is invoked. Repeated calls with the same id are O(1) reads.
+     */
+    async announceOnce(announcementId, message, channel) {
+        if (!announcementId || typeof announcementId !== 'string') {
+            throw new Error('AnnouncementManager.announceOnce: announcementId is required');
+        }
+        if (typeof message !== 'string') {
+            throw new Error('AnnouncementManager.announceOnce: message must be a string');
+        }
+        if (channel !== 'telegram' && channel !== 'dashboard' && channel !== 'log') {
+            throw new Error(`AnnouncementManager.announceOnce: invalid channel "${channel}"`);
+        }
+        if (!fs.existsSync(this.stateDir)) {
+            fs.mkdirSync(this.stateDir, { recursive: true });
+        }
+        const ledger = this.readLedger();
+        if (ledger[announcementId]) {
+            return false;
+        }
+        // Record BEFORE emitting so a sink that throws cannot leave us
+        // emitting twice on the next call. Worst case: announcement was
+        // recorded but the sink failed — operator sees a missed notice
+        // once, never a duplicate.
+        ledger[announcementId] = {
+            channel,
+            shownAt: new Date().toISOString(),
+        };
+        this.writeLedger(ledger);
+        try {
+            await this.sink(announcementId, message, channel);
+        }
+        catch {
+            // Swallow — see comment above. The ledger entry stands.
+        }
+        return true;
+    }
+    /** Has this announcement been shown? Read-only check. */
+    hasBeenShown(announcementId) {
+        const ledger = this.readLedger();
+        return Boolean(ledger[announcementId]);
+    }
+    readLedger() {
+        try {
+            if (!fs.existsSync(this.ledgerPath))
+                return {};
+            const raw = fs.readFileSync(this.ledgerPath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                return parsed;
+            }
+            return {};
+        }
+        catch {
+            return {};
+        }
+    }
+    writeLedger(ledger) {
+        const tmpPath = `${this.ledgerPath}.tmp-${process.pid}-${Date.now()}`;
+        const serialized = JSON.stringify(ledger, null, 2) + '\n';
+        const fd = fs.openSync(tmpPath, 'w', 0o600);
+        try {
+            fs.writeSync(fd, serialized);
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        fs.renameSync(tmpPath, this.ledgerPath);
+    }
+}
+function defaultSink(announcementId, message, channel) {
+    // Default sink writes to stderr so it never interferes with stdout
+    // RPC responses or CLI output capture.
+    const line = `[announcement:${channel}] ${announcementId}: ${message}`;
+    process.stderr.write(line + '\n');
+}
+//# sourceMappingURL=MigratorStepEngine.js.map

package/dist/core/MigratorStepEngine.js.map

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

package/dist/core/PostUpdateMigrator.d.ts

@@ -18,6 +18,7 @@
  *   - CLAUDE.md sections are appended only if missing (check by heading)
  *   - Scripts are installed only if missing (never overwrite user modifications)
  */
+import { type MigratorStep, type RunPendingStepsResult } from './MigratorStepEngine.js';
 export interface MigrationResult {
     /** What was upgraded */
     upgraded: string[];
@@ -35,7 +36,37 @@ export interface MigratorConfig {
 }
 export declare class PostUpdateMigrator {
     private config;
+    /**
+     * F-7 atomic-step engine. Lazily constructed on first access via
+     * `getStepEngine()` so existing callers that never touch atomic steps
+     * pay zero cost. See `src/core/MigratorStepEngine.ts` for the primitive
+     * docs; see `docs/specs/SELF-HEALING-REMEDIATOR-V2-SPEC.md` §A35/§A50
+     * for the spec.
+     */
+    private stepEngine;
     constructor(config: MigratorConfig);
+    /**
+     * F-7 atomic-step primitive: register a step that will run once on
+     * the release boundary where `step.version <= toVersion`. Idempotent
+     * across runs — the engine records every step's outcome in
+     * `<stateDir>/migrator-steps-completed.json` keyed by
+     * `<version>:<step-name>`.
+     *
+     * Steps are atomic and self-contained: a failure in one step does not
+     * roll back prior steps and does not block subsequent steps.
+     *
+     * See `docs/specs/SELF-HEALING-REMEDIATOR-V2-SPEC.md` §A35 + §A50.
+     */
+    registerStep(step: MigratorStep): void;
+    /**
+     * F-7 atomic-step primitive: execute every pending step. Pending =
+     * step.version <= toVersion AND no ledger entry recorded yet.
+     *
+     * Steps run in registration order. Failures are recorded (never
+     * thrown) and do not stop subsequent steps.
+     */
+    runPendingSteps(fromVersion: string, toVersion: string): Promise<RunPendingStepsResult>;
+    private getStepEngine;
     /**
      * Run all post-update migrations. Safe to call multiple times —
      * each migration is idempotent.
@@ -67,6 +98,51 @@ export declare class PostUpdateMigrator {
      * Non-destructive — only writes SKILL.md files that don't already exist.
      */
     private migrateBuiltinSkills;
+    /**
+     * Phase 2 — install/refresh built-in agentmd jobs. Copies the shipped
+     * markdown templates into `.instar/jobs/instar/` and writes their
+     * per-slug manifests. Honors operator-disabled state (preserves
+     * `enabled: false` + `disabledAtBodyHash` across updates). Retires
+     * jobs that are no longer shipped.
+     *
+     * The `.instar/jobs/user/` namespace is structurally untouched (Seamless
+     * Migration Guarantee invariant 4).
+     */
+    private migrateBuiltinJobs;
+    /**
+     * Phase 5 — auto-run `instar jobs migrate` for pre-spec agents on update.
+     *
+     * Behavior:
+     *   - SKIP entirely if `.instar/jobs/.migration-complete.json` exists
+     *     (operator already confirmed completion via Dashboard).
+     *   - SKIP entirely if `.instar/jobs/.migration-abandoned.json` exists
+     *     (operator explicitly chose to roll back).
+     *   - SKIP if `.instar/jobs.json` is absent (nothing to migrate).
+     *   - Otherwise, invoke `jobsMigrate({ defaultAction: 'fork' })` —
+     *     fork policy preserves the operator's customized body in user/
+     *     namespace, never silently drops content. This is the
+     *     spec-mandated default for the auto-run path.
+     *   - Emit a Dashboard banner event via the migration result so the
+     *     operator sees "migration ran on update — confirm in Dashboard."
+     *
+     * Seamless Migration Guarantee invariants enforced at this layer
+     * (PR #180 §Seamless Migration Guarantee):
+     *   #6 in-flight protection — JobScheduler.activeRuns() check is
+     *      currently a defensive no-op until Phase 4 wires the scheduler
+     *      back-reference; the migration runs at update time, before the
+     *      new scheduler instance comes up, so by construction nothing is
+     *      in flight.
+     *   #7 transactional safety on interrupt — `jobsMigrate` is structurally
+     *      safe (backup-first, idempotent, rollback via --abandon).
+     *   #8 telemetry — outcome is appended to result.upgraded/errors.
+     */
+    private autoMigrateLegacyJobsJson;
+    /** Read the installed package's version, for the migration event's
+     *  `instarVersion` field. Best-effort — returns undefined on failure. */
+    private readBundledInstarVersion;
+    /** Best-effort telemetry write. Missing telemetry is degradation, not a
+     *  release-blocker, so failures are swallowed. */
+    private appendMigrationTelemetry;
     /**
      * Re-install hooks with the latest templates.
      * Built-in hooks in instar/ are always overwritten.

package/dist/core/PostUpdateMigrator.d.ts.map

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