@ngocsangairvds/vsaf 3.2.16 → 4.0.0

package/tools/vds-scripts/telegram_bridge/tests/spikes/test_0_10_acp_schema_drift.py

@@ -1,259 +0,0 @@
-"""TSK-0.10 — ACP schema-drift watch (CI-loadbearing).
-
-Spec acceptance (round-6 — THREE conditions):
-  (a) Installed agent-client-protocol SDK schema version matches the SDK
-      release pinned in pyproject.toml.
-  (b) PROTOCOL_VERSION constant has the expected value reported by the SDK.
-  (c) The SDK's schema $defs include the eight expected ACP wire-event names
-      (agent_message_chunk, tool_call, tool_call_update, agent_thought_chunk,
-      plan, available_commands_update, current_mode_update, session_info_update)
-      but NOT `usage_update` (round-6 confirmed: usage_update is daemon-
-      synthesised and does NOT exist on the wire).
-
-Drift detected → CI fails with an explicit directive to update
-references/wave-0-spike-results.md.
-
-Per round-5/round-6 findings (SDK issue #91), schema 0.11.2 lags upstream
-protocol 0.12.2 by 2 minor versions; the v0.12.x adds 6 new $defs
-(CloseSession/ResumeSession request/response/capabilities). Pinned SDK stays
->=0.9.0,<0.10 until re-audit.
-
-This test is OFFLINE-runnable — it inspects the installed package metadata and
-schema in-process; no live infrastructure required. It skips cleanly when the
-package is not installed.
-"""
-
-from __future__ import annotations
-
-import importlib.metadata
-import re
-from pathlib import Path
-
-import pytest
-
-# ---------------------------------------------------------------------------
-# Expected constants (update after each SDK upgrade + spec re-audit)
-# ---------------------------------------------------------------------------
-
-# The pip version specifier pinned in telegram_bridge/pyproject.toml.
-# Update this floor/ceiling whenever the spec re-audits the SDK.
-_PINNED_FLOOR = (0, 9, 0)
-_PINNED_CEILING = (0, 10, 0)  # exclusive
-
-# Wire-level event names that MUST appear in the schema $defs.
-_REQUIRED_WIRE_EVENTS: frozenset[str] = frozenset(
-    {
-        "agent_message_chunk",
-        "tool_call",
-        "tool_call_update",
-        "agent_thought_chunk",
-        "plan",
-        "available_commands_update",
-        "current_mode_update",
-        "session_info_update",
-    }
-)
-
-# Wire-level event names that must NOT appear (daemon-synthesised only).
-_FORBIDDEN_WIRE_EVENTS: frozenset[str] = frozenset({"usage_update"})
-
-# ---------------------------------------------------------------------------
-# Helpers
-# ---------------------------------------------------------------------------
-
-
-def _parse_version(version_str: str) -> tuple[int, ...]:
-    """Parse 'X.Y.Z' into (X, Y, Z). Pre-release suffixes are ignored."""
-    match = re.match(r"(\d+)\.(\d+)\.(\d+)", version_str)
-    if not match:
-        raise ValueError(f"Cannot parse version: {version_str!r}")
-    return tuple(int(g) for g in match.groups())
-
-
-def _get_acp_schema_defs() -> set[str]:
-    """Return the set of $defs keys from the SDK's wire schema.
-
-    Tries several strategies in order:
-      1. acp.schema.get_schema() -> dict with "$defs"
-      2. acp.get_schema() -> dict with "$defs"
-      3. Inspect the top-level module for a dict named SCHEMA or _SCHEMA.
-      4. Scan model classes exported from the package for __name__ that looks
-         like a wire-event (snake_case) or find a JSON schema file in the dist.
-    """
-    import acp  # type: ignore[import-not-found]
-
-    # Strategy 1: schema submodule with get_schema()
-    try:
-        import acp.schema as _schema_mod  # type: ignore[import-not-found]
-
-        schema = _schema_mod.get_schema()
-        return set(schema.get("$defs", {}).keys())
-    except (ImportError, AttributeError):
-        pass
-
-    # Strategy 2: top-level get_schema()
-    try:
-        schema = acp.get_schema()  # type: ignore[attr-defined]
-        return set(schema.get("$defs", {}).keys())
-    except AttributeError:
-        pass
-
-    # Strategy 3: module-level SCHEMA dict
-    for attr_name in ("SCHEMA", "_SCHEMA", "WIRE_SCHEMA"):
-        schema = getattr(acp, attr_name, None)
-        if isinstance(schema, dict) and "$defs" in schema:
-            return set(schema["$defs"].keys())
-
-    # Strategy 4: look for a bundled JSON schema in dist-info
-    try:
-        dist = importlib.metadata.distribution("agent-client-protocol")
-        for f in dist.files or []:
-            if f.name.endswith(".json") and "schema" in f.name.lower():
-                import json
-
-                text = Path(str(dist.locate_file(f))).read_text()
-                schema = json.loads(text)
-                defs = schema.get("$defs", schema.get("definitions", {}))
-                if defs:
-                    return set(defs.keys())
-    except Exception:
-        pass
-
-    raise RuntimeError(
-        "Could not locate ACP wire schema $defs. "
-        "Update _get_acp_schema_defs() for this SDK version and record the "
-        "discovery strategy in references/wave-0-spike-results.md."
-    )
-
-
-def _get_protocol_version() -> str:
-    """Return the PROTOCOL_VERSION string from the installed SDK."""
-    import acp  # type: ignore[import-not-found]
-
-    for attr in ("PROTOCOL_VERSION", "protocol_version", "VERSION"):
-        val = getattr(acp, attr, None)
-        if val is not None:
-            return str(val)
-
-    # Try acp.constants
-    try:
-        import acp.constants as _const  # type: ignore[import-not-found]
-
-        for attr in ("PROTOCOL_VERSION", "VERSION"):
-            val = getattr(_const, attr, None)
-            if val is not None:
-                return str(val)
-    except ImportError:
-        pass
-
-    raise RuntimeError(
-        "Cannot find PROTOCOL_VERSION in the installed agent-client-protocol SDK. "
-        "Update _get_protocol_version() for this version and document in "
-        "references/wave-0-spike-results.md."
-    )
-
-
-# ---------------------------------------------------------------------------
-# Tests — condition (a)
-# ---------------------------------------------------------------------------
-
-
-def test_installed_sdk_version_within_pinned_range() -> None:
-    """(a) Installed agent-client-protocol version is within the pyproject.toml pin."""
-    try:
-        raw = importlib.metadata.version("agent-client-protocol")
-    except importlib.metadata.PackageNotFoundError:
-        pytest.skip("agent-client-protocol not installed — install deps first")
-        return  # unreachable; satisfies Pyright's unbound-variable analysis
-
-    version = _parse_version(raw)
-    assert version >= _PINNED_FLOOR, (
-        f"Installed agent-client-protocol {raw} is BELOW pinned floor "
-        f"{'.'.join(str(x) for x in _PINNED_FLOOR)}. "
-        "Update the pin in telegram_bridge/pyproject.toml and re-audit. "
-        "Record finding in references/wave-0-spike-results.md."
-    )
-    assert version < _PINNED_CEILING, (
-        f"Installed agent-client-protocol {raw} exceeds pinned ceiling "
-        f"{'.'.join(str(x) for x in _PINNED_CEILING)}. "
-        "Re-audit the SDK for breaking schema changes before widening the pin. "
-        "Record finding in references/wave-0-spike-results.md."
-    )
-
-
-# ---------------------------------------------------------------------------
-# Tests — condition (b)
-# ---------------------------------------------------------------------------
-
-
-def test_protocol_version_constant_is_accessible() -> None:
-    """(b) SDK exposes a PROTOCOL_VERSION constant that can be read."""
-    try:
-        importlib.metadata.version("agent-client-protocol")
-    except importlib.metadata.PackageNotFoundError:
-        pytest.skip("agent-client-protocol not installed")
-        return  # unreachable; satisfies Pyright
-
-    try:
-        pv = _get_protocol_version()
-    except RuntimeError as exc:
-        pytest.fail(str(exc))
-        return  # unreachable; satisfies Pyright
-
-    # Verify it looks like a semver string (e.g. "0.12.2" or "0.9.0")
-    assert re.match(r"\d+\.\d+", pv), (
-        f"PROTOCOL_VERSION {pv!r} does not look like a version string. "
-        "Update _get_protocol_version() and document in wave-0-spike-results.md."
-    )
-
-
-# ---------------------------------------------------------------------------
-# Tests — condition (c)
-# ---------------------------------------------------------------------------
-
-
-def test_schema_defs_include_required_wire_events() -> None:
-    """(c) SDK schema $defs include all eight expected ACP wire-event names."""
-    try:
-        importlib.metadata.version("agent-client-protocol")
-    except importlib.metadata.PackageNotFoundError:
-        pytest.skip("agent-client-protocol not installed")
-        return  # unreachable; satisfies Pyright
-
-    try:
-        defs = _get_acp_schema_defs()
-    except RuntimeError as exc:
-        pytest.fail(str(exc))
-        return  # unreachable; satisfies Pyright
-
-    missing = _REQUIRED_WIRE_EVENTS - defs
-    assert not missing, (
-        f"ACP schema $defs is missing required wire-event names: {sorted(missing)}. "
-        "The SDK schema has drifted from the spec. "
-        "Update _REQUIRED_WIRE_EVENTS or pin a different SDK version. "
-        "Record finding in references/wave-0-spike-results.md."
-    )
-
-
-def test_schema_defs_exclude_daemon_synthesised_events() -> None:
-    """(c) SDK schema $defs do NOT contain daemon-synthesised event names like usage_update."""
-    try:
-        importlib.metadata.version("agent-client-protocol")
-    except importlib.metadata.PackageNotFoundError:
-        pytest.skip("agent-client-protocol not installed")
-        return  # unreachable; satisfies Pyright
-
-    try:
-        defs = _get_acp_schema_defs()
-    except RuntimeError as exc:
-        pytest.fail(str(exc))
-        return  # unreachable; satisfies Pyright
-
-    present = _FORBIDDEN_WIRE_EVENTS & defs
-    assert not present, (
-        f"ACP schema $defs unexpectedly contains daemon-synthesised event(s): "
-        f"{sorted(present)}. Round-6 confirmed usage_update does NOT exist on "
-        "the wire — it is synthesised by the daemon. If the SDK added it, "
-        "re-audit and remove it from _FORBIDDEN_WIRE_EVENTS with documentation. "
-        "Record finding in references/wave-0-spike-results.md."
-    )

