Skip to content

refactor(knowledge): extract graph module - #190

Merged
kl3inIT merged 7 commits into
mainfrom
refactor/modulith-knowledge-graph
Jul 31, 2026
Merged

refactor(knowledge): extract graph module#190
kl3inIT merged 7 commits into
mainfrom
refactor/modulith-knowledge-graph

Conversation

@kl3inIT

@kl3inIT kl3inIT commented Jul 31, 2026

Copy link
Copy Markdown
Owner

Summary

  • move graph indexing, processing profiles, lifecycle, curation, exploration, and export into the open knowledge.graph nested module
  • repair API, worker, connector, source-ledger, asset, and test imports without changing persistence or runtime contracts
  • keep the Asset projection contract graph-neutral and pin the temporary OPEN boundary's exact consumers/internal types

Verification

  • :core:compileJava and :core:compileTestJava
  • focused graph, retrieval-regression, Modulith, API, and worker tests
  • :core:test
  • python scripts/check_docs.py
  • pnpm release:check
  • repository-wide clean test before main sync: 108 tasks, 5m13s
  • repository-wide clean test after origin/main e088e9c: 99 tasks, 6m18s
  • repository-wide clean test after origin/main f99afb9 and conflict resolution: 108 tasks, 6m46s
  • repository-wide clean test after review fix: 99 tasks, 6m26s
  • stale FQN/package/duplicate import/zero-byte/diff and Asset-to-Graph reference checks

Scope

  • 56 changed files
  • root core.knowledge direct Java files: 63 -> 40

@coderabbitai

coderabbitai Bot commented Jul 31, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

The change moves knowledge-graph types into com.orgmemory.core.knowledge.graph, exposes parent-package contracts required by those types, updates API and worker imports, and adjusts Modulith and service tests.

Changes

Knowledge graph package boundary

