instar 1.3.91 → 1.3.92

package/dist/core/NicknameAssigner.js

@@ -0,0 +1,91 @@
+/**
+ * NicknameAssigner — derives a friendly, collision-free machine nickname.
+ *
+ * Multi-Machine Session Pool, spec §L2 "Machine Nicknames". Users name a
+ * machine by its nickname (the user-facing handle) rather than a raw machineId
+ * (`m_a3f9…`) — for the Machines dashboard tab and for "run this on <nickname>"
+ * / "move this to <nickname>" placement & transfer commands (§L4).
+ *
+ * This module is PURE LOGIC (no I/O): given a machine's own properties + the
+ * nicknames already in the pool, it produces a deterministic nickname. Keeping
+ * it pure makes the derivation + the collision rule unit-testable, and means
+ * every machine reading the same registry derives the same disambiguation.
+ *
+ * Assignment is auto + idempotent (a machine that already has a nickname keeps
+ * it — see MachineIdentityManager.registerMachine), and the result is always
+ * user-editable via PATCH /pool/machines/:id (§L2).
+ */
+/** Max nickname length (matches the validation regex below). */
+const MAX_NICKNAME_LEN = 40;
+/**
+ * Validation: a non-empty string starting with a word char, then up to 40 word
+ * chars / spaces / hyphens. Rejects control chars, leading separators, reserved
+ * shapes, and over-length values. Used at the editable surface (PATCH) and as a
+ * sanity gate on auto-derived values.
+ */
+export function isValidNickname(value) {
+    return typeof value === 'string' && /^[\w][\w \-]{0,40}$/.test(value.trim()) && value.trim().length > 0;
+}
+/** Title-case a space-separated phrase ("macbook pro" → "Macbook Pro"). */
+function titleCase(s) {
+    return s
+        .split(/\s+/)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+}
+/** Friendly label for a platform string like "darwin-arm64". */
+function platformLabel(platform) {
+    const p = (platform || '').toLowerCase();
+    const os = p.startsWith('darwin')
+        ? 'Mac'
+        : p.startsWith('linux')
+            ? 'Linux'
+            : p.startsWith('win')
+                ? 'Windows'
+                : 'Machine';
+    const archMatch = p.match(/-(arm64|x64|x86_64|arm|amd64)$/);
+    const arch = archMatch ? archMatch[1] : '';
+    return arch ? `${os} ${arch}` : os;
+}
+/**
+ * Derive a base (pre-collision) nickname from a machine's own properties.
+ * Prefers a sanitized hostname/identity-name; falls back to a platform label.
+ *
+ * @param identityName the machine's identity `name` (a sanitized hostname, e.g.
+ *   "justins-macbook-pro") — may be empty.
+ * @param platform     the platform string (e.g. "darwin-arm64") — fallback.
+ */
+export function deriveBaseNickname(identityName, platform) {
+    const fromName = titleCase((identityName || '').replace(/\.local$/i, '').replace(/[-_.]+/g, ' ').trim()).slice(0, MAX_NICKNAME_LEN);
+    if (fromName)
+        return fromName;
+    return platformLabel(platform);
+}
+/**
+ * Assign a collision-free nickname for a new machine.
+ *
+ * Deterministic: same (identityName, platform, existingNicknames) → same result.
+ * If the derived base collides (case-insensitive) with an existing nickname, a
+ * numeric suffix is appended ("mac mini" → "mac mini 2" → "mac mini 3"). The
+ * comparison is case-insensitive + trimmed so "Mac Mini" and "mac mini " collide.
+ *
+ * @param opts.identityName     the machine's identity `name`.
+ * @param opts.platform         the machine's platform string.
+ * @param opts.existingNicknames nicknames already taken in the pool.
+ */
+export function assignNickname(opts) {
+    const base = deriveBaseNickname(opts.identityName, opts.platform);
+    const taken = new Set((opts.existingNicknames || []).map((n) => n.trim().toLowerCase()));
+    if (!taken.has(base.toLowerCase()))
+        return base;
+    // Disambiguate with a numeric suffix, deterministically.
+    for (let n = 2; n < 1000; n++) {
+        const candidate = `${base} ${n}`;
+        if (!taken.has(candidate.toLowerCase()))
+            return candidate;
+    }
+    // Pathological (1000 same-named machines) — fall through to a base label.
+    return base;
+}
+//# sourceMappingURL=NicknameAssigner.js.map

