OSA v0.5.2.dev0

What's Changed

2bd10e4 Bump version to 0.5.2.dev0
7ad045c feat: update worker for community-based architecture (#89)
f5ad12f feat: automate version management for main branch (#88)
d1c5f4d docs: add GitHub labels reference to CLAUDE.md
225b1af test: add 6 test coverage improvements (no mocks)
746de0d docs: add comprehensive version management workflow guide
4470dcf ci: add automatic tag and release workflow for main branch
e105bd0 feat: add --push and --ci flags to bump_version script

Full Changelog: v0.5.1.dev0...v0.5.2.dev0

What's Changed

• feat: automate version management for main branch by @neuromechanist in #88
• feat: update worker for community-based architecture by @neuromechanist in #89

Full Changelog: v0.5.1.dev0...v0.5.2.dev0

OSA v0.5.1.dev0

What's Changed

5e63d76 Bump version to 0.5.1.dev0 (#83)
1e4eb59 fix: settings icon and worker origin forwarding (#81)
8ee194d fix: allow platform demo origins in API authorization (#80)
0267f2c Merge pull request #78 from OpenScience-Collective/feature/issue-72-api-key-enhancement
106b2c2 fix: address critical PR review findings
5f00ed7 feat: enhance API key validation and monitoring
31650c4 Merge pull request #77 from OpenScience-Collective/feature/issue-71-widget-integration-test
a5a860c fix: address critical PR review issues in widget test
ae3b1da feat: add widget integration test endpoint (Phase 5)
2278dfd Merge pull request #76 from OpenScience-Collective/feature/issue-69-70-operational-basics
7d5772d fix: address PR review findings for Phase 4
d8a29c3 feat: add structured logging and health check endpoint (Phase 4)
a4a9f96 Merge pull request #75 from OpenScience-Collective/feature/issue-64-68-security-hardening
c1f1345 fix: update test to use valid env var name pattern
3511126 fix: address critical and important PR review findings
f3647ef feat: add security hardening validators (Phase 3)
88fbcef feat: add settings modal with BYOK and model selection (Phase 2) (#74)
0cf5cee feat: validation CLI and onboarding docs (Phase 1) (#73)
f164f32 Merge pull request #60 from OpenScience-Collective/develop
0869eee Merge branch 'main' into develop
8d93aaa fix: resolve fixture naming issue in authorization tests
5e2e5c2 fix: sanitize error messages and add fail-fast to discovery
8f559ae feat: add CORS-based API key authorization and model selection
c144100 feat: add per-community OpenRouter API keys for cost attribution
349e32c fix: address PR review findings for multi-community support
d1f501d Bump version to 0.5.0
fc8d97c fix: add main demo page CORS origin
0eb621c Merge pull request #59 from OpenScience-Collective/feature/issue-57-cors-yaml-config
1db124f feat: add YAML-driven CORS origins for community configs
770be08 Merge pull request #58 from OpenScience-Collective/feature/issue-49-readme-registry
05e3bcc docs: add community registry section to README
78200c2 Merge pull request #56 from OpenScience-Collective/feature/issue-48-frontend-widget-modularization
2ec493d fix: use Object.hasOwn for prototype pollution protection
197db06 fix: address PR review findings for widget safety
5dbc2f7 feat: modularize frontend widget for multi-community support
f711120 Merge pull request #54 from OpenScience-Collective/feature/issue-47-api-router-generalization
2916154 fix: distinguish route 404 from session 404 in tests
012df4d fix: make session endpoint test environment-agnostic
af056ff fix: address PR review findings for community router
149abfd feat: add prompt caching optimization for widget users
75bc53b feat: add generic community router factory for API generalization
c7f4af9 Merge pull request #53 from OpenScience-Collective/feature/issue-46-cli-sync-integration
4bc34c3 fix: strip ANSI codes in help text tests for CI compatibility
5fc4426 fix: address all PR review findings for Phase 3
8f2d37f fix: address PR review findings
758f027 feat: community-aware CLI sync with admin access control
cdf513d Bump version to 0.3.2a0
dddecf5 Merge pull request #43 from OpenScience-Collective/develop

Full Changelog: v0.4.0.dev0...v0.5.1.dev0

What's Changed

• Release v0.3.2: Knowledge Database, Modular Assistants, and Critical Fixes by @neuromechanist in #43
• Phase 3: CLI sync integration with registry by @neuromechanist in #53
• feat: generalize API router with community factory by @neuromechanist in #54
• feat: modularize frontend widget for multi-community support by @neuromechanist in #56
• docs: add community registry section to README by @neuromechanist in #58
• feat: add YAML-driven CORS origins for community configs by @neuromechanist in #59
• Release v0.5.0: YAML-driven community architecture + knowledge discovery by @neuromechanist in #60
• feat: validation CLI and onboarding docs (Phase 1) by @neuromechanist in #73
• feat: add settings modal with BYOK and model selection (Phase 2) by @neuromechanist in #74
• feat: security hardening validators (Phase 3) by @neuromechanist in #75
• feat: structured logging and health checks (Phase 4) by @neuromechanist in #76
• feat: widget integration test endpoint (Phase 5) by @neuromechanist in #77
• feat: API key validation and monitoring (Phase 6) by @neuromechanist in #78
• fix: allow platform demo origins in API authorization by @neuromechanist in #80
• fix: settings icon and worker origin forwarding by @neuromechanist in #81
• chore: bump version to 0.5.1.dev0 by @neuromechanist in #83

Full Changelog: v0.4.0.dev0...v0.5.1.dev0

OSA v0.4.0.dev0

What's Changed

3457551 Bump version to 0.4.0.dev0
e77c0db Merge pull request #52 from OpenScience-Collective/feature/issue-45-yaml-driven-architecture
cb815b9 test: restore comprehensive test coverage for tools
770283e fix: address PR review findings
8b6df16 refactor: complete YAML-driven assistant architecture
977fa23 Merge pull request #50 from OpenScience-Collective/feature/issue-45-generic-community-assistant
6e41c16 fix: preserve HED factory with module reload in discover_assistants
8963b06 refactor: extract SSRF protection to shared module
0ef9468 Merge HED YAML migration into generic CommunityAssistant
5a9493b feat: migrate HED to YAML + CommunityAssistant
34e57b5 feat: add preloaded docs and page context support to CommunityAssistant
a035eff feat: add system_prompt field to CommunityConfig
dedda62 fix: address PR review findings
336e5da feat: add generic CommunityAssistant for YAML-only communities
1344aed Merge pull request #44 from OpenScience-Collective/feature/issue-42-yaml-registry
52293fc feat: add robust validation to community config models
4820478 fix: address PR review findings
2aa6c97 docs: add YAML registry documentation
c97848a feat: add YAML-based community registry (Phase 1)
bef52e9 Merge branch 'main' into develop
26253de test: add critical test coverage for sync and deduplication
e554c26 fix: propagate database operational errors instead of returning empty results
83e52c5 fix: address PR review findings - improve error handling and docs
f1957fb chore: bump version to 0.3.2.dev0
0208737 fix: align env var name GIT_COMMIT_SHA in Dockerfile
5d32c71 feat: add git commit SHA to health endpoint and footer
1bf9909 fix: add fuzzy matching for paper deduplication
c55ff68 fix: improve knowledge tool output format
103d64f feat: add version display in widget footer
8958d8d feat: auto-detect dev/prod environment for frontend
53054f7 fix: enable LLM streaming for proper tool response handling
2016c1a fix: reset tool loop flag after tool_end to stream final response
b531d38 fix: stream buffered response after tool execution instead of discarding
785178b fix: update test expectations for new list_hed_recent tool
bc1b0c4 fix: add paper DOIs to prompt and require tool use for citations
068a852 fix: make agent use knowledge tools by listing repos in prompt
bf49f01 feat: add list_hed_recent tool for querying recent PRs/issues
def2d5f docs: add backend server SSH access instructions to CLAUDE.md
2cd747c feat: add hed-python to GitHub sync repos
05d0ddd feat: add citation tracking for core HED papers
5a255b2 fix: resolve pyalex iteration error in papers sync
ffe1159 Merge pull request #37 from OpenScience-Collective/feature/issue-32-github-rest-api
435d1db fix: prevent intermediate thinking from leaking into chat responses
11ff05b Add pop-out button to chat widget for full-screen view (#38)
4f85938 fix: improve error handling in GitHub sync
14277b6 feat: migrate GitHub sync from gh CLI to REST API
b32f49e Merge pull request #33 from OpenScience-Collective/feature/modular-assistants
aa2bafc Merge pull request #35 from OpenScience-Collective/feature/issue-34-token-trimming
5f29cfc fix: remove end_on parameter that dropped AI responses
84c0745 feat: add token-aware conversation trimming to reduce context size
c03fdf5 refactor: remove backward compatibility modules
53be5e6 fix: use correct parameter name in test factory function
51a8b9f test: add tests for registry, knowledge tools, and project validation
87d217e refactor: lazy-load HED_REPOS for backward compatibility
27dfe2f refactor: remove duplicate retrieve_hed_docs from docs.py
49c4d37 refactor: improve FTS5 exception handling in search
413a479 refactor: add logging to HED tool exception handlers
8704463 refactor: improve assistant registry and discovery
4788588 test: update tests for modular assistant architecture
48af24a refactor: expose SSRF protection functions for testing
02e04f9 refactor: add backward compatibility imports for old module paths
60a1246 feat: update API and CLI to use assistant registry
1df9bb2 feat: create self-contained HED assistant package
4ac4362 feat: add assistant registry and parameterize knowledge DB
b7b7852 chore: bump version to 0.3.1.dev0 for sync status API
76eafd4 Merge pull request #29 from OpenScience-Collective/feature/issue-27-sync-status-api
f71fa28 security: address code review findings for sync API
989792e fix: make sync trigger tests environment-agnostic
841b401 feat: add sync status API endpoints for monitoring
b7d23b8 Merge pull request #26 from OpenScience-Collective/feature/issue-25-knowledge-sources
fd60760 security: add FTS5 query sanitization to prevent injection attacks
7493bbe fix: consolidate .env.example in root, remove duplicate
92141a5 feat: add automated knowledge sync with APScheduler
95a3ddd feat: add knowledge sources database for HED discovery

Full Changelog: v0.2.0a0...v0.4.0.dev0

What's Changed

• feat: add knowledge sources database for HED discovery by @neuromechanist in #26
• feat: add sync status API endpoints for monitoring by @neuromechanist in #29
• feat: add token-aware conversation trimming by @neuromechanist in #35
• feat: refactor assistants into self-contained modular packages by @neuromechanist in #33
• Add pop-out button to chat widget for full-screen view by @neuromechanist in #38
• feat: migrate GitHub sync from gh CLI to REST API by @neuromechanist in #37
• feat: add YAML-based community registry (Phase 1) by @neuromechanist in #44
• feat: migrate HED to YAML + CommunityAssistant by @neuromechanist in #51
• feat: add generic CommunityAssistant for YAML-only communities by @neuromechanist in #50
• refactor: complete YAML-driven assistant architecture by @neuromechanist in #52

Full Changelog: v0.2.0a0...v0.4.0.dev0

OSA v0.3.2a0

What's Changed

cdf513d Bump version to 0.3.2a0
dddecf5 Merge pull request #43 from OpenScience-Collective/develop
bef52e9 Merge branch 'main' into develop
26253de test: add critical test coverage for sync and deduplication
e554c26 fix: propagate database operational errors instead of returning empty results
83e52c5 fix: address PR review findings - improve error handling and docs
f1957fb chore: bump version to 0.3.2.dev0
0208737 fix: align env var name GIT_COMMIT_SHA in Dockerfile
5d32c71 feat: add git commit SHA to health endpoint and footer
1bf9909 fix: add fuzzy matching for paper deduplication
c55ff68 fix: improve knowledge tool output format
103d64f feat: add version display in widget footer
8958d8d feat: auto-detect dev/prod environment for frontend
53054f7 fix: enable LLM streaming for proper tool response handling
2016c1a fix: reset tool loop flag after tool_end to stream final response
b531d38 fix: stream buffered response after tool execution instead of discarding
785178b fix: update test expectations for new list_hed_recent tool
bc1b0c4 fix: add paper DOIs to prompt and require tool use for citations
068a852 fix: make agent use knowledge tools by listing repos in prompt
bf49f01 feat: add list_hed_recent tool for querying recent PRs/issues
def2d5f docs: add backend server SSH access instructions to CLAUDE.md
2cd747c feat: add hed-python to GitHub sync repos
05d0ddd feat: add citation tracking for core HED papers
5a255b2 fix: resolve pyalex iteration error in papers sync
ffe1159 Merge pull request #37 from OpenScience-Collective/feature/issue-32-github-rest-api
435d1db fix: prevent intermediate thinking from leaking into chat responses
11ff05b Add pop-out button to chat widget for full-screen view (#38)
4f85938 fix: improve error handling in GitHub sync
14277b6 feat: migrate GitHub sync from gh CLI to REST API
b32f49e Merge pull request #33 from OpenScience-Collective/feature/modular-assistants
aa2bafc Merge pull request #35 from OpenScience-Collective/feature/issue-34-token-trimming
5f29cfc fix: remove end_on parameter that dropped AI responses
84c0745 feat: add token-aware conversation trimming to reduce context size
c03fdf5 refactor: remove backward compatibility modules
53be5e6 fix: use correct parameter name in test factory function
51a8b9f test: add tests for registry, knowledge tools, and project validation
87d217e refactor: lazy-load HED_REPOS for backward compatibility
27dfe2f refactor: remove duplicate retrieve_hed_docs from docs.py
49c4d37 refactor: improve FTS5 exception handling in search
413a479 refactor: add logging to HED tool exception handlers
8704463 refactor: improve assistant registry and discovery
4788588 test: update tests for modular assistant architecture
48af24a refactor: expose SSRF protection functions for testing
02e04f9 refactor: add backward compatibility imports for old module paths
60a1246 feat: update API and CLI to use assistant registry
1df9bb2 feat: create self-contained HED assistant package
4ac4362 feat: add assistant registry and parameterize knowledge DB
b7b7852 chore: bump version to 0.3.1.dev0 for sync status API
76eafd4 Merge pull request #29 from OpenScience-Collective/feature/issue-27-sync-status-api
f71fa28 security: address code review findings for sync API
989792e fix: make sync trigger tests environment-agnostic
841b401 feat: add sync status API endpoints for monitoring
b7d23b8 Merge pull request #26 from OpenScience-Collective/feature/issue-25-knowledge-sources
fd60760 security: add FTS5 query sanitization to prevent injection attacks
7493bbe fix: consolidate .env.example in root, remove duplicate
92141a5 feat: add automated knowledge sync with APScheduler
95a3ddd feat: add knowledge sources database for HED discovery

Full Changelog: v0.2.0a0...v0.3.2a0

What's Changed

• feat: add knowledge sources database for HED discovery by @neuromechanist in #26
• feat: add sync status API endpoints for monitoring by @neuromechanist in #29
• feat: add token-aware conversation trimming by @neuromechanist in #35
• feat: refactor assistants into self-contained modular packages by @neuromechanist in #33
• Add pop-out button to chat widget for full-screen view by @neuromechanist in #38
• feat: migrate GitHub sync from gh CLI to REST API by @neuromechanist in #37
• Release v0.3.2: Knowledge Database, Modular Assistants, and Critical Fixes by @neuromechanist in #43

Full Changelog: v0.2.0a0...v0.3.2a0

OSA v0.2.0a0

What's Changed

a255213 Bump version to 0.2.0a0
c3165d4 Merge pull request #24 from OpenScience-Collective/develop
ec1fdc0 fix: handle ANSI escape codes in CLI help test assertions
1a1c51e test: add CLI structure tests and fix integration tests
d96bf69 docs: add deployment documentation and bump version to 0.2.0.dev1
aacdb8b feat: allow BYOK users to bypass server API key auth
fbe0bca docs: clarify standalone mode auth behavior
d19b35b test: update BYOK header names in tests to match server
83c6bd7 fix: CLI endpoint and BYOK header fixes for standalone mode
f8b2659 Merge pull request #23 from OpenScience-Collective/feature/cli-restructure
daeecf8 docs: update README for new CLI structure and package name
d85577a ci: add Python 3.13 to test matrix and classifiers
48bd102 feat: restructure CLI and rename package to open-science-assistant
2751e36 Merge pull request #22 from OpenScience-Collective/develop
d958dba ci: add auto-release workflow for version tags

Full Changelog: v0.1.0a1...v0.2.0a0

What's Changed

• ci: add auto-release workflow by @neuromechanist in #22
• feat: restructure CLI and rename package to open-science-assistant by @neuromechanist in #23
• release: v0.2.0a0 - CLI restructure and package rename by @neuromechanist in #24

Full Changelog: v0.1.0a1...v0.2.0a0

OSA v0.1.0a1 - First Alpha Release

OSA v0.1.0a1 - First Alpha Release

Open Science Assistant is an extensible AI assistant platform for open science projects, starting with HED (Hierarchical Event Descriptors).

Features

• Chat Widget: Embeddable chat widget for documentation sites

  • Markdown rendering with syntax highlighting
  • Copy buttons for code blocks and messages
  • Privacy-respecting page context toggle
  • Responsive design for desktop and mobile

• Page Context Awareness: Optional URL/title sharing for context-aware responses

  • User-controlled with localStorage persistence
  • SSRF protection with strict URL validation

• Backend API: FastAPI-based assistant backend

  • OpenRouter integration for LLM provider abstraction
  • Rate limiting and CORS protection
  • Health check endpoints

• CI/CD: Automated deployment

  • Cloudflare Pages deployment for frontend demo
  • GitHub Actions workflows

Deployment

• Demo: https://osa-demo.pages.dev
• Preview: https://develop.osa-demo.pages.dev

Getting Started

uv sync
uv run uvicorn src.api.main:app --reload --port 38528

See the README for full documentation.