Layer / File(s) Summary
Relocate graph implementation
core/src/main/java/com/orgmemory/core/knowledge/graph/*
Graph indexing, processing, lifecycle, curation, exploration, export, and configuration types now use the knowledge.graph package.
Expose parent knowledge contracts
core/src/main/java/com/orgmemory/core/knowledge/*
Evidence-scope, embedding, retrieval, and projection contracts required by graph services are now publicly accessible.
Update consumers and verification
apps/api/..., apps/worker/..., core/src/test/...
Application imports, test doubles, service tests, and Modulith expectations now reference the relocated graph types.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly summarizes the primary change: extracting the knowledge graph into a separate module.
Description check ✅ Passed The description provides a clear summary and detailed verification evidence, but it omits the template's Documentation impact section.
✨ Finishing Touches 💡 2
📝 Generate docstrings 💡
  • Create stacked PR
  • Commit on current branch
🛠️ Fix failing CI checks 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch refactor/modulith-knowledge-graph

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.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

kl3inIT added 2 commits August 1, 2026 02:01
…wledge-graph

# Conflicts:
#	core/src/main/java/com/orgmemory/core/knowledge/ResolvedKnowledgeEvidenceScope.java
@github-actions

github-actions Bot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Tegami

This repository uses Tegami to manage releases. When your changes affect published packages, add a changelog file under .tegami/ before merging.

Create a changelog → · Changelog format

Release preview

Package Bump Version
orgmemory patch 0.1.10.1.2

Changelogs in this PR

Changelog Title
knowledge-graph-module.md Improvements

Run pnpm run tegami locally to create a changelog interactively.

Managed by Tegami.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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
`@core/src/main/java/com/orgmemory/core/knowledge/asset/KnowledgeChunkProjectionStore.java`:
- Line 4: Address the cross-module dependency exposed by
KnowledgeChunkProjectionStore.loadActive(...) and GraphIndexingCoordinator
injection: either make the contract graph-neutral by removing GraphIndexChunk
from the asset-facing API, or document an architecture challenge decision
recording this dependency, its rationale, and considered alternatives.
🪄 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: 35996b7e-103a-4f9e-ac0a-7c106f85fac1

📥 Commits

Reviewing files that changed from the base of the PR and between f99afb9 and 0a1c5a7.

⛔ Files ignored due to path filters (2)
  • docs/increments/active/2026-07-31-spring-modulith-package-refactor/design.md is excluded by !docs/**
  • docs/increments/active/2026-07-31-spring-modulith-package-refactor/plan.md is excluded by !docs/**
📒 Files selected for processing (52)
  • apps/api/src/main/java/com/orgmemory/api/OrgMemoryApiApplication.java
  • apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeAssetLifecycleController.java
  • apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeGraphExplorerController.java
  • apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeGraphManagementController.java
  • apps/api/src/test/java/com/orgmemory/api/knowledge/KnowledgeGraphManagementControllerTests.java
  • apps/worker/src/main/java/com/orgmemory/worker/OrgMemoryWorkerApplication.java
  • apps/worker/src/main/java/com/orgmemory/worker/graph/GraphIndexingProcessor.java
  • apps/worker/src/main/java/com/orgmemory/worker/graph/GraphPublicationCommitter.java
  • apps/worker/src/test/java/com/orgmemory/worker/graph/GraphIndexingProcessorTests.java
  • apps/worker/src/test/java/com/orgmemory/worker/graph/GraphPublicationCommitterTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/EmbeddingProfile.java
  • core/src/main/java/com/orgmemory/core/knowledge/EmbeddingProfileRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeResolver.java
  • core/src/main/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeUnavailableException.java
  • core/src/main/java/com/orgmemory/core/knowledge/ResolvedKnowledgeEvidenceScope.java
  • core/src/main/java/com/orgmemory/core/knowledge/SecureKnowledgeRetrievalStore.java
  • core/src/main/java/com/orgmemory/core/knowledge/SecureRetrievalCandidate.java
  • core/src/main/java/com/orgmemory/core/knowledge/asset/KnowledgeChunkProjectionStore.java
  • core/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorSourceRevisionCoordinator.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/ClaimedGraphIndex.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphExplorerProperties.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexChunk.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJob.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobQueue.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobStatus.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobView.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexLifecycleService.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinator.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexingStoppedException.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileRef.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileRegistry.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileResolver.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProperties.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationService.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerConfiguration.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerService.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExportService.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphView.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/PersistedGraphProcessingProfile.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/package-info.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceIngestionCoordinator.java
  • core/src/test/java/com/orgmemory/core/ModulithVerificationTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/CanonicalHybridKnowledgeSearchTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalServiceTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/graph/GraphIndexLifecycleServiceTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinatorTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationServiceTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerServiceTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExportServiceTests.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.
Read docs/guidelines/agent-safety.md before retrieval, AI, MCP, permission, upload, graph, or export work; never commit secrets or customer data.
Keep ddl-auto=validate and pair every persisted-model change with a Flyway migration.
Use the testing harness; a terminating clean test is the JVM context gate, and bootRun is not verification.

Files:

  • apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeGraphExplorerController.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/package-info.java
  • core/src/main/java/com/orgmemory/core/knowledge/EmbeddingProfileRepository.java
  • apps/api/src/test/java/com/orgmemory/api/knowledge/KnowledgeGraphManagementControllerTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/EmbeddingProfile.java
  • apps/worker/src/main/java/com/orgmemory/worker/OrgMemoryWorkerApplication.java
  • core/src/test/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationServiceTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExportServiceTests.java
  • apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeGraphManagementController.java
  • core/src/test/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinatorTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobStatus.java
  • core/src/main/java/com/orgmemory/core/knowledge/SecureRetrievalCandidate.java
  • core/src/test/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerServiceTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/graph/GraphIndexLifecycleServiceTests.java
  • apps/worker/src/test/java/com/orgmemory/worker/graph/GraphIndexingProcessorTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobView.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJob.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileResolver.java
  • apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeAssetLifecycleController.java
  • core/src/main/java/com/orgmemory/core/knowledge/ResolvedKnowledgeEvidenceScope.java
  • apps/worker/src/main/java/com/orgmemory/worker/graph/GraphPublicationCommitter.java
  • apps/worker/src/test/java/com/orgmemory/worker/graph/GraphPublicationCommitterTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexChunk.java
  • apps/worker/src/main/java/com/orgmemory/worker/graph/GraphIndexingProcessor.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProperties.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphExplorerProperties.java
  • apps/api/src/main/java/com/orgmemory/api/OrgMemoryApiApplication.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/ClaimedGraphIndex.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/PersistedGraphProcessingProfile.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceIngestionCoordinator.java
  • core/src/main/java/com/orgmemory/core/knowledge/SecureKnowledgeRetrievalStore.java
  • core/src/main/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeUnavailableException.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobQueue.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerConfiguration.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerService.java
  • core/src/main/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeResolver.java
  • core/src/main/java/com/orgmemory/core/knowledge/asset/KnowledgeChunkProjectionStore.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationService.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinator.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphView.java
  • core/src/test/java/com/orgmemory/core/knowledge/CanonicalHybridKnowledgeSearchTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileRepository.java
  • core/src/test/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalServiceTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileRef.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexingStoppedException.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexLifecycleService.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileRegistry.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExportService.java
  • core/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorSourceRevisionCoordinator.java
  • core/src/test/java/com/orgmemory/core/ModulithVerificationTests.java
**/*.java

