Skip to content

Commit 2574549

Browse files
authored
nim: add 2026 Q4 commitments and tasks (#526)
1 parent e6e30bb commit 2574549

3 files changed

Lines changed: 144 additions & 1 deletion

File tree

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
---
2+
title: 2026q4 Nim Core Libraries
3+
tags:
4+
- "2026q4"
5+
- "nim"
6+
- "ift"
7+
draft: false
8+
description: Maintain Nim core libraries, improve documentation, and integrate nimlangserver fixes with a consistent LSP protocol model.
9+
---
10+
11+
`ift-ts:nim:ift:2026q4-nim-core-libs`
12+
13+
## Description
14+
15+
Maintain and document the foundational Nim libraries used by IFT teams.
16+
Improve nimlangserver by reviewing and integrating applicable fixes from the recent fork and following the separation of protocol handling, JSON serialization, and protocol data models used by nim-web3.
17+
18+
## Task List
19+
20+
### Documentation Improvement
21+
22+
* fully qualified name: `ift-ts:nim:ift:2026q4-nim-core-libs:docs-improvement`
23+
* owner: Constantine
24+
* status: not started
25+
* start-date: 2026/10/01
26+
* end-date: 2026/12/31
27+
28+
#### Description
29+
30+
Continue improving documentation for Nim core libraries, including missing API guidance, runnable examples, and integration notes needed by downstream teams.
31+
Improve documentation tooling where it helps keep package documentation accurate and maintainable.
32+
33+
#### Deliverables
34+
35+
- Documentation PRs covering identified gaps and downstream usage examples.
36+
- Documentation tooling improvements and validation of the updated examples or builds.
37+
38+
### Maintenance
39+
40+
* fully qualified name: `ift-ts:nim:ift:2026q4-nim-core-libs:maintenance`
41+
* owner: Constantine
42+
* status: not started
43+
* start-date: 2026/10/01
44+
* end-date: 2026/12/31
45+
46+
#### Description
47+
48+
Provide ongoing maintenance and fixes across Nim core libraries.
49+
Triage issues, address regressions and compatibility problems, support downstream consumers, and maintain tests and CI as dependencies and toolchains evolve.
50+
51+
#### Deliverables
52+
53+
- PRs fixing library defects and maintaining compatibility, tests, and CI.
54+
- Tracked issues and verification results for downstream integration problems.
55+
56+
### Nimlangserver improvements
57+
58+
* fully qualified name: `ift-ts:nim:ift:2026q4-nim-core-libs:nimlangserver`
59+
* owner: TBD
60+
* status: not started
61+
* start-date: 2026/10/01
62+
* end-date: 2026/12/31
63+
64+
#### Description
65+
66+
Review the recent nimlangserver fork and cherry-pick applicable improvements and fixes into the team's maintained branch, adapting changes where needed.
67+
Identify the fork URL, source commits, and target branch before selecting changes; these references remain to be specified.
68+
69+
Use the nim-web3 approach as the model for the LSP implementation:
70+
- Keep JSON-RPC protocol handling in `nim-json-rpc`.
71+
- Define an LSP-specific `nim-json-ser` flavor for interpreting and emitting protocol JSON, including null values, number formatting, and missing or extra fields.
72+
- Represent the protocol data model with Nim objects that map directly to the [LSP 3.18 specification](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.18/specification/), starting with the messages and structures used by nimlangserver today.
73+
- Make additional protocol objects straightforward to add using the same model. Generating objects from the specification is optional; the task does not require implementing every LSP feature.
74+
- Add regression tests for imported fixes and serialization tests for the supported protocol objects and edge cases.
75+
76+
#### Deliverables
77+
78+
- A fork review identifying source commits, target branch, selected fixes, and deferred changes.
79+
- PRs integrating applicable fork fixes and improvements into the maintained branch.
80+
- An LSP JSON serialization flavor and Nim protocol objects for the currently used messages and structures.
81+
- Regression and serialization tests, plus guidance for adding further protocol objects.

‎content/nim/ift/2026q4-nimble.md‎

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
---
2+
title: 2026q4 Nimble
3+
tags:
4+
- "2026q4"
5+
- "nim"
6+
- "ift"
7+
draft: false
8+
description: Continue Nimble development and review its integration into Messaging, Storage, and Nimbus CI workflows.
9+
---
10+
11+
`ift-ts:nim:ift:2026q4-nimble`
12+
13+
## Description
14+
15+
Continue improving Nimble as a reliable package and build tool for downstream teams.
16+
Build on the Q3 development track and review how Messaging, Storage, and Nimbus use Nimble in CI, identifying integration gaps and coordinating fixes with each team.
17+
18+
## Task List
19+
20+
### Nimble development
21+
22+
* fully qualified name: `ift-ts:nim:ift:2026q4-nimble:development`
23+
* owner: Juan
24+
* status: not started
25+
* start-date: 2026/10/01
26+
* end-date: 2026/12/31
27+
28+
#### Description
29+
30+
Continue Nimble development, stabilization, and issue resolution from Q3.
31+
Prioritize outstanding development goals, dependency resolution and lockfile reliability, package installation, and build behavior needed by downstream projects.
32+
Add regression coverage for fixes and update usage documentation when behavior changes.
33+
34+
#### Deliverables
35+
36+
- PRs implementing Nimble improvements and fixes with regression coverage.
37+
- Updated documentation and tracked follow-ups for outstanding development or compatibility issues.
38+
39+
### CI integration review
40+
41+
* fully qualified name: `ift-ts:nim:ift:2026q4-nimble:ci-integration-review`
42+
* owner: TBD
43+
* status: not started
44+
* start-date: 2026/10/01
45+
* end-date: 2026/12/31
46+
47+
#### Description
48+
49+
Review Nimble integration into the CI workflows of Logos Messaging, Logos Storage, and Nimbus.
50+
For each project, inspect the current integration, dependency and lockfile handling, toolchain selection, caching, and build/test execution on its supported CI platforms.
51+
Identify gaps or failures, agree follow-up work with the project owners, and contribute Nimble or workflow fixes where needed.
52+
53+
#### Deliverables
54+
55+
- A review for each of Messaging, Storage, and Nimbus documenting current integration, findings, and recommended changes.
56+
- Issues or PRs addressing integration gaps, with ownership for remaining follow-ups.
57+
- CI validation results for changes made during the review.

‎content/nim/index.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,12 @@ tags:
1111

1212
[[nim/preview|Roadmap Preview]]
1313

14+
## 2026q4
15+
16+
### `ift:`
17+
* [[nim/ift/2026q4-nim-core-libs|nim-core-libs]]
18+
* [[nim/ift/2026q4-nimble|nimble]]
19+
1420
## 2026q3
1521

1622
### `nimbus:`
@@ -72,4 +78,3 @@ tags:
7278
* [[nim/ift/2025q1-nim-ide-tooling|2025q1-nim-ide-tooling]]
7379
* [[nim/ift/2025q1-nimble|2025q1-nimble]]
7480

75-

0 commit comments

Comments
 (0)