package/dist/core/NicknameAssigner.js.map

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

package/dist/core/NicknameCommand.d.ts

@@ -0,0 +1,28 @@
+/**
+ * NicknameCommand — pure recognizer for the user's natural-language "move/run this
+ * on <machine-nickname>" requests (Multi-Machine Session Pool §L4). The headline
+ * test-as-self scenario: the user, mid-conversation, says "move this to the mini"
+ * and the session transfers to that machine. Per "Structure > Willpower" this is a
+ * deterministic recognizer over the KNOWN nickname set (resolved from the registry),
+ * NOT an open-ended LLM intent guess — so it can never invent a target machine.
+ *
+ * The recognizer is intentionally conservative: it only matches when an explicit
+ * relocation verb is present AND the tail resolves to a real, known nickname. A
+ * bare mention of a machine name ("the mini is fast") never triggers a transfer.
+ */
+export interface NicknameCommand {
+    /** 'transfer' (move an existing session) vs 'pin' (hard-pin future placement). */
+    intent: 'transfer' | 'pin';
+    /** The known nickname that was matched (canonical form as registered). */
+    nickname: string;
+    /** The verb phrase that triggered recognition (for audit/telemetry). */
+    matchedVerb: string;
+}
+/**
+ * Recognize a nickname relocation command in free text. Returns null if the text
+ * is not an explicit move/pin request OR if the target doesn't resolve to a known
+ * nickname. Matching is case-insensitive; when multiple nicknames could match, the
+ * LONGEST is chosen (so "mac mini" wins over "mini").
+ */
+export declare function recognizeNicknameCommand(text: string, knownNicknames: string[]): NicknameCommand | null;
+//# sourceMappingURL=NicknameCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NicknameCommand.d.ts","sourceRoot":"","sources":["../../src/core/NicknameCommand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;CACrB;AAeD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,eAAe,GAAG,IAAI,CAuCvG"}

package/dist/core/NicknameCommand.js

@@ -0,0 +1,69 @@
+/**
+ * NicknameCommand — pure recognizer for the user's natural-language "move/run this
+ * on <machine-nickname>" requests (Multi-Machine Session Pool §L4). The headline
+ * test-as-self scenario: the user, mid-conversation, says "move this to the mini"
+ * and the session transfers to that machine. Per "Structure > Willpower" this is a
+ * deterministic recognizer over the KNOWN nickname set (resolved from the registry),
+ * NOT an open-ended LLM intent guess — so it can never invent a target machine.
+ *
+ * The recognizer is intentionally conservative: it only matches when an explicit
+ * relocation verb is present AND the tail resolves to a real, known nickname. A
+ * bare mention of a machine name ("the mini is fast") never triggers a transfer.
+ */
+// Relocation verbs → intent. "pin" is the only hard-pin verb; the rest are transfers.
+const TRANSFER_VERBS = ['move', 'transfer', 'switch', 'migrate', 'send', 'shift', 'hand off', 'handoff', 'run', 'continue', 'resume', 'keep'];
+const PIN_VERBS = ['pin', 'lock'];
+// A relocation command must contain BOTH a verb and a "to/on/onto/over to" preposition
+// before the target, OR an explicit "this/the conversation … on <nick>" shape. We
+// anchor on the preposition so "the mini handled that" can't match.
+const PREPOSITION = /\b(?:over to|onto|on to|to|on|at)\b/i;
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Recognize a nickname relocation command in free text. Returns null if the text
+ * is not an explicit move/pin request OR if the target doesn't resolve to a known
+ * nickname. Matching is case-insensitive; when multiple nicknames could match, the
+ * LONGEST is chosen (so "mac mini" wins over "mini").
+ */
+export function recognizeNicknameCommand(text, knownNicknames) {
+    if (!text || typeof text !== 'string' || knownNicknames.length === 0)
+        return null;
+    // Find the EARLIEST-occurring relocation verb (pin verbs win on a positional tie).
+    const allVerbs = [
+        ...PIN_VERBS.map((v) => ({ verb: v, intent: 'pin' })),
+        ...TRANSFER_VERBS.map((v) => ({ verb: v, intent: 'transfer' })),
+    ];
+    let chosenVerb = null;
+    let chosenIdx = Infinity;
+    let verbEnd = -1;
+    for (const cand of allVerbs) {
+        const m = new RegExp(`\\b${escapeRegExp(cand.verb)}\\b`, 'i').exec(text);
+        if (m && m.index < chosenIdx) {
+            chosenVerb = cand;
+            chosenIdx = m.index;
+            verbEnd = m.index + m[0].length;
+        }
+    }
+    if (!chosenVerb)
+        return null;
+    // There must be a preposition AFTER the verb (the target follows it).
+    const afterVerb = text.slice(verbEnd);
+    const prep = PREPOSITION.exec(afterVerb);
+    if (!prep)
+        return null;
+    const tail = afterVerb.slice(prep.index + prep[0].length);
+    const tailLower = tail.toLowerCase();
+    // Resolve the target against the KNOWN nickname set (longest match wins).
+    const matches = knownNicknames
+        .filter((n) => n && typeof n === 'string')
+        .filter((n) => {
+        const re = new RegExp(`(?:^|\\b|\\s)${escapeRegExp(n.toLowerCase())}(?:$|\\b|\\s|[.!?,])`, 'i');
+        return re.test(tailLower);
+    })
+        .sort((a, b) => b.length - a.length);
+    if (matches.length === 0)
+        return null;
+    return { intent: chosenVerb.intent, nickname: matches[0], matchedVerb: chosenVerb.verb };
+}
+//# sourceMappingURL=NicknameCommand.js.map

