refactor(knowledge): extract retrieval contracts - #193
Merged
Conversation
|
Warning Review limit reached
Next review available in: 53 minutes Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available. How can I continue?After more reviews become available, a review can be triggered using the To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews. How do review limits work?CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability. For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window. Please refer docs for additional details. Review details⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: ASSERTIVE Plan: Pro Plus Run ID: 📒 Files selected for processing (1)
📝 WalkthroughWalkthroughThe PR moves knowledge retrieval contracts into ChangesKnowledge retrieval module
Estimated code review effort: 2 (Simple) | ~10 minutes Possibly related PRs
🚥 Pre-merge checks | ✅ 4 | ❌ 1❌ Failed checks (1 warning)
✅ Passed checks (4 passed)
✨ Finishing Touches 💡 1📝 Generate docstrings 💡
🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
Contributor
TegamiThis repository uses Tegami to manage releases. When your changes affect published packages, add a changelog file under Create a changelog → · Changelog format Release preview
Changelogs in this PR
Run Managed by Tegami. |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In @.tegami/knowledge-retrieval-contracts.md:
- Line 7: Add a top-level H1 heading after the front matter in
knowledge-retrieval-contracts.md, before the existing “Improvements” heading, so
the document satisfies Markdownlint MD041 while preserving the current section
structure.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: ASSERTIVE
Plan: Pro Plus
Run ID: 12121ffe-283e-4554-a623-b54ffd019e70
⛔ Files ignored due to path filters (2)
docs/increments/active/2026-07-31-spring-modulith-package-refactor/design.mdis excluded by!docs/**docs/increments/active/2026-07-31-spring-modulith-package-refactor/plan.mdis excluded by!docs/**
📒 Files selected for processing (53)
.tegami/knowledge-retrieval-contracts.mdapps/api/src/main/java/com/orgmemory/api/OrgMemoryApiApplication.javaapps/api/src/main/java/com/orgmemory/api/admin/AdminAiModelController.javaapps/api/src/main/java/com/orgmemory/api/assistant/GraphRagRuntimeConfiguration.javaapps/api/src/main/java/com/orgmemory/api/knowledge/SpringAiQueryEmbeddingAdapter.javaapps/api/src/test/java/com/orgmemory/api/admin/KnowledgeSpaceAdminIntegrationTests.javaapps/api/src/test/java/com/orgmemory/api/admin/PermissionsAdminIntegrationTests.javaapps/api/src/test/java/com/orgmemory/api/assetregistry/AssetRegistryIntegrationTests.javaapps/worker/src/main/java/com/orgmemory/worker/connector/ModelConnectorTextEmbedder.javaapps/worker/src/main/java/com/orgmemory/worker/ingestion/SourceIngestionProcessor.javaapps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorContentEditIntegrationTests.javaapps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorCrawlCheckpointIntegrationTests.javaapps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorIdentityTrustIntegrationTests.javaapps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorPruningIntegrationTests.javaapps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorStagingIngestionIntegrationTests.javaapps/worker/src/test/java/com/orgmemory/worker/graph/GraphIndexingProcessorTests.javaapps/worker/src/test/java/com/orgmemory/worker/graph/GraphPublicationCommitterTests.javaapps/worker/src/test/java/com/orgmemory/worker/ingestion/SourceIngestionPipelineIntegrationTests.javacore/src/main/java/com/orgmemory/core/knowledge/CanonicalHybridKnowledgeSearch.javacore/src/main/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalConfiguration.javacore/src/main/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalService.javacore/src/main/java/com/orgmemory/core/knowledge/SecureKnowledgeRetrievalStore.javacore/src/main/java/com/orgmemory/core/knowledge/asset/KnowledgeAssetLifecycleService.javacore/src/main/java/com/orgmemory/core/knowledge/asset/KnowledgeChunkProjectionStore.javacore/src/main/java/com/orgmemory/core/knowledge/asset/PublishKnowledgeAssetCommand.javacore/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorEmbeddingResult.javacore/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorReconciler.javacore/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorSourceRevisionCoordinator.javacore/src/main/java/com/orgmemory/core/knowledge/graph/ClaimedGraphIndex.javacore/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinator.javacore/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationService.javacore/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerService.javacore/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExportService.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingDistanceMetric.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfile.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileRef.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileRegistry.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileRepository.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileSpec.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/KnowledgeEmbeddingProperties.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/KnowledgeProjectionNamespaces.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/QueryEmbedding.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/QueryEmbeddingPort.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/package-info.javacore/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceIngestionCoordinator.javacore/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceQueryService.javacore/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceRevision.javacore/src/test/java/com/orgmemory/core/ModulithVerificationTests.javacore/src/test/java/com/orgmemory/core/knowledge/CanonicalHybridKnowledgeSearchTests.javacore/src/test/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalServiceTests.javacore/src/test/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinatorTests.javacore/src/test/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileSpecTests.javacore/src/test/java/com/orgmemory/core/knowledge/sourceledger/SourceQueryServiceTests.java
📜 Review details
⏰ Context from checks skipped due to timeout. (2)
- GitHub Check: Web · Node 24
- GitHub Check: Backend · Java 25
🧰 Additional context used
📓 Path-based instructions (4)
**/*
📄 CodeRabbit inference engine (AGENTS.md)
**/*: Treat the repository and runtime evidence as the engineering system of record; do not treat chat or Northstar as authoritative.
Before changing a domain, read its specification, test-coverage document, and applicable decision filenames.
Material decisions about domain boundaries, authorization, persistence, publication, concurrency, cache isolation, parity scope, or deployment require an independent architecture challenge and documented alternatives before implementation.
Do not use completed increment documents as the source for current behavior; use them only for history or archaeology.
Before using unfamiliar Spring Boot, Spring Modulith, Spring AI, Gradle, React, Vite, Tailwind, TypeScript, Next.js, or Fumadocs APIs, consult current official documentation, Context7, and the relevant verification skill.
Readdocs/guidelines/agent-safety.mdbefore retrieval, AI, MCP, permission, upload, graph, or export work; never commit secrets or customer data.
Keepddl-auto=validateand pair every persisted-model change with a Flyway migration.
Use the testing harness; a terminating clean test is the JVM context gate, andbootRunis not verification.
Files:
core/src/main/java/com/orgmemory/core/knowledge/SecureKnowledgeRetrievalStore.javaapps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorStagingIngestionIntegrationTests.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingDistanceMetric.javaapps/worker/src/test/java/com/orgmemory/worker/graph/GraphPublicationCommitterTests.javacore/src/test/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileSpecTests.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileRef.javacore/src/main/java/com/orgmemory/core/knowledge/CanonicalHybridKnowledgeSearch.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfile.javacore/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorSourceRevisionCoordinator.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/KnowledgeProjectionNamespaces.javaapps/api/src/main/java/com/orgmemory/api/OrgMemoryApiApplication.javacore/src/test/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinatorTests.javacore/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationService.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/KnowledgeEmbeddingProperties.javacore/src/test/java/com/orgmemory/core/knowledge/CanonicalHybridKnowledgeSearchTests.javaapps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorCrawlCheckpointIntegrationTests.javaapps/api/src/test/java/com/orgmemory/api/admin/KnowledgeSpaceAdminIntegrationTests.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/QueryEmbeddingPort.javaapps/worker/src/main/java/com/orgmemory/worker/connector/ModelConnectorTextEmbedder.javaapps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorIdentityTrustIntegrationTests.javaapps/api/src/test/java/com/orgmemory/api/assetregistry/AssetRegistryIntegrationTests.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileRepository.javaapps/worker/src/main/java/com/orgmemory/worker/ingestion/SourceIngestionProcessor.javaapps/api/src/main/java/com/orgmemory/api/admin/AdminAiModelController.javacore/src/test/java/com/orgmemory/core/ModulithVerificationTests.javacore/src/main/java/com/orgmemory/core/knowledge/asset/KnowledgeAssetLifecycleService.javacore/src/main/java/com/orgmemory/core/knowledge/asset/KnowledgeChunkProjectionStore.javaapps/api/src/main/java/com/orgmemory/api/assistant/GraphRagRuntimeConfiguration.javacore/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerService.javacore/src/test/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalServiceTests.javacore/src/main/java/com/orgmemory/core/knowledge/graph/ClaimedGraphIndex.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/package-info.javacore/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinator.javacore/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceRevision.javaapps/api/src/test/java/com/orgmemory/api/admin/PermissionsAdminIntegrationTests.javaapps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorPruningIntegrationTests.javacore/src/main/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalConfiguration.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/QueryEmbedding.javacore/src/test/java/com/orgmemory/core/knowledge/sourceledger/SourceQueryServiceTests.javacore/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorReconciler.javaapps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorContentEditIntegrationTests.javacore/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorEmbeddingResult.javacore/src/main/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalService.javaapps/worker/src/test/java/com/orgmemory/worker/ingestion/SourceIngestionPipelineIntegrationTests.javacore/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExportService.javacore/src/main/java/com/orgmemory/core/knowledge/asset/PublishKnowledgeAssetCommand.javacore/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceQueryService.javacore/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceIngestionCoordinator.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileSpec.javaapps/worker/src/test/java/com/orgmemory/worker/graph/GraphIndexingProcessorTests.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileRegistry.javaapps/api/src/main/java/com/orgmemory/api/knowledge/SpringAiQueryEmbeddingAdapter.java
**/*.java
📄 CodeRabbit inference engine (AGENTS.md)
Apply IDE inspection only to edited backend Java files.
Files:
core/src/main/java/com/orgmemory/core/knowledge/SecureKnowledgeRetrievalStore.javaapps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorStagingIngestionIntegrationTests.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingDistanceMetric.javaapps/worker/src/test/java/com/orgmemory/worker/graph/GraphPublicationCommitterTests.javacore/src/test/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileSpecTests.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileRef.javacore/src/main/java/com/orgmemory/core/knowledge/CanonicalHybridKnowledgeSearch.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfile.javacore/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorSourceRevisionCoordinator.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/KnowledgeProjectionNamespaces.javaapps/api/src/main/java/com/orgmemory/api/OrgMemoryApiApplication.javacore/src/test/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinatorTests.javacore/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationService.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/KnowledgeEmbeddingProperties.javacore/src/test/java/com/orgmemory/core/knowledge/CanonicalHybridKnowledgeSearchTests.javaapps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorCrawlCheckpointIntegrationTests.javaapps/api/src/test/java/com/orgmemory/api/admin/KnowledgeSpaceAdminIntegrationTests.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/QueryEmbeddingPort.javaapps/worker/src/main/java/com/orgmemory/worker/connector/ModelConnectorTextEmbedder.javaapps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorIdentityTrustIntegrationTests.javaapps/api/src/test/java/com/orgmemory/api/assetregistry/AssetRegistryIntegrationTests.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileRepository.javaapps/worker/src/main/java/com/orgmemory/worker/ingestion/SourceIngestionProcessor.javaapps/api/src/main/java/com/orgmemory/api/admin/AdminAiModelController.javacore/src/test/java/com/orgmemory/core/ModulithVerificationTests.javacore/src/main/java/com/orgmemory/core/knowledge/asset/KnowledgeAssetLifecycleService.javacore/src/main/java/com/orgmemory/core/knowledge/asset/KnowledgeChunkProjectionStore.javaapps/api/src/main/java/com/orgmemory/api/assistant/GraphRagRuntimeConfiguration.javacore/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerService.javacore/src/test/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalServiceTests.javacore/src/main/java/com/orgmemory/core/knowledge/graph/ClaimedGraphIndex.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/package-info.javacore/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinator.javacore/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceRevision.javaapps/api/src/test/java/com/orgmemory/api/admin/PermissionsAdminIntegrationTests.javaapps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorPruningIntegrationTests.javacore/src/main/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalConfiguration.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/QueryEmbedding.javacore/src/test/java/com/orgmemory/core/knowledge/sourceledger/SourceQueryServiceTests.javacore/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorReconciler.javaapps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorContentEditIntegrationTests.javacore/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorEmbeddingResult.javacore/src/main/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalService.javaapps/worker/src/test/java/com/orgmemory/worker/ingestion/SourceIngestionPipelineIntegrationTests.javacore/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExportService.javacore/src/main/java/com/orgmemory/core/knowledge/asset/PublishKnowledgeAssetCommand.javacore/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceQueryService.javacore/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceIngestionCoordinator.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileSpec.javaapps/worker/src/test/java/com/orgmemory/worker/graph/GraphIndexingProcessorTests.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileRegistry.javaapps/api/src/main/java/com/orgmemory/api/knowledge/SpringAiQueryEmbeddingAdapter.java
core/src/main/java/com/orgmemory/core/{authorization,knowledge,permission}/**/*.java
⚙️ CodeRabbit configuration file
core/src/main/java/com/orgmemory/core/{authorization,knowledge,permission}/**/*.java: Treat PostgreSQL ACL evidence as canonical and OpenFGA as the relationship
authorization decision point. Authorization must fail closed. Filtering
must happen before ranking, LIMIT, graph traversal, answer generation,
export, and citation rendering. Flag metadata or timing leak paths.
Files:
core/src/main/java/com/orgmemory/core/knowledge/SecureKnowledgeRetrievalStore.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingDistanceMetric.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileRef.javacore/src/main/java/com/orgmemory/core/knowledge/CanonicalHybridKnowledgeSearch.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfile.javacore/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorSourceRevisionCoordinator.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/KnowledgeProjectionNamespaces.javacore/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationService.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/KnowledgeEmbeddingProperties.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/QueryEmbeddingPort.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileRepository.javacore/src/main/java/com/orgmemory/core/knowledge/asset/KnowledgeAssetLifecycleService.javacore/src/main/java/com/orgmemory/core/knowledge/asset/KnowledgeChunkProjectionStore.javacore/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerService.javacore/src/main/java/com/orgmemory/core/knowledge/graph/ClaimedGraphIndex.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/package-info.javacore/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinator.javacore/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceRevision.javacore/src/main/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalConfiguration.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/QueryEmbedding.javacore/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorReconciler.javacore/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorEmbeddingResult.javacore/src/main/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalService.javacore/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExportService.javacore/src/main/java/com/orgmemory/core/knowledge/asset/PublishKnowledgeAssetCommand.javacore/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceQueryService.javacore/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceIngestionCoordinator.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileSpec.javacore/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileRegistry.java
apps/api/src/main/java/**/*.java
⚙️ CodeRabbit configuration file
apps/api/src/main/java/**/*.java: Enforce the browser-BFF and resource-server boundaries. Authentication
must resolve an active internal actor through the explicit issuer and
subject binding. Reject identity, tenant, roles, or permissions supplied
by request payloads, JWT email, or untrusted JWT role claims.
Files:
apps/api/src/main/java/com/orgmemory/api/OrgMemoryApiApplication.javaapps/api/src/main/java/com/orgmemory/api/admin/AdminAiModelController.javaapps/api/src/main/java/com/orgmemory/api/assistant/GraphRagRuntimeConfiguration.javaapps/api/src/main/java/com/orgmemory/api/knowledge/SpringAiQueryEmbeddingAdapter.java
🧠 Learnings (2)
📚 Learning: 2026-07-26T05:46:47.443Z
Learnt from: kl3inIT
Repo: kl3inIT/OrgMemory PR: 61
File: apps/mcp/src/main/java/com/orgmemory/mcp/McpSecurityConfiguration.java:50-52
Timestamp: 2026-07-26T05:46:47.443Z
Learning: In OrgMemory, treat the `apps/mcp` and `apps/api` as independent protocol adapter modules. When adjusting OAuth/wire-level scopes, do not introduce a shared Java constant or create a code dependency from `apps/mcp` to `apps/api` solely to deduplicate scope values. Instead, keep OAuth/scope constants adapter-local (e.g., in the relevant adapter/security configuration classes) and ensure cross-adapter consistency via automated realm/OAuth/authorization tests, rather than via shared wiring-level constants or cross-module references.
Applied to files:
apps/api/src/main/java/com/orgmemory/api/OrgMemoryApiApplication.javaapps/api/src/main/java/com/orgmemory/api/admin/AdminAiModelController.javaapps/api/src/main/java/com/orgmemory/api/assistant/GraphRagRuntimeConfiguration.javaapps/api/src/main/java/com/orgmemory/api/knowledge/SpringAiQueryEmbeddingAdapter.java
📚 Learning: 2026-07-24T22:53:12.988Z
Learnt from: kl3inIT
Repo: kl3inIT/OrgMemory PR: 40
File: apps/api/src/main/java/com/orgmemory/api/knowledge/CitationContentController.java:0-0
Timestamp: 2026-07-24T22:53:12.988Z
Learning: For OrgMemory knowledge content handling in the API, treat `KnowledgeContentType` as the single closed policy (source of truth) for: canonical storage media type, browser-safe response media type, upload eligibility rules, and inline disposition behavior. Do not duplicate or bypass these decisions in controllers/services; route media-type and disposition logic through `KnowledgeContentType`. Specifically, Markdown should be stored with the canonical media type `text/markdown`, but served as `text/plain` when returning browser-safe citation preview content.
Applied to files:
apps/api/src/main/java/com/orgmemory/api/knowledge/SpringAiQueryEmbeddingAdapter.java
🪛 markdownlint-cli2 (0.23.1)
.tegami/knowledge-retrieval-contracts.md
[warning] 7-7: First line in a file should be a top-level heading
(MD041, first-line-heading, first-line-h1)
🔇 Additional comments (53)
core/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingDistanceMetric.java (1)
1-1: LGTM!core/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfile.java (1)
1-1: LGTM!apps/api/src/main/java/com/orgmemory/api/OrgMemoryApiApplication.java (1)
7-7: LGTM!apps/api/src/main/java/com/orgmemory/api/admin/AdminAiModelController.java (1)
11-11: LGTM!apps/api/src/main/java/com/orgmemory/api/assistant/GraphRagRuntimeConfiguration.java (1)
6-6: LGTM!apps/api/src/main/java/com/orgmemory/api/knowledge/SpringAiQueryEmbeddingAdapter.java (1)
6-11: LGTM!apps/api/src/test/java/com/orgmemory/api/admin/KnowledgeSpaceAdminIntegrationTests.java (1)
24-24: LGTM!apps/api/src/test/java/com/orgmemory/api/admin/PermissionsAdminIntegrationTests.java (1)
25-25: LGTM!apps/api/src/test/java/com/orgmemory/api/assetregistry/AssetRegistryIntegrationTests.java (1)
60-60: LGTM!apps/worker/src/main/java/com/orgmemory/worker/connector/ModelConnectorTextEmbedder.java (1)
5-8: LGTM!core/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileRef.java (1)
1-1: LGTM!core/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileRegistry.java (1)
1-1: LGTM!core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceQueryService.java (1)
3-5: LGTM!core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceRevision.java (1)
3-3: LGTM!core/src/test/java/com/orgmemory/core/knowledge/CanonicalHybridKnowledgeSearchTests.java (1)
15-16: LGTM!core/src/test/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalServiceTests.java (1)
21-24: LGTM!core/src/test/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinatorTests.java (1)
3-6: LGTM!core/src/test/java/com/orgmemory/core/knowledge/sourceledger/SourceQueryServiceTests.java (1)
5-5: LGTM!apps/worker/src/test/java/com/orgmemory/worker/graph/GraphPublicationCommitterTests.java (1)
13-14: LGTM!apps/worker/src/test/java/com/orgmemory/worker/ingestion/SourceIngestionPipelineIntegrationTests.java (1)
29-33: LGTM!core/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileRepository.java (1)
1-1: LGTM!core/src/main/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileSpec.java (1)
1-1: LGTM!core/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorEmbeddingResult.java (1)
3-3: LGTM!core/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorReconciler.java (1)
3-3: LGTM!core/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorSourceRevisionCoordinator.java (1)
3-3: LGTM!core/src/main/java/com/orgmemory/core/knowledge/graph/ClaimedGraphIndex.java (1)
3-3: LGTM!core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinator.java (1)
3-5: LGTM!core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationService.java (1)
5-5: LGTM!core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerService.java (1)
5-5: LGTM!core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExportService.java (1)
5-5: LGTM!core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceIngestionCoordinator.java (1)
3-3: LGTM!core/src/main/java/com/orgmemory/core/knowledge/retrieval/KnowledgeEmbeddingProperties.java (1)
1-1: LGTM!core/src/main/java/com/orgmemory/core/knowledge/retrieval/KnowledgeProjectionNamespaces.java (1)
1-1: LGTM!core/src/main/java/com/orgmemory/core/knowledge/retrieval/QueryEmbedding.java (1)
1-1: LGTM!apps/worker/src/main/java/com/orgmemory/worker/ingestion/SourceIngestionProcessor.java (1)
19-22: LGTM!apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorContentEditIntegrationTests.java (1)
39-39: LGTM!apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorCrawlCheckpointIntegrationTests.java (1)
29-29: LGTM!apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorIdentityTrustIntegrationTests.java (1)
36-36: LGTM!apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorPruningIntegrationTests.java (1)
36-36: LGTM!apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorStagingIngestionIntegrationTests.java (1)
31-31: LGTM!apps/worker/src/test/java/com/orgmemory/worker/graph/GraphIndexingProcessorTests.java (1)
23-24: LGTM!core/src/main/java/com/orgmemory/core/knowledge/retrieval/QueryEmbeddingPort.java (1)
1-1: LGTM!core/src/main/java/com/orgmemory/core/knowledge/retrieval/package-info.java (1)
1-9: LGTM!core/src/test/java/com/orgmemory/core/knowledge/retrieval/EmbeddingProfileSpecTests.java (1)
1-1: LGTM!core/src/test/java/com/orgmemory/core/ModulithVerificationTests.java (2)
63-68: LGTM!
70-119: LGTM!core/src/main/java/com/orgmemory/core/knowledge/CanonicalHybridKnowledgeSearch.java (1)
3-4: LGTM!core/src/main/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalConfiguration.java (1)
3-4: LGTM!core/src/main/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalService.java (1)
8-14: LGTM!core/src/main/java/com/orgmemory/core/knowledge/SecureKnowledgeRetrievalStore.java (1)
3-3: LGTM!core/src/main/java/com/orgmemory/core/knowledge/asset/KnowledgeAssetLifecycleService.java (1)
6-6: LGTM!core/src/main/java/com/orgmemory/core/knowledge/asset/KnowledgeChunkProjectionStore.java (1)
3-3: LGTM!core/src/main/java/com/orgmemory/core/knowledge/asset/PublishKnowledgeAssetCommand.java (1)
3-3: LGTM!
This was referenced Aug 1, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
knowledge.retrievalnested moduleVerification
:core:testpython scripts/check_docs.pypnpm release:checkclean testafter merging current main: 99 tasks in 6m22sScope
Summary by CodeRabbit
Refactor
Documentation
Tests