Skip to content

Enhance documentation, features, and dependencies across modules - #1941

Merged
nmaguiar merged 29 commits into
masterfrom
t8
Nov 13, 2026
Merged

nmaguiar merged 29 commits into
masterfrom
t8

Conversation

@nmaguiar

Copy link
Copy Markdown
Collaborator

This pull request introduces several improvements to the build process, error handling, and documentation for the OpenAF project. The most significant changes ensure that build failures are caught and reported early, test results are more robustly validated and uploaded, and developer documentation is clearer regarding coding and build conventions.

Build process reliability and error handling:

  • Refactored the main build script (buildos.js) to use a new runBuildCommand helper that merges stdout/stderr and throws on failure, preventing deadlocks and ensuring all critical build steps (Java and JS compilation, minification, and class generation) are checked for errors. Compilation failures now halt the build and are reported with detailed output. [1] [2] [3] [4] [5]
  • Improved error handling in build.yaml by checking exit codes after repacking and other subprocesses, logging errors, and exiting on failure to avoid proceeding with incomplete or broken artifacts. [1] [2] [3] [4]

Test validation and CI improvements:

  • Enhanced CI workflows (.github/workflows/build-and-test.yml, .github/workflows/publish-maven.yml) to upload structured test results as artifacts, validate the presence and success of test runs with stricter Python assertions, and run additional framework tests across OS/Java matrixes. [1] [2] [3] [4]

Documentation updates:

  • Expanded BUILD.md to document the atomic build process, temporary JAR handling, and additional regression/failure test scripts. Provided instructions for running browser table sorting and build failure regressions, and clarified subprocess testing for shell pressure and cancellation. [1] [2]
  • Updated AGENTS.md to clarify coding style for JavaScript/YAML (indentation, semicolon usage), and added ODoc documentation conventions for API reference generation.

ODoc reference generation:

  • Added a new build step in build.yaml to generate ODoc API documentation, ensuring reference docs are always up to date and build failures in this step halt the process. [1] [2]

Miscellaneous build script improvements:

  • Improved classpath and source list handling in buildos.js, with better error messages if dependencies are missing, and ensured temporary files are cleaned up after JS-to-Java compilation. [1] [2] [3]

These changes collectively make the build and test process more robust, transparent, and maintainable, while improving developer experience and documentation.

Nuno Aguiar and others added 28 commits November 5, 2026 03:15
- Update docs/python.md with extensive new content
- Refine docs/cli.md
- Update SKILL.md for openaf-python and openaf-owrap skills
- Update js/oafpy.js to refine python execution logic
- Update tests/python-subprocess.py to validate subprocess behavior
- Update docs/python.md with relevant changes
- Update docs/channel-graph.md with new graph details
- Refine js/njsmap.js and js/owrap.ch.js for improved channel handling
- Expand tests/autoTestAll.Channels.js to cover new changes
- Add comprehensive ow-test framework in js/owrap.test.*
- Create detailed modernization plan and implementation status in docs/plans/
- Update autoTestAll orchestration and add new test fixtures
- Integrate test framework into build and CI workflows
- Add supporting documentation and schemas for test results
Update a wide range of autoTestAll YAML configurations and test logic.
Add common and reporting utilities to the test suite.
Update testing documentation and add new fixtures.
- Update clean.yaml to refine cleanup process
- Remove precompiled test jars and result files from tests/
- Update AFBase, DB, and HTTP server plugins
- Refactor JS wrappers (owrap.ai, owrap.ch, owrap.oJob)
- Add comprehensive tests for nLinq, AI, Channels, DB, and Server
- Update build configuration and documentation
- Add comprehensive MCP client documentation and OAuth support
- Enhance openaf.js and owrap.format.js with new MCP logic
- Implement advanced MCP test cases and fixtures
- Update MCP skill documentation
- Update documentation in docs/llm-frontend-guide.md
- Refine chart.js implementation in js/chart.js
Update the odoc.md file with 11 insertions and 3 deletions.
Add HPROFReader Java class to parse HPROF heap dumps, with JS CLI wrappers in owrap.java.js, OOM diagnostics documentation, and tests (autoTestAll.OOM, HPROFReaderTest) wired into the test suite.