📄 CodeRabbit inference engine (AGENTS.md)

Apply IDE inspection only to edited backend Java files.

Files:

  • apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeGraphExplorerController.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/package-info.java
  • core/src/main/java/com/orgmemory/core/knowledge/EmbeddingProfileRepository.java
  • apps/api/src/test/java/com/orgmemory/api/knowledge/KnowledgeGraphManagementControllerTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/EmbeddingProfile.java
  • apps/worker/src/main/java/com/orgmemory/worker/OrgMemoryWorkerApplication.java
  • core/src/test/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationServiceTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExportServiceTests.java
  • apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeGraphManagementController.java
  • core/src/test/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinatorTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobStatus.java
  • core/src/main/java/com/orgmemory/core/knowledge/SecureRetrievalCandidate.java
  • core/src/test/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerServiceTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/graph/GraphIndexLifecycleServiceTests.java
  • apps/worker/src/test/java/com/orgmemory/worker/graph/GraphIndexingProcessorTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobView.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJob.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileResolver.java
  • apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeAssetLifecycleController.java
  • core/src/main/java/com/orgmemory/core/knowledge/ResolvedKnowledgeEvidenceScope.java
  • apps/worker/src/main/java/com/orgmemory/worker/graph/GraphPublicationCommitter.java
  • apps/worker/src/test/java/com/orgmemory/worker/graph/GraphPublicationCommitterTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexChunk.java
  • apps/worker/src/main/java/com/orgmemory/worker/graph/GraphIndexingProcessor.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProperties.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphExplorerProperties.java
  • apps/api/src/main/java/com/orgmemory/api/OrgMemoryApiApplication.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/ClaimedGraphIndex.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/PersistedGraphProcessingProfile.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceIngestionCoordinator.java
  • core/src/main/java/com/orgmemory/core/knowledge/SecureKnowledgeRetrievalStore.java
  • core/src/main/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeUnavailableException.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobQueue.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerConfiguration.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerService.java
  • core/src/main/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeResolver.java
  • core/src/main/java/com/orgmemory/core/knowledge/asset/KnowledgeChunkProjectionStore.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationService.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinator.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphView.java
  • core/src/test/java/com/orgmemory/core/knowledge/CanonicalHybridKnowledgeSearchTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileRepository.java
  • core/src/test/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalServiceTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileRef.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexingStoppedException.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexLifecycleService.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileRegistry.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExportService.java
  • core/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorSourceRevisionCoordinator.java
  • core/src/test/java/com/orgmemory/core/ModulithVerificationTests.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/knowledge/KnowledgeGraphExplorerController.java
  • apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeGraphManagementController.java
  • apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeAssetLifecycleController.java
  • apps/api/src/main/java/com/orgmemory/api/OrgMemoryApiApplication.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/graph/package-info.java
  • core/src/main/java/com/orgmemory/core/knowledge/EmbeddingProfileRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/EmbeddingProfile.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobStatus.java
  • core/src/main/java/com/orgmemory/core/knowledge/SecureRetrievalCandidate.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobView.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJob.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileResolver.java
  • core/src/main/java/com/orgmemory/core/knowledge/ResolvedKnowledgeEvidenceScope.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexChunk.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProperties.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphExplorerProperties.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/ClaimedGraphIndex.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/PersistedGraphProcessingProfile.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceIngestionCoordinator.java
  • core/src/main/java/com/orgmemory/core/knowledge/SecureKnowledgeRetrievalStore.java
  • core/src/main/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeUnavailableException.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobQueue.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerConfiguration.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerService.java
  • core/src/main/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeResolver.java
  • core/src/main/java/com/orgmemory/core/knowledge/asset/KnowledgeChunkProjectionStore.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationService.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinator.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphView.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileRef.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexingStoppedException.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexLifecycleService.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileRegistry.java
  • core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExportService.java
  • core/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorSourceRevisionCoordinator.java
🧠 Learnings (2)
📚 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/KnowledgeGraphExplorerController.java
  • apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeGraphManagementController.java
  • apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeAssetLifecycleController.java
📚 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/knowledge/KnowledgeGraphExplorerController.java
  • apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeGraphManagementController.java
  • apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeAssetLifecycleController.java
  • apps/api/src/main/java/com/orgmemory/api/OrgMemoryApiApplication.java
🔇 Additional comments (51)
core/src/main/java/com/orgmemory/core/knowledge/graph/ClaimedGraphIndex.java (1)

1-3: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileRepository.java (1)

1-1: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileResolver.java (1)

1-1: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProperties.java (1)

1-1: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationCommand.java (1)

