Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 81 additions & 0 deletions content/nim/ift/2026q4-nim-core-libs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
---
title: 2026q4 Nim Core Libraries
tags:
- "2026q4"
- "nim"
- "ift"
draft: false
description: Maintain Nim core libraries, improve documentation, and integrate nimlangserver fixes with a consistent LSP protocol model.
---

`ift-ts:nim:ift:2026q4-nim-core-libs`

## Description

Maintain and document the foundational Nim libraries used by IFT teams.
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.

## Task List

### Documentation Improvement

* fully qualified name: `ift-ts:nim:ift:2026q4-nim-core-libs:docs-improvement`
* owner: Constantine
* status: not started
* start-date: 2026/10/01
* end-date: 2026/12/31

#### Description

Continue improving documentation for Nim core libraries, including missing API guidance, runnable examples, and integration notes needed by downstream teams.
Improve documentation tooling where it helps keep package documentation accurate and maintainable.

#### Deliverables

- Documentation PRs covering identified gaps and downstream usage examples.
- Documentation tooling improvements and validation of the updated examples or builds.

### Maintenance

* fully qualified name: `ift-ts:nim:ift:2026q4-nim-core-libs:maintenance`
* owner: Constantine
* status: not started
* start-date: 2026/10/01
* end-date: 2026/12/31

#### Description

Provide ongoing maintenance and fixes across Nim core libraries.
Triage issues, address regressions and compatibility problems, support downstream consumers, and maintain tests and CI as dependencies and toolchains evolve.

#### Deliverables

- PRs fixing library defects and maintaining compatibility, tests, and CI.
- Tracked issues and verification results for downstream integration problems.

### Nimlangserver improvements

* fully qualified name: `ift-ts:nim:ift:2026q4-nim-core-libs:nimlangserver`
* owner: TBD
* status: not started
* start-date: 2026/10/01
* end-date: 2026/12/31

#### Description

Review the recent nimlangserver fork and cherry-pick applicable improvements and fixes into the team's maintained branch, adapting changes where needed.
Identify the fork URL, source commits, and target branch before selecting changes; these references remain to be specified.

Use the nim-web3 approach as the model for the LSP implementation:
- Keep JSON-RPC protocol handling in `nim-json-rpc`.
- Define an LSP-specific `nim-json-ser` flavor for interpreting and emitting protocol JSON, including null values, number formatting, and missing or extra fields.
- 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.
- 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.
- Add regression tests for imported fixes and serialization tests for the supported protocol objects and edge cases.

#### Deliverables

- A fork review identifying source commits, target branch, selected fixes, and deferred changes.
- PRs integrating applicable fork fixes and improvements into the maintained branch.
- An LSP JSON serialization flavor and Nim protocol objects for the currently used messages and structures.
- Regression and serialization tests, plus guidance for adding further protocol objects.
57 changes: 57 additions & 0 deletions content/nim/ift/2026q4-nimble.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
---
title: 2026q4 Nimble
tags:
- "2026q4"
- "nim"
- "ift"
draft: false
description: Continue Nimble development and review its integration into Messaging, Storage, and Nimbus CI workflows.
---

`ift-ts:nim:ift:2026q4-nimble`

## Description

Continue improving Nimble as a reliable package and build tool for downstream teams.
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.

## Task List

### Nimble development

* fully qualified name: `ift-ts:nim:ift:2026q4-nimble:development`
* owner: Juan
* status: not started
* start-date: 2026/10/01
* end-date: 2026/12/31

#### Description

Continue Nimble development, stabilization, and issue resolution from Q3.
Prioritize outstanding development goals, dependency resolution and lockfile reliability, package installation, and build behavior needed by downstream projects.
Add regression coverage for fixes and update usage documentation when behavior changes.

#### Deliverables

- PRs implementing Nimble improvements and fixes with regression coverage.
- Updated documentation and tracked follow-ups for outstanding development or compatibility issues.

### CI integration review

* fully qualified name: `ift-ts:nim:ift:2026q4-nimble:ci-integration-review`
* owner: TBD
* status: not started
* start-date: 2026/10/01
* end-date: 2026/12/31

#### Description

Review Nimble integration into the CI workflows of Logos Messaging, Logos Storage, and Nimbus.
For each project, inspect the current integration, dependency and lockfile handling, toolchain selection, caching, and build/test execution on its supported CI platforms.
Identify gaps or failures, agree follow-up work with the project owners, and contribute Nimble or workflow fixes where needed.

#### Deliverables

- A review for each of Messaging, Storage, and Nimbus documenting current integration, findings, and recommended changes.
- Issues or PRs addressing integration gaps, with ownership for remaining follow-ups.
- CI validation results for changes made during the review.
7 changes: 6 additions & 1 deletion content/nim/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,12 @@ tags:

[[nim/preview|Roadmap Preview]]

## 2026q4

### `ift:`
* [[nim/ift/2026q4-nim-core-libs|nim-core-libs]]
* [[nim/ift/2026q4-nimble|nimble]]

## 2026q3

### `nimbus:`
Expand Down Expand Up @@ -72,4 +78,3 @@ tags:
* [[nim/ift/2025q1-nim-ide-tooling|2025q1-nim-ide-tooling]]
* [[nim/ift/2025q1-nimble|2025q1-nimble]]


Loading