package/dist/core/NicknameCommand.js.map

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

package/dist/core/PlacementExecutor.d.ts

@@ -0,0 +1,71 @@
+/**
+ * PlacementExecutor — the single canonical placement component (Multi-Machine
+ * Session Pool §L4). Per "Structure > Willpower", placement is NOT pluggable
+ * per-agent code: ALL placement decisions route through this one component, and
+ * its policy is structured DATA (JSON) validated against a fixed schema — never
+ * ad-hoc logic. `decide()` is PURE over its inputs (deterministic, unit-testable);
+ * the CALLER (router) performs the CAS + side effects from the returned decision.
+ */
+import type { MachineCapacity } from './types.js';
+/** Per-topic placement metadata (persisted with the topic; §L4). */
+export interface TopicPlacement {
+    /** A specific machine the session prefers / is pinned to (nickname-resolved → machineId). */
+    preferredMachine?: string;
+    /** Hard capability requirements (e.g. "gpu", "local-model:llama3"). */
+    requiredCapabilities?: string[];
+    /** When true + preferredMachine set → a HARD pin (queue+escalate if that machine is unavailable). */
+    pinned?: boolean;
+    lastTransferredAt?: number;
+    queueReason?: string;
+}
+export interface PlacementPolicy {
+    weights: {
+        loadAvg: number;
+        activeSessionRatio: number;
+        memPressure: number;
+    };
+    thresholds: {
+        rebalanceThresholdPercent: number;
+        placementHysteresisDelta: number;
+    };
+    capabilityWhitelist: string[];
+    ordering: Array<'hard-constraint' | 'pin' | 'sticky' | 'least-loaded'>;
+}
+export declare const DEFAULT_PLACEMENT_POLICY: PlacementPolicy;
+export interface PlacementRequest {
+    sessionKey: string;
+    topicMetadata: TopicPlacement;
+    machineRegistry: MachineCapacity[];
+    currentOwner?: string;
+    reason: 'new' | 'failover' | 'rebalance' | 'pin';
+}
+export interface PlacementDecision {
+    chosenMachine: string | null;
+    score: number;
+    reason: string;
+    outcome: 'placed' | 'queued' | 'placement-blocked';
+    escalationReason?: string;
+}
+/**
+ * Validate a PlacementPolicy against the fixed schema (§L4). Throws on a malformed
+ * policy — unknown weight key, non-numeric threshold/weight, or a capability token
+ * outside the whitelist vocabulary — so a router refuses to act with a bad policy
+ * (never silently defaulted). Called at startup.
+ */
+export declare function validatePlacementPolicy(policy: unknown): asserts policy is PlacementPolicy;
+/** Validate per-topic placement metadata on read (§L4) — never infer/sanitize; block+escalate on a violation. */
+export declare function validateTopicPlacement(tp: unknown, capabilityWhitelist: string[]): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare class PlacementExecutor {
+    private readonly policy;
+    constructor(policy?: PlacementPolicy);
+    /** Score a candidate (lower = better): weighted load + session-ratio + mem pressure. */
+    private score;
+    /** Pure placement decision (§L4). Deterministic over its inputs. */
+    decide(req: PlacementRequest): PlacementDecision;
+}
+//# sourceMappingURL=PlacementExecutor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PlacementExecutor.d.ts","sourceRoot":"","sources":["../../src/core/PlacementExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,6FAA6F;IAC7F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,qGAAqG;IACrG,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9E,UAAU,EAAE;QAAE,yBAAyB,EAAE,MAAM,CAAC;QAAC,wBAAwB,EAAE,MAAM,CAAA;KAAE,CAAC;IACpF,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,EAAE,KAAK,CAAC,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,cAAc,CAAC,CAAC;CACxE;AAED,eAAO,MAAM,wBAAwB,EAAE,eAKtC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,cAAc,CAAC;IAC9B,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,KAAK,GAAG,UAAU,GAAG,WAAW,GAAG,KAAK,CAAC;CAClD;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,mBAAmB,CAAC;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,eAAe,CAqB1F;AAED,iHAAiH;AACjH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAqB/H;AAID,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAC7B,MAAM,GAAE,eAA0C;IAK9D,wFAAwF;IACxF,OAAO,CAAC,KAAK;IAQb,oEAAoE;IACpE,MAAM,CAAC,GAAG,EAAE,gBAAgB,GAAG,iBAAiB;CA6DjD"}

