opensquid 0.5.441 → 0.5.447

package/dist/runtime/hooks/permission_decision.js

@@ -1,39 +0,0 @@
-/**
- * PreToolUse permission-decision envelope (T-RJ-FOLLOWUPS FU.11).
- *
- * A PreToolUse hook signals a block in one of two ways:
- *   - `exit 2` — the simple path, BUT `--dangerously-skip-permissions`
- *     (= `bypassPermissions` mode) silently IGNORES it (proven live: a
- *     `git commit` the gate should block ran anyway).
- *   - a `permissionDecision: "deny"` JSON envelope on stdout (exit 0) — HONORED
- *     even under `bypassPermissions` (proven live: the call was denied).
- *
- * So opensquid emits the JSON envelope on every block, making drift gates
- * enforce in BOTH normal and bypass permission modes. Pure builder so the shape
- * is unit-testable without spawning the hook bin.
- */
-/**
- * Every drift/block message opensquid emits to the user carries a leading 🦑 so
- * it's unmistakably opensquid speaking — NOT the agent's own prose, NOT a chat
- * message (chat replies via chat_send are deliberately unprefixed). Added HERE at
- * the hook EMIT boundary (not in the dispatcher/verdict layer) so skill YAML
- * `message:` fields stay clean and the dispatch internals stay emoji-free.
- * Idempotent; empty string passes through untouched (nothing to surface).
- */
-export const SQUID = '🦑';
-export function squidPrefix(message) {
-    if (message.length === 0)
-        return message;
-    return message.trimStart().startsWith(SQUID) ? message : `${SQUID} ${message}`;
-}
-/** Build the deny envelope; falls back to a generic reason when none is given. */
-export function buildPreToolUseDeny(reason) {
-    return {
-        hookSpecificOutput: {
-            hookEventName: 'PreToolUse',
-            permissionDecision: 'deny',
-            permissionDecisionReason: squidPrefix(reason.length > 0 ? reason : 'opensquid: blocked by a drift gate'),
-        },
-    };
-}
-//# sourceMappingURL=permission_decision.js.map

package/dist/runtime/hooks/permission_decision.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"permission_decision.js","sourceRoot":"","sources":["../../../src/runtime/hooks/permission_decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC;AAC1B,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,OAAO,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,OAAO,EAAE,CAAC;AACjF,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAO;QACL,kBAAkB,EAAE;YAClB,aAAa,EAAE,YAAY;YAC3B,kBAAkB,EAAE,MAAM;YAC1B,wBAAwB,EAAE,WAAW,CACnC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,oCAAoC,CAClE;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime/workflow_fsm.d.ts

@@ -1,21 +0,0 @@
-/**
- * T-PACK-FSM-STANDARDIZATION slice A — the 7-phase workflow as a declared FSM.
- *
- * This models `chain_state.ts`'s pipeline (the same 7 stages, same forward
- * order) as data the generic `fsm.ts` engine runs — the preset slice A2 will
- * wire in to REPLACE the hardcoded `transitionChainStage` + its 5 scattered
- * call-sites. Two things it gains over `chain_state` immediately:
- *
- *   1. TOTALITY — `validateFsm` proves every transition lands on a real state;
- *      the runner defines an outcome for every (state, event). `chain_state`'s
- *      `transitionChainStage` accepts ANY target with no legality check.
- *   2. LOOP-BACK — `researched --guess_found--> scoping` is an explicit edge.
- *      `chain_state` is forward-only (its `idle→scoping` writer even guards
- *      AGAINST regression), so it structurally cannot re-enter research when an
- *      unresolved guess is found. That backward edge is exactly what the scope
- *      guess-prevention gate (slice C) loops on.
- */
-import type { Fsm } from './fsm.js';
-/** Stage order matches `chain_state.ts` CHAIN_STAGES (parity-tested). */
-export declare const WORKFLOW_FSM: Fsm;
-//# sourceMappingURL=workflow_fsm.d.ts.map

package/dist/runtime/workflow_fsm.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow_fsm.d.ts","sourceRoot":"","sources":["../../src/runtime/workflow_fsm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,yEAAyE;AACzE,eAAO,MAAM,YAAY,EAAE,GAsB1B,CAAC"}

package/dist/runtime/workflow_fsm.js

@@ -1,25 +0,0 @@
-/** Stage order matches `chain_state.ts` CHAIN_STAGES (parity-tested). */
-export const WORKFLOW_FSM = {
-    initial: 'idle',
-    states: [
-        'idle',
-        'scoping',
-        'researched',
-        'spec_authored',
-        'tasks_loaded',
-        'phases_in_flight',
-        'phases_complete',
-    ],
-    transitions: [
-        { from: 'idle', on: 'scope_start', to: 'scoping' },
-        { from: 'scoping', on: 'research_done', to: 'researched' },
-        // The loop-back chain_state cannot express: an unresolved guess sends the
-        // workflow back to scoping/research (slice C drives this edge).
-        { from: 'researched', on: 'guess_found', to: 'scoping' },
-        { from: 'researched', on: 'spec_authored', to: 'spec_authored' },
-        { from: 'spec_authored', on: 'tasks_loaded', to: 'tasks_loaded' },
-        { from: 'tasks_loaded', on: 'phase_started', to: 'phases_in_flight' },
-        { from: 'phases_in_flight', on: 'phases_done', to: 'phases_complete' },
-    ],
-};
-//# sourceMappingURL=workflow_fsm.js.map

package/dist/runtime/workflow_fsm.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow_fsm.js","sourceRoot":"","sources":["../../src/runtime/workflow_fsm.ts"],"names":[],"mappings":"AAmBA,yEAAyE;AACzE,MAAM,CAAC,MAAM,YAAY,GAAQ;IAC/B,OAAO,EAAE,MAAM;IACf,MAAM,EAAE;QACN,MAAM;QACN,SAAS;QACT,YAAY;QACZ,eAAe;QACf,cAAc;QACd,kBAAkB;QAClB,iBAAiB;KAClB;IACD,WAAW,EAAE;QACX,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE;QAClD,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,YAAY,EAAE;QAC1D,0EAA0E;QAC1E,gEAAgE;QAChE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE;QACxD,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,eAAe,EAAE;QAChE,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,EAAE;QACjE,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,kBAAkB,EAAE;QACrE,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,iBAAiB,EAAE;KACvE;CACF,CAAC"}

package/dist/runtime/workflow_map.d.ts

@@ -1,26 +0,0 @@
-/**
- * Workflow forward-map (T-FLOW-COHESION FC.2) — the SINGLE source of "given the
- * current chain-stage, what is the next step." When a gate blocks, the hook
- * folds this map into the deny message so the agent is pointed FORWARD at the
- * wall (current stage + next step) instead of bouncing backward through
- * prerequisites. Reads the chain-state FSM, which FC.1 made atomic/trustworthy,
- * so no degradation branch is needed — `idle` is a real, correct stage.
- *
- * `STAGE_NEXT` is the canonical stage→next-step text. The `chain-handoffs` skill
- * (prompt_submit reinforcement) describes the same pipeline; this is the
- * authoritative source — keep that skill's rationale consistent with it.
- *
- * Imports from: ./chain_state.js.
- * Imported by: src/runtime/hooks/pre-tool-use.ts (block path).
- */
-import { type ChainStage } from './chain_state.js';
-/** Canonical next step for each pipeline stage. Exhaustive over `ChainStage`
- *  (the compiler enforces every stage has an entry). */
-export declare const STAGE_NEXT: Record<ChainStage, string>;
-/**
- * The compact forward map for a session's current stage: the path, where you
- * are, and the single next step. Fail-open: a read error resolves to `idle`
- * (the correct fresh-session stage), never throws.
- */
-export declare function forwardMap(sessionId: string): Promise<string>;
-//# sourceMappingURL=workflow_map.d.ts.map

package/dist/runtime/workflow_map.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow_map.d.ts","sourceRoot":"","sources":["../../src/runtime/workflow_map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAEnE;wDACwD;AACxD,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CASjD,CAAC;AAIF;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGnE"}

package/dist/runtime/workflow_map.js

@@ -1,38 +0,0 @@
-/**
- * Workflow forward-map (T-FLOW-COHESION FC.2) — the SINGLE source of "given the
- * current chain-stage, what is the next step." When a gate blocks, the hook
- * folds this map into the deny message so the agent is pointed FORWARD at the
- * wall (current stage + next step) instead of bouncing backward through
- * prerequisites. Reads the chain-state FSM, which FC.1 made atomic/trustworthy,
- * so no degradation branch is needed — `idle` is a real, correct stage.
- *
- * `STAGE_NEXT` is the canonical stage→next-step text. The `chain-handoffs` skill
- * (prompt_submit reinforcement) describes the same pipeline; this is the
- * authoritative source — keep that skill's rationale consistent with it.
- *
- * Imports from: ./chain_state.js.
- * Imported by: src/runtime/hooks/pre-tool-use.ts (block path).
- */
-import { readChainState } from './chain_state.js';
-/** Canonical next step for each pipeline stage. Exhaustive over `ChainStage`
- *  (the compiler enforces every stage has an entry). */
-export const STAGE_NEXT = {
-    idle: 'no active scope — scope it first: write the pre-research doc (docs/research/<slug>-pre-research-*.md)',
-    scoping: 'write the pre-research doc (docs/research/<slug>-pre-research-*.md)',
-    researched: 'author the track spec via the task-spec-author profession (consume the pre-research)',
-    spec_authored: 'TaskCreate each "### Task" with metadata.spec = the spec\'s absolute path',
-    tasks_loaded: 'set the task in_progress, then log_phase through the 7 phases as you work',
-    phases_in_flight: 'resume at the next unlogged phase; log_phase as each of the 7 completes',
-    phases_complete: 'workflow complete for the active task — the terminal action is allowed',
-};
-const PATH_LINE = 'Workflow: pre_research → spec → tasks → 7 phases → commit';
-/**
- * The compact forward map for a session's current stage: the path, where you
- * are, and the single next step. Fail-open: a read error resolves to `idle`
- * (the correct fresh-session stage), never throws.
- */
-export async function forwardMap(sessionId) {
-    const stage = (await readChainState(sessionId).catch(() => null))?.stage ?? 'idle';
-    return `${PATH_LINE}\nYou are at: ${stage}\nNext: ${STAGE_NEXT[stage]}`;
-}
-//# sourceMappingURL=workflow_map.js.map

package/dist/runtime/workflow_map.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow_map.js","sourceRoot":"","sources":["../../src/runtime/workflow_map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAmB,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEnE;wDACwD;AACxD,MAAM,CAAC,MAAM,UAAU,GAA+B;IACpD,IAAI,EAAE,uGAAuG;IAC7G,OAAO,EAAE,qEAAqE;IAC9E,UAAU,EACR,sFAAsF;IACxF,aAAa,EAAE,2EAA2E;IAC1F,YAAY,EAAE,2EAA2E;IACzF,gBAAgB,EAAE,yEAAyE;IAC3F,eAAe,EAAE,wEAAwE;CAC1F,CAAC;AAEF,MAAM,SAAS,GAAG,2DAA2D,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB;IAChD,MAAM,KAAK,GAAe,CAAC,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI,MAAM,CAAC;IAC/F,OAAO,GAAG,SAAS,iBAAiB,KAAK,WAAW,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;AAC1E,CAAC"}

package/dist/scope.d.ts

@@ -1,48 +0,0 @@
-import type { MemoryScope } from "./engine-client.js";
-export interface DetectedProject {
-    project: string;
-}
-/**
- * Sync detection (v0.3.1 surface). Does NOT consult the project ID
- * card. Use the async variant for v0.4+ behavior.
- */
-export declare function detectProjectScope(cwd?: string): DetectedProject | null;
-/**
- * v0.4: async detection that consults the project ID card first.
- *
- * Order:
- *   1. OPENSQUID_PROJECT env → wins
- *   2. .opensquid/project.json card (any ancestor of cwd) → stable id
- *   3. git basename → fallback
- *   4. null
- */
-export declare function detectProjectScopeAsync(cwd?: string): Promise<DetectedProject | null>;
-/**
- * Sync default-memorize-scope (v0.3.1 surface).
- */
-export declare function defaultMemorizeScope(cwd?: string): MemoryScope;
-/**
- * v0.4: async default-memorize-scope that consults the project ID
- * card. Also AUTO-CREATES the card on first call in a new project
- * (so the second call onward gets a stable id even if the user
- * renames the directory). Pass `autoCreate: false` to skip creation.
- */
-export declare function defaultMemorizeScopeAsync(cwd?: string, options?: {
-    autoCreate?: boolean;
-}): Promise<MemoryScope>;
-/**
- * Sync default-recall-scope-filter (v0.3.1 surface).
- */
-export declare function defaultRecallScopeFilter(cwd?: string): {
-    kind: "any_of";
-    scopes: MemoryScope[];
-};
-/**
- * v0.4: async default-recall-scope-filter that consults the project
- * ID card. Does NOT auto-create a card — recall is read-only.
- */
-export declare function defaultRecallScopeFilterAsync(cwd?: string): Promise<{
-    kind: "any_of";
-    scopes: MemoryScope[];
-}>;
-//# sourceMappingURL=scope.d.ts.map

package/dist/scope.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src.legacy/scope.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAsB,GAAG,eAAe,GAAG,IAAI,CAetF;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAQjC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAG9D;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,GAAE,MAAsB,EAC3B,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GACrC,OAAO,CAAC,WAAW,CAAC,CAiBtB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG;IACtD,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAKA;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,CAKpD"}

package/dist/scope.js

@@ -1,111 +0,0 @@
-/**
- * Project-scope auto-detection for memorize/recall defaults.
- *
- * Priority order (v0.4+ with project ID card):
- *  1. `OPENSQUID_PROJECT` env var — explicit override, always wins.
- *  2. **Project ID card** at `.opensquid/project.json` (walking up from
- *     cwd) — stable across moves/renames. v0.4 addition.
- *  3. `git rev-parse --show-toplevel` basename — fallback for projects
- *     that don't have a card yet (auto-created on first memorize).
- *  4. `null` — caller falls back to `MemoryScope::User`.
- *
- * The sync helpers below keep the v0.3 wire surface; the async
- * variants consult the ID card and are preferred for new call sites.
- */
-import { execSync } from "node:child_process";
-import * as path from "node:path";
-import { applyResolution, findProjectCard, resolveProject } from "./project.js";
-/**
- * Sync detection (v0.3.1 surface). Does NOT consult the project ID
- * card. Use the async variant for v0.4+ behavior.
- */
-export function detectProjectScope(cwd = process.cwd()) {
-    const explicit = process.env.OPENSQUID_PROJECT?.trim();
-    if (explicit)
-        return { project: explicit };
-    try {
-        const root = execSync("git rev-parse --show-toplevel", {
-            cwd,
-            encoding: "utf8",
-            stdio: ["ignore", "pipe", "ignore"],
-        }).trim();
-        if (root)
-            return { project: path.basename(root) };
-    }
-    catch {
-        // Not a git repo, or git not installed — fall through.
-    }
-    return null;
-}
-/**
- * v0.4: async detection that consults the project ID card first.
- *
- * Order:
- *   1. OPENSQUID_PROJECT env → wins
- *   2. .opensquid/project.json card (any ancestor of cwd) → stable id
- *   3. git basename → fallback
- *   4. null
- */
-export async function detectProjectScopeAsync(cwd = process.cwd()) {
-    const explicit = process.env.OPENSQUID_PROJECT?.trim();
-    if (explicit)
-        return { project: explicit };
-    const card = await findProjectCard(cwd);
-    if (card)
-        return { project: card.card.id };
-    return detectProjectScope(cwd);
-}
-/**
- * Sync default-memorize-scope (v0.3.1 surface).
- */
-export function defaultMemorizeScope(cwd) {
-    const detected = detectProjectScope(cwd);
-    return detected ? { project: detected.project } : "user";
-}
-/**
- * v0.4: async default-memorize-scope that consults the project ID
- * card. Also AUTO-CREATES the card on first call in a new project
- * (so the second call onward gets a stable id even if the user
- * renames the directory). Pass `autoCreate: false` to skip creation.
- */
-export async function defaultMemorizeScopeAsync(cwd = process.cwd(), options = {}) {
-    const explicit = process.env.OPENSQUID_PROJECT?.trim();
-    if (explicit)
-        return { project: explicit };
-    const card = await findProjectCard(cwd);
-    if (card)
-        return { project: card.card.id };
-    // No card yet — auto-create if allowed, otherwise fall through to
-    // sync detection (returns git basename or "user").
-    if (options.autoCreate !== false) {
-        const resolved = await resolveProject(cwd);
-        if (resolved.kind === "new") {
-            const created = await applyResolution(cwd, resolved, { autoCreate: true });
-            if (created)
-                return { project: created.id };
-        }
-    }
-    return defaultMemorizeScope(cwd);
-}
-/**
- * Sync default-recall-scope-filter (v0.3.1 surface).
- */
-export function defaultRecallScopeFilter(cwd) {
-    const detected = detectProjectScope(cwd);
-    const scopes = ["user"];
-    if (detected)
-        scopes.push({ project: detected.project });
-    return { kind: "any_of", scopes };
-}
-/**
- * v0.4: async default-recall-scope-filter that consults the project
- * ID card. Does NOT auto-create a card — recall is read-only.
- */
-export async function defaultRecallScopeFilterAsync(cwd = process.cwd()) {
-    const detected = await detectProjectScopeAsync(cwd);
-    const scopes = ["user"];
-    if (detected)
-        scopes.push({ project: detected.project });
-    return { kind: "any_of", scopes };
-}
-//# sourceMappingURL=scope.js.map

package/dist/scope.js.map

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

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

@@ -1,84 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}