package/tools/vds-scripts/telegram_bridge/tests/spikes/test_0_11_telegram_general_topic_api.py

@@ -1,63 +0,0 @@
-"""TSK-0.11 — Telegram general-topic API surface smoke.
-
-Spec acceptance: Verify that closeForumTopic(message_thread_id=1) returns 400
-and closeGeneralForumTopic succeeds. Verify editGeneralForumTopic,
-reopenGeneralForumTopic, unpinAllGeneralForumTopicMessages exist and behave
-as expected. Confirms the General-topic-distinct-API claim in §7.4.
-
-Live-run preconditions:
-  - TELEGRAM_BOT_TOKEN set to a real bot token
-  - VDS_TELEGRAM_TEST_SUPERGROUP_ID set to a throwaway test supergroup
-    (bot must be admin with can_manage_topics)
-  - VDS_TELEGRAM_SPIKE_LIVE=1
-"""
-
-from __future__ import annotations
-
-import os
-
-import pytest
-
-pytestmark = pytest.mark.spike_live
-
-
-@pytest.mark.skipif(
-    not os.environ.get("VDS_TELEGRAM_SPIKE_LIVE"),
-    reason="set VDS_TELEGRAM_SPIKE_LIVE=1 + supply real credentials to run this spike",
-)
-def test_close_forum_topic_on_general_returns_400() -> None:
-    # Preconditions:
-    #   - Bot admin in a test supergroup.
-    # Steps:
-    #   1. bot.close_forum_topic(chat_id=supergroup_id, message_thread_id=1)
-    #   2. Expect TelegramBadRequest (400) — the general topic CANNOT be closed
-    #      via the regular close_forum_topic endpoint.
-    #   Record result in references/wave-0-spike-results.md; amend §7.4 if wrong.
-    raise NotImplementedError("operator-run live spike — see docstring for setup steps")
-
-
-@pytest.mark.skipif(
-    not os.environ.get("VDS_TELEGRAM_SPIKE_LIVE"),
-    reason="set VDS_TELEGRAM_SPIKE_LIVE=1 + supply real credentials to run this spike",
-)
-def test_close_general_forum_topic_succeeds() -> None:
-    # Steps:
-    #   1. bot.close_general_forum_topic(chat_id=supergroup_id)
-    #   2. assert result is True (or no exception).
-    raise NotImplementedError("operator-run live spike — see docstring for setup steps")
-
-
-@pytest.mark.skipif(
-    not os.environ.get("VDS_TELEGRAM_SPIKE_LIVE"),
-    reason="set VDS_TELEGRAM_SPIKE_LIVE=1 + supply real credentials to run this spike",
-)
-def test_general_topic_api_surface_exists() -> None:
-    # Verify aiogram 3.27 exposes the four general-topic methods.
-    # This check is IMPORTABLE offline — just verify the methods exist on the Bot class.
-    # Steps:
-    #   1. from aiogram import Bot
-    #   2. assert hasattr(Bot, "close_general_forum_topic")
-    #   3. assert hasattr(Bot, "edit_general_forum_topic")
-    #   4. assert hasattr(Bot, "reopen_general_forum_topic")
-    #   5. assert hasattr(Bot, "unpin_all_general_forum_topic_messages")
-    raise NotImplementedError("operator-run live spike — see docstring for setup steps")

