Feature/delta team/epic r04 (#7)

## Summary

epic r04 - begin refactor

## Change Type

- [x] Cowork feature
- [ ] Bug fix
- [ ] Core AI contribution
- [ ] Test / hardening
- [ ] Performance
- [ ] Documentation

## Related Work

Cowork Task:

Core Repo: http://34.143.229.138/gitea-admin/fsg-ai-core-assets

Core AI Issue:

Core Task:

Related PR:

## Scope

What is intentionally included?

What is intentionally NOT included?

## Validation

- [ ] Unit tests
- [ ] Integration tests
- [ ] Manual verification
- [ ] Regression check

Commands / evidence:

## Security Impact

Permission / credential / network / customer data impact:

## Compatibility

- [ ] No breaking change
- [ ] Breaking change documented

## Reviewer Notes

Anything Cowork reviewers should pay attention to.

---------

Co-authored-by: Anh Tran Nguyen Minh <anhtnm1@fpt.com>
Co-authored-by: Huong Le Thi Thien <huongltt35@fpt.com>
Co-authored-by: Nam Pham Dinh Thanh <nampdt@fpt.com>
Co-authored-by: Vu Dam Tuan <vudt15@fpt.com>
Co-authored-by: Hiep Ha Van <hiephv3@fpt.com>
Co-authored-by: Lam Hoang Van <lamhv7@fpt.com>
Reviewed-on: #7
Co-authored-by: Duy Le Huu <duylh19@fpt.com>

mcp_servers/project_context/providers/issue.py

@@ -8,11 +8,24 @@ from ..foundation import IdentityContext, ProviderError
 
 
 class IssueProvider(Protocol):
-    def get_issue_context(self, **arguments: Any) -> dict[str, Any]: ...
+    """Nguồn cấp bối cảnh issue/ticket cho một project.
+
+    Chỉ là hợp đồng: bản cài đặt thật được nối vào qua ``build_provider``.
+    """
+    def get_issue_context(self, **arguments: Any) -> dict[str, Any]:
+        """Trả về bối cảnh issue/ticket theo tham số của tool."""
+        ...
 
 
 class UnconfiguredIssueProvider:
+    """Bản thay thế khi chưa cấu hình nguồn issue/ticket thật.
+
+    Luôn ném lỗi ``UNAVAILABLE`` thay vì trả dữ liệu rỗng — rỗng sẽ bị Agent
+    hiểu nhầm là "tra rồi, không có gì", còn lỗi thì nói đúng sự thật là
+    chưa có nguồn nào được nối.
+    """
     def get_issue_context(self, **arguments: Any) -> dict[str, Any]:
+        """Luôn báo chưa cấu hình; không cho thử lại."""
         raise ProviderError(
             "UNAVAILABLE",
             "The issue provider is not configured for this environment.",