1-1: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerConfiguration.java (1)

1-3: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerService.java (1)

1-7: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExportService.java (1)

1-7: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphView.java (1)

1-1: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/ResolvedKnowledgeEvidenceScope.java (1)

12-12: LGTM!

Also applies to: 22-22, 45-55, 66-66

core/src/main/java/com/orgmemory/core/knowledge/graph/package-info.java (1)

1-9: 📐 Maintainability & Code Quality

No change needed. The SPRING MODULITH refactor increment documents the temporary OPEN boundary, independent architecture challenge, alternatives, graph module consumers, exposed types, closing exit criteria, and the ApplicationModules.verify() gate.

core/src/main/java/com/orgmemory/core/knowledge/graph/GraphExplorerProperties.java (1)

1-1: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexChunk.java (1)

1-1: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobQueue.java (1)

1-1: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobRepository.java (1)

1-1: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/SecureRetrievalCandidate.java (1)

5-5: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/connector/ConnectorSourceRevisionCoordinator.java (1)

4-4: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceIngestionCoordinator.java (1)

4-4: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJob.java (1)

1-3: 🎯 Functional Correctness

No change needed. SourceFailureMessage is declared as public, so the import from com.orgmemory.core.knowledge.graph is valid.

core/src/main/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeResolver.java (1)

37-37: 🔒 Security & Privacy

No change needed.

core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobStatus.java (1)

1-1: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexJobView.java (1)

1-1: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexLifecycleService.java (1)

1-1: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinator.java (1)

1-5: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/GraphIndexingStoppedException.java (1)

1-1: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileRef.java (1)

1-1: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/GraphProcessingProfileRegistry.java (1)

1-1: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/EmbeddingProfile.java (1)

44-44: LGTM!

core/src/test/java/com/orgmemory/core/knowledge/graph/GraphIndexingCoordinatorTests.java (1)

1-6: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/graph/PersistedGraphProcessingProfile.java (1)

1-1: 🗄️ Data Integrity & Integration

No change needed.

PersistedGraphProcessingProfile, GraphProcessingProfileRepository, GraphProcessingProfileRegistry, and GraphIndexJob references remain in the same package/entity scope, and the table/column model is unchanged.

core/src/main/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationService.java (1)

1-9: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeUnavailableException.java (1)

3-8: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/EmbeddingProfileRepository.java (1)

7-7: LGTM!

apps/worker/src/main/java/com/orgmemory/worker/graph/GraphIndexingProcessor.java (1)

6-9: LGTM!

apps/worker/src/main/java/com/orgmemory/worker/graph/GraphPublicationCommitter.java (1)

3-5: LGTM!

apps/worker/src/test/java/com/orgmemory/worker/graph/GraphIndexingProcessorTests.java (1)

22-27: LGTM!

apps/worker/src/test/java/com/orgmemory/worker/graph/GraphPublicationCommitterTests.java (1)

12-17: LGTM!

core/src/test/java/com/orgmemory/core/ModulithVerificationTests.java (1)

56-89: LGTM!

Also applies to: 107-112

core/src/test/java/com/orgmemory/core/knowledge/graph/GraphIndexLifecycleServiceTests.java (1)

1-1: LGTM!

core/src/test/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExplorerServiceTests.java (1)

1-5: LGTM!

core/src/test/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphExportServiceTests.java (1)

1-6: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/SecureKnowledgeRetrievalStore.java (1)

275-291: LGTM!

apps/api/src/main/java/com/orgmemory/api/OrgMemoryApiApplication.java (1)

5-6: LGTM!

apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeAssetLifecycleController.java (1)

4-5: LGTM!

apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeGraphExplorerController.java (1)

4-5: LGTM!

apps/api/src/main/java/com/orgmemory/api/knowledge/KnowledgeGraphManagementController.java (1)

5-7: LGTM!

apps/api/src/test/java/com/orgmemory/api/knowledge/KnowledgeGraphManagementControllerTests.java (1)

10-12: LGTM!

apps/worker/src/main/java/com/orgmemory/worker/OrgMemoryWorkerApplication.java (1)

6-7: LGTM!

core/src/test/java/com/orgmemory/core/knowledge/CanonicalHybridKnowledgeSearchTests.java (1)

205-206: LGTM!

core/src/test/java/com/orgmemory/core/knowledge/GraphRagKnowledgeRetrievalServiceTests.java (1)

893-895: LGTM!

Also applies to: 914-916

core/src/test/java/com/orgmemory/core/knowledge/graph/KnowledgeGraphCurationServiceTests.java (1)

1-7: LGTM!

@kl3inIT
kl3inIT merged commit 7a97096 into main Jul 31, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant