sneakoscope 8.0.2 → 8.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (122) hide show
  1. package/README.md +47 -23
  2. package/config/skills-hash-ledger.v1.json +1 -1
  3. package/crates/sks-core/Cargo.lock +1 -1
  4. package/crates/sks-core/Cargo.toml +1 -1
  5. package/dist/bin/fast-inline.js +55 -13
  6. package/dist/bin/sks-dispatch.js +1 -1
  7. package/dist/cli/command-manifest-lite.js +4 -0
  8. package/dist/cli/command-registry.js +4 -0
  9. package/dist/cli/install-helpers-codex-lb-chain.js +187 -0
  10. package/dist/cli/install-helpers-codex-lb-config.js +74 -8
  11. package/dist/cli/install-helpers.js +89 -44
  12. package/dist/commands/codex-lb.js +117 -19
  13. package/dist/commands/doctor.js +697 -37
  14. package/dist/config/skills-manifest.json +3 -2
  15. package/dist/core/agents/agent-runner-codex-exec.js +5 -3
  16. package/dist/core/codex/codex-config-guard.js +238 -52
  17. package/dist/core/codex-adapter.js +5 -3
  18. package/dist/core/codex-app/menubar/constants.js +10 -1
  19. package/dist/core/codex-app/menubar/global-install.js +288 -0
  20. package/dist/core/codex-app/menubar/installer.js +79 -14
  21. package/dist/core/codex-app/menubar/launch-agent.js +267 -45
  22. package/dist/core/codex-app/menubar/paths.js +3 -0
  23. package/dist/core/codex-app/menubar/rollback.js +55 -7
  24. package/dist/core/codex-app/menubar/status.js +75 -4
  25. package/dist/core/codex-control/codex-0139-image-path-real-probe.js +3 -1
  26. package/dist/core/codex-control/codex-0139-web-search-probe.js +3 -1
  27. package/dist/core/codex-control/codex-app-server-runtime-env.js +13 -4
  28. package/dist/core/codex-control/codex-app-server-v2-client.js +3 -3
  29. package/dist/core/codex-exec-output-schema.js +4 -1
  30. package/dist/core/codex-lb/codex-lb-env.js +63 -72
  31. package/dist/core/codex-lb/codex-lb-setup.js +15 -2
  32. package/dist/core/codex-lb/desktop-center-credentials.js +517 -58
  33. package/dist/core/codex-lb/desktop-controller.js +153 -24
  34. package/dist/core/codex-lb/routing-truth.js +327 -0
  35. package/dist/core/codex-native/core-skill-manifest.js +1 -1
  36. package/dist/core/commands/basic-cli.js +7 -1
  37. package/dist/core/commands/qa-loop-command.js +3 -1
  38. package/dist/core/commands/telegram-command.js +241 -0
  39. package/dist/core/config-adopt/config-adopt-command.js +35 -0
  40. package/dist/core/config-adopt/config-adopt.js +346 -0
  41. package/dist/core/config-adopt/index.js +3 -0
  42. package/dist/core/doctor/command-alias-cleanup.js +4 -1
  43. package/dist/core/doctor/current-project-guidance-nested.js +37 -6
  44. package/dist/core/doctor/current-project-guidance.js +11 -6
  45. package/dist/core/doctor/doctor-readiness-matrix.js +14 -0
  46. package/dist/core/doctor/retired-managed-residue-private.js +1 -1
  47. package/dist/core/doctor/sks-menubar-doctor.js +4 -0
  48. package/dist/core/feature-fixtures.js +8 -0
  49. package/dist/core/hooks-runtime/hook-context.js +9 -0
  50. package/dist/core/hooks-runtime/managed-skill-admission.js +54 -4
  51. package/dist/core/hooks-runtime/official-subagent-lifecycle.js +69 -1
  52. package/dist/core/hooks-runtime/subagent-skill-availability-contract.js +2 -2
  53. package/dist/core/hooks-runtime/subagent-skill-availability-evidence.js +3 -3
  54. package/dist/core/hooks-runtime/subagent-skill-availability-guards.js +43 -5
  55. package/dist/core/hooks-runtime/subagent-skill-availability.js +64 -30
  56. package/dist/core/hooks-runtime/subagent-stop-hook.js +15 -2
  57. package/dist/core/hooks-runtime.js +148 -4
  58. package/dist/core/imagegen/imagegen-capability.js +46 -0
  59. package/dist/core/imagegen/require-imagegen.js +2 -2
  60. package/dist/core/init/skills.js +17 -3
  61. package/dist/core/install/installed-package-smoke.js +8 -2
  62. package/dist/core/naruto/hardware-capacity-probe.js +9 -3
  63. package/dist/core/naruto/naruto-concurrency-governor.js +68 -24
  64. package/dist/core/perf/import-graph-budget.js +0 -1
  65. package/dist/core/product-design-app-server.js +13 -1
  66. package/dist/core/release/package-size-budget.js +2 -2
  67. package/dist/core/release/release-pack-receipt.js +1 -2
  68. package/dist/core/routes/dollar-manifest-lite.js +1 -1
  69. package/dist/core/routes.js +1 -1
  70. package/dist/core/security/private-credential-file.js +209 -0
  71. package/dist/core/subagents/agent-catalog.js +17 -32
  72. package/dist/core/subagents/naruto-help-contract.js +5 -5
  73. package/dist/core/subagents/official-subagent-config.js +16 -6
  74. package/dist/core/subagents/official-subagent-preparation.js +34 -15
  75. package/dist/core/subagents/official-subagent-prompt.js +4 -4
  76. package/dist/core/subagents/official-subagent-runner.js +27 -4
  77. package/dist/core/subagents/thread-budget.js +19 -12
  78. package/dist/core/subagents/wave-lifecycle.js +18 -6
  79. package/dist/core/telegram/access.js +54 -0
  80. package/dist/core/telegram/client.js +144 -0
  81. package/dist/core/telegram/confirmation.js +37 -0
  82. package/dist/core/telegram/doctor.js +151 -0
  83. package/dist/core/telegram/index.js +9 -0
  84. package/dist/core/telegram/keychain.js +265 -0
  85. package/dist/core/telegram/liveness.js +109 -0
  86. package/dist/core/telegram/poller.js +90 -0
  87. package/dist/core/telegram/redaction.js +15 -0
  88. package/dist/core/telegram/types.js +1 -0
  89. package/dist/core/update/update-diagnostics.js +52 -0
  90. package/dist/core/update/update-migration-state.js +5 -1
  91. package/dist/core/update/update-operation.js +2 -1
  92. package/dist/core/update/update-stage-diagnostics.js +38 -0
  93. package/dist/core/update/update-status.js +2 -9
  94. package/dist/core/update-check.js +147 -31
  95. package/dist/core/version.js +1 -1
  96. package/dist/core/zellij/zellij-launcher.js +23 -4
  97. package/dist/native/sks-menubar/Sources/AppDelegate.swift +13 -0
  98. package/dist/native/sks-menubar/Sources/AppIdentity.swift +7 -0
  99. package/dist/native/sks-menubar/Sources/OperationCoordinator.swift +3 -2
  100. package/dist/native/sks-menubar/Sources/ProvidersConnectTest.swift +115 -0
  101. package/dist/native/sks-menubar/Sources/ProvidersFastMode.swift +17 -0
  102. package/dist/native/sks-menubar/Sources/ProvidersRoutingTruth.swift +190 -0
  103. package/dist/native/sks-menubar/Sources/ProvidersViewController.swift +100 -59
  104. package/dist/native/sks-menubar/Sources/SingletonInstanceGuard.swift +328 -0
  105. package/dist/native/sks-menubar/Sources/TelegramPrivateFileStore.swift +320 -0
  106. package/dist/native/sks-menubar/Sources/TelegramPrivateFileSupport.swift +303 -0
  107. package/dist/native/sks-menubar/Sources/TelegramProcessGateway.swift +238 -0
  108. package/dist/native/sks-menubar/Sources/TelegramRuntimeSupport.swift +56 -0
  109. package/dist/native/sks-menubar/Sources/TelegramSupport.swift +56 -0
  110. package/dist/native/sks-menubar/Sources/TelegramTransport.swift +474 -0
  111. package/dist/native/sks-menubar/Sources/main.swift +15 -1
  112. package/dist/native/sks-menubar/Tests/OperationCoordinatorTests.swift +4 -3
  113. package/dist/native/sks-menubar/Tests/ProvidersViewControllerTests.swift +129 -0
  114. package/dist/native/sks-menubar/Tests/SingletonInstanceGuardTests.swift +183 -0
  115. package/dist/native/sks-menubar/Tests/TelegramRuntimeSmokeTests.swift +267 -0
  116. package/dist/native/sks-menubar/Tests/TelegramRuntimeTests.swift +222 -0
  117. package/dist/scripts/codex-lb-fast-mode-truth-check.js +1 -1
  118. package/dist/scripts/codex-lb-fast-ui-preservation-check.js +1 -1
  119. package/dist/scripts/current-command-surface-check.js +2 -4
  120. package/dist/scripts/official-subagent-workflow-check.js +1 -1
  121. package/dist/scripts/packlist-performance-check.js +1 -2
  122. package/package.json +1 -1