package/tools/vds-scripts/telegram_bridge/tests/spikes/test_0_12_last_processed_offset.py

@@ -1,56 +0,0 @@
-"""TSK-0.12 — last_processed_update_id persistence smoke.
-
-Spec acceptance: Daemon starts; processes 50 updates; persisted offset visible
-in Postgres as last_update_offset event. Daemon kill -9; restart; verifies
-resume from persisted offset (no replay of already-processed updates).
-FR-9.10 verified.
-
-Live-run preconditions:
-  - vds-telegram-daemon running against a live Telegram bot
-  - Postgres reachable with the telegram_bridge schema applied
-  - A way to inject 50 synthetic updates (or use a pre-loaded test supergroup)
-  - VDS_TELEGRAM_SPIKE_LIVE=1
-"""
-
-from __future__ import annotations
-
-import os
-
-import pytest
-
-pytestmark = pytest.mark.spike_live
-
-
-@pytest.mark.skipif(
-    not os.environ.get("VDS_TELEGRAM_SPIKE_LIVE"),
-    reason="set VDS_TELEGRAM_SPIKE_LIVE=1 + supply real credentials to run this spike",
-)
-def test_offset_persisted_after_processing_updates() -> None:
-    # Preconditions:
-    #   - Daemon running and connected to Postgres.
-    #   - 50 test messages sent to the supergroup (use a test script or Telegram CLI).
-    # Steps:
-    #   1. Wait for daemon to process all 50 updates (poll vds_telegram_session_events
-    #      or check daemon health endpoint for last_update_id).
-    #   2. SELECT event_payload->>'update_id' FROM vds_telegram_session_events
-    #      WHERE event_type = 'last_update_offset' ORDER BY created_at DESC LIMIT 1
-    #   3. assert persisted_offset == 50th_update_id
-    raise NotImplementedError("operator-run live spike — see docstring for setup steps")
-
-
-@pytest.mark.skipif(
-    not os.environ.get("VDS_TELEGRAM_SPIKE_LIVE"),
-    reason="set VDS_TELEGRAM_SPIKE_LIVE=1 + supply real credentials to run this spike",
-)
-def test_daemon_resumes_from_persisted_offset_after_kill() -> None:
-    # Preconditions:
-    #   - Offset persisted as above.
-    #   - A way to observe Telegram's getUpdates offset parameter on daemon restart.
-    # Steps:
-    #   1. kill -9 <daemon-pid>
-    #   2. Restart daemon (or wait for tini to restart it).
-    #   3. Intercept the first getUpdates call offset parameter (from daemon logs
-    #      or a Telegram API proxy / mock).
-    #   4. assert getUpdates offset == persisted_offset + 1  (no replay).
-    #   Record result in references/wave-0-spike-results.md.
-    raise NotImplementedError("operator-run live spike — see docstring for setup steps")

