opensquid 0.5.395

package/dist/setup/cli/schedule_state.js

@@ -0,0 +1,291 @@
+/**
+ * Schedule state + persistence helpers for CLI.2.
+ *
+ * Split out of `schedule.ts` (file-size budget). Five concerns:
+ *
+ *   1. `readUserSchedules` / `writeUserSchedules` — load + atomically rewrite
+ *      `~/.opensquid/schedules.yaml`. Holds USER-ADDED schedules only.
+ *      Pack-declared schedules live in pack manifests and are read via
+ *      `enumeratePacks` (from CLI.1). The CLI's view is the merged union.
+ *   2. `readPausedSet` / `writePausedSet` — `~/.opensquid/schedule_paused.yaml`.
+ *      Pause/resume applies to user-added schedules ONLY (pack-declared
+ *      schedules are managed via the pack manifest, never the CLI).
+ *   3. `appendHistory` / `readHistory` — `~/.opensquid/schedule_history.jsonl`
+ *      for force-fire records. Combined with per-session SCHED.4 outcome logs
+ *      to produce the `history` view.
+ *   4. `readStatusAcrossSessions` — walks `~/.opensquid/sessions/<id>/
+ *      scheduling/<scheduleId>.status.json` and returns the most-recent
+ *      status sentinel. Defaults to 'probationary' when nothing on disk.
+ *   5. `computeNextFire` — minute-by-minute walker over a small pure
+ *      5-field POSIX cron matcher. Bounded horizon (30 d) so we never spin
+ *      on a pathological expression. node-cron has no public `getNext` —
+ *      we ship our own matcher rather than reach into node-cron internals.
+ *
+ * Schedule id format (user-added): `user:<name>` — `name` is the
+ * `<pack>.<skill>.<n>` suffix the CLI generates so two `add` calls with the
+ * same (pack, skill) produce distinct ids. Pack-declared schedule ids come
+ * from `ScheduleRegistry` (`<pack>::<skill>::<index>`) — we surface them
+ * unchanged so audit logs match.
+ *
+ * Imports from: node:fs/promises, yaml, ../../runtime/paths,
+ *   ../../runtime/wedge/schedule_outcome.
+ * Imported by: src/setup/cli/schedule.ts + src/setup/cli/schedule_actions.ts.
+ */
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { OPENSQUID_HOME } from '../../runtime/paths.js';
+import { scheduleOutcomeDir } from '../../runtime/wedge/schedule_outcome.js';
+import { appendJsonlEntry, readJsonlEntries, readKeyedYamlList, writeKeyedYamlList, } from './state_io.js';
+export const defaultUserSchedulesPath = () => join(OPENSQUID_HOME(), 'schedules.yaml');
+export const defaultPausedPath = () => join(OPENSQUID_HOME(), 'schedule_paused.yaml');
+export const defaultHistoryPath = () => join(OPENSQUID_HOME(), 'schedule_history.jsonl');
+export const defaultSessionsDir = () => join(OPENSQUID_HOME(), 'sessions');
+// ---------------------------------------------------------------------------
+// User-added schedules — yaml mapping `{ schedules: [UserSchedule, ...] }`.
+// Atomic write via `tmp + rename` matches the trigger_state.yaml pattern.
+// ---------------------------------------------------------------------------
+const isUserSchedule = (v) => typeof v === 'object' && v !== null;
+const isString = (v) => typeof v === 'string';
+export async function readUserSchedules(path) {
+    return readKeyedYamlList(path, 'schedules', 'schedules.yaml', isUserSchedule);
+}
+export async function writeUserSchedules(path, schedules) {
+    return writeKeyedYamlList(path, 'schedules', schedules);
+}
+// ---------------------------------------------------------------------------
+// Paused set — yaml mapping `{ paused: [ <scheduleId>, ... ] }`.
+// ---------------------------------------------------------------------------
+export async function readPausedSet(path) {
+    return new Set(await readKeyedYamlList(path, 'paused', 'schedule_paused.yaml', isString));
+}
+export async function writePausedSet(path, paused) {
+    return writeKeyedYamlList(path, 'paused', [...paused].sort());
+}
+// ---------------------------------------------------------------------------
+// History (force-fire records).
+//
+// Pack-declared schedule fires are captured by SCHED.4's per-session JSONL.
+// `schedule run` (CLI) records into this file because the CLI may run with
+// no daemon + no active session — we need a daemon-agnostic surface for
+// `schedule history` to reflect manual fires.
+// ---------------------------------------------------------------------------
+export async function appendHistory(path, entry) {
+    return appendJsonlEntry(path, entry);
+}
+/**
+ * Read schedule history JSONL entries. T-SIC L11 NOTE: the previous
+ * impl used `.map(JSON.parse)` which throws on a malformed line; the
+ * shared helper instead skips silently — matches the lenient posture
+ * used by `permissions_state.readAuditEntries` and prevents one bad
+ * row from breaking `schedule history`.
+ */
+export async function readHistory(path) {
+    return readJsonlEntries(path);
+}
+// ---------------------------------------------------------------------------
+// Status — walk `~/.opensquid/sessions/<id>/scheduling/<scheduleId>.status.json`
+// and pick the most-recent sentinel. The CLI has no active session, so a
+// schedule's "current status" is the union over all sessions that have
+// touched it (SCHED.4 captures per session). Missing → 'probationary'.
+// ---------------------------------------------------------------------------
+export async function readStatusAcrossSessions(sessionsDir, scheduleId) {
+    let sessions;
+    try {
+        sessions = await readdir(sessionsDir);
+    }
+    catch (e) {
+        if (e.code === 'ENOENT')
+            return 'probationary';
+        throw e;
+    }
+    let latestStatus = 'probationary';
+    let latestUpdatedAt = 0;
+    for (const session of sessions) {
+        const dir = scheduleOutcomeDir(session);
+        const statusFile = join(dir, `${scheduleId}.status.json`);
+        let raw;
+        try {
+            raw = await readFile(statusFile, 'utf8');
+        }
+        catch (e) {
+            if (e.code === 'ENOENT')
+                continue;
+            throw e;
+        }
+        try {
+            const parsed = JSON.parse(raw);
+            const updated = parsed.updatedAt ? Date.parse(parsed.updatedAt) : 0;
+            if (Number.isFinite(updated) && updated >= latestUpdatedAt) {
+                if (parsed.status === 'permanent' || parsed.status === 'retired') {
+                    latestStatus = parsed.status;
+                    latestUpdatedAt = updated;
+                }
+                else if (parsed.status === 'probationary' && updated > latestUpdatedAt) {
+                    latestStatus = 'probationary';
+                    latestUpdatedAt = updated;
+                }
+            }
+        }
+        catch {
+            // skip malformed file — don't fail the whole CLI on one bad sentinel
+        }
+    }
+    return latestStatus;
+}
+/** Walk all sessions and return SCHED.4 outcome JSONL entries for one
+ *  schedule. Used by `schedule history`. */
+export async function readOutcomesAcrossSessions(sessionsDir, scheduleId) {
+    let sessions;
+    try {
+        sessions = await readdir(sessionsDir);
+    }
+    catch (e) {
+        if (e.code === 'ENOENT')
+            return [];
+        throw e;
+    }
+    const out = [];
+    for (const session of sessions) {
+        const file = join(scheduleOutcomeDir(session), `${scheduleId}.jsonl`);
+        let s;
+        try {
+            s = await stat(file);
+        }
+        catch {
+            continue;
+        }
+        if (!s.isFile())
+            continue;
+        const raw = await readFile(file, 'utf8');
+        for (const line of raw.split('\n')) {
+            if (line.length === 0)
+                continue;
+            try {
+                out.push(JSON.parse(line));
+            }
+            catch {
+                /* skip malformed line */
+            }
+        }
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// computeNextFire — minute-by-minute walker over a pure 5-field POSIX cron
+// matcher.
+//
+// node-cron does not expose a public `getNext` API and its internal
+// `TimeMatcher` is not part of its public surface. Rather than reach into
+// node-cron internals OR pull in cron-parser, we ship a small pure matcher
+// here. The expression has already been validated upstream by
+// `cron.validate()` (in schedule_registry / schedule_nl) — we trust the
+// shape and parse field-by-field.
+//
+// Bounded to 30 d so a degenerate expression that never matches returns
+// `null` instead of looping forever.
+//
+// Timezone semantics: when `timezone` is provided, we convert the date to
+// that zone's wall-clock fields via `Intl.DateTimeFormat` before matching.
+// Default UTC matches SCHED.1's ScheduleRegistry default.
+// ---------------------------------------------------------------------------
+const MAX_HORIZON_MS = 30 * 24 * 60 * 60 * 1000;
+function expandField(spec, min, max) {
+    const out = new Set();
+    for (const part of spec.split(',')) {
+        const slash = part.split('/');
+        const range = slash[0] ?? '*';
+        const step = slash[1] !== undefined ? Number.parseInt(slash[1], 10) : 1;
+        let lo = min;
+        let hi = max;
+        if (range !== '*') {
+            const hyphen = range.split('-');
+            lo = Number.parseInt(hyphen[0] ?? '0', 10);
+            hi = hyphen[1] !== undefined ? Number.parseInt(hyphen[1], 10) : lo;
+        }
+        if (!Number.isFinite(lo) || !Number.isFinite(hi) || !Number.isFinite(step) || step <= 0) {
+            continue;
+        }
+        for (let v = lo; v <= hi; v += step)
+            out.add(v);
+    }
+    return out;
+}
+function parseCronFields(expr) {
+    const parts = expr.trim().split(/\s+/);
+    if (parts.length !== 5)
+        throw new Error(`computeNextFire: expected 5-field cron, got "${expr}"`);
+    const [m, h, dom, mon, dow] = parts;
+    const dowSet = expandField(dow, 0, 7);
+    // Cron tradition: 7 == Sunday == 0. Normalize.
+    if (dowSet.has(7)) {
+        dowSet.delete(7);
+        dowSet.add(0);
+    }
+    return {
+        minute: expandField(m, 0, 59),
+        hour: expandField(h, 0, 23),
+        dayOfMonth: expandField(dom, 1, 31),
+        month: expandField(mon, 1, 12),
+        dayOfWeek: dowSet,
+    };
+}
+function wallClockFor(date, timezone) {
+    if (timezone === 'UTC') {
+        return {
+            minute: date.getUTCMinutes(),
+            hour: date.getUTCHours(),
+            dayOfMonth: date.getUTCDate(),
+            month: date.getUTCMonth() + 1,
+            dayOfWeek: date.getUTCDay(),
+        };
+    }
+    const dtf = new Intl.DateTimeFormat('en-US', {
+        timeZone: timezone,
+        hourCycle: 'h23',
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        weekday: 'short',
+    });
+    const parts = dtf.formatToParts(date);
+    const get = (t) => parts.find((p) => p.type === t)?.value ?? '';
+    const weekdayMap = {
+        Sun: 0,
+        Mon: 1,
+        Tue: 2,
+        Wed: 3,
+        Thu: 4,
+        Fri: 5,
+        Sat: 6,
+    };
+    return {
+        minute: Number.parseInt(get('minute'), 10),
+        hour: Number.parseInt(get('hour'), 10) % 24,
+        dayOfMonth: Number.parseInt(get('day'), 10),
+        month: Number.parseInt(get('month'), 10),
+        dayOfWeek: weekdayMap[get('weekday')] ?? 0,
+    };
+}
+export function computeNextFire(cronExpr, fromDate, timezone = 'UTC') {
+    const fields = parseCronFields(cronExpr);
+    // Step to the next minute boundary (seconds = 0).
+    const start = new Date(fromDate.getTime());
+    start.setSeconds(0, 0);
+    start.setTime(start.getTime() + 60_000);
+    const deadline = fromDate.getTime() + MAX_HORIZON_MS;
+    for (let t = start.getTime(); t <= deadline; t += 60_000) {
+        const d = new Date(t);
+        const wc = wallClockFor(d, timezone);
+        if (fields.minute.has(wc.minute) &&
+            fields.hour.has(wc.hour) &&
+            fields.dayOfMonth.has(wc.dayOfMonth) &&
+            fields.month.has(wc.month) &&
+            fields.dayOfWeek.has(wc.dayOfWeek)) {
+            return d;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=schedule_state.js.map

package/dist/setup/cli/schedule_state.js.map

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

package/dist/setup/cli/state_io.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Shared state-I/O helpers for the CLI's `*_state.ts` files (T-SIC).
+ *
+ * Four helpers consolidate four patterns previously reimplemented across
+ * webhooks_state, permissions_state, triggers_state, schedule_state
+ * (full inventory + duplication shape in T-state-io-consolidate
+ * pre-research §1 + §2):
+ *
+ *   - writeKeyedYamlList — atomic `mkdir + tmp + writeFile + rename` for
+ *     a YAML file whose root is `{ <key>: [...items] }`. Empty-list
+ *     branch emits the literal `${key}: []\n` (T-SIC L9 — byte-preserves
+ *     the existing on-disk format; `yaml.stringify` emits the same bytes
+ *     without a trailing newline, so we hand-craft to match).
+ *   - readKeyedYamlList — read the same shape with ENOENT default +
+ *     bespoke error label (T-SIC L4) + per-row TypeGuard predicate
+ *     (T-SIC L3, drops invalid rows silently — matches the existing
+ *     posture across all five sites).
+ *   - appendJsonlEntry — `mkdir + appendFile` for JSON-line audit logs.
+ *   - readJsonlEntries — read JSONL with ENOENT default + silent
+ *     malformed-line skip (T-SIC L11 — schedule_state.readHistory's
+ *     previous strict-throw is normalized to silent-skip to match
+ *     permissions_state.readAuditEntries; verified no test relied on
+ *     the throw).
+ *
+ * Imports from: node:fs/promises, node:path, yaml.
+ * Imported by: webhooks_state.ts, permissions_state.ts, triggers_state.ts,
+ *   schedule_state.ts + state_io.test.ts.
+ */
+/**
+ * Atomic keyed-YAML-list write. The body is `{ [key]: [...items] }`
+ * serialized via `yaml.stringify`, OR the literal `${key}: []\n` when
+ * `items` is empty (T-SIC L9 — byte-preserves the existing on-disk
+ * format).
+ *
+ * Atomicity contract: write to `${path}.tmp` first, then `rename` onto
+ * `path`. The `tmp` file lives in the SAME directory so the rename
+ * stays on one filesystem (POSIX atomicity guarantee). Concurrent CLI
+ * invocations are not serialized here — callers MUST pass the FULL
+ * desired list (per the existing JSDoc convention on writeWebhooksFile
+ * et al.).
+ */
+export declare function writeKeyedYamlList<T>(path: string, key: string, items: readonly T[]): Promise<void>;
+/**
+ * Read a YAML mapping with a single list key.
+ *
+ * Returns `defaultValue` (default `[]`) on ENOENT, an empty root mapping,
+ * or a missing key. Throws a `${label}`-prefixed error on malformed YAML,
+ * the root not being a mapping, or the key not being a list. `predicate`
+ * filters per-row to the validated `T` shape; rows that fail the
+ * predicate are dropped silently (matches every existing call site's
+ * posture — drift on a single row mustn't break the whole CLI verb).
+ */
+export declare function readKeyedYamlList<T>(path: string, key: string, label: string, predicate: (v: unknown) => v is T, defaultValue?: T[]): Promise<T[]>;
+/** Append one JSON-encoded entry as a newline-terminated line. `mkdir -p` first. */
+export declare function appendJsonlEntry(path: string, entry: unknown): Promise<void>;
+/**
+ * Read JSONL, skipping malformed lines silently. ENOENT → `[]`.
+ *
+ * T-SIC L11 NOTE: the previous `schedule_state.readHistory` posture was
+ * `.map(line => JSON.parse(line))` which throws on the first malformed
+ * line. This helper instead skips malformed lines (matches the previous
+ * `permissions_state.readAuditEntries` posture). Verified no test relied
+ * on the strict-throw; the user-facing improvement is that a single
+ * corrupted line can't break the whole CLI verb.
+ */
+export declare function readJsonlEntries<T = unknown>(path: string): Promise<T[]>;
+//# sourceMappingURL=state_io.d.ts.map

package/dist/setup/cli/state_io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state_io.d.ts","sourceRoot":"","sources":["../../../src/setup/cli/state_io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAOH;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,SAAS,CAAC,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,IAAI,CAAC,EACjC,YAAY,GAAE,CAAC,EAAO,GACrB,OAAO,CAAC,CAAC,EAAE,CAAC,CA0Bd;AAED,oFAAoF;AACpF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlF;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAkB9E"}

package/dist/setup/cli/state_io.js

@@ -0,0 +1,130 @@
+/**
+ * Shared state-I/O helpers for the CLI's `*_state.ts` files (T-SIC).
+ *
+ * Four helpers consolidate four patterns previously reimplemented across
+ * webhooks_state, permissions_state, triggers_state, schedule_state
+ * (full inventory + duplication shape in T-state-io-consolidate
+ * pre-research §1 + §2):
+ *
+ *   - writeKeyedYamlList — atomic `mkdir + tmp + writeFile + rename` for
+ *     a YAML file whose root is `{ <key>: [...items] }`. Empty-list
+ *     branch emits the literal `${key}: []\n` (T-SIC L9 — byte-preserves
+ *     the existing on-disk format; `yaml.stringify` emits the same bytes
+ *     without a trailing newline, so we hand-craft to match).
+ *   - readKeyedYamlList — read the same shape with ENOENT default +
+ *     bespoke error label (T-SIC L4) + per-row TypeGuard predicate
+ *     (T-SIC L3, drops invalid rows silently — matches the existing
+ *     posture across all five sites).
+ *   - appendJsonlEntry — `mkdir + appendFile` for JSON-line audit logs.
+ *   - readJsonlEntries — read JSONL with ENOENT default + silent
+ *     malformed-line skip (T-SIC L11 — schedule_state.readHistory's
+ *     previous strict-throw is normalized to silent-skip to match
+ *     permissions_state.readAuditEntries; verified no test relied on
+ *     the throw).
+ *
+ * Imports from: node:fs/promises, node:path, yaml.
+ * Imported by: webhooks_state.ts, permissions_state.ts, triggers_state.ts,
+ *   schedule_state.ts + state_io.test.ts.
+ */
+import { appendFile, mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+/**
+ * Atomic keyed-YAML-list write. The body is `{ [key]: [...items] }`
+ * serialized via `yaml.stringify`, OR the literal `${key}: []\n` when
+ * `items` is empty (T-SIC L9 — byte-preserves the existing on-disk
+ * format).
+ *
+ * Atomicity contract: write to `${path}.tmp` first, then `rename` onto
+ * `path`. The `tmp` file lives in the SAME directory so the rename
+ * stays on one filesystem (POSIX atomicity guarantee). Concurrent CLI
+ * invocations are not serialized here — callers MUST pass the FULL
+ * desired list (per the existing JSDoc convention on writeWebhooksFile
+ * et al.).
+ */
+export async function writeKeyedYamlList(path, key, items) {
+    await mkdir(dirname(path), { recursive: true });
+    const body = items.length === 0 ? `${key}: []\n` : stringifyYaml({ [key]: [...items] });
+    const tmp = `${path}.tmp`;
+    await writeFile(tmp, body, 'utf8');
+    await rename(tmp, path);
+}
+/**
+ * Read a YAML mapping with a single list key.
+ *
+ * Returns `defaultValue` (default `[]`) on ENOENT, an empty root mapping,
+ * or a missing key. Throws a `${label}`-prefixed error on malformed YAML,
+ * the root not being a mapping, or the key not being a list. `predicate`
+ * filters per-row to the validated `T` shape; rows that fail the
+ * predicate are dropped silently (matches every existing call site's
+ * posture — drift on a single row mustn't break the whole CLI verb).
+ */
+export async function readKeyedYamlList(path, key, label, predicate, defaultValue = []) {
+    let raw;
+    try {
+        raw = await readFile(path, 'utf8');
+    }
+    catch (e) {
+        if (e.code === 'ENOENT')
+            return defaultValue;
+        throw e;
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (e) {
+        throw new Error(`${label} is malformed (${path}): ${e instanceof Error ? e.message : String(e)}`);
+    }
+    if (parsed === null || parsed === undefined)
+        return defaultValue;
+    if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`${label} must be a mapping (${path})`);
+    }
+    const list = parsed[key];
+    if (list === undefined)
+        return defaultValue;
+    if (!Array.isArray(list)) {
+        throw new Error(`${label}: \`${key}\` must be a list (${path})`);
+    }
+    return list.filter(predicate);
+}
+/** Append one JSON-encoded entry as a newline-terminated line. `mkdir -p` first. */
+export async function appendJsonlEntry(path, entry) {
+    await mkdir(dirname(path), { recursive: true });
+    await appendFile(path, JSON.stringify(entry) + '\n', 'utf8');
+}
+/**
+ * Read JSONL, skipping malformed lines silently. ENOENT → `[]`.
+ *
+ * T-SIC L11 NOTE: the previous `schedule_state.readHistory` posture was
+ * `.map(line => JSON.parse(line))` which throws on the first malformed
+ * line. This helper instead skips malformed lines (matches the previous
+ * `permissions_state.readAuditEntries` posture). Verified no test relied
+ * on the strict-throw; the user-facing improvement is that a single
+ * corrupted line can't break the whole CLI verb.
+ */
+export async function readJsonlEntries(path) {
+    let raw;
+    try {
+        raw = await readFile(path, 'utf8');
+    }
+    catch (e) {
+        if (e.code === 'ENOENT')
+            return [];
+        throw e;
+    }
+    const out = [];
+    for (const line of raw.split('\n')) {
+        if (line.length === 0)
+            continue;
+        try {
+            out.push(JSON.parse(line));
+        }
+        catch {
+            /* skip malformed line — don't fail the whole CLI verb on one bad row */
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=state_io.js.map

package/dist/setup/cli/state_io.js.map

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

package/dist/setup/cli/topic_create_step.d.ts

@@ -0,0 +1,84 @@
+/**
+ * TPS.4 — first-run topic-create step for the chat-setup wizard.
+ *
+ * Slots between WIZ.3 (executePlan: writes models.yaml + chat_agent.yaml)
+ * and WIZ.4 (runChannelTestStep). When the user has a Telegram supergroup
+ * configured, offers to auto-create a forum topic for the current
+ * workspace + bind it via TPS.3's `resolveOrCreateTopic`. Opt-out (default
+ * = yes). On accept, the workspace's per-project `chat-routing.json` gets
+ * an `auto_bound` block + the new topic_id added to `inbound_topic_ids`,
+ * so the next WIZ.4 test (and subsequent agent traffic) lands in the
+ * freshly-bound topic.
+ *
+ * Why not import `resolveOrCreateTopic` statically: `src.legacy/` is
+ * excluded from `tsconfig.json`. The whole-tree typecheck can't see legacy
+ * exports, and `tsconfig.build.json` doesn't emit them either. We load
+ * the legacy module at runtime via a path computed from `import.meta.url`
+ * — the runtime location is `dist/chat/daemon/workspace-topic.js` (built
+ * by the ad-hoc `pnpm exec tsc src.legacy/...` invocation documented in
+ * `src.legacy/chat/adapters/telegram.ts`). Tests inject a fake
+ * `resolveOrCreateTopic` via the `deps` interface and bypass the loader.
+ *
+ * Never throws past the wizard — mirrors WIZ.4's contract. Every failure
+ * prints a recovery hint via `note()` and returns. The WIZ.3 writes are
+ * already on disk by the time this step runs; failure here leaves the
+ * user with a working config minus the auto-binding.
+ */
+import type { ChatDaemonState } from './chat_state.js';
+export interface ResolveTopicArgs {
+    workspaceUuid: string;
+    workspacePath: string;
+    chatId: string;
+    mode: 'wizard' | 'auto-boot' | 'manual';
+    dataRoot?: string;
+}
+export interface ResolveTopicResult {
+    topicId: number;
+    topicName: string;
+    created: boolean;
+}
+export type ResolveOrCreateTopicFn = (args: ResolveTopicArgs) => Promise<ResolveTopicResult>;
+export interface TopicCreateDeps {
+    /** WIZ.2 daemon snapshot — same source the WIZ.4 sibling uses. */
+    daemonState: ChatDaemonState;
+    /** Cwd-walk start (test injection). Defaults to process.cwd(). */
+    cwd?: string;
+    /** Env override sink (test injection). Defaults to process.env. */
+    env?: NodeJS.ProcessEnv;
+    /**
+     * Override the topic-resolver (test injection). Defaults to the
+     * runtime-loaded `resolveOrCreateTopic` from `dist/chat/daemon/
+     * workspace-topic.js`. Tests substitute a stub here to avoid both the
+     * dist dependency and the daemon RPC round-trip.
+     */
+    resolveOrCreateTopic?: ResolveOrCreateTopicFn;
+    /**
+     * Override the routing-read function (test injection). Defaults to
+     * reading `~/.opensquid/projects/<uuid>/chat-routing.json`.
+     */
+    loadRouting?: (uuid: string) => Promise<ProjectChatRouting | null>;
+}
+export interface ProjectChatRouting {
+    telegram?: {
+        report_channel?: string;
+        report_topic_id?: number;
+        inbound_chat_ids?: string[];
+        inbound_topic_ids?: number[];
+        auto_bound?: {
+            workspace_path: string;
+            workspace_uuid: string;
+            topic_id: number;
+            topic_name: string;
+            created_at: string;
+            created_by: string;
+        };
+    };
+    discord?: {
+        report_channel?: string;
+    };
+    slack?: {
+        report_channel?: string;
+    };
+}
+export declare function runTopicCreateStep(deps: TopicCreateDeps): Promise<void>;
+//# sourceMappingURL=topic_create_step.d.ts.map

package/dist/setup/cli/topic_create_step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic_create_step.d.ts","sourceRoot":"","sources":["../../../src/setup/cli/topic_create_step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAWH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMvD,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAE7F,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,WAAW,EAAE,eAAe,CAAC;IAC7B,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,sBAAsB,CAAC;IAC9C;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE;QACT,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC7B,UAAU,CAAC,EAAE;YACX,cAAc,EAAE,MAAM,CAAC;YACvB,cAAc,EAAE,MAAM,CAAC;YACvB,QAAQ,EAAE,MAAM,CAAC;YACjB,UAAU,EAAE,MAAM,CAAC;YACnB,UAAU,EAAE,MAAM,CAAC;YACnB,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;IACF,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,KAAK,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrC;AAMD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAwE7E"}