package/dist/core/PlacementExecutor.js

@@ -0,0 +1,156 @@
+/**
+ * PlacementExecutor — the single canonical placement component (Multi-Machine
+ * Session Pool §L4). Per "Structure > Willpower", placement is NOT pluggable
+ * per-agent code: ALL placement decisions route through this one component, and
+ * its policy is structured DATA (JSON) validated against a fixed schema — never
+ * ad-hoc logic. `decide()` is PURE over its inputs (deterministic, unit-testable);
+ * the CALLER (router) performs the CAS + side effects from the returned decision.
+ */
+export const DEFAULT_PLACEMENT_POLICY = {
+    weights: { loadAvg: 1.0, activeSessionRatio: 1.0, memPressure: 0.5 },
+    thresholds: { rebalanceThresholdPercent: 0.85, placementHysteresisDelta: 0.15 },
+    capabilityWhitelist: ['gpu', 'fast-cpu', 'sessions', 'jobs', 'telegram', 'tunnel'],
+    ordering: ['hard-constraint', 'pin', 'sticky', 'least-loaded'],
+};
+/**
+ * Validate a PlacementPolicy against the fixed schema (§L4). Throws on a malformed
+ * policy — unknown weight key, non-numeric threshold/weight, or a capability token
+ * outside the whitelist vocabulary — so a router refuses to act with a bad policy
+ * (never silently defaulted). Called at startup.
+ */
+export function validatePlacementPolicy(policy) {
+    const p = policy;
+    if (!p || typeof p !== 'object')
+        throw new Error('PlacementPolicy must be an object');
+    const wKeys = ['loadAvg', 'activeSessionRatio', 'memPressure'];
+    if (!p.weights || typeof p.weights !== 'object')
+        throw new Error('PlacementPolicy.weights required');
+    for (const k of Object.keys(p.weights)) {
+        if (!wKeys.includes(k))
+            throw new Error(`PlacementPolicy.weights: unknown key '${k}'`);
+    }
+    for (const k of wKeys) {
+        if (typeof p.weights[k] !== 'number')
+            throw new Error(`PlacementPolicy.weights.${k} must be a number`);
+    }
+    if (!p.thresholds || typeof p.thresholds.rebalanceThresholdPercent !== 'number' || typeof p.thresholds.placementHysteresisDelta !== 'number') {
+        throw new Error('PlacementPolicy.thresholds.{rebalanceThresholdPercent,placementHysteresisDelta} must be numbers');
+    }
+    if (!Array.isArray(p.capabilityWhitelist) || p.capabilityWhitelist.some((c) => typeof c !== 'string')) {
+        throw new Error('PlacementPolicy.capabilityWhitelist must be string[]');
+    }
+    const validSteps = ['hard-constraint', 'pin', 'sticky', 'least-loaded'];
+    if (!Array.isArray(p.ordering) || p.ordering.some((s) => !validSteps.includes(s))) {
+        throw new Error(`PlacementPolicy.ordering must be a subset of ${validSteps.join(',')}`);
+    }
+}
+/** Validate per-topic placement metadata on read (§L4) — never infer/sanitize; block+escalate on a violation. */
+export function validateTopicPlacement(tp, capabilityWhitelist) {
+    if (tp == null)
+        return { ok: true };
+    if (typeof tp !== 'object')
+        return { ok: false, reason: 'topic-metadata-not-object' };
+    const t = tp;
+    if ('preferredMachine' in t && t.preferredMachine != null && (typeof t.preferredMachine !== 'string' || !/^[\w-]+$/.test(t.preferredMachine))) {
+        return { ok: false, reason: 'preferredMachine-invalid' };
+    }
+    if ('pinned' in t && t.pinned != null && typeof t.pinned !== 'boolean')
+        return { ok: false, reason: 'pinned-not-boolean' };
+    // A hard pin (pinned:true) is meaningless without a target machine — reject it rather
+    // than silently treating it as unpinned (which would let placement drift off the
+    // machine the user explicitly pinned to). (2026-05-29 pre-merge review.)
+    if (t.pinned === true && (t.preferredMachine == null || t.preferredMachine === '')) {
+        return { ok: false, reason: 'pinned-without-target' };
+    }
+    if ('requiredCapabilities' in t && t.requiredCapabilities != null) {
+        if (!Array.isArray(t.requiredCapabilities))
+            return { ok: false, reason: 'requiredCapabilities-not-array' };
+        for (const c of t.requiredCapabilities) {
+            if (typeof c !== 'string' || !capabilityWhitelist.includes(c))
+                return { ok: false, reason: `capability-not-whitelisted:${String(c)}` };
+        }
+    }
+    return { ok: true };
+}
+const MEM_PRESSURE_NUM = { low: 0, moderate: 1, high: 2, critical: 3 };
+export class PlacementExecutor {
+    policy;
+    constructor(policy = DEFAULT_PLACEMENT_POLICY) {
+        validatePlacementPolicy(policy);
+        this.policy = policy;
+    }
+    /** Score a candidate (lower = better): weighted load + session-ratio + mem pressure. */
+    score(m) {
+        const w = this.policy.weights;
+        const load = m.loadAvg ?? 0;
+        const ratio = m.maxSessions && m.maxSessions > 0 ? (m.activeSessionCount ?? 0) / m.maxSessions : 0;
+        const mem = MEM_PRESSURE_NUM[m.memPressure ?? 'low'] ?? 0;
+        return w.loadAvg * load + w.activeSessionRatio * ratio + w.memPressure * mem;
+    }
+    /** Pure placement decision (§L4). Deterministic over its inputs. */
+    decide(req) {
+        // 0. Validate the topic metadata on read — never mis-place on corrupt metadata.
+        const v = validateTopicPlacement(req.topicMetadata, this.policy.capabilityWhitelist);
+        if (!v.ok) {
+            return { chosenMachine: null, score: 0, reason: 'topic-metadata-invalid', outcome: 'placement-blocked', escalationReason: v.reason };
+        }
+        const tp = req.topicMetadata ?? {};
+        // Eligible = online (clock-ok machines are already excluded upstream via the registry,
+        // but we also honor an explicit offline flag here for determinism).
+        let candidates = req.machineRegistry.filter((m) => m.online && m.clockSkewStatus !== 'suspect-clock-removed');
+        for (const step of this.policy.ordering) {
+            if (step === 'hard-constraint') {
+                // Required capabilities.
+                if (tp.requiredCapabilities && tp.requiredCapabilities.length > 0) {
+                    candidates = candidates.filter((m) => tp.requiredCapabilities.every((c) => (m.capabilities ?? []).includes(c)));
+                    if (candidates.length === 0) {
+                        return { chosenMachine: null, score: 0, reason: 'no-capable-machine', outcome: 'queued', escalationReason: 'capabilities-unsatisfiable' };
+                    }
+                }
+                // Hard pin: the named machine MUST run it; queue+escalate if unavailable (never re-route).
+                if (tp.pinned && tp.preferredMachine) {
+                    const pinned = candidates.find((m) => m.machineId === tp.preferredMachine);
+                    if (!pinned) {
+                        return { chosenMachine: null, score: 0, reason: 'hard-pin-unavailable', outcome: 'queued', escalationReason: 'hard-pin-unsatisfiable' };
+                    }
+                    return { chosenMachine: pinned.machineId, score: this.score(pinned), reason: 'hard-pin', outcome: 'placed' };
+                }
+            }
+            else if (step === 'pin') {
+                // Soft preference: prefer the named machine if eligible; else fall through (degrade).
+                if (tp.preferredMachine) {
+                    const pref = candidates.find((m) => m.machineId === tp.preferredMachine);
+                    if (pref)
+                        return { chosenMachine: pref.machineId, score: this.score(pref), reason: 'preference', outcome: 'placed' };
+                }
+            }
+            else if (step === 'sticky') {
+                // Keep the current owner unless it's under pressure (hysteresis) or being rebalanced.
+                if (req.currentOwner && req.reason !== 'rebalance') {
+                    const cur = candidates.find((m) => m.machineId === req.currentOwner);
+                    if (cur) {
+                        const best = candidates.reduce((a, b) => (this.score(b) < this.score(a) ? b : a), candidates[0]);
+                        // Stick unless a meaningfully-better machine exists (hysteresis margin).
+                        if (this.score(cur) <= this.score(best) + this.policy.thresholds.placementHysteresisDelta) {
+                            return { chosenMachine: cur.machineId, score: this.score(cur), reason: 'sticky', outcome: 'placed' };
+                        }
+                    }
+                }
+            }
+            else if (step === 'least-loaded') {
+                if (candidates.length === 0) {
+                    return { chosenMachine: null, score: 0, reason: 'no-online-machine', outcome: 'queued', escalationReason: 'no-capable-online-machine' };
+                }
+                const best = candidates.reduce((a, b) => (this.score(b) < this.score(a) ? b : a), candidates[0]);
+                return { chosenMachine: best.machineId, score: this.score(best), reason: 'least-loaded', outcome: 'placed' };
+            }
+        }
+        // Ordering exhausted with no placement (e.g. no least-loaded step + no pin matched).
+        if (candidates.length === 0) {
+            return { chosenMachine: null, score: 0, reason: 'no-online-machine', outcome: 'queued', escalationReason: 'no-capable-online-machine' };
+        }
+        const best = candidates.reduce((a, b) => (this.score(b) < this.score(a) ? b : a), candidates[0]);
+        return { chosenMachine: best.machineId, score: this.score(best), reason: 'fallback-least-loaded', outcome: 'placed' };
+    }
+}
+//# sourceMappingURL=PlacementExecutor.js.map