package/tools/vds-scripts/telegram_bridge/tests/spikes/test_0_13_resume_corrupted.py

@@ -1,77 +0,0 @@
-"""TSK-0.13 — claude-agent-sdk #856 defensive validator — end-to-end spike.
-
-Spec acceptance: Conformance test simulates a corrupted entry (tool_use.id
-violating ^[a-zA-Z0-9_-]+$); load() correctly emits agent_resume_corrupted
-system event + session_end(reason=resume_corrupted) instead of raising.
-
-This spike drives the FULL daemon-emits-agent_resume_corrupted-event behaviour
-end-to-end (daemon up, session store populated, load() triggered). The unit-
-level validator logic is already covered in:
-  telegram_bridge/tests/unit/test_session_store_resume_validator.py
-
-Live-run preconditions:
-  - vds-telegram-daemon running (or daemon under test running in a test
-    container with testcontainers Postgres)
-  - claude-agent-sdk>=0.1.68 installed
-  - PgAsyncpgSessionStore reachable against test Postgres
-  - A session record pre-seeded with a corrupted tool_use.id entry
-    (e.g., "functions.X:0")
-  - VDS_TELEGRAM_SPIKE_LIVE=1
-
-Unit coverage for the validator helpers lives in:
-  telegram_bridge/tests/unit/test_session_store_resume_validator.py
-  (CorruptedSessionEntry, _TOOL_USE_ID_VALID, _scan_for_invalid_tool_use_ids)
-"""
-
-from __future__ import annotations
-
-import os
-
-import pytest
-
-pytestmark = pytest.mark.spike_live
-
-
-@pytest.mark.skipif(
-    not os.environ.get("VDS_TELEGRAM_SPIKE_LIVE"),
-    reason="set VDS_TELEGRAM_SPIKE_LIVE=1 + supply real credentials to run this spike",
-)
-def test_load_corrupted_session_emits_agent_resume_corrupted_event() -> None:
-    # Preconditions:
-    #   - Postgres with schema applied; asyncpg pool available.
-    #   - A session row in vds_telegram_sessions with status='active'.
-    #   - JSONL or Postgres session store populated with an entry containing
-    #     a tool_use block whose id="functions.read:0" (violates the regex).
-    # Steps:
-    #   1. pool = await asyncpg.create_pool(os.environ["DATABASE_URL"])
-    #   2. store = PgAsyncpgSessionStore(pool)
-    #   3. events_emitted = []
-    #      # Patch or subscribe to the daemon event bus to capture emitted events.
-    #   4. with pytest.raises(CorruptedSessionEntry):
-    #          ... OR ...
-    #      # Alternatively, if load() catches internally and emits:
-    #      result = await store.load(session_id=corrupted_session_id)
-    #      assert result is None  # refused to return corrupted state
-    #   5. assert any(e.event_type == "agent_resume_corrupted" for e in events_emitted)
-    #   6. assert any(
-    #          e.event_type == "session_end" and e.payload.get("reason") == "resume_corrupted"
-    #          for e in events_emitted
-    #      )
-    raise NotImplementedError("operator-run live spike — see docstring for setup steps")
-
-
-@pytest.mark.skipif(
-    not os.environ.get("VDS_TELEGRAM_SPIKE_LIVE"),
-    reason="set VDS_TELEGRAM_SPIKE_LIVE=1 + supply real credentials to run this spike",
-)
-def test_daemon_receives_session_end_reason_resume_corrupted_via_uds() -> None:
-    # End-to-end: daemon receives the session_end event over UDS from the runner.
-    # Preconditions:
-    #   - Daemon running with a fake runner that has a pre-corrupted store entry.
-    # Steps:
-    #   1. Connect to daemon UDS socket as a fake surface.
-    #   2. Send a "resume" session request for the corrupted session_id.
-    #   3. Collect frames from the runner over UDS.
-    #   4. assert SessionEndFrame(reason="resume_corrupted") received.
-    #   5. assert no Python exception propagated to the daemon process.
-    raise NotImplementedError("operator-run live spike — see docstring for setup steps")

package/tools/vds-scripts/telegram_bridge/tests/spikes/test_0_1_telegram_forum_smoke.py

@@ -1,42 +0,0 @@
-"""TSK-0.1 — Telegram forum topic lifecycle smoke.
-
-Spec acceptance: Each call to createForumTopic (with each of the 6 valid
-icon_color values), editForumTopic, closeForumTopic, deleteForumTopic returns
-success; trying icon_color=0xCBC8C8 (gray) returns the expected validation
-error.
-
-Live-run preconditions:
-  - TELEGRAM_BOT_TOKEN set to a real bot token
-  - VDS_TELEGRAM_TEST_SUPERGROUP_ID set to a throwaway test supergroup ID
-    (the bot must be admin with can_manage_topics permission)
-  - VDS_TELEGRAM_SPIKE_LIVE=1
-"""
-
-from __future__ import annotations
-
-import os
-
-import pytest
-
-pytestmark = pytest.mark.spike_live
-
-
-@pytest.mark.skipif(
-    not os.environ.get("VDS_TELEGRAM_SPIKE_LIVE"),
-    reason="set VDS_TELEGRAM_SPIKE_LIVE=1 + supply real credentials to run this spike",
-)
-def test_forum_topic_full_lifecycle() -> None:
-    # Preconditions:
-    #   - Bot must be admin in a test supergroup with is_forum=True.
-    #   - The 6 valid icon_color values (as of aiogram 3.27) are documented in
-    #     telegram_bridge/references/wave-0-spike-results.md.
-    # Steps:
-    #   1. For each of the 6 valid icon_color values:
-    #        bot.create_forum_topic(chat_id=supergroup_id, name="Spike-{color}", icon_color=color)
-    #        assert result.message_thread_id is not None
-    #   2. editForumTopic(rename to "Spike-renamed")
-    #   3. createForumTopic with name of exactly 128 chars — should succeed.
-    #   4. closeForumTopic — should succeed.
-    #   5. deleteForumTopic — should succeed.
-    #   6. createForumTopic with icon_color=0xCBC8C8 (gray) — expect BadRequest.
-    raise NotImplementedError("operator-run live spike — see docstring for setup steps")