Add genODocReference ojob to generate the ODoc reference docs, with matching autoTestAll.ODocReference tests, odoc.md updates, and test result artifacts.
- Expand format helpers in owrap.format.js with new visualization
  output, tests (autoTestAll.Format), sample data and a benchmark
- Add Java diagnostics support: HPROFReader updates,
  java-diagnostic-helper.js, oom-diagnostics docs and a smoke test
- Adjust Terminal.java and owrap.screen.js terminal size handling;
  refresh llm-tui-guide, oafp and openaf-advanced docs
- Update test results and precompiled test framework artifacts
- Update completion_oafp.sh and completion_oafp.yaml for improved shell integration
- Refactor oafp.js to enhance command handling and output logic
Regenerate the full set of API reference pages and update the reference index. This includes updates to over 100 markdown files and the reference JSON metadata.
- Add HPROFIndex.java to enable efficient indexing of heap profiles
- Update HPROFReader.java to integrate with the new index
- Add HPROFIndexTest.java and update OOM tests for validation
- Update Java wrapper (owrap.java.js) and corresponding documentation
- Update shell completion and general project docs
Upgrade Jackson jars (core, databind, annotations, dataformat-toml) from 2.22.x to 2.23.x and update the version references in pom.xml and pom.json. Adjust js/oafp.js to match (301 insertions, 299 deletions).
- Add MCP OAuth support in js/openaf.js and src/openaf/plugins/HTTPServer.java
- Create comprehensive tests in tests/autoTestAll.MCPOAuth.js and .yaml
- Update extensive documentation across docs/ including MCP, HTTP server, and various reference guides
- Refine js/owrap.server.js and general project tests
- Update oafp.js and owrap desktop/screen JS logic
- Update corresponding documentation in docs/ and docs/ref/
- Update shell completion files
- Update DesktopTUI tests
Add oJob interact step support (docs/OJOB-INTERACT.md) built on new
owrap.screen.js helpers plus Console plugin and ConsoleReader
extensions, with autoTestAll.Console and autoTestAll.Interact test
pairs wired into autoTestAll.allJobs.yaml and regenerated reference
docs refreshed.
- Upgrade Jetty libraries from 12.1.14 to 12.1.15
- Update pom.xml and pom.json
- Refine AI-related documentation in docs/ref/
Update jline-native, jline-reader, jline-terminal, and jline-terminal-jni from 4.5.0 to 4.6.0. Update pom.json and pom.xml accordingly.
Extend ow.ai with new decision-related behaviour, update the
AIDecisions test orchestrator accordingly, and refresh the
generated reference docs plus llm-decisions.md to match.
Update dependencies in pom.xml and pom.json to the latest versions.
Update js/oafp.js with new behaviour and extend the
completion_oafp.sh/completion_oafp.yaml completion definitions
so the shell completions cover the updated oafp functionality.
- Add ArchiveLimits and HttpRequestBodyBudget to enforce byte and request limits on remote resources.
- Update HTTPServer and ZIP plugins to respect these limits.
- Update NanoHTTPD and NanoWSD to handle request body budgets.
- Refactor opack.js to improve package staging and verification.
- Add comprehensive tests for archive and HTTP body limits.
- Update documentation for oJob security and oPack usage.
Bumps [org.codehaus.mojo:exec-maven-plugin](https://github.com/mojohaus/exec-maven-plugin) from 3.6.4 to 3.7.0.
- [Release notes](https://github.com/mojohaus/exec-maven-plugin/releases)
- [Commits](mojohaus/exec-maven-plugin@3.6.4...3.7.0)

---
updated-dependencies:
- dependency-name: org.codehaus.mojo:exec-maven-plugin
  dependency-version: 3.7.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
….mojo-exec-maven-plugin-3.7.0

chore(deps-dev): bump org.codehaus.mojo:exec-maven-plugin from 3.6.4 to 3.7.0
@nmaguiar nmaguiar self-assigned this Nov 13, 2026
@nmaguiar nmaguiar added the bug label Nov 13, 2026
@nmaguiar
nmaguiar merged commit dbe0563 into master Nov 13, 2026
1 check failed
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