Skip to content

Add channel graph and time-series support with documentation and tests - #1925

Merged
nmaguiar merged 20 commits into
masterfrom
t8
Oct 22, 2026
Merged

nmaguiar merged 20 commits into
masterfrom
t8

Conversation

@nmaguiar

Copy link
Copy Markdown
Collaborator

This pull request introduces comprehensive documentation for the new graph channel type, which allows users to operate and navigate a knowledge graph stored in a JSON file or external store using OpenAF channels. The documentation covers the file format, configuration options, usage patterns, navigation helpers, and several practical use cases, including integration with Mini-A and exporting for visualization.

Key additions in this pull request:

Graph channel documentation:

  • Added a new docs/channel-graph.md file that thoroughly documents the graph channel type, including its file format, configuration options, and behaviors. The documentation explains how to create, use, and persist a knowledge graph, either in memory or via an external store.

  • Provided detailed usage examples for real-world scenarios such as modeling folder trees, service dependencies, ownership mapping, and exporting to visualization formats.

  • Documented the navigation helpers available in ow.ch.utils.graph, including functions for traversing, searching, and analyzing the graph.

Help system updates:

  • Registered new help files for ow.desktop and ow.screen in the buildos.js help files map, making their documentation accessible via the help system.

Add a channel graph to the Channels wrapper (js/owrap.ch.js) and wire it into the console (js/openafconsole.js).

Document the new graph in docs/channel-graph.md and reference it from docs/index.md and docs/openaf.md.

Extend the Channels test suite (tests/autoTestAll.Channels.js and tests/autoTestAll.Channels.yaml) to cover the new functionality.
Add detailed documentation for the channel graph in docs/channel-graph.md.
- Update js/owrap.ch.js with significant logic changes
- Expand docs/channel-graph.md
- Add comprehensive tests in tests/autoTestAll.Channels.js and .yaml
Extend the channels wrapper (js/owrap.ch.js) with time-series capabilities. Add a new channel-timeseries.md guide and update index.md, openaf.md and llm-guide.md to reference it. Broaden the Channels test suite (autoTestAll.Channels.js/.yaml) to cover the new behaviour.
Add tests/autoTestAll.Metrics.{js,yaml} with focused coverage for the
owrap.metrics module and register the new job in
tests/autoTestAll.allJobs.yaml. Extend js/owrap.metrics.js with the
minor changes needed to support the new test cases.
- Update documentation in docs/channel-timeseries.md
- Implement logic in js/owrap.ch.js
- Add comprehensive tests in tests/autoTestAll.Channels.js and .yaml
- Add metrics logic to owrap.metrics.js and owrap.server.js
- Update oJob integration in owrap.oJob.js
- Add comprehensive tests in tests/autoTestAll.Metrics.js and .yaml
- Update documentation in docs/channel-timeseries.md, ojob.md, and openaf-advanced.md
Update dependency versions in pom.xml and pom.json.
Add js/owrap.desktop.js and js/owrap.desktop.ui.js implementing the
desktop wrapper and UI layer, plus user and provider documentation
under docs/. Extend NanoWSD, jline Terminal, and AFCmdBase to support
the desktop runtime, and register the new modules in buildos.js and
js/openaf.js. Include Desktop and DesktopTUI autoTestAll suites with
fixtures and helpers to cover the new functionality.
Add examples/desktop-view.js, a new example script demonstrating the desktop view (26 lines, single new file).
- Add js/owrap.screen.js and enhance existing oWrap modules
- Update OpenAF Java core (AFBase, IO, DB, CSV) and various plugins
- Update documentation and add tests for DesktopTUI and oDoc
- Refactor js/openaf.js and related JS utilities
Refine AI decision handling in oafp.js and owrap.ai.js, update corresponding documentation in llm-decisions.md, and expand test coverage in autoTestAll.AIDecisions.js.
Refine guidance in the ojob-authoring, openaf-javascript, openaf-llm and openaf-owrap SKILL.md files and align the openaf-llm decision-preflight.js asset with them.
Modify one line in js/oafp.js (1 insertion, 1 deletion).
Extend the AI decisions wrapper in js/owrap.ai.js and align the llm-decisions documentation and AIDecisions tests with the updated behaviour.
Add new Path-related functionality to js/openaf.js (22 lines) and
include corresponding test coverage in tests/autoTestAll.Path.js
(25 lines) and tests/autoTestAll.Path.yaml (6 lines).
Restructure js/oafp.js with a near-balanced change set (217 insertions, 215 deletions), reorganizing the oafp script internals without net new functionality.
Update jackson-core, jackson-databind, and jackson-dataformat-toml to version 2.22.4. Update pom.json and pom.xml accordingly.
Replace lib/okhttp-5.5.0.jar and lib/okhttp-jvm-5.5.0.jar with their
5.5.1 counterparts and update the version references in pom.xml and
pom.json to pick up the latest okhttp patch release.
@nmaguiar
nmaguiar merged commit 2437c6b into master Oct 22, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant