spurline-core 0.3.0

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 (127) hide show
  1. checksums.yaml +7 -0
  2. data/LICENSE +21 -0
  3. data/README.md +177 -0
  4. data/exe/spur +6 -0
  5. data/lib/CLAUDE.md +11 -0
  6. data/lib/spurline/CLAUDE.md +16 -0
  7. data/lib/spurline/adapters/CLAUDE.md +12 -0
  8. data/lib/spurline/adapters/base.rb +17 -0
  9. data/lib/spurline/adapters/claude.rb +208 -0
  10. data/lib/spurline/adapters/open_ai.rb +213 -0
  11. data/lib/spurline/adapters/registry.rb +33 -0
  12. data/lib/spurline/adapters/scheduler/base.rb +15 -0
  13. data/lib/spurline/adapters/scheduler/sync.rb +15 -0
  14. data/lib/spurline/adapters/stub_adapter.rb +54 -0
  15. data/lib/spurline/agent.rb +433 -0
  16. data/lib/spurline/audit/log.rb +156 -0
  17. data/lib/spurline/audit/secret_filter.rb +121 -0
  18. data/lib/spurline/base.rb +130 -0
  19. data/lib/spurline/cartographer/CLAUDE.md +12 -0
  20. data/lib/spurline/cartographer/analyzer.rb +71 -0
  21. data/lib/spurline/cartographer/analyzers/CLAUDE.md +12 -0
  22. data/lib/spurline/cartographer/analyzers/ci_config.rb +171 -0
  23. data/lib/spurline/cartographer/analyzers/dotfiles.rb +134 -0
  24. data/lib/spurline/cartographer/analyzers/entry_points.rb +145 -0
  25. data/lib/spurline/cartographer/analyzers/file_signatures.rb +55 -0
  26. data/lib/spurline/cartographer/analyzers/manifests.rb +217 -0
  27. data/lib/spurline/cartographer/analyzers/security_scan.rb +223 -0
  28. data/lib/spurline/cartographer/repo_profile.rb +140 -0
  29. data/lib/spurline/cartographer/runner.rb +88 -0
  30. data/lib/spurline/cartographer.rb +6 -0
  31. data/lib/spurline/channels/base.rb +41 -0
  32. data/lib/spurline/channels/event.rb +136 -0
  33. data/lib/spurline/channels/github.rb +205 -0
  34. data/lib/spurline/channels/router.rb +103 -0
  35. data/lib/spurline/cli/check.rb +88 -0
  36. data/lib/spurline/cli/checks/CLAUDE.md +11 -0
  37. data/lib/spurline/cli/checks/adapter_resolution.rb +81 -0
  38. data/lib/spurline/cli/checks/agent_loadability.rb +41 -0
  39. data/lib/spurline/cli/checks/base.rb +35 -0
  40. data/lib/spurline/cli/checks/credentials.rb +43 -0
  41. data/lib/spurline/cli/checks/permissions.rb +22 -0
  42. data/lib/spurline/cli/checks/project_structure.rb +48 -0
  43. data/lib/spurline/cli/checks/session_store.rb +97 -0
  44. data/lib/spurline/cli/console.rb +73 -0
  45. data/lib/spurline/cli/credentials.rb +181 -0
  46. data/lib/spurline/cli/generators/CLAUDE.md +11 -0
  47. data/lib/spurline/cli/generators/agent.rb +123 -0
  48. data/lib/spurline/cli/generators/migration.rb +62 -0
  49. data/lib/spurline/cli/generators/project.rb +331 -0
  50. data/lib/spurline/cli/generators/tool.rb +98 -0
  51. data/lib/spurline/cli/router.rb +121 -0
  52. data/lib/spurline/configuration.rb +23 -0
  53. data/lib/spurline/dsl/CLAUDE.md +11 -0
  54. data/lib/spurline/dsl/guardrails.rb +108 -0
  55. data/lib/spurline/dsl/hooks.rb +51 -0
  56. data/lib/spurline/dsl/memory.rb +39 -0
  57. data/lib/spurline/dsl/model.rb +23 -0
  58. data/lib/spurline/dsl/persona.rb +74 -0
  59. data/lib/spurline/dsl/suspend_until.rb +53 -0
  60. data/lib/spurline/dsl/tools.rb +176 -0
  61. data/lib/spurline/errors.rb +109 -0
  62. data/lib/spurline/lifecycle/CLAUDE.md +18 -0
  63. data/lib/spurline/lifecycle/deterministic_runner.rb +207 -0
  64. data/lib/spurline/lifecycle/runner.rb +456 -0
  65. data/lib/spurline/lifecycle/states.rb +47 -0
  66. data/lib/spurline/lifecycle/suspension_boundary.rb +82 -0
  67. data/lib/spurline/memory/CLAUDE.md +12 -0
  68. data/lib/spurline/memory/context_assembler.rb +100 -0
  69. data/lib/spurline/memory/embedder/CLAUDE.md +11 -0
  70. data/lib/spurline/memory/embedder/base.rb +17 -0
  71. data/lib/spurline/memory/embedder/open_ai.rb +70 -0
  72. data/lib/spurline/memory/episode.rb +56 -0
  73. data/lib/spurline/memory/episodic_store.rb +147 -0
  74. data/lib/spurline/memory/long_term/CLAUDE.md +11 -0
  75. data/lib/spurline/memory/long_term/base.rb +22 -0
  76. data/lib/spurline/memory/long_term/postgres.rb +106 -0
  77. data/lib/spurline/memory/manager.rb +147 -0
  78. data/lib/spurline/memory/short_term.rb +57 -0
  79. data/lib/spurline/orchestration/agent_spawner.rb +151 -0
  80. data/lib/spurline/orchestration/judge.rb +109 -0
  81. data/lib/spurline/orchestration/ledger/store/base.rb +28 -0
  82. data/lib/spurline/orchestration/ledger/store/memory.rb +50 -0
  83. data/lib/spurline/orchestration/ledger.rb +339 -0
  84. data/lib/spurline/orchestration/merge_queue.rb +133 -0
  85. data/lib/spurline/orchestration/permission_intersection.rb +151 -0
  86. data/lib/spurline/orchestration/task_envelope.rb +201 -0
  87. data/lib/spurline/persona/base.rb +42 -0
  88. data/lib/spurline/persona/registry.rb +42 -0
  89. data/lib/spurline/secrets/resolver.rb +65 -0
  90. data/lib/spurline/secrets/vault.rb +42 -0
  91. data/lib/spurline/security/content.rb +76 -0
  92. data/lib/spurline/security/context_pipeline.rb +58 -0
  93. data/lib/spurline/security/gates/base.rb +36 -0
  94. data/lib/spurline/security/gates/operator_config.rb +22 -0
  95. data/lib/spurline/security/gates/system_prompt.rb +23 -0
  96. data/lib/spurline/security/gates/tool_result.rb +23 -0
  97. data/lib/spurline/security/gates/user_input.rb +22 -0
  98. data/lib/spurline/security/injection_scanner.rb +109 -0
  99. data/lib/spurline/security/pii_filter.rb +104 -0
  100. data/lib/spurline/session/CLAUDE.md +11 -0
  101. data/lib/spurline/session/resumption.rb +36 -0
  102. data/lib/spurline/session/serializer.rb +169 -0
  103. data/lib/spurline/session/session.rb +154 -0
  104. data/lib/spurline/session/store/CLAUDE.md +12 -0
  105. data/lib/spurline/session/store/base.rb +27 -0
  106. data/lib/spurline/session/store/memory.rb +45 -0
  107. data/lib/spurline/session/store/postgres.rb +123 -0
  108. data/lib/spurline/session/store/sqlite.rb +139 -0
  109. data/lib/spurline/session/suspension.rb +93 -0
  110. data/lib/spurline/session/turn.rb +98 -0
  111. data/lib/spurline/spur.rb +213 -0
  112. data/lib/spurline/streaming/CLAUDE.md +12 -0
  113. data/lib/spurline/streaming/buffer.rb +77 -0
  114. data/lib/spurline/streaming/chunk.rb +62 -0
  115. data/lib/spurline/streaming/stream_enumerator.rb +29 -0
  116. data/lib/spurline/testing.rb +245 -0
  117. data/lib/spurline/toolkit.rb +110 -0
  118. data/lib/spurline/tools/base.rb +209 -0
  119. data/lib/spurline/tools/idempotency.rb +220 -0
  120. data/lib/spurline/tools/permissions.rb +44 -0
  121. data/lib/spurline/tools/registry.rb +43 -0
  122. data/lib/spurline/tools/runner.rb +255 -0
  123. data/lib/spurline/tools/scope.rb +309 -0
  124. data/lib/spurline/tools/toolkit_registry.rb +63 -0
  125. data/lib/spurline/version.rb +5 -0
  126. data/lib/spurline.rb +56 -0
  127. metadata +333 -0