package/tools/vds-scripts/telegram_bridge/tests/spikes/test_0_2_telegram_file_smoke.py

@@ -1,38 +0,0 @@
-"""TSK-0.2 — Telegram file upload size boundary smoke.
-
-Spec acceptance: 20 MB threshold confirmed; daemon's MAX_INBOUND_FILE_BYTES
-set to 20 × 1024 × 1024. getFile succeeds for 1 MB and 19 MB documents;
-getFile is rejected for a 21 MB document per Bot API limits.
-
-Live-run preconditions:
-  - TELEGRAM_BOT_TOKEN set to a real bot token
-  - VDS_TELEGRAM_TEST_CHAT_ID set to a chat the bot can post to
-  - Three test files (1 MB, 19 MB, 21 MB) generated or available locally
-  - VDS_TELEGRAM_SPIKE_LIVE=1
-"""
-
-from __future__ import annotations
-
-import os
-
-import pytest
-
-pytestmark = pytest.mark.spike_live
-
-
-@pytest.mark.skipif(
-    not os.environ.get("VDS_TELEGRAM_SPIKE_LIVE"),
-    reason="set VDS_TELEGRAM_SPIKE_LIVE=1 + supply real credentials to run this spike",
-)
-def test_file_upload_size_boundary() -> None:
-    # Preconditions:
-    #   - Create three temp files: 1 * 1024 * 1024 bytes, 19 * 1024 * 1024 bytes,
-    #     21 * 1024 * 1024 bytes (e.g., /tmp/spike_1mb.bin etc.).
-    # Steps:
-    #   1. bot.send_document(chat_id, FSInputFile("/tmp/spike_1mb.bin"))  → OK
-    #      bot.get_file(file_id) → succeeds; file_size <= 20 MB confirmed.
-    #   2. Same for 19 MB → OK.
-    #   3. Same for 21 MB → expect TelegramAPIError (file too large).
-    #   4. Assert MAX_INBOUND_FILE_BYTES = 20 * 1024 * 1024 is the correct cap.
-    #   Record result in references/wave-0-spike-results.md.
-    raise NotImplementedError("operator-run live spike — see docstring for setup steps")