@@ -0,0 +1,183 @@
1
+ #if SKS_STANDALONE_TESTS
2
+ import Foundation
3
+
4
+ @main
5
+ enum SingletonInstanceGuardStandaloneTests {
6
+ static func main() {
7
+ expect(
8
+ .keepCandidate(terminate: [100, 200]),
9
+ candidate: .init(processIdentifier: 300, packageVersion: "8.0.3", buildVersion: "803"),
10
+ running: [
11
+ .init(processIdentifier: 100, packageVersion: "7.5.0", buildVersion: "750"),
12
+ .init(processIdentifier: 200, packageVersion: "8.0.2", buildVersion: "802")
13
+ ]
14
+ )
15
+ expect(
16
+ .exitCandidate(winner: 100, terminate: []),
17
+ candidate: .init(
18
+ processIdentifier: 50,
19
+ packageVersion: "8.0.3",
20
+ buildVersion: "803",
21
+ startedAt: Date(timeIntervalSince1970: 20)
22
+ ),
23
+ running: [.init(
24
+ processIdentifier: 100,
25
+ packageVersion: "8.0.3",
26
+ buildVersion: "803",
27
+ startedAt: Date(timeIntervalSince1970: 10)
28
+ )]
29
+ )
30
+ expect(
31
+ .exitCandidate(winner: 100, terminate: [200]),
32
+ candidate: .init(processIdentifier: 300, packageVersion: "8.0.2", buildVersion: "802"),
33
+ running: [
34
+ .init(processIdentifier: 100, packageVersion: "8.0.3", buildVersion: "803"),
35
+ .init(processIdentifier: 200, packageVersion: "8.0.1", buildVersion: "801")
36
+ ]
37
+ )
38
+ expect(
39
+ .keepCandidate(terminate: [200]),
40
+ candidate: .init(processIdentifier: 100, packageVersion: "8.0.3", buildVersion: "803"),
41
+ running: [.init(processIdentifier: 200, packageVersion: "8.0.3", buildVersion: "803")]
42
+ )
43
+ expect(
44
+ .exitCandidate(winner: 200, terminate: []),
45
+ candidate: .init(
46
+ processIdentifier: 100,
47
+ packageVersion: "8.0.3",
48
+ buildVersion: "803",
49
+ startedAt: Date(timeIntervalSince1970: 20)
50
+ ),
51
+ running: [.init(processIdentifier: 200, packageVersion: "8.0.3", buildVersion: "803")]
52
+ )
53
+ let legacy = SingletonInstanceGuard.identity(
54
+ processIdentifier: 400,
55
+ runtimeState: nil,
56
+ expectedBundleIdentifier: "com.sneakoscope.menubar"
57
+ )
58
+ precondition(legacy.packageVersion == nil && legacy.buildVersion == nil && legacy.startedAt == nil)
59
+ expect(
60
+ .keepCandidate(terminate: [400]),
61
+ candidate: .init(processIdentifier: 500, packageVersion: "8.0.3", buildVersion: "803"),
62
+ running: [legacy]
63
+ )
64
+ precondition(SingletonInstanceGuard.compareVersions("8.0.3-beta.2", "8.0.3") == .orderedAscending)
65
+ precondition(SingletonInstanceGuard.compareVersions("8.0.10", "8.0.3") == .orderedDescending)
66
+ print("SingletonInstanceGuardTests: 7 passed")
67
+ }
68
+
69
+ private static func expect(
70
+ _ expected: MenuBarInstanceArbitration,
71
+ candidate: MenuBarInstanceIdentity,
72
+ running: [MenuBarInstanceIdentity]
73
+ ) {
74
+ precondition(SingletonInstanceGuard.arbitrate(candidate: candidate, running: running) == expected)
75
+ }
76
+ }
77
+ #elseif canImport(XCTest)
78
+ import XCTest
79
+
80
+ final class SingletonInstanceGuardTests: XCTestCase {
81
+ func testNewerCandidateTerminatesEveryOlderInstance() {
82
+ let candidate = MenuBarInstanceIdentity(processIdentifier: 300, packageVersion: "8.0.3", buildVersion: "803")
83
+ let running = [
84
+ MenuBarInstanceIdentity(processIdentifier: 100, packageVersion: "7.5.0", buildVersion: "750"),
85
+ MenuBarInstanceIdentity(processIdentifier: 200, packageVersion: "8.0.2", buildVersion: "802")
86
+ ]
87
+ XCTAssertEqual(
88
+ SingletonInstanceGuard.arbitrate(candidate: candidate, running: running),
89
+ .keepCandidate(terminate: [100, 200])
90
+ )
91
+ }
92
+
93
+ func testLaterSameVersionCandidateExits() {
94
+ let candidate = MenuBarInstanceIdentity(
95
+ processIdentifier: 50,
96
+ packageVersion: "8.0.3",
97
+ buildVersion: "803",
98
+ startedAt: Date(timeIntervalSince1970: 20)
99
+ )
100
+ let running = [MenuBarInstanceIdentity(
101
+ processIdentifier: 100,
102
+ packageVersion: "8.0.3",
103
+ buildVersion: "803",
104
+ startedAt: Date(timeIntervalSince1970: 10)
105
+ )]
106
+ XCTAssertEqual(
107
+ SingletonInstanceGuard.arbitrate(candidate: candidate, running: running),
108
+ .exitCandidate(winner: 100, terminate: [])
109
+ )
110
+ }
111
+
112
+ func testLosingCandidateStillCollapsesOlderExtraInstances() {
113
+ let candidate = MenuBarInstanceIdentity(processIdentifier: 300, packageVersion: "8.0.2", buildVersion: "802")
114
+ let running = [
115
+ MenuBarInstanceIdentity(processIdentifier: 100, packageVersion: "8.0.3", buildVersion: "803"),
116
+ MenuBarInstanceIdentity(processIdentifier: 200, packageVersion: "8.0.1", buildVersion: "801")
117
+ ]
118
+ XCTAssertEqual(
119
+ SingletonInstanceGuard.arbitrate(candidate: candidate, running: running),
120
+ .exitCandidate(winner: 100, terminate: [200])
121
+ )
122
+ }
123
+
124
+ func testSimultaneousSameBuildUsesPidAsDeterministicTieBreak() {
125
+ let candidate = MenuBarInstanceIdentity(processIdentifier: 100, packageVersion: "8.0.3", buildVersion: "803")
126
+ let running = [MenuBarInstanceIdentity(processIdentifier: 200, packageVersion: "8.0.3", buildVersion: "803")]
127
+ XCTAssertEqual(
128
+ SingletonInstanceGuard.arbitrate(candidate: candidate, running: running),
129
+ .keepCandidate(terminate: [200])
130
+ )
131
+ }
132
+
133
+ func testSameVersionIncumbentWithoutStartTimeIsKept() {
134
+ let candidate = MenuBarInstanceIdentity(
135
+ processIdentifier: 100,
136
+ packageVersion: "8.0.3",
137
+ buildVersion: "803",
138
+ startedAt: Date(timeIntervalSince1970: 20)
139
+ )
140
+ let incumbent = SingletonInstanceGuard.identity(
141
+ processIdentifier: 200,
142
+ runtimeState: MenuBarRuntimeState(
143
+ schema: "sks.menubar-runtime-state.v1",
144
+ pid: 200,
145
+ package_version: "8.0.3",
146
+ build_version: "803",
147
+ bundle_identifier: "com.sneakoscope.menubar",
148
+ executable_path: "/tmp/SKS Menu Bar",
149
+ started_at: nil
150
+ ),
151
+ expectedBundleIdentifier: "com.sneakoscope.menubar"
152
+ )
153
+ XCTAssertEqual(
154
+ SingletonInstanceGuard.arbitrate(candidate: candidate, running: [incumbent]),
155
+ .exitCandidate(winner: 200, terminate: [])
156
+ )
157
+ }
158
+
159
+ func testMissingRuntimeStateIsUnversionedAndLosesToVersionedCandidate() {
160
+ let legacy = SingletonInstanceGuard.identity(
161
+ processIdentifier: 400,
162
+ runtimeState: nil,
163
+ expectedBundleIdentifier: "com.sneakoscope.menubar"
164
+ )
165
+ XCTAssertNil(legacy.packageVersion)
166
+ XCTAssertNil(legacy.buildVersion)
167
+ XCTAssertNil(legacy.startedAt)
168
+ XCTAssertEqual(
169
+ SingletonInstanceGuard.arbitrate(
170
+ candidate: .init(processIdentifier: 500, packageVersion: "8.0.3", buildVersion: "803"),
171
+ running: [legacy]
172
+ ),
173
+ .keepCandidate(terminate: [400])
174
+ )
175
+ }
176
+
177
+ func testPrereleaseSortsBeforeRelease() {
178
+ XCTAssertEqual(SingletonInstanceGuard.compareVersions("8.0.3-beta.2", "8.0.3"), .orderedAscending)
179
+ XCTAssertEqual(SingletonInstanceGuard.compareVersions("8.0.10", "8.0.3"), .orderedDescending)
180
+ }
181
+ }
182
+
183
+ #endif
@@ -0,0 +1,267 @@
1
+ #if TELEGRAM_STANDALONE_TEST
2
+ import Foundation
3
+
4
+ private enum TelegramSmokeError: Error { case auditUnavailable }
5
+
6
+ private final class TelegramSmokeAccess: TelegramAccessStoring, @unchecked Sendable {
7
+ func loadToken() throws -> String? { "123456:abcdefghijklmnopqrstuvwxyzABCDE" }
8
+ func consumePairing(code: String, chatID: Int64, senderID: Int64, chatType: String) throws -> Bool { false }
9
+ func isAuthorized(chatID: Int64, senderID: Int64) throws -> Bool { chatID == 10 && senderID == 20 }
10
+ func authorizedCount() throws -> Int { 1 }
11
+ func issueConfirmation(
12
+ chatID: Int64,
13
+ senderID: Int64,
14
+ request: TelegramTypedCommandRequest,
15
+ expiresAt: Date
16
+ ) throws -> String { "unused-confirmation" }
17
+ func consumeConfirmation(
18
+ nonce: String,
19
+ chatID: Int64,
20
+ senderID: Int64
21
+ ) throws -> TelegramStoredConfirmation? { nil }
22
+ }
23
+
24
+ private actor TelegramSmokeAPI: TelegramBotAPI {
25
+ var first = true
26
+ var offsets: [Int64] = []
27
+ var replies: [String] = []
28
+ func getMe(token: String) async throws -> TelegramNativeUser {
29
+ TelegramNativeUser(id: 1, is_bot: true, first_name: "SKS")
30
+ }
31
+ func getUpdates(token: String, offset: Int64, timeoutSeconds: Int) async throws -> [TelegramNativeUpdate] {
32
+ offsets.append(offset)
33
+ guard first else {
34
+ try await Task.sleep(nanoseconds: 10_000_000)
35
+ return []
36
+ }
37
+ first = false
38
+ return [
39
+ TelegramNativeUpdate(update_id: 4, message: TelegramNativeMessage(
40
+ message_id: 1, date: 1, chat: TelegramNativeChat(id: 99, type: "private"),
41
+ from: TelegramNativeUser(id: 99, is_bot: false, first_name: "No"), text: "/sks status {}"
42
+ )),
43
+ TelegramNativeUpdate(update_id: 5, message: TelegramNativeMessage(
44
+ message_id: 2, date: 1, chat: TelegramNativeChat(id: 10, type: "private"),
45
+ from: TelegramNativeUser(id: 20, is_bot: false, first_name: "Yes"), text: "/sks status {}"
46
+ ))
47
+ ]
48
+ }
49
+ func sendMessage(token: String, chatID: Int64, text: String) async throws { replies.append("\(chatID):\(text)") }
50
+ func state() -> ([Int64], [String]) { (offsets, replies) }
51
+ }
52
+
53
+ private actor TelegramSmokeGateway: TelegramTypedCommandGateway {
54
+ var executions = 0
55
+ func prepare(_ request: TelegramTypedCommandRequest) async -> TelegramTypedCommandDecision {
56
+ TelegramTypedCommandDecision(allowed: request.name == "status", confirmationRequired: false, publicError: nil)
57
+ }
58
+ func execute(_ request: TelegramTypedCommandRequest) async throws -> String {
59
+ executions += 1
60
+ return "ok"
61
+ }
62
+ func count() -> Int { executions }
63
+ }
64
+
65
+ @main
66
+ private enum TelegramRuntimeSmokeTests {
67
+ static func main() async throws {
68
+ let directory = FileManager.default.temporaryDirectory.appendingPathComponent("sks-telegram-smoke-\(UUID().uuidString)")
69
+ defer { try? FileManager.default.removeItem(at: directory) }
70
+ try FileManager.default.createDirectory(at: directory, withIntermediateDirectories: false)
71
+ try verifyPrivateFileStore(in: directory)
72
+ let api = TelegramSmokeAPI()
73
+ let gateway = TelegramSmokeGateway()
74
+ let receiptURL = directory.appendingPathComponent("liveness.json")
75
+ let runtime = TelegramMenuBarRuntime(
76
+ api: api, access: TelegramSmokeAccess(), gateway: gateway,
77
+ receiptURL: receiptURL, audit: { _ in }
78
+ )
79
+ let service = TelegramMenuBarService(runtime: runtime)
80
+ _ = try await service.start().value
81
+ do {
82
+ _ = try await runtime.start()
83
+ fatalError("duplicate poller start was accepted")
84
+ } catch { }
85
+ try await Task.sleep(nanoseconds: 100_000_000)
86
+ precondition(service.stopAndWait(timeout: 2), "bounded menu-bar stop timed out")
87
+ let receipt = TelegramLivenessWriter(url: receiptURL).read()
88
+ let executionCount = await gateway.count()
89
+ precondition(receipt?.poller.offset == 6)
90
+ precondition(receipt?.running == false)
91
+ precondition(receipt?.getme_checked_at != nil)
92
+ precondition(receipt?.getme_latency_ms != nil)
93
+ precondition(receipt?.audit_healthy == true)
94
+ precondition(executionCount == 1)
95
+ let (_, replies) = await api.state()
96
+ precondition(replies == ["10:ok"], "unauthorized chat received a response")
97
+ let auditURL = directory.appendingPathComponent("audit.jsonl")
98
+ let ledger = TelegramAuditLedger(url: auditURL, maximumBytes: 64 * 1024)
99
+ try ledger.record(TelegramNativeAuditEvent(
100
+ actor: "chat:redacted", action: "unauthorized_chat", command: nil,
101
+ outcome: "denied", detail: nil
102
+ ))
103
+ let audit = try String(contentsOf: auditURL, encoding: .utf8)
104
+ let mode = try FileManager.default.attributesOfItem(atPath: auditURL.path)[.posixPermissions] as? NSNumber
105
+ precondition(mode?.intValue == 0o600)
106
+ precondition(audit.contains("chat:redacted") && !audit.contains("123456:abcdefghijklmnopqrstuvwxyzABCDE"))
107
+
108
+ let firstActor = telegramRedactedActor(chatID: 10, senderID: 20)
109
+ let secondActor = telegramRedactedActor(chatID: 10, senderID: 21)
110
+ precondition(firstActor.hasPrefix("actor:") && firstActor != secondActor)
111
+ precondition(firstActor != "10:20")
112
+
113
+ let failedAuditReceiptURL = directory.appendingPathComponent("audit-failure-liveness.json")
114
+ let failedAuditRuntime = TelegramMenuBarRuntime(
115
+ api: TelegramSmokeAPI(), access: TelegramSmokeAccess(), gateway: TelegramSmokeGateway(),
116
+ receiptURL: failedAuditReceiptURL,
117
+ audit: { _ in throw TelegramSmokeError.auditUnavailable }
118
+ )
119
+ do {
120
+ _ = try await failedAuditRuntime.start()
121
+ fatalError("poller started without a writable audit ledger")
122
+ } catch TelegramTransportError.auditUnavailable { }
123
+ let failedAuditReceipt = TelegramLivenessWriter(url: failedAuditReceiptURL).read()
124
+ precondition(failedAuditReceipt?.running == false)
125
+ precondition(failedAuditReceipt?.poller.running == false)
126
+ precondition(failedAuditReceipt?.audit_healthy == false)
127
+ precondition(failedAuditReceipt?.audit_last_error == "telegram_audit_unavailable")
128
+ precondition(telegramSelfHealAction(failedAuditReceipt!) == .operatorRepairAudit)
129
+ print("telegram swift runtime smoke: ok")
130
+ }
131
+
132
+ private static func verifyPrivateFileStore(in directory: URL) throws {
133
+ let home = directory.appendingPathComponent("home", isDirectory: true)
134
+ let sks = home.appendingPathComponent(".sneakoscope", isDirectory: true)
135
+ let secrets = sks.appendingPathComponent("secrets", isDirectory: true)
136
+ let stateDirectory = sks.appendingPathComponent("state", isDirectory: true)
137
+ let tokenURL = secrets.appendingPathComponent("telegram-bot-token")
138
+ let stateURL = stateDirectory.appendingPathComponent("telegram.json")
139
+ for privateDirectory in [home, sks, secrets, stateDirectory] {
140
+ try FileManager.default.createDirectory(
141
+ at: privateDirectory,
142
+ withIntermediateDirectories: false,
143
+ attributes: [.posixPermissions: 0o700]
144
+ )
145
+ try FileManager.default.setAttributes([.posixPermissions: 0o700], ofItemAtPath: privateDirectory.path)
146
+ }
147
+ try FileManager.default.setAttributes([.posixPermissions: 0o755], ofItemAtPath: sks.path)
148
+
149
+ let fileToken = "11111:abcdefghijklmnopqrstuvwxyzAB"
150
+ try Data("\(fileToken)\n".utf8).write(to: tokenURL)
151
+ try FileManager.default.setAttributes([.posixPermissions: 0o600], ofItemAtPath: tokenURL.path)
152
+ let primaryToken = "22222:abcdefghijklmnopqrstuvwxyzCD"
153
+ let secondaryToken = "33333:abcdefghijklmnopqrstuvwxyzEF"
154
+ let primary = TelegramPrivateFileStore(
155
+ homeDirectory: home,
156
+ environment: [
157
+ "TELEGRAM_BOT_TOKEN": primaryToken,
158
+ "SKS_TELEGRAM_BOT_TOKEN": secondaryToken
159
+ ]
160
+ )
161
+ let resolvedPrimaryToken = try primary.loadToken()
162
+ precondition(resolvedPrimaryToken == primaryToken, "primary token environment precedence failed")
163
+ let secondary = TelegramPrivateFileStore(
164
+ homeDirectory: home,
165
+ environment: [
166
+ "TELEGRAM_BOT_TOKEN": " ",
167
+ "SKS_TELEGRAM_BOT_TOKEN": secondaryToken
168
+ ]
169
+ )
170
+ let resolvedSecondaryToken = try secondary.loadToken()
171
+ precondition(resolvedSecondaryToken == secondaryToken, "secondary token environment fallback failed")
172
+ let fixedNow = Date(timeIntervalSince1970: 1_800_000_000)
173
+ let store = TelegramPrivateFileStore(
174
+ homeDirectory: home,
175
+ environment: [:],
176
+ now: { fixedNow }
177
+ )
178
+ let resolvedFileToken = try store.loadToken()
179
+ precondition(resolvedFileToken == fileToken, "private token file fallback failed")
180
+
181
+ let configuredRoot = directory.appendingPathComponent("configured-sks-home", isDirectory: true)
182
+ let configuredSecrets = configuredRoot.appendingPathComponent("secrets", isDirectory: true)
183
+ try FileManager.default.createDirectory(
184
+ at: configuredRoot,
185
+ withIntermediateDirectories: false,
186
+ attributes: [.posixPermissions: 0o755]
187
+ )
188
+ try FileManager.default.createDirectory(
189
+ at: configuredSecrets,
190
+ withIntermediateDirectories: false,
191
+ attributes: [.posixPermissions: 0o700]
192
+ )
193
+ try FileManager.default.setAttributes([.posixPermissions: 0o755], ofItemAtPath: configuredRoot.path)
194
+ try FileManager.default.setAttributes([.posixPermissions: 0o700], ofItemAtPath: configuredSecrets.path)
195
+ let configuredTokenURL = configuredSecrets.appendingPathComponent("telegram-bot-token")
196
+ try Data("\(secondaryToken)\n".utf8).write(to: configuredTokenURL)
197
+ try FileManager.default.setAttributes([.posixPermissions: 0o600], ofItemAtPath: configuredTokenURL.path)
198
+ let configured = TelegramPrivateFileStore(environment: ["SKS_HOME": configuredRoot.path])
199
+ let configuredToken = try configured.loadToken()
200
+ precondition(configuredToken == secondaryToken, "SKS_HOME root was not honored")
201
+ let factoryEquivalent = TelegramPrivateFileStore(
202
+ homeDirectory: home,
203
+ environment: ["SKS_HOME": configuredRoot.path]
204
+ )
205
+ let factoryEquivalentToken = try factoryEquivalent.loadToken()
206
+ precondition(
207
+ factoryEquivalentToken == secondaryToken,
208
+ "SKS_HOME root was ignored when the runtime factory supplied HOME"
209
+ )
210
+
211
+ let stateFixture = #"{"schema":"sks.telegram-state.v1","pairing":{"schema":"sks.telegram-pairing.v1","code":"123456-ABCD","expires_at":"2030-01-01T00:00:00.000Z","used":false,"future_pairing":"kept"},"chats":[],"confirmations":[],"future_root":{"kept":true}}"#
212
+ try Data("\(stateFixture)\n".utf8).write(to: stateURL)
213
+ try FileManager.default.setAttributes([.posixPermissions: 0o600], ofItemAtPath: stateURL.path)
214
+ let paired = try store.consumePairing(code: "123456-ABCD", chatID: 10, senderID: 20, chatType: "private")
215
+ precondition(paired, "pairing consume failed")
216
+ let authorized = try store.isAuthorized(chatID: 10, senderID: 20)
217
+ precondition(authorized, "paired chat was not persisted")
218
+ let reusedPairing = try store.consumePairing(code: "123456-ABCD", chatID: 11, senderID: 21, chatType: "private")
219
+ precondition(!reusedPairing, "pairing code was reusable")
220
+
221
+ let request = TelegramTypedCommandRequest(name: "gates", inputJSON: #"{"target":"affected"}"#)
222
+ let nonce = try store.issueConfirmation(
223
+ chatID: 10,
224
+ senderID: 20,
225
+ request: request,
226
+ expiresAt: fixedNow.addingTimeInterval(120)
227
+ )
228
+ let reopened = TelegramPrivateFileStore(homeDirectory: home, environment: [:], now: { fixedNow })
229
+ let wrongActor = try reopened.consumeConfirmation(nonce: nonce, chatID: 10, senderID: 21)
230
+ precondition(wrongActor == nil, "confirmation was not actor-bound")
231
+ let consumed = try reopened.consumeConfirmation(nonce: nonce, chatID: 10, senderID: 20)
232
+ precondition(consumed?.request == request, "persisted confirmation did not round-trip")
233
+ let reusedConfirmation = try reopened.consumeConfirmation(nonce: nonce, chatID: 10, senderID: 20)
234
+ precondition(reusedConfirmation == nil, "confirmation was reusable")
235
+
236
+ let rawState = try Data(contentsOf: stateURL)
237
+ let root = try JSONSerialization.jsonObject(with: rawState) as? [String: Any]
238
+ let pairing = root?["pairing"] as? [String: Any]
239
+ let chats = root?["chats"] as? [[String: Any]]
240
+ let confirmations = root?["confirmations"] as? [[String: Any]]
241
+ precondition(root?["schema"] as? String == "sks.telegram-state.v1")
242
+ precondition(pairing?["schema"] as? String == "sks.telegram-pairing.v1")
243
+ precondition(pairing?["used"] as? Bool == true)
244
+ precondition(pairing?["future_pairing"] as? String == "kept")
245
+ precondition((root?["future_root"] as? [String: Any])?["kept"] as? Bool == true)
246
+ precondition(chats?.count == 1 && confirmations?.isEmpty == true)
247
+ let stateMode = try FileManager.default.attributesOfItem(atPath: stateURL.path)[.posixPermissions] as? NSNumber
248
+ precondition(stateMode?.intValue == 0o600, "state mode was not 0600")
249
+ let sksMode = try FileManager.default.attributesOfItem(atPath: sks.path)[.posixPermissions] as? NSNumber
250
+ precondition(sksMode?.intValue == 0o755, "shared SKS root mode was mutated")
251
+ for privateDirectory in [secrets, stateDirectory] {
252
+ let mode = try FileManager.default.attributesOfItem(atPath: privateDirectory.path)[.posixPermissions] as? NSNumber
253
+ precondition(mode?.intValue == 0o700, "private directory mode was not 0700")
254
+ }
255
+
256
+ let decoy = home.appendingPathComponent("decoy-token")
257
+ try Data("\(fileToken)\n".utf8).write(to: decoy)
258
+ try FileManager.default.setAttributes([.posixPermissions: 0o600], ofItemAtPath: decoy.path)
259
+ try FileManager.default.removeItem(at: tokenURL)
260
+ try FileManager.default.createSymbolicLink(at: tokenURL, withDestinationURL: decoy)
261
+ do {
262
+ _ = try store.loadToken()
263
+ preconditionFailure("token symlink was accepted")
264
+ } catch TelegramPrivateFileError.insecurePath { }
265
+ }
266
+ }
267
+ #endif
@@ -0,0 +1,222 @@
1
+ #if canImport(XCTest)
2
+ import Foundation
3
+ import XCTest
4
+
5
+ private final class TelegramFakeAccess: TelegramAccessStoring, @unchecked Sendable {
6
+ private struct Pending {
7
+ let chatID: Int64
8
+ let senderID: Int64
9
+ let request: TelegramTypedCommandRequest
10
+ let expiresAt: Date
11
+ }
12
+
13
+ var authorizedActors: Set<String> = []
14
+ var pairedCode = "123456-ABCD"
15
+ private var confirmations: [String: Pending] = [:]
16
+
17
+ func loadToken() throws -> String? { "123456:abcdefghijklmnopqrstuvwxyzABCDE" }
18
+ func consumePairing(code: String, chatID: Int64, senderID: Int64, chatType: String) throws -> Bool {
19
+ guard code == pairedCode, chatType == "private" else { return false }
20
+ authorizedActors.insert("\(chatID):\(senderID)")
21
+ pairedCode = ""
22
+ return true
23
+ }
24
+ func isAuthorized(chatID: Int64, senderID: Int64) throws -> Bool {
25
+ authorizedActors.contains("\(chatID):\(senderID)")
26
+ }
27
+ func authorizedCount() throws -> Int { authorizedActors.count }
28
+ func issueConfirmation(
29
+ chatID: Int64,
30
+ senderID: Int64,
31
+ request: TelegramTypedCommandRequest,
32
+ expiresAt: Date
33
+ ) throws -> String {
34
+ let nonce = UUID().uuidString.replacingOccurrences(of: "-", with: "")
35
+ confirmations[nonce] = Pending(
36
+ chatID: chatID,
37
+ senderID: senderID,
38
+ request: request,
39
+ expiresAt: expiresAt
40
+ )
41
+ return nonce
42
+ }
43
+ func consumeConfirmation(
44
+ nonce: String,
45
+ chatID: Int64,
46
+ senderID: Int64
47
+ ) throws -> TelegramStoredConfirmation? {
48
+ guard let pending = confirmations[nonce],
49
+ pending.chatID == chatID,
50
+ pending.senderID == senderID,
51
+ pending.expiresAt > Date() else { return nil }
52
+ confirmations.removeValue(forKey: nonce)
53
+ return TelegramStoredConfirmation(request: pending.request)
54
+ }
55
+ }
56
+
57
+ private actor TelegramFakeAPI: TelegramBotAPI {
58
+ var pending: [TelegramNativeUpdate] = []
59
+ var offsets: [Int64] = []
60
+ var sent: [(Int64, String)] = []
61
+
62
+ func getMe(token: String) async throws -> TelegramNativeUser {
63
+ TelegramNativeUser(id: 1, is_bot: true, first_name: "SKS")
64
+ }
65
+ func getUpdates(token: String, offset: Int64, timeoutSeconds: Int) async throws -> [TelegramNativeUpdate] {
66
+ offsets.append(offset)
67
+ if pending.isEmpty {
68
+ try await Task.sleep(nanoseconds: 10_000_000)
69
+ return []
70
+ }
71
+ let result = pending
72
+ pending = []
73
+ return result
74
+ }
75
+ func sendMessage(token: String, chatID: Int64, text: String) async throws { sent.append((chatID, text)) }
76
+ func enqueue(_ updates: [TelegramNativeUpdate]) { pending.append(contentsOf: updates) }
77
+ func messages() -> [(Int64, String)] { sent }
78
+ func observedOffsets() -> [Int64] { offsets }
79
+ }
80
+
81
+ private actor TelegramFakeGateway: TelegramTypedCommandGateway {
82
+ var executions: [TelegramTypedCommandRequest] = []
83
+ func prepare(_ request: TelegramTypedCommandRequest) async -> TelegramTypedCommandDecision {
84
+ TelegramTypedCommandDecision(allowed: true, confirmationRequired: request.name == "gates", publicError: nil)
85
+ }
86
+ func execute(_ request: TelegramTypedCommandRequest) async throws -> String {
87
+ executions.append(request)
88
+ return "ok"
89
+ }
90
+ func executionCount() -> Int { executions.count }
91
+ }
92
+
93
+ final class TelegramRuntimeTests: XCTestCase {
94
+ func testProcessGatewayUsesOnlyFixedArgvAndBoundedJSONStdin() async throws {
95
+ final class Capture: @unchecked Sendable {
96
+ var calls: [([String], String)] = []
97
+ }
98
+ let capture = Capture()
99
+ let gateway = TelegramProcessCommandGateway { arguments, stdin, _, completion in
100
+ capture.calls.append((arguments, stdin))
101
+ let output = arguments.contains("prepare")
102
+ ? #"{"allowed":true,"confirmation_required":false,"public_error":null}"#
103
+ : #"{"ok":true,"output":{"status":"ready"}}"#
104
+ completion(ProcessResult(code: 0, output: output, truncated: false, timedOut: false, emptyOutput: false))
105
+ }
106
+ let request = TelegramTypedCommandRequest(name: "status", inputJSON: #"{"json":true}"#)
107
+ XCTAssertTrue(await gateway.prepare(request).allowed)
108
+ XCTAssertTrue(try await gateway.execute(request).contains(#""status""#))
109
+ XCTAssertEqual(capture.calls[0].0, ["telegram", "prepare", "--stdin-json", "--json"])
110
+ XCTAssertEqual(capture.calls[1].0, ["telegram", "execute", "--stdin-json", "--confirmed", "--json"])
111
+ XCTAssertFalse(capture.calls.map(\.0).joined().contains("status"))
112
+ XCTAssertTrue(capture.calls.allSatisfy { $0.1.contains(#""name":"status""#) })
113
+ }
114
+
115
+ func testSinglePollerUsesMonotonicCheckpointAndStopsCleanly() async throws {
116
+ let directory = FileManager.default.temporaryDirectory.appendingPathComponent("sks-telegram-\(UUID().uuidString)")
117
+ defer { try? FileManager.default.removeItem(at: directory) }
118
+ let api = TelegramFakeAPI()
119
+ let access = TelegramFakeAccess()
120
+ access.authorizedActors = ["10:20"]
121
+ let gateway = TelegramFakeGateway()
122
+ await api.enqueue([
123
+ update(id: 8, chat: 10, sender: 20, text: "/sks status {}"),
124
+ update(id: 7, chat: 10, sender: 20, text: "/sks status {}")
125
+ ])
126
+ let runtime = TelegramMenuBarRuntime(
127
+ api: api, access: access, gateway: gateway,
128
+ receiptURL: directory.appendingPathComponent("liveness.json"), audit: { _ in }
129
+ )
130
+ _ = try await runtime.start()
131
+ do {
132
+ _ = try await runtime.start()
133
+ XCTFail("a second resident poller must be rejected")
134
+ } catch { }
135
+ try await Task.sleep(nanoseconds: 100_000_000)
136
+ await runtime.stop()
137
+ XCTAssertEqual(await gateway.executionCount(), 2)
138
+ XCTAssertTrue(await api.observedOffsets().contains(9))
139
+ let receipt = TelegramLivenessWriter(url: directory.appendingPathComponent("liveness.json")).read()
140
+ XCTAssertEqual(receipt?.poller.offset, 9)
141
+ XCTAssertEqual(receipt?.running, false)
142
+ }
143
+
144
+ func testUnauthorizedChatIsSilentAndDestructiveConfirmationIsActorBound() async throws {
145
+ let directory = FileManager.default.temporaryDirectory.appendingPathComponent("sks-telegram-\(UUID().uuidString)")
146
+ defer { try? FileManager.default.removeItem(at: directory) }
147
+ let api = TelegramFakeAPI()
148
+ let access = TelegramFakeAccess()
149
+ access.authorizedActors = ["10:20", "10:21"]
150
+ let gateway = TelegramFakeGateway()
151
+ await api.enqueue([
152
+ update(id: 1, chat: 99, sender: 99, text: "/sks status {}"),
153
+ update(id: 2, chat: 10, sender: 20, text: "/sks gates {}")
154
+ ])
155
+ let runtime = TelegramMenuBarRuntime(
156
+ api: api, access: access, gateway: gateway,
157
+ receiptURL: directory.appendingPathComponent("liveness.json"), audit: { _ in }
158
+ )
159
+ _ = try await runtime.start()
160
+ try await Task.sleep(nanoseconds: 100_000_000)
161
+ let confirmation = try XCTUnwrap(await api.messages().first(where: { $0.0 == 10 })?.1)
162
+ let nonce = try XCTUnwrap(confirmation.split(separator: " ").dropFirst(4).first.map(String.init))
163
+ await api.enqueue([
164
+ update(id: 3, chat: 10, sender: 21, text: "/confirm \(nonce)"),
165
+ update(id: 4, chat: 10, sender: 20, text: "/confirm \(nonce)")
166
+ ])
167
+ try await Task.sleep(nanoseconds: 100_000_000)
168
+ await runtime.stop()
169
+ XCTAssertEqual(await gateway.executionCount(), 1)
170
+ XCTAssertFalse(await api.messages().contains(where: { $0.0 == 99 }))
171
+ }
172
+
173
+ func testAuditFailurePreventsPollerStartAndPersistsBlocker() async throws {
174
+ enum AuditError: Error { case unavailable }
175
+ let directory = FileManager.default.temporaryDirectory.appendingPathComponent("sks-telegram-\(UUID().uuidString)")
176
+ defer { try? FileManager.default.removeItem(at: directory) }
177
+ let receiptURL = directory.appendingPathComponent("liveness.json")
178
+ let gateway = TelegramFakeGateway()
179
+ let runtime = TelegramMenuBarRuntime(
180
+ api: TelegramFakeAPI(), access: TelegramFakeAccess(), gateway: gateway,
181
+ receiptURL: receiptURL, audit: { _ in throw AuditError.unavailable }
182
+ )
183
+ do {
184
+ _ = try await runtime.start()
185
+ XCTFail("audit failure must prevent poller start")
186
+ } catch TelegramTransportError.auditUnavailable { }
187
+ let receipt = try XCTUnwrap(TelegramLivenessWriter(url: receiptURL).read())
188
+ XCTAssertFalse(receipt.running)
189
+ XCTAssertFalse(receipt.poller.running)
190
+ XCTAssertEqual(receipt.audit_healthy, false)
191
+ XCTAssertEqual(receipt.audit_last_error, "telegram_audit_unavailable")
192
+ XCTAssertEqual(telegramSelfHealAction(receipt), .operatorRepairAudit)
193
+ XCTAssertEqual(await gateway.executionCount(), 0)
194
+ }
195
+
196
+ func testMenuBarServiceBoundedStopPersistsStoppedReceipt() async throws {
197
+ let directory = FileManager.default.temporaryDirectory.appendingPathComponent("sks-telegram-\(UUID().uuidString)")
198
+ defer { try? FileManager.default.removeItem(at: directory) }
199
+ let receiptURL = directory.appendingPathComponent("liveness.json")
200
+ let runtime = TelegramMenuBarRuntime(
201
+ api: TelegramFakeAPI(), access: TelegramFakeAccess(), gateway: TelegramFakeGateway(),
202
+ receiptURL: receiptURL, audit: { _ in }
203
+ )
204
+ let service = TelegramMenuBarService(runtime: runtime)
205
+ _ = try await service.start().value
206
+ XCTAssertTrue(service.stopAndWait(timeout: 2))
207
+ let receipt = try XCTUnwrap(TelegramLivenessWriter(url: receiptURL).read())
208
+ XCTAssertFalse(receipt.running)
209
+ XCTAssertFalse(receipt.poller.running)
210
+ }
211
+ }
212
+
213
+ private func update(id: Int64, chat: Int64, sender: Int64, text: String) -> TelegramNativeUpdate {
214
+ TelegramNativeUpdate(
215
+ update_id: id,
216
+ message: TelegramNativeMessage(
217
+ message_id: id, date: 1, chat: TelegramNativeChat(id: chat, type: "private"),
218
+ from: TelegramNativeUser(id: sender, is_bot: false, first_name: "Operator"), text: text
219
+ )
220
+ )
221
+ }
222
+ #endif