metadata ADDED
@@ -0,0 +1,333 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: spurline-core
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.3.0
5
+ platform: ruby
6
+ authors:
7
+ - Dylan Wilcox
8
+ bindir: exe
9
+ cert_chain: []
10
+ date: 1980-01-02 00:00:00.000000000 Z
11
+ dependencies:
12
+ - !ruby/object:Gem::Dependency
13
+ name: anthropic
14
+ requirement: !ruby/object:Gem::Requirement
15
+ requirements:
16
+ - - "~>"
17
+ - !ruby/object:Gem::Version
18
+ version: '1.0'
19
+ type: :runtime
20
+ prerelease: false
21
+ version_requirements: !ruby/object:Gem::Requirement
22
+ requirements:
23
+ - - "~>"
24
+ - !ruby/object:Gem::Version
25
+ version: '1.0'
26
+ - !ruby/object:Gem::Dependency
27
+ name: base64
28
+ requirement: !ruby/object:Gem::Requirement
29
+ requirements:
30
+ - - ">="
31
+ - !ruby/object:Gem::Version
32
+ version: '0'
33
+ type: :runtime
34
+ prerelease: false
35
+ version_requirements: !ruby/object:Gem::Requirement
36
+ requirements:
37
+ - - ">="
38
+ - !ruby/object:Gem::Version
39
+ version: '0'
40
+ - !ruby/object:Gem::Dependency
41
+ name: zeitwerk
42
+ requirement: !ruby/object:Gem::Requirement
43
+ requirements:
44
+ - - "~>"
45
+ - !ruby/object:Gem::Version
46
+ version: '2.6'
47
+ type: :runtime
48
+ prerelease: false
49
+ version_requirements: !ruby/object:Gem::Requirement
50
+ requirements:
51
+ - - "~>"
52
+ - !ruby/object:Gem::Version
53
+ version: '2.6'
54
+ - !ruby/object:Gem::Dependency
55
+ name: dry-configurable
56
+ requirement: !ruby/object:Gem::Requirement
57
+ requirements:
58
+ - - "~>"
59
+ - !ruby/object:Gem::Version
60
+ version: '1.0'
61
+ type: :runtime
62
+ prerelease: false
63
+ version_requirements: !ruby/object:Gem::Requirement
64
+ requirements:
65
+ - - "~>"
66
+ - !ruby/object:Gem::Version
67
+ version: '1.0'
68
+ - !ruby/object:Gem::Dependency
69
+ name: irb
70
+ requirement: !ruby/object:Gem::Requirement
71
+ requirements:
72
+ - - ">="
73
+ - !ruby/object:Gem::Version
74
+ version: '0'
75
+ type: :runtime
76
+ prerelease: false
77
+ version_requirements: !ruby/object:Gem::Requirement
78
+ requirements:
79
+ - - ">="
80
+ - !ruby/object:Gem::Version
81
+ version: '0'
82
+ - !ruby/object:Gem::Dependency
83
+ name: reline
84
+ requirement: !ruby/object:Gem::Requirement
85
+ requirements:
86
+ - - ">="
87
+ - !ruby/object:Gem::Version
88
+ version: '0'
89
+ type: :runtime
90
+ prerelease: false
91
+ version_requirements: !ruby/object:Gem::Requirement
92
+ requirements:
93
+ - - ">="
94
+ - !ruby/object:Gem::Version
95
+ version: '0'
96
+ - !ruby/object:Gem::Dependency
97
+ name: rdoc
98
+ requirement: !ruby/object:Gem::Requirement
99
+ requirements:
100
+ - - ">="
101
+ - !ruby/object:Gem::Version
102
+ version: '0'
103
+ type: :runtime
104
+ prerelease: false
105
+ version_requirements: !ruby/object:Gem::Requirement
106
+ requirements:
107
+ - - ">="
108
+ - !ruby/object:Gem::Version
109
+ version: '0'
110
+ - !ruby/object:Gem::Dependency
111
+ name: sqlite3
112
+ requirement: !ruby/object:Gem::Requirement
113
+ requirements:
114
+ - - "~>"
115
+ - !ruby/object:Gem::Version
116
+ version: '2.0'
117
+ type: :runtime
118
+ prerelease: false
119
+ version_requirements: !ruby/object:Gem::Requirement
120
+ requirements:
121
+ - - "~>"
122
+ - !ruby/object:Gem::Version
123
+ version: '2.0'
124
+ - !ruby/object:Gem::Dependency
125
+ name: rspec
126
+ requirement: !ruby/object:Gem::Requirement
127
+ requirements:
128
+ - - "~>"
129
+ - !ruby/object:Gem::Version
130
+ version: '3.12'
131
+ type: :development
132
+ prerelease: false
133
+ version_requirements: !ruby/object:Gem::Requirement
134
+ requirements:
135
+ - - "~>"
136
+ - !ruby/object:Gem::Version
137
+ version: '3.12'
138
+ - !ruby/object:Gem::Dependency
139
+ name: pg
140
+ requirement: !ruby/object:Gem::Requirement
141
+ requirements:
142
+ - - "~>"
143
+ - !ruby/object:Gem::Version
144
+ version: '1.5'
145
+ type: :development
146
+ prerelease: false
147
+ version_requirements: !ruby/object:Gem::Requirement
148
+ requirements:
149
+ - - "~>"
150
+ - !ruby/object:Gem::Version
151
+ version: '1.5'
152
+ - !ruby/object:Gem::Dependency
153
+ name: webmock
154
+ requirement: !ruby/object:Gem::Requirement
155
+ requirements:
156
+ - - "~>"
157
+ - !ruby/object:Gem::Version
158
+ version: '3.18'
159
+ type: :development
160
+ prerelease: false
161
+ version_requirements: !ruby/object:Gem::Requirement
162
+ requirements:
163
+ - - "~>"
164
+ - !ruby/object:Gem::Version
165
+ version: '3.18'
166
+ - !ruby/object:Gem::Dependency
167
+ name: vcr
168
+ requirement: !ruby/object:Gem::Requirement
169
+ requirements:
170
+ - - "~>"
171
+ - !ruby/object:Gem::Version
172
+ version: '6.2'
173
+ type: :development
174
+ prerelease: false
175
+ version_requirements: !ruby/object:Gem::Requirement
176
+ requirements:
177
+ - - "~>"
178
+ - !ruby/object:Gem::Version
179
+ version: '6.2'
180
+ description: Spurline is to AI agents what Rails is to web applications — opinionated,
181
+ convention-driven, and designed so that the right thing is the easy thing.
182
+ executables:
183
+ - spur
184
+ extensions: []
185
+ extra_rdoc_files: []
186
+ files:
187
+ - LICENSE
188
+ - README.md
189
+ - exe/spur
190
+ - lib/CLAUDE.md
191
+ - lib/spurline.rb
192
+ - lib/spurline/CLAUDE.md
193
+ - lib/spurline/adapters/CLAUDE.md
194
+ - lib/spurline/adapters/base.rb
195
+ - lib/spurline/adapters/claude.rb
196
+ - lib/spurline/adapters/open_ai.rb
197
+ - lib/spurline/adapters/registry.rb
198
+ - lib/spurline/adapters/scheduler/base.rb
199
+ - lib/spurline/adapters/scheduler/sync.rb
200
+ - lib/spurline/adapters/stub_adapter.rb
201
+ - lib/spurline/agent.rb
202
+ - lib/spurline/audit/log.rb
203
+ - lib/spurline/audit/secret_filter.rb
204
+ - lib/spurline/base.rb
205
+ - lib/spurline/cartographer.rb
206
+ - lib/spurline/cartographer/CLAUDE.md
207
+ - lib/spurline/cartographer/analyzer.rb
208
+ - lib/spurline/cartographer/analyzers/CLAUDE.md
209
+ - lib/spurline/cartographer/analyzers/ci_config.rb
210
+ - lib/spurline/cartographer/analyzers/dotfiles.rb
211
+ - lib/spurline/cartographer/analyzers/entry_points.rb
212
+ - lib/spurline/cartographer/analyzers/file_signatures.rb
213
+ - lib/spurline/cartographer/analyzers/manifests.rb
214
+ - lib/spurline/cartographer/analyzers/security_scan.rb
215
+ - lib/spurline/cartographer/repo_profile.rb
216
+ - lib/spurline/cartographer/runner.rb
217
+ - lib/spurline/channels/base.rb
218
+ - lib/spurline/channels/event.rb
219
+ - lib/spurline/channels/github.rb
220
+ - lib/spurline/channels/router.rb
221
+ - lib/spurline/cli/check.rb
222
+ - lib/spurline/cli/checks/CLAUDE.md
223
+ - lib/spurline/cli/checks/adapter_resolution.rb
224
+ - lib/spurline/cli/checks/agent_loadability.rb
225
+ - lib/spurline/cli/checks/base.rb
226
+ - lib/spurline/cli/checks/credentials.rb
227
+ - lib/spurline/cli/checks/permissions.rb
228
+ - lib/spurline/cli/checks/project_structure.rb
229
+ - lib/spurline/cli/checks/session_store.rb
230
+ - lib/spurline/cli/console.rb
231
+ - lib/spurline/cli/credentials.rb
232
+ - lib/spurline/cli/generators/CLAUDE.md
233
+ - lib/spurline/cli/generators/agent.rb
234
+ - lib/spurline/cli/generators/migration.rb
235
+ - lib/spurline/cli/generators/project.rb
236
+ - lib/spurline/cli/generators/tool.rb
237
+ - lib/spurline/cli/router.rb
238
+ - lib/spurline/configuration.rb
239
+ - lib/spurline/dsl/CLAUDE.md
240
+ - lib/spurline/dsl/guardrails.rb
241
+ - lib/spurline/dsl/hooks.rb
242
+ - lib/spurline/dsl/memory.rb
243
+ - lib/spurline/dsl/model.rb
244
+ - lib/spurline/dsl/persona.rb
245
+ - lib/spurline/dsl/suspend_until.rb
246
+ - lib/spurline/dsl/tools.rb
247
+ - lib/spurline/errors.rb
248
+ - lib/spurline/lifecycle/CLAUDE.md
249
+ - lib/spurline/lifecycle/deterministic_runner.rb
250
+ - lib/spurline/lifecycle/runner.rb
251
+ - lib/spurline/lifecycle/states.rb
252
+ - lib/spurline/lifecycle/suspension_boundary.rb
253
+ - lib/spurline/memory/CLAUDE.md
254
+ - lib/spurline/memory/context_assembler.rb
255
+ - lib/spurline/memory/embedder/CLAUDE.md
256
+ - lib/spurline/memory/embedder/base.rb
257
+ - lib/spurline/memory/embedder/open_ai.rb
258
+ - lib/spurline/memory/episode.rb
259
+ - lib/spurline/memory/episodic_store.rb
260
+ - lib/spurline/memory/long_term/CLAUDE.md
261
+ - lib/spurline/memory/long_term/base.rb
262
+ - lib/spurline/memory/long_term/postgres.rb
263
+ - lib/spurline/memory/manager.rb
264
+ - lib/spurline/memory/short_term.rb
265
+ - lib/spurline/orchestration/agent_spawner.rb
266
+ - lib/spurline/orchestration/judge.rb
267
+ - lib/spurline/orchestration/ledger.rb
268
+ - lib/spurline/orchestration/ledger/store/base.rb
269
+ - lib/spurline/orchestration/ledger/store/memory.rb
270
+ - lib/spurline/orchestration/merge_queue.rb
271
+ - lib/spurline/orchestration/permission_intersection.rb
272
+ - lib/spurline/orchestration/task_envelope.rb
273
+ - lib/spurline/persona/base.rb
274
+ - lib/spurline/persona/registry.rb
275
+ - lib/spurline/secrets/resolver.rb
276
+ - lib/spurline/secrets/vault.rb
277
+ - lib/spurline/security/content.rb
278
+ - lib/spurline/security/context_pipeline.rb
279
+ - lib/spurline/security/gates/base.rb
280
+ - lib/spurline/security/gates/operator_config.rb
281
+ - lib/spurline/security/gates/system_prompt.rb
282
+ - lib/spurline/security/gates/tool_result.rb
283
+ - lib/spurline/security/gates/user_input.rb
284
+ - lib/spurline/security/injection_scanner.rb
285
+ - lib/spurline/security/pii_filter.rb
286
+ - lib/spurline/session/CLAUDE.md
287
+ - lib/spurline/session/resumption.rb
288
+ - lib/spurline/session/serializer.rb
289
+ - lib/spurline/session/session.rb
290
+ - lib/spurline/session/store/CLAUDE.md
291
+ - lib/spurline/session/store/base.rb
292
+ - lib/spurline/session/store/memory.rb
293
+ - lib/spurline/session/store/postgres.rb
294
+ - lib/spurline/session/store/sqlite.rb
295
+ - lib/spurline/session/suspension.rb
296
+ - lib/spurline/session/turn.rb
297
+ - lib/spurline/spur.rb
298
+ - lib/spurline/streaming/CLAUDE.md
299
+ - lib/spurline/streaming/buffer.rb
300
+ - lib/spurline/streaming/chunk.rb
301
+ - lib/spurline/streaming/stream_enumerator.rb
302
+ - lib/spurline/testing.rb
303
+ - lib/spurline/toolkit.rb
304
+ - lib/spurline/tools/base.rb
305
+ - lib/spurline/tools/idempotency.rb
306
+ - lib/spurline/tools/permissions.rb
307
+ - lib/spurline/tools/registry.rb
308
+ - lib/spurline/tools/runner.rb
309
+ - lib/spurline/tools/scope.rb
310
+ - lib/spurline/tools/toolkit_registry.rb
311
+ - lib/spurline/version.rb
312
+ homepage: https://github.com/dylanwilcox/spurline
313
+ licenses:
314
+ - MIT
315
+ metadata: {}
316
+ rdoc_options: []
317
+ require_paths:
318
+ - lib
319
+ required_ruby_version: !ruby/object:Gem::Requirement
320
+ requirements:
321
+ - - ">="
322
+ - !ruby/object:Gem::Version
323
+ version: 3.2.0
324
+ required_rubygems_version: !ruby/object:Gem::Requirement
325
+ requirements:
326
+ - - ">="
327
+ - !ruby/object:Gem::Version
328
+ version: '0'
329
+ requirements: []
330
+ rubygems_version: 3.6.9
331
+ specification_version: 4
332
+ summary: A Ruby framework for building production-grade AI agents
333
+ test_files: []