package/tools/vds-scripts/telegram_bridge/tests/spikes/test_0_3_telegram_permission_smoke.py

@@ -1,40 +0,0 @@
-"""TSK-0.3 — Telegram bot permission probe smoke.
-
-Spec acceptance: getChatMember returns the bot's permissions. Each of
-can_manage_topics, can_post_messages, can_edit_messages, can_delete_messages,
-can_change_info is independently detectable. Preflight failure reports the
-specific missing permission.
-
-Live-run preconditions:
-  - TELEGRAM_BOT_TOKEN set to a real bot token
-  - VDS_TELEGRAM_TEST_SUPERGROUP_ID set to a throwaway supergroup
-  - Bot added as admin with a known set of permissions
-  - VDS_TELEGRAM_SPIKE_LIVE=1
-"""
-
-from __future__ import annotations
-
-import os
-
-import pytest
-
-pytestmark = pytest.mark.spike_live
-
-
-@pytest.mark.skipif(
-    not os.environ.get("VDS_TELEGRAM_SPIKE_LIVE"),
-    reason="set VDS_TELEGRAM_SPIKE_LIVE=1 + supply real credentials to run this spike",
-)
-def test_permission_probe_detects_each_permission_independently() -> None:
-    # Preconditions:
-    #   - Run three passes with the bot having different permission subsets:
-    #       Pass A: all five permissions granted → preflight passes.
-    #       Pass B: remove can_manage_topics → preflight raises and names it.
-    #       Pass C: remove can_post_messages → preflight raises and names it.
-    # Steps:
-    #   1. bot.get_chat_member(chat_id=supergroup_id, user_id=bot.id)
-    #   2. Inspect ChatMemberAdministrator fields for each permission.
-    #   3. Call telegram_bridge.daemon.bot._check_permissions() (or equivalent)
-    #      and verify the error message names the specific missing field.
-    #   Record result in references/wave-0-spike-results.md.
-    raise NotImplementedError("operator-run live spike — see docstring for setup steps")

package/tools/vds-scripts/telegram_bridge/tests/spikes/test_0_4_claude_sdk_hooks_mcp_smoke.py

