Skip to content

T8 - #1888

Merged
nmaguiar merged 50 commits into
masterfrom
t8
Aug 26, 2026
Merged

T8#1888
nmaguiar merged 50 commits into
masterfrom
t8

Conversation

@nmaguiar

Copy link
Copy Markdown
Collaborator

This pull request introduces several improvements across the documentation, build process, and shell completion scripts for OpenAF. The main changes include the addition of comprehensive "Getting Started" and CLI reference guides, improved documentation structure and navigation, enhancements to the build system to prevent bundling obsolete compiled classes, and updates to shell completion scripts to support new output formats.

Documentation improvements:

  • Added docs/getting-started.md and linked it from README.md and docs/index.md for a clear installation and first-steps guide. [1] [2] [3] [4]
  • Introduced docs/cli.md as a complete command-line reference, linked from README.md and docs/index.md. [1] [2] [3]
  • Improved the structure and descriptions in docs/index.md, clarifying the documentation path and adding a developer notes section. [1] [2]
  • Added a direct link to the CHANGELOG.md in the documentation index for easier access to release notes.
  • Clarified the expected input for heatmap widgets in docs/llm-tui-guide.md.

Build system improvements:

  • Updated buildos.js to ensure the jslib directory is emptied before each build, preventing obsolete .class files from being bundled into openaf.jar. Added the addCompiledClasses helper to include all relevant compiled classes for each script. [1] [2] [3] [4]

Shell completion enhancements:

  • Added support for the new out=ttree output format in both the Bash completion script (completion_oafp.sh) and the YAML completion spec (completion_oafp.yaml). [1] [2] [3] [4]

nmaguiar added 30 commits August 4, 2026 10:35
- Update commons-codec to 1.22.1
- Update java-util to 4.110.0
- Update jsch to 2.28.6
- Update json-io to 4.110.0
- Update okio and okio-jvm to 3.18.1
- Update LICENSES.txt and dependency configuration files
Allow specifying the working directory and environment variables when launching a JSON-RPC server via stdio. Environment variables replace the child process environment entirely.
Expand owrap.oJob.js with additional oJob functionality and update
ojob.js, openaf.js, and RhinoEngine.java to support the changes.
97 insertions, 30 deletions across 4 files.
Add a new docs/opacks.md page (331 lines) covering opacks usage and link to it from docs/index.md.
Upgrade Jetty libraries from 12.1.11 to 12.1.12 across the
client, http, io, util, and websocket modules, and update the
corresponding dependency versions in pom.xml and pom.json.
Upgrade snmp4j to 3.13.1 and snmp4j-agent to 3.10.1,
replacing the older 3.9.7 and 3.9.2 versions. Update
pom.json and pom.xml to reference the new versions.
Bump the Oracle JDBC driver from 23.26.2.0.0 to 23.26.3.0.0,
renaming the bundled jar and updating the version references
in pom.json and pom.xml.
Update Rhino engine and XML jars from 1.8.1 to 1.9.1, adapting Java sources and tests to the new version.
Streamline the AI wrapper module by removing 41 lines of redundant logic and consolidating into 23 cleaner lines. Reduces maintenance burden without changing behaviour.
Update js/genScripts.js (1 insertion, 1 deletion) to adjust the generated script output.
- Significant updates to js/openaf.js
- Refine owrap.obj.js and owrap.server.js
- Update tests/autoTestAll.MCP.js
Modified src/openaf/plugins/Threads.java to improve thread handling (+17, -2).
Update dependency version in pom.xml and pom.json, and replace the corresponding JAR file in lib/
Modified js/owrap.ch.js with 6 insertions and 2 deletions to refine functionality.
Modified js/owrap.obj.js with 23 insertions and 4 deletions to improve object wrapping functionality.
Minor adjustment to the script generation logic in js/genScripts.js.
- Significant updates to js/openaf.js (+152, -29)
- Expand generic test logic in tests/autoTestAll.Generic.js
- Update test configuration in tests/autoTestAll.Generic.yaml
Update openaf.js to support MCP functionality and add corresponding automated tests in autoTestAll.MCP.js and autoTestAll.MCP.yaml.
Refine implementation across openaf.js and various owrap modules (java, net, oJob, obj, template) and update corresponding Obj tests to align with changes.
Modified js/genScripts.js to refine script generation logic.
Update AFCmdBase, AFCmdOS, and IO for better core functionality. Significant improvements to Threads and HTTP plugins, and updates to openaf.js.
- Implement core formatting logic in js/owrap.format.js
- Add comprehensive tests in tests/autoTestAll.Format.js and .yaml
- Update documentation in docs/llm-tui-guide.md and docs/openaf.md
Update Threads.java and openaf.js to improve threading logic and integration.
…ogic