package/dist/setup/cli/topic_create_step.js

@@ -1,213 +0,0 @@
-/**
- * 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 { readFile } from 'node:fs/promises';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-import { confirm, isCancel, note, spinner } from '@clack/prompts';
-import pc from 'picocolors';
-import { OPENSQUID_HOME, resolveProjectUuid } from '../../runtime/paths.js';
-// ---------------------------------------------------------------------------
-// runTopicCreateStep — TPS.4 entry point. Returns void; never throws.
-// ---------------------------------------------------------------------------
-export async function runTopicCreateStep(deps) {
-    const env = deps.env ?? process.env;
-    if (env.OPENSQUID_NO_BILLED_CALLS === '1') {
-        note('Topic-create skipped (OPENSQUID_NO_BILLED_CALLS=1).', 'Topic');
-        return;
-    }
-    // Pre-flight: daemon liveness (same snapshot WIZ.4 uses).
-    if (!deps.daemonState.running) {
-        note(daemonNotRunningHint(deps.daemonState.pidPath), 'Topic');
-        return;
-    }
-    const workspaceUuid = await resolveProjectUuid({
-        cwd: deps.cwd ?? process.cwd(),
-        env,
-    });
-    if (workspaceUuid === null) {
-        note(noProjectUuidHint(), 'Topic');
-        return;
-    }
-    const loadRouting = deps.loadRouting ?? loadProjectChatRouting;
-    const routing = await loadRouting(workspaceUuid);
-    const chatId = routing?.telegram?.report_channel;
-    if (chatId === undefined || chatId.length === 0) {
-        note(noSupergroupHint(), 'Topic');
-        return;
-    }
-    const proceed = await confirm({
-        message: 'Create a Telegram forum topic for this workspace so its messages are isolated from other projects?',
-        initialValue: true,
-    });
-    if (isCancel(proceed) || proceed !== true) {
-        note('Topic-create skipped — workspace messages will land in the supergroup general topic.', 'Topic');
-        return;
-    }
-    const workspacePath = deps.cwd ?? process.cwd();
-    const resolver = deps.resolveOrCreateTopic ?? (await loadLegacyResolver());
-    const s = spinner();
-    s.start('Creating topic (or reusing existing binding)...');
-    try {
-        const result = await resolver({
-            workspaceUuid,
-            workspacePath: resolve(workspacePath),
-            chatId,
-            mode: 'wizard',
-        });
-        if (result.created) {
-            s.stop(pc.green(`Created topic "${result.topicName}" (thread_id=${String(result.topicId)}). Bound to this workspace.`));
-        }
-        else {
-            s.stop(pc.green(`Existing topic "${result.topicName}" (thread_id=${String(result.topicId)}) reused. Workspace already bound.`));
-        }
-    }
-    catch (err) {
-        s.stop(pc.red(`Topic-create failed: ${describeError(err)}`));
-        note(recoveryHintFor(err), 'Topic');
-    }
-}
-// ---------------------------------------------------------------------------
-// Default routing reader — duplicates WIZ.4's inlined reader. Same
-// type-poison avoidance rationale documented in chat_actions_test_step.ts.
-// ---------------------------------------------------------------------------
-async function loadProjectChatRouting(uuid) {
-    const p = join(OPENSQUID_HOME(), 'projects', uuid, 'chat-routing.json');
-    try {
-        const raw = await readFile(p, 'utf8');
-        return JSON.parse(raw);
-    }
-    catch (err) {
-        if (err.code === 'ENOENT')
-            return null;
-        return null;
-    }
-}
-// ---------------------------------------------------------------------------
-// Lazy legacy-resolver loader — resolves at first call so tests that
-// inject `deps.resolveOrCreateTopic` never trigger the dist read. Path
-// is constructed from `import.meta.url` (runtime location) rather than
-// a static import string so the tsconfig src.legacy exclude is honored.
-// ---------------------------------------------------------------------------
-async function loadLegacyResolver() {
-    const here = dirname(fileURLToPath(import.meta.url));
-    // Runtime: this file is at dist/setup/cli/topic_create_step.js;
-    // workspace-topic.js lives at dist/chat/daemon/workspace-topic.js.
-    const target = resolve(here, '..', '..', 'chat', 'daemon', 'workspace-topic.js');
-    const mod = (await import(pathToFileURL(target).href));
-    if (typeof mod.resolveOrCreateTopic !== 'function') {
-        throw new Error(`legacy workspace-topic module at ${target} did not export resolveOrCreateTopic — rebuild dist/chat/daemon/* per the src.legacy header instructions`);
-    }
-    return mod.resolveOrCreateTopic;
-}
-// ---------------------------------------------------------------------------
-// Error classification — maps known TPS.3 failure modes to user-actionable
-// recovery hints. Catch-all returns a generic "see daemon logs" hint.
-// Detection is message-substring based (Telegram + grammy error messages
-// pass through resolveOrCreateTopic unchanged).
-// ---------------------------------------------------------------------------
-function describeError(err) {
-    if (err instanceof Error)
-        return err.message;
-    return String(err);
-}
-function recoveryHintFor(err) {
-    const msg = describeError(err);
-    const lower = msg.toLowerCase();
-    // 403 — bot lacks can_manage_topics. Telegram returns "Bad Request:
-    // CHAT_ADMIN_REQUIRED" or "Forbidden: ...".
-    if (lower.includes('chat_admin_required') ||
-        lower.includes('can_manage_topics') ||
-        msg.includes('403') ||
-        lower.includes('forbidden')) {
-        return [
-            "The bot needs the 'Manage Topics' admin permission on this supergroup.",
-            'In Telegram: open the group → Edit → Administrators → your bot → enable Manage Topics.',
-            'Then re-run `opensquid setup chat` and accept the topic-create step.',
-        ].join('\n');
-    }
-    // 429 — rate-limited.
-    if (msg.includes('429') || lower.includes('too many requests') || lower.includes('retry after')) {
-        return [
-            'Telegram is rate-limiting topic creation for this bot.',
-            'Wait a minute, then re-run `opensquid setup chat` and accept the topic-create step.',
-        ].join('\n');
-    }
-    // 400 — forum topics disabled on the supergroup.
-    if ((msg.includes('400') && (lower.includes('topic') || lower.includes('forum'))) ||
-        lower.includes('topics_disabled') ||
-        lower.includes('not a forum')) {
-        return [
-            'Forum topics are not enabled on this supergroup.',
-            'In Telegram: open the group → Edit → Topics → enable Topics.',
-            'Then re-run `opensquid setup chat` and accept the topic-create step.',
-        ].join('\n');
-    }
-    // Lockfile LOCKED — another opensquid process is binding.
-    if (lower.includes('elocked') || lower.includes('lock')) {
-        return [
-            'Another opensquid process is binding a topic for this workspace right now.',
-            'Wait a few seconds and re-run `opensquid setup chat`.',
-        ].join('\n');
-    }
-    // Persist failed AFTER createTopic — orphan recorded.
-    if (lower.includes('orphan') || (lower.includes('persist') && lower.includes('fail'))) {
-        return [
-            'A topic was created on Telegram but the local binding write failed.',
-            'The orphan was logged to ~/.opensquid/orphan-topics.jsonl for manual cleanup.',
-            'Re-run `opensquid setup chat` after fixing the disk / permissions issue.',
-        ].join('\n');
-    }
-    return [
-        'See `~/.opensquid/chat-daemon.log` for daemon-side detail.',
-        'Re-run `opensquid setup chat` to retry the topic-create step.',
-    ].join('\n');
-}
-// ---------------------------------------------------------------------------
-// Static-text hints (same shape as WIZ.4 sibling)
-// ---------------------------------------------------------------------------
-function daemonNotRunningHint(pidPath) {
-    return [
-        `The chat-daemon is not running (pidfile: ${pidPath}).`,
-        'Start it with:',
-        '  opensquid chat-daemon start',
-        'then re-run `opensquid setup chat` and accept the topic-create step.',
-    ].join('\n');
-}
-function noProjectUuidHint() {
-    return [
-        'Could not resolve the active project UUID.',
-        'Run `opensquid init` in this directory, or set OPENSQUID_PROJECT_UUID.',
-    ].join('\n');
-}
-function noSupergroupHint() {
-    return [
-        'No Telegram supergroup is configured for this workspace.',
-        'Set `report_channel` in ~/.opensquid/projects/<uuid>/chat-routing.json,',
-        'then re-run `opensquid setup chat` to bind a workspace topic.',
-    ].join('\n');
-}
-//# sourceMappingURL=topic_create_step.js.map