@@ -1,45 +0,0 @@
-"""TSK-0.4 — ClaudeSDKClient with PreToolUse hook + custom MCP tool smoke.
-
-Spec acceptance: Hook fires; custom in-process MCP tool (echo) returns; multi-
-turn client.query() works in the same session.
-
-Live-run preconditions:
-  - ANTHROPIC_API_KEY or configured proxy profile set
-  - claude-agent-sdk>=0.1.68 installed
-  - VDS_TELEGRAM_SPIKE_LIVE=1
-
-Note: Uses ClaudeSDKClient (NOT query() — issue #817 deadlocks query() when
-MCP servers + hooks are configured together). This spike validates ADR-10.
-"""
-
-from __future__ import annotations
-
-import os
-
-import pytest
-
-pytestmark = pytest.mark.spike_live
-
-
-@pytest.mark.skipif(
-    not os.environ.get("VDS_TELEGRAM_SPIKE_LIVE"),
-    reason="set VDS_TELEGRAM_SPIKE_LIVE=1 + supply real credentials to run this spike",
-)
-def test_claude_sdk_client_hooks_and_mcp_tool() -> None:
-    # Preconditions:
-    #   - claude-agent-sdk >= 0.1.68 installed.
-    #   - ANTHROPIC_API_KEY or proxy configured.
-    # Steps:
-    #   1. Define an in-process MCP tool: echo(text: str) -> str.
-    #   2. Define a PreToolUse hook that appends to a list when fired.
-    #   3. async with ClaudeSDKClient(options=ClaudeAgentOptions(
-    #          mcp_servers={"spike-echo": echo_mcp},
-    #          hooks={"PreToolUse": [hook]},
-    #      )) as client:
-    #       response = await client.query("Call echo with text='hello'")
-    #       assert hook_fired_list  # hook was called
-    #       assert "hello" in response.content
-    #   4. Second turn: await client.query("Say the echo result in uppercase.")
-    #      assert multi-turn works (session id consistent).
-    #   Record result in references/wave-0-spike-results.md.
-    raise NotImplementedError("operator-run live spike — see docstring for setup steps")

package/tools/vds-scripts/telegram_bridge/tests/spikes/test_0_5_session_store_conformance.py

@@ -1,37 +0,0 @@
-"""TSK-0.5 — PgAsyncpgSessionStore conformance against claude-agent-sdk.
-
-Spec acceptance: claude_agent_sdk.run_session_store_conformance against
-PgAsyncpgSessionStore passes all conformance assertions.
-
-Live-run preconditions:
-  - Postgres reachable (VDS_DATABASE_URL or DATABASE_URL set)
-  - claude-agent-sdk>=0.1.68 installed with run_session_store_conformance
-  - vds_telegram_sessions table exists (Alembic migration applied)
-  - VDS_TELEGRAM_SPIKE_LIVE=1
-"""
-
-from __future__ import annotations
-
-import os
-
-import pytest
-
-pytestmark = pytest.mark.spike_live
-
-
-@pytest.mark.skipif(
-    not os.environ.get("VDS_TELEGRAM_SPIKE_LIVE"),
-    reason="set VDS_TELEGRAM_SPIKE_LIVE=1 + supply real credentials to run this spike",
-)
-def test_pg_asyncpg_session_store_conformance() -> None:
-    # Preconditions:
-    #   - A running Postgres instance with the telegram_bridge schema applied.
-    #   - DATABASE_URL env var pointing to it.
-    #   - claude_agent_sdk.run_session_store_conformance importable.
-    # Steps:
-    #   1. pool = await asyncpg.create_pool(os.environ["DATABASE_URL"])
-    #   2. store = PgAsyncpgSessionStore(pool)
-    #   3. await claude_agent_sdk.run_session_store_conformance(store)
-    #   4. Assert no conformance assertion errors raised.
-    #   Record result in references/wave-0-spike-results.md.
-    raise NotImplementedError("operator-run live spike — see docstring for setup steps")