- Create comprehensive python.md documentation
- Update genScripts.js and wrap scripts to improve Python integration
- Minor updates to index.md and openaf.md
- Update js/genScripts.js and js/owrap.format.js
- Refactor js/oafp.js for improved logic and structure
- Update completion_oafp.sh and completion_oafp.yaml for improved shell integration
- Refine oafp.js and openaf.js core logic
Modified js/owrap.format.js to refine formatting behavior (11 insertions, 5 deletions).
- Update completion_oafp.sh and completion_oafp.yaml
- Refine oafp.js and openaf.js
Minor adjustments to the Python wrapper logic in js/owrap.python.js.
Minor adjustment to js/openaf.js (1 insertion, 1 deletion).
Modified js/oafp.js with 6 insertions and 7 deletions to refine functionality.
Update okhttp and okhttp-jvm libraries to version 5.5.0 and update pom.json/pom.xml configurations.
Add comprehensive documentation for oafp, obook, odoc, and sigil, along with detailed guides for various plugins including HTTP, SSH, SNMP, and others. Update index.md to reflect these additions.
Minor adjustment to js/openaf.js (1 insertion, 1 deletion).
Update jackson-core, jackson-databind, and jackson-dataformat-toml to version 2.22.2. Update pom.xml and pom.json accordingly.
Improve formatting implementation in owrap.format.js with 30 insertions and 2 deletions.
… tests

- Update AFBase and CompileJS2Java to support JS to Java translation
- Refactor openaf.js and opack.js for improved build handling
- Add new test suite autoTestAll.Compile for verification
- Update buildos.js and general test results
Modify the owrap template logic to improve structure or fix minor issues.
Restructure js/openaf.js with 73 insertions and 40 deletions to improve code organization and maintainability.
Modified js/owrap.sec.js with 35 insertions and 20 deletions to refine security wrapping behavior.
Refactor js/oafp.js with equal insertions and deletions (33/33), indicating code restructure without behaviour change.
- Add cli.md and getting-started.md
- Update index, ojob, openaf, and plugins documentation
- Rename dev docs to lowercase for consistency
- Refine HTTPServer and python documentation
Updated js/openafconsole.js with 153 insertions and 6 deletions to improve console capabilities.
Modified js/openafconsole.js to refine console behavior (3 insertions, 2 deletions).
Update owrap.net.js with new functionality and add comprehensive\ntest cases in autoTestAll.Net.js and autoTestAll.Net.yaml.
- Update HTTPd and HTTPWSd in both nwu and nwu2 packages
- Modify AFCmdBase and genScripts.js
- Add new test cases in autoTestAll.HTTP.js
Update jsch library version in lib/ and corresponding references in pom.json and pom.xml.
@nmaguiar nmaguiar self-assigned this Aug 26, 2026
@nmaguiar
nmaguiar merged commit 918a7dc into master Aug 26, 2026
1 check passed
@github-project-automation github-project-automation Bot moved this from Backlog to Done in Continuous Enhancement Aug 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Development

Successfully merging this pull request may close these issues.

1 participant