Skip to content

T8 - #1912

Merged
nmaguiar merged 7 commits into
masterfrom
t8
Sep 30, 2026
Merged

T8#1912
nmaguiar merged 7 commits into
masterfrom
t8

Conversation

@nmaguiar

Copy link
Copy Markdown
Collaborator

This pull request updates and extends the documentation for OpenAF, focusing on improving clarity, accuracy, and coverage of advanced features, particularly around oJob YAML syntax and persistent delegated OAuth for $mcp. The changes include a new in-depth guide for OAuth, refinements to the annotated oJob syntax catalog, and clarifications in build and core documentation.

Major Documentation Additions and Improvements:

Persistent Delegated OAuth for $mcp:

  • Added a comprehensive guide (docs/mcp-oauth.md) detailing how to enable, configure, and operate persistent delegated OAuth authentication for $mcp, including secure token storage, custom token stores, and behavioral details for interactive and unattended use.

oJob YAML Syntax Catalog Enhancements:

  • Clarified that docs/ojob-all.yaml is an annotated syntax catalog with illustrative options, not a runnable oJob, and referenced ojob-recipes.md for runnable examples.
  • Updated descriptions and defaults for core oJob fields, including async, sequential, shareArgs, and argsFromEnvs, to better reflect actual behavior and typical usage. [1] [2]
  • Improved documentation for integrity checks in include: sections, making strict now require a registered hash and clarifying the effect of the warn flag.
  • Refined job and type argument documentation, including changes to when, noTemplateArgs, async, and stopWhen for clarity and correctness. [1] [2] [3] [4]
  • Enhanced explanations for parallel execution and retry logic in periodic jobs, and clarified code inclusion mechanisms in the code: section. [1] [2]

Other Documentation Updates:

Build and Core Docs:

  • Added details to BUILD.md on how repacking works on Linux/macOS, including atomic file moves and symlink/permission handling, and differences on Windows.
  • Improved the index of core documentation, clarifying the purpose of ojob-all.yaml and adding a reference to the new ojob-examples.md for source patterns and examples.

These changes collectively make the documentation more accurate, actionable, and easier to use for both new and advanced users.

Update jline dependencies in lib/, pom.json, and pom.xml, and update src/jline/Terminal.java to accommodate the new version.
- Extract repackFile.js for better modularity
- Upgrade java-util and json-io jars to 4.112.0
- Add dedicated Repack tests and update allJobs.yaml
- Update BUILD.md and pom configuration
- Reorganize ojob documentation structure
- Add new ojob-examples.md guide
- Update ojob-all.yaml, ojob-security.md and index
Add OAuth 2.0 authentication to the MCP server implementation in
js/openaf.js, including token validation and authorization flows.

- Add MCP OAuth documentation (docs/mcp-oauth.md)
- Add MCP OAuth test suite (tests/autoTestAll.MCPOAuth.{js,yaml})
- Register new tests in tests/autoTestAll.MCP.yaml
- Update advanced docs for the new MCP OAuth capabilities
- Upgrade H2 database library from 2.5.250 to 2.5.252
Add SKILL.md files and corresponding assets for:
- ojob-authoring
- ojob-common-jobs
- openaf-javascript
- openaf-opacks
- openaf-owrap
- Update commons-lang3 from 3.20.0 to 3.21.0
- Update pom.xml, pom.json, and versionsAndDeps.json
- Update LICENSES.txt
@nmaguiar nmaguiar self-assigned this Sep 30, 2026
@nmaguiar nmaguiar added the dependencies Pull requests that update a dependency file label Sep 30, 2026
@nmaguiar
nmaguiar merged commit 539259a into master Sep 30, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dependencies Pull requests that update a dependency file

Projects

Development

Successfully merging this pull request may close these issues.

1 participant