package/dist/core/PlacementExecutor.js.map

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

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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"}

package/dist/core/PostUpdateMigrator.js

@@ -2627,6 +2627,27 @@ The attention queue spawns ONE Telegram forum topic per item — right for a gen
         else {
             result.skipped.push('CLAUDE.md: Topic-Flood Guard section already present');
         }
+        // Multi-Machine Session Pool (§L2) — tells the agent about the active-active
+        // pool + the Machines tab + nickname-based placement/transfer. Without it an
+        // agent asked "what machines am I on / move this to the mini / where is this
+        // running?" has no grounded answer. Idempotent via the unique marker phrase.
+        if (!content.includes('Multi-Machine Session Pool (active-active') && !content.includes('/pool/machines/')) {
+            const section = `
+## Multi-Machine Session Pool (active-active — spread conversations across machines)
+
+Beyond the one-awake-machine model: with the pool enabled I run conversations across ALL my machines at once and can MOVE a conversation between them. Ships DARK behind \`multiMachine.sessionPool.stage\` (default 'dark'); a single-machine agent is a no-op.
+
+- **See the pool:** the **Machines tab** in the dashboard, or \`GET /pool\` (Bearer-auth) → which machine is the router ("dispatcher") + every machine's nickname, hardware, online status, load, and clock-skew status.
+- **Machine nicknames** are the user-facing handle (auto-assigned, editable). Rename via \`PATCH /pool/machines/:machineId\` with \`{"nickname":"the mini"}\`, or inline on the Machines tab.
+- **Proactive triggers:** when the user says "run this on <nickname>" / "move this to <nickname>" → placement/transfer-by-nickname (the session moves to the named machine, resuming like a session restart). "where is this running?" → \`GET /pool\`. Deep mechanics: the Machines tab + \`docs/specs/MULTI-MACHINE-SESSION-POOL-SPEC.md\`.
+`;
+            content += '\n' + section;
+            patched = true;
+            result.upgraded.push('CLAUDE.md: added Multi-Machine Session Pool section');
+        }
+        else {
+            result.skipped.push('CLAUDE.md: Multi-Machine Session Pool section already present');
+        }
         // ContextWedgeSentinel — the 4th silently-stopped sentinel. Tells the agent
         // about the thinking-block-400 wedge + that auto-recovery is opt-in. Without
         // it, an agent asked "why did my session keep failing instantly / what is