elelem-server 0.2.1 → 0.2.2
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.
- checksums.yaml +4 -4
- data/.agents/backlog/001-turn-spec-thread-leak.md +53 -0
- data/.agents/backlog/002-readme.md +41 -0
- data/.agents/backlog/003-gem-metadata-links.md +64 -0
- data/.github/workflows/release.yml +2 -0
- data/.release-please-manifest.json +1 -1
- data/CHANGELOG.md +7 -0
- data/lib/elelem/server/version.rb +1 -1
- metadata +8 -5
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 2e034b7cce93d7fa6df64974d28c0c9471d36e36bd623a26da72351ed4164815
|
|
4
|
+
data.tar.gz: c02b64737c2c5f7f50333463694a107dcbfe3c8b0a87038a3d720d119dc95aa9
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: f4ca00541121457b4c959fe5340e6824d628f796c8cd9c5ffdd7a37d42593ba20a183f6814c88835128ac0065085b27acff6aa257c2511e8c9295b76bb38c114
|
|
7
|
+
data.tar.gz: 1ad962496dc8b17c76dcc2ab1675cbdf59b9b38ef0a76b34a717400a012c67e0367409ed9c59c49388f0c1cae6088c54370b353f792839294e4736c7c50b4f39
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
As a `contributor running the elelem-server specs`, I `want each
|
|
2
|
+
example to finish its turn threads before the next one starts`, so
|
|
3
|
+
that `the output shows only real failures and the suite does not
|
|
4
|
+
depend on order`.
|
|
5
|
+
|
|
6
|
+
# SYNOPSIS
|
|
7
|
+
|
|
8
|
+
Join or kill the turn threads that turn_spec.rb starts.
|
|
9
|
+
|
|
10
|
+
# DESCRIPTION
|
|
11
|
+
|
|
12
|
+
`Server#message` starts each turn on a new thread:
|
|
13
|
+
`Thread.new { tab.run(text) }` (server.rb:153). In
|
|
14
|
+
spec/elelem/server/turn_spec.rb the session double's `turn` blocks on a
|
|
15
|
+
`gate` queue (turn_spec.rb:6, :12). Some examples end while a turn is
|
|
16
|
+
still waiting on the gate. The thread wakes later, during another
|
|
17
|
+
example, and calls the expired `double("session")`. Each run prints
|
|
18
|
+
about 19 traces like:
|
|
19
|
+
|
|
20
|
+
```
|
|
21
|
+
#<Thread:... server.rb:153 run> terminated with exception (report_on_exception is true):
|
|
22
|
+
... #<Double "session"> was originally created in one example but has leaked into another example and can no longer be used. (RSpec::Mocks::ExpiredTestDoubleError)
|
|
23
|
+
from lib/elelem/server/tab.rb:16 in 'Elelem::Server::Tab#terminal'
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
The specs still pass, but the noise hides real failures, and leaked
|
|
27
|
+
threads can change the result of later examples.
|
|
28
|
+
|
|
29
|
+
Options:
|
|
30
|
+
|
|
31
|
+
* Keep track of the threads `message` starts (for example a
|
|
32
|
+
`@turns` list on the server, which also helps shutdown), and join or
|
|
33
|
+
kill them in an `after` hook.
|
|
34
|
+
* Give the specs a way to wait for a turn to finish, and release every
|
|
35
|
+
waiting turn through the gate before each example ends.
|
|
36
|
+
|
|
37
|
+
# SEE ALSO
|
|
38
|
+
|
|
39
|
+
* [ ] lib/elelem/server.rb:146-155 - message starts the turn thread
|
|
40
|
+
* [ ] lib/elelem/server/tab.rb:16 - where the leaked thread fails
|
|
41
|
+
* [ ] spec/elelem/server/turn_spec.rb:6-12 - gate and session double
|
|
42
|
+
* [ ] spec/elelem/server/turn_spec.rb:73 - another Thread.new in specs
|
|
43
|
+
* [ ] Formerly elelem-sh/elelem.sh#54
|
|
44
|
+
|
|
45
|
+
# Tasks
|
|
46
|
+
|
|
47
|
+
* [ ] TBD (filled in design mode)
|
|
48
|
+
|
|
49
|
+
# Acceptance Criteria
|
|
50
|
+
|
|
51
|
+
* [ ] `bin/test` prints no "terminated with exception" lines
|
|
52
|
+
* [ ] No thread started by an example is alive after that example ends
|
|
53
|
+
* [ ] The suite passes with `--order rand` for several seeds
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
As a `person who wants to use elelem from a browser`, I `want a
|
|
2
|
+
README in the elelem-server repository`, so that `I can start the
|
|
3
|
+
server safely and know what it exposes`.
|
|
4
|
+
|
|
5
|
+
# SYNOPSIS
|
|
6
|
+
|
|
7
|
+
Add a short README.
|
|
8
|
+
|
|
9
|
+
# DESCRIPTION
|
|
10
|
+
|
|
11
|
+
The repository has no README. It should cover:
|
|
12
|
+
|
|
13
|
+
* Install and start: `elelem-server`, with `-p/--provider` (default
|
|
14
|
+
from `ELELEM_PROVIDER`, else `demo`), `--port` (default 4567) and
|
|
15
|
+
`--bind` (default 127.0.0.1).
|
|
16
|
+
* Security: the server runs an agent with whatever tools are loaded,
|
|
17
|
+
so binding to anything other than localhost exposes a shell to the
|
|
18
|
+
network. Say what the guard protects and what it does not
|
|
19
|
+
(lib/elelem/server.rb, spec/elelem/server/guard_spec.rb).
|
|
20
|
+
* Tabs: one conversation per browser tab, one turn at a time, and the
|
|
21
|
+
limit on open tabs.
|
|
22
|
+
* A link to https://elelem.sh/plugins/server/.
|
|
23
|
+
|
|
24
|
+
Show commands without a leading `$`.
|
|
25
|
+
|
|
26
|
+
# SEE ALSO
|
|
27
|
+
|
|
28
|
+
* [ ] exe/elelem-server - options and defaults
|
|
29
|
+
* [ ] lib/elelem/server.rb - routes, guard, tabs
|
|
30
|
+
* [ ] https://elelem.sh/plugins/server/
|
|
31
|
+
* [ ] Formerly elelem-sh/elelem.sh#23
|
|
32
|
+
|
|
33
|
+
# Tasks
|
|
34
|
+
|
|
35
|
+
* [ ] TBD (filled in design mode)
|
|
36
|
+
|
|
37
|
+
# Acceptance Criteria
|
|
38
|
+
|
|
39
|
+
* [ ] README.md exists and covers start options, security and tabs
|
|
40
|
+
* [ ] Defaults in the README match exe/elelem-server
|
|
41
|
+
* [ ] Commands have no leading `$`
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
As a `person who finds elelem-server on RubyGems`, I `want the
|
|
2
|
+
gem page to link to the plugin's documentation, backlog and
|
|
3
|
+
changelog`, so that `I can learn how to use it and see known
|
|
4
|
+
problems without GitHub Issues`.
|
|
5
|
+
|
|
6
|
+
# SYNOPSIS
|
|
7
|
+
|
|
8
|
+
Point the gemspec homepage at elelem.sh and add the standard links.
|
|
9
|
+
|
|
10
|
+
# DESCRIPTION
|
|
11
|
+
|
|
12
|
+
RubyGems shows `homepage_uri` and the other `metadata` links on every
|
|
13
|
+
gem page. Today `elelem-server.gemspec` sets `spec.homepage`
|
|
14
|
+
to the site root (https://elelem.sh) and sets only `homepage_uri`,
|
|
15
|
+
`source_code_uri`, `allowed_push_host` and
|
|
16
|
+
`rubygems_mfa_required`.
|
|
17
|
+
There is no documentation, bug tracker or changelog link.
|
|
18
|
+
|
|
19
|
+
Proposed change:
|
|
20
|
+
|
|
21
|
+
```ruby
|
|
22
|
+
spec.homepage = "https://elelem.sh/plugins/server/"
|
|
23
|
+
spec.metadata["homepage_uri"] = spec.homepage
|
|
24
|
+
spec.metadata["source_code_uri"] = "https://github.com/elelem-sh/server"
|
|
25
|
+
spec.metadata["documentation_uri"] = spec.homepage
|
|
26
|
+
spec.metadata["bug_tracker_uri"] = "https://github.com/elelem-sh/server/tree/main/.agents/backlog"
|
|
27
|
+
spec.metadata["changelog_uri"] = "https://github.com/elelem-sh/server/blob/main/CHANGELOG.md"
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
The original proposal pointed `bug_tracker_uri` at GitHub Issues on
|
|
31
|
+
elelem-sh/elelem.sh, filtered by label. That no longer fits: the
|
|
32
|
+
project is moving its backlog out of GitHub Issues and into
|
|
33
|
+
`.agents/backlog` story files in each repository, so the bug tracker
|
|
34
|
+
link points at this repository's backlog directory instead.
|
|
35
|
+
|
|
36
|
+
/man/server/ redirects to /plugins/server/ on elelem.sh, so a
|
|
37
|
+
separate documentation_uri adds nothing. Point both at the plugin page.
|
|
38
|
+
|
|
39
|
+
CHANGELOG.md exists on main, so the link works today.
|
|
40
|
+
|
|
41
|
+
Keep `allowed_push_host` and `rubygems_mfa_required` as they are.
|
|
42
|
+
RubyGems only shows the new links after the next release.
|
|
43
|
+
|
|
44
|
+
# SEE ALSO
|
|
45
|
+
|
|
46
|
+
* [ ] elelem-server.gemspec:13 - spec.homepage
|
|
47
|
+
* [ ] elelem-server.gemspec:18 - source_code_uri
|
|
48
|
+
* [ ] .agents/backlog/ - where bug_tracker_uri will point
|
|
49
|
+
* [ ] Formerly elelem-sh/elelem.sh#41
|
|
50
|
+
|
|
51
|
+
# Tasks
|
|
52
|
+
|
|
53
|
+
* [ ] TBD (filled in design mode)
|
|
54
|
+
|
|
55
|
+
# Acceptance Criteria
|
|
56
|
+
|
|
57
|
+
* [ ] `spec.homepage` and `homepage_uri` are https://elelem.sh/plugins/server/
|
|
58
|
+
* [ ] `bug_tracker_uri` points at this repository's `.agents/backlog`,
|
|
59
|
+
not at GitHub Issues
|
|
60
|
+
* [ ] `changelog_uri` and `source_code_uri` point at this repository
|
|
61
|
+
* [ ] `allowed_push_host` and `rubygems_mfa_required` are unchanged
|
|
62
|
+
* [ ] `gem build` succeeds and `gem spec` on the built gem shows every
|
|
63
|
+
link
|
|
64
|
+
* [ ] Every link resolves (no 404) at release time
|
data/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [0.2.2](https://github.com/elelem-sh/server/compare/v0.2.1...v0.2.2) (2026-11-18)
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
### Bug Fixes
|
|
7
|
+
|
|
8
|
+
* **deps:** accept the json that Ruby 4.0 ships ([3b4c161](https://github.com/elelem-sh/server/commit/3b4c1613d604799dd5813a4d5dafd2bcde88a824))
|
|
9
|
+
|
|
3
10
|
## [0.2.1](https://github.com/elelem-sh/server/compare/v0.2.0...v0.2.1) (2026-11-15)
|
|
4
11
|
|
|
5
12
|
|
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: elelem-server
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.2.
|
|
4
|
+
version: 0.2.2
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- mo khan
|
|
@@ -33,16 +33,16 @@ dependencies:
|
|
|
33
33
|
name: json
|
|
34
34
|
requirement: !ruby/object:Gem::Requirement
|
|
35
35
|
requirements:
|
|
36
|
-
- - "
|
|
36
|
+
- - ">="
|
|
37
37
|
- !ruby/object:Gem::Version
|
|
38
|
-
version: '
|
|
38
|
+
version: '2.18'
|
|
39
39
|
type: :runtime
|
|
40
40
|
prerelease: false
|
|
41
41
|
version_requirements: !ruby/object:Gem::Requirement
|
|
42
42
|
requirements:
|
|
43
|
-
- - "
|
|
43
|
+
- - ">="
|
|
44
44
|
- !ruby/object:Gem::Version
|
|
45
|
-
version: '
|
|
45
|
+
version: '2.18'
|
|
46
46
|
- !ruby/object:Gem::Dependency
|
|
47
47
|
name: webrick
|
|
48
48
|
requirement: !ruby/object:Gem::Requirement
|
|
@@ -65,6 +65,9 @@ executables:
|
|
|
65
65
|
extensions: []
|
|
66
66
|
extra_rdoc_files: []
|
|
67
67
|
files:
|
|
68
|
+
- ".agents/backlog/001-turn-spec-thread-leak.md"
|
|
69
|
+
- ".agents/backlog/002-readme.md"
|
|
70
|
+
- ".agents/backlog/003-gem-metadata-links.md"
|
|
68
71
|
- ".github/workflows/release.yml"
|
|
69
72
|
- ".release-please-manifest.json"
|
|
70
73
|
- ".rspec"
|