Add a reproducible Python 3.11 local installation for Cowork Local, including runtime dependencies, safe installer/launcher scripts, and verified installation documentation.
Change Type
Documentation
Test / hardening
Scope
Included: isolated .venv, non-destructive user launcher, core/optional requirements, macOS installation record, and README quick start.
Not included: application behavior changes, packaging as a signed macOS .app, provider credentials, or Windows-only dependencies.
Validation
Unit tests
Manual verification
Regression check
Commands / evidence:
.venv/bin/python -m pytest tests -q — 81 passed
All Cowork Local modules imported — 0 failures
Qt offscreen application startup — exit 0
Installer rerun — idempotent, 75 ms reconciliation
Secret scan — 0 findings
Security Impact
No credentials are stored. The installer uses a repository-local virtual environment and never overwrites an existing user launcher.
Compatibility
No breaking change
Reviewer Notes
Windows-only AppContainer/Outlook/Office COM paths remain optional and unavailable on macOS, as documented.
## Summary
Add a reproducible Python 3.11 local installation for Cowork Local, including runtime dependencies, safe installer/launcher scripts, and verified installation documentation.
## Change Type
- [x] Documentation
- [x] Test / hardening
## Scope
Included: isolated `.venv`, non-destructive user launcher, core/optional requirements, macOS installation record, and README quick start.
Not included: application behavior changes, packaging as a signed macOS `.app`, provider credentials, or Windows-only dependencies.
## Validation
- [x] Unit tests
- [x] Manual verification
- [x] Regression check
Commands / evidence:
- `.venv/bin/python -m pytest tests -q` — 81 passed
- All Cowork Local modules imported — 0 failures
- Qt offscreen application startup — exit 0
- Installer rerun — idempotent, 75 ms reconciliation
- Secret scan — 0 findings
## Security Impact
No credentials are stored. The installer uses a repository-local virtual environment and never overwrites an existing user launcher.
## Compatibility
- [x] No breaking change
## Reviewer Notes
Windows-only AppContainer/Outlook/Office COM paths remain optional and unavailable on macOS, as documented.
PR này vẫn giữ nguyên scope cài đặt local có thể tái lập. Không đưa feature MCP vào PR #1. Sau khi PR #1 được Cowork Team review/merge, một team ALPHA/MCP thực hiện tuần tự:
ALPHA-01 / issue #2 — chốt provider-neutral contract và mapping vào McpServerConnection, AppContext.build_mcp_tools, combine_tool_sources, audit_log.record.
ALPHA-02 / issue #3 — feature PR riêng cho provider interface và Gitea reference adapter của get_project_issue.
ALPHA-03 / issue #4 — feature PR riêng cho search_project_knowledge, fixture tối thiểu và Agent demo.
GAMMA/RAG không phải dependency của luồng này. Contract phải cho phép team MCP bổ sung Jira/Redmine adapter sau pilot mà không sửa Agent/tool schema.
## Follow-up sau baseline cài đặt
PR này vẫn giữ nguyên scope **cài đặt local có thể tái lập**. Không đưa feature MCP vào PR #1. Sau khi PR #1 được Cowork Team review/merge, một team ALPHA/MCP thực hiện tuần tự:
1. [ALPHA-01 / issue #2](http://34.143.229.138/gitea-admin/fsg-ai-core-assets/issues/2) — chốt provider-neutral contract và mapping vào `McpServerConnection`, `AppContext.build_mcp_tools`, `combine_tool_sources`, `audit_log.record`.
2. [ALPHA-02 / issue #3](http://34.143.229.138/gitea-admin/fsg-ai-core-assets/issues/3) — feature PR riêng cho provider interface và Gitea reference adapter của `get_project_issue`.
3. [ALPHA-03 / issue #4](http://34.143.229.138/gitea-admin/fsg-ai-core-assets/issues/4) — feature PR riêng cho `search_project_knowledge`, fixture tối thiểu và Agent demo.
GAMMA/RAG không phải dependency của luồng này. Contract phải cho phép team MCP bổ sung Jira/Redmine adapter sau pilot mà không sửa Agent/tool schema.
Hướng dẫn: [Playbook Cowork Local MCP Pilot](http://34.143.229.138/gitea-admin/fsg-ai-core-assets/src/branch/main/docs/task-management/PLAYBOOK_COWORK_LOCAL_MCP_PILOT.md).
taiph9
scheduled this pull request to auto merge when all checks succeed 2026-08-17 11:25:30 +00:00
taiph9
scheduled this pull request to auto merge when all checks succeed 2026-08-17 11:35:08 +00:00
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Summary
Add a reproducible Python 3.11 local installation for Cowork Local, including runtime dependencies, safe installer/launcher scripts, and verified installation documentation.
Change Type
Scope
Included: isolated
.venv, non-destructive user launcher, core/optional requirements, macOS installation record, and README quick start.Not included: application behavior changes, packaging as a signed macOS
.app, provider credentials, or Windows-only dependencies.Validation
Commands / evidence:
.venv/bin/python -m pytest tests -q— 81 passedSecurity Impact
No credentials are stored. The installer uses a repository-local virtual environment and never overwrites an existing user launcher.
Compatibility
Reviewer Notes
Windows-only AppContainer/Outlook/Office COM paths remain optional and unavailable on macOS, as documented.
Follow-up sau baseline cài đặt
PR này vẫn giữ nguyên scope cài đặt local có thể tái lập. Không đưa feature MCP vào PR #1. Sau khi PR #1 được Cowork Team review/merge, một team ALPHA/MCP thực hiện tuần tự:
McpServerConnection,AppContext.build_mcp_tools,combine_tool_sources,audit_log.record.get_project_issue.search_project_knowledge, fixture tối thiểu và Agent demo.GAMMA/RAG không phải dependency của luồng này. Contract phải cho phép team MCP bổ sung Jira/Redmine adapter sau pilot mà không sửa Agent/tool schema.
Hướng dẫn: Playbook Cowork Local MCP Pilot.
View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.