Skip to content

refactor(knowledge): extract source ACL module - #181

Merged
kl3inIT merged 1 commit into
mainfrom
refactor/modulith-knowledge-acl
Jul 31, 2026
Merged

refactor(knowledge): extract source ACL module#181
kl3inIT merged 1 commit into
mainfrom
refactor/modulith-knowledge-acl

Conversation

@kl3inIT

@kl3inIT kl3inIT commented Jul 31, 2026

Copy link
Copy Markdown
Owner

Summary

  • extract source ACL snapshots/heads, external principals/mappings, and group-membership evidence into knowledge.acl
  • declare the slice as an explicitly open Spring Modulith nested module during facade migration
  • repair imports and widen only compiler-required connector/connection edges
  • move focused ACL tests and add structural coverage for the nested module

Verification

  • all production and test sources compile
  • focused ACL, principal, membership, connector, retrieval, graph, and Modulith tests pass
  • :core:test passes
  • repository-wide clean test passes (108 tasks, 6m46s)
  • python scripts/check_docs.py passes (361 Markdown files, 8 mirrored domain pairs)
  • PR changes 84 files, below the agreed 100-file limit

Migration debt

  • knowledge.acl remains Type.OPEN temporarily
  • compiler-forced edges to connector connection/context/sync-run types must be replaced by intentional facades before ACL and connector are closed

skip-release: internal package refactor with no runtime or published behavior change

Summary by CodeRabbit

  • Improvements

    • Improved the organization and accessibility of access-control and group-membership capabilities.
    • Standardized handling of source principals, permissions, identity mappings, and membership records across connected sources.
    • Expanded access to connection and trust information for integrated workflows.
  • Documentation

    • Documented the access-control module and its ownership of permission and membership data.
  • Tests

    • Added coverage validating the access-control module structure and continued integration behavior.

@coderabbitai

coderabbitai Bot commented Jul 31, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

The ACL domain moved into com.orgmemory.core.knowledge.acl. Selected ACL and connector contracts became public. API, worker, source-ledger, connector, test, and documentation references were updated.

Changes

ACL module refactor

Layer / File(s) Summary
ACL package and module boundaries
core/src/main/java/com/orgmemory/core/knowledge/acl/*, core/src/test/java/com/orgmemory/core/knowledge/acl/*, ARCHITECTURE.md, core/src/test/java/com/orgmemory/core/ModulithVerificationTests.java
ACL snapshots, membership evidence, principal mappings, and services moved to the knowledge.acl package. Selected classes and services became public. The package is declared as an open Spring Modulith module and documented as transitional.
Cross-module contract exposure
core/src/main/java/com/orgmemory/core/knowledge/{Connector*,SourceConnection*,SourceIdentityObservation*,SourceMembershipSyncRun*}
Connector identity, ingestion, source connection, membership, and repository contracts gained public visibility or explicit ACL imports. Runtime behavior remains unchanged.
Dependent application and connector imports
apps/api/..., apps/worker/..., core/src/main/java/com/orgmemory/core/knowledge/sourceledger/*, core/src/test/java/..., integrations/connectors/...
API, worker, source-ledger, connector, and test imports now reference ACL types from com.orgmemory.core.knowledge.acl. Import-only changes do not alter control flow.

Estimated code review effort: 2 (Simple) | ~15 minutes

Possibly related PRs

  • kl3inIT/OrgMemory#16: Refactors ACL classes and SourcePrincipalAdminService used by the admin controllers.
  • kl3inIT/OrgMemory#31: Imports shared ACL types such as SourceAclSnapshotRepository and SourcePrincipalKind.
  • kl3inIT/OrgMemory#96: Overlaps with ACL and connector classes, including group-membership types and Slack or Google Drive integrations.
🚥 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
Title check ✅ Passed The title clearly and concisely describes the extraction of the source ACL module, which is the primary change.
Description check ✅ Passed The description covers the summary and verification evidence, and explains the internal refactor, but omits the template's Documentation impact heading and checkboxes.
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.
✨ Finishing Touches 💡 1
📝 Generate docstrings 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch refactor/modulith-knowledge-acl

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.

@github-actions

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

This PR does not add changelog files. Pending changelogs from other branches are included in the preview above.

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 `@ARCHITECTURE.md`:
- Around line 122-125: Update the `core.knowledge.acl` architecture description
to state that connector and source-ledger callers still have direct migration
dependencies, rather than claiming they use intentional facades. Move the
planned facade routing out of `ARCHITECTURE.md` into the appropriate active
increment or roadmap documentation.
🪄 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: 92bda561-8f46-4cc6-b298-02c21707489d

📥 Commits

Reviewing files that changed from the base of the PR and between 284901c and 3f174c1.

⛔ 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 (82)
  • ARCHITECTURE.md
  • apps/api/src/main/java/com/orgmemory/api/admin/AdminSourceAccessController.java
  • apps/api/src/main/java/com/orgmemory/api/admin/AdminUserController.java
  • apps/api/src/main/java/com/orgmemory/api/source/SourceResponse.java
  • apps/api/src/test/java/com/orgmemory/api/knowledge/KnowledgeIngestionIntegrationTests.java
  • apps/worker/src/main/java/com/orgmemory/worker/ingestion/SourceIngestionProcessor.java
  • apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorContentEditIntegrationTests.java
  • apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorIdentityTrustIntegrationTests.java
  • apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorPruningIntegrationTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/ActiveGroupMembershipRow.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorAclGrant.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorIdentityItem.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorIdentityResolution.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorIngestionContext.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorMembershipMember.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorReconciler.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorSourceProfile.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorSourceRevisionCoordinator.java
  • core/src/main/java/com/orgmemory/core/knowledge/GraphIndexingCoordinator.java
  • core/src/main/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeResolver.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceConnection.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceConnectionRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceIdentityObservation.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceMembershipSyncRun.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceMembershipSyncRunRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/AclAuthority.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/AclCaptureStatus.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/RotateSourceAclCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclEntry.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclEntryCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclEntryRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclHead.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclHeadRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclRotationRef.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshot.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshotRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshotSeal.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshotSealRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipHead.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipHeadRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipMember.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipMemberRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshot.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshotRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshotSeal.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshotSealRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipal.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalAdminService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalKind.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMapping.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingMethod.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingStatus.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingView.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalType.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalView.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/package-info.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/KnowledgeIngestionService.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/NormalizedRecord.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/RegisterRawSourceCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceObject.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceSummary.java
  • core/src/test/java/com/orgmemory/core/ModulithVerificationTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/ConnectorIdentityResolutionTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/ConnectorSourceRegistryTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/ExternalPrincipalRetrievalIntegrationTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/GraphIndexingCoordinatorTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeResolverTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipHeadTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingServiceTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/sourceledger/SourceQueryServiceTests.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/github/GitHubConnectorBatchSource.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/googledrive/GoogleDriveConnectorBatchSource.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/googledrive/GoogleDrivePermissionMapper.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/slack/SlackConnectorBatchSource.java
  • integrations/connectors/src/test/java/com/orgmemory/connectors/github/GitHubConnectorBatchSourceTests.java
  • integrations/connectors/src/test/java/com/orgmemory/connectors/googledrive/GoogleDriveConnectorBatchSourceTests.java
  • integrations/connectors/src/test/java/com/orgmemory/connectors/slack/SlackConnectorBatchSourceTests.java
📜 Review details
⏰ Context from checks skipped due to timeout. (2)
  • GitHub Check: Backend · Java 25
  • GitHub Check: Web · Node 24
🧰 Additional context used
📓 Path-based instructions (6)
**/*

📄 CodeRabbit inference engine (CLAUDE.md)

**/*: Read the repository guidance map and relevant sections of ARCHITECTURE.md before making changes; read applicable subproject guidance after the root guidance.
Read docs/guidelines/agent-safety.md before retrieval, AI, MCP, permission, upload, graph, or export work.
Never commit secrets or customer data.
Pair persisted-model changes with a Flyway migration.
Use the testing harness; a terminating clean test is the JVM context gate, and bootRun is not verification.

Files:

  • ARCHITECTURE.md
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/RegisterRawSourceCommand.java
  • core/src/test/java/com/orgmemory/core/knowledge/ConnectorIdentityResolutionTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/sourceledger/SourceQueryServiceTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/NormalizedRecord.java
  • integrations/connectors/src/test/java/com/orgmemory/connectors/googledrive/GoogleDriveConnectorBatchSourceTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/ActiveGroupMembershipRow.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceMembershipSyncRun.java
  • core/src/main/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeResolver.java
  • apps/api/src/test/java/com/orgmemory/api/knowledge/KnowledgeIngestionIntegrationTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorMembershipMember.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorSourceProfile.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/package-info.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceSummary.java
  • core/src/main/java/com/orgmemory/core/knowledge/GraphIndexingCoordinator.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorReconciler.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceMembershipSyncRunRepository.java
  • apps/api/src/main/java/com/orgmemory/api/admin/AdminUserController.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceConnectionRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorIdentityItem.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/googledrive/GoogleDrivePermissionMapper.java
  • apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorPruningIntegrationTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorAclGrant.java
  • integrations/connectors/src/test/java/com/orgmemory/connectors/slack/SlackConnectorBatchSourceTests.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/slack/SlackConnectorBatchSource.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorSourceRevisionCoordinator.java
  • apps/worker/src/main/java/com/orgmemory/worker/ingestion/SourceIngestionProcessor.java
  • core/src/test/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipHeadTests.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/googledrive/GoogleDriveConnectorBatchSource.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorIngestionContext.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingStatus.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceConnection.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceObject.java
  • apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorIdentityTrustIntegrationTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalKind.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingView.java
  • core/src/test/java/com/orgmemory/core/knowledge/ExternalPrincipalRetrievalIntegrationTests.java
  • apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorContentEditIntegrationTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingServiceTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMapping.java
  • core/src/test/java/com/orgmemory/core/knowledge/GraphIndexingCoordinatorTests.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/github/GitHubConnectorBatchSource.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/KnowledgeIngestionService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalRepository.java
  • core/src/test/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeResolverTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclEntry.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclHead.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclEntryRepository.java
  • apps/api/src/main/java/com/orgmemory/api/admin/AdminSourceAccessController.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclRotationRef.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/AclCaptureStatus.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/AclAuthority.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclEntryCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshotSealRepository.java
  • integrations/connectors/src/test/java/com/orgmemory/connectors/github/GitHubConnectorBatchSourceTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalType.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshotRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshotRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalView.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceIdentityObservation.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorIdentityResolution.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipMemberRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingMethod.java
  • core/src/test/java/com/orgmemory/core/knowledge/ConnectorSourceRegistryTests.java
  • apps/api/src/main/java/com/orgmemory/api/source/SourceResponse.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/RotateSourceAclCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshot.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclHeadRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshotSealRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalAdminService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshot.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipHeadRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshotSeal.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipHead.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipMember.java
  • core/src/test/java/com/orgmemory/core/ModulithVerificationTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipal.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshotSeal.java
ARCHITECTURE.md

📄 CodeRabbit inference engine (CLAUDE.md)

ARCHITECTURE.md must contain implemented facts only; intended or selected-but-unimplemented behavior belongs in vision, roadmap, or an active increment.

Files:

  • ARCHITECTURE.md
**/*.{java,gradle,gradle.kts,ts,tsx,js,jsx}

📄 CodeRabbit inference engine (CLAUDE.md)

Before using unfamiliar Spring Boot 4, Spring Modulith 2, Spring AI 2, Gradle, React, Vite, Tailwind, TypeScript, Next.js, or Fumadocs APIs, consult Context7 or current official documentation and the relevant project verification skill.

Files:

  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/RegisterRawSourceCommand.java
  • core/src/test/java/com/orgmemory/core/knowledge/ConnectorIdentityResolutionTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/sourceledger/SourceQueryServiceTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/NormalizedRecord.java
  • integrations/connectors/src/test/java/com/orgmemory/connectors/googledrive/GoogleDriveConnectorBatchSourceTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/ActiveGroupMembershipRow.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceMembershipSyncRun.java
  • core/src/main/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeResolver.java
  • apps/api/src/test/java/com/orgmemory/api/knowledge/KnowledgeIngestionIntegrationTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorMembershipMember.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorSourceProfile.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/package-info.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceSummary.java
  • core/src/main/java/com/orgmemory/core/knowledge/GraphIndexingCoordinator.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorReconciler.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceMembershipSyncRunRepository.java
  • apps/api/src/main/java/com/orgmemory/api/admin/AdminUserController.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceConnectionRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorIdentityItem.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/googledrive/GoogleDrivePermissionMapper.java
  • apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorPruningIntegrationTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorAclGrant.java
  • integrations/connectors/src/test/java/com/orgmemory/connectors/slack/SlackConnectorBatchSourceTests.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/slack/SlackConnectorBatchSource.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorSourceRevisionCoordinator.java
  • apps/worker/src/main/java/com/orgmemory/worker/ingestion/SourceIngestionProcessor.java
  • core/src/test/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipHeadTests.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/googledrive/GoogleDriveConnectorBatchSource.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorIngestionContext.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingStatus.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceConnection.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceObject.java
  • apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorIdentityTrustIntegrationTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalKind.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingView.java
  • core/src/test/java/com/orgmemory/core/knowledge/ExternalPrincipalRetrievalIntegrationTests.java
  • apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorContentEditIntegrationTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingServiceTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMapping.java
  • core/src/test/java/com/orgmemory/core/knowledge/GraphIndexingCoordinatorTests.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/github/GitHubConnectorBatchSource.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/KnowledgeIngestionService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalRepository.java
  • core/src/test/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeResolverTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclEntry.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclHead.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclEntryRepository.java
  • apps/api/src/main/java/com/orgmemory/api/admin/AdminSourceAccessController.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclRotationRef.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/AclCaptureStatus.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/AclAuthority.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclEntryCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshotSealRepository.java
  • integrations/connectors/src/test/java/com/orgmemory/connectors/github/GitHubConnectorBatchSourceTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalType.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshotRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshotRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalView.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceIdentityObservation.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorIdentityResolution.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipMemberRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingMethod.java
  • core/src/test/java/com/orgmemory/core/knowledge/ConnectorSourceRegistryTests.java
  • apps/api/src/main/java/com/orgmemory/api/source/SourceResponse.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/RotateSourceAclCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshot.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclHeadRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshotSealRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalAdminService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshot.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipHeadRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshotSeal.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipHead.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipMember.java
  • core/src/test/java/com/orgmemory/core/ModulithVerificationTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipal.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshotSeal.java
**/*.java

📄 CodeRabbit inference engine (CLAUDE.md)

Apply IDE inspection only to edited backend Java files.

Files:

  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/RegisterRawSourceCommand.java
  • core/src/test/java/com/orgmemory/core/knowledge/ConnectorIdentityResolutionTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/sourceledger/SourceQueryServiceTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/NormalizedRecord.java
  • integrations/connectors/src/test/java/com/orgmemory/connectors/googledrive/GoogleDriveConnectorBatchSourceTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/ActiveGroupMembershipRow.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceMembershipSyncRun.java
  • core/src/main/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeResolver.java
  • apps/api/src/test/java/com/orgmemory/api/knowledge/KnowledgeIngestionIntegrationTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorMembershipMember.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorSourceProfile.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/package-info.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceSummary.java
  • core/src/main/java/com/orgmemory/core/knowledge/GraphIndexingCoordinator.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorReconciler.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceMembershipSyncRunRepository.java
  • apps/api/src/main/java/com/orgmemory/api/admin/AdminUserController.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceConnectionRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorIdentityItem.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/googledrive/GoogleDrivePermissionMapper.java
  • apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorPruningIntegrationTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorAclGrant.java
  • integrations/connectors/src/test/java/com/orgmemory/connectors/slack/SlackConnectorBatchSourceTests.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/slack/SlackConnectorBatchSource.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorSourceRevisionCoordinator.java
  • apps/worker/src/main/java/com/orgmemory/worker/ingestion/SourceIngestionProcessor.java
  • core/src/test/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipHeadTests.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/googledrive/GoogleDriveConnectorBatchSource.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorIngestionContext.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingStatus.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceConnection.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceObject.java
  • apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorIdentityTrustIntegrationTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalKind.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingView.java
  • core/src/test/java/com/orgmemory/core/knowledge/ExternalPrincipalRetrievalIntegrationTests.java
  • apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorContentEditIntegrationTests.java
  • core/src/test/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingServiceTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMapping.java
  • core/src/test/java/com/orgmemory/core/knowledge/GraphIndexingCoordinatorTests.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/github/GitHubConnectorBatchSource.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/KnowledgeIngestionService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalRepository.java
  • core/src/test/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeResolverTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclEntry.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclHead.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclEntryRepository.java
  • apps/api/src/main/java/com/orgmemory/api/admin/AdminSourceAccessController.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclRotationRef.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/AclCaptureStatus.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/AclAuthority.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclEntryCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshotSealRepository.java
  • integrations/connectors/src/test/java/com/orgmemory/connectors/github/GitHubConnectorBatchSourceTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalType.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshotRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshotRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalView.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceIdentityObservation.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorIdentityResolution.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipMemberRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingMethod.java
  • core/src/test/java/com/orgmemory/core/knowledge/ConnectorSourceRegistryTests.java
  • apps/api/src/main/java/com/orgmemory/api/source/SourceResponse.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/RotateSourceAclCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshot.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclHeadRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshotSealRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalAdminService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshot.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipHeadRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshotSeal.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipHead.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipMember.java
  • core/src/test/java/com/orgmemory/core/ModulithVerificationTests.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipal.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshotSeal.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/sourceledger/RegisterRawSourceCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/NormalizedRecord.java
  • core/src/main/java/com/orgmemory/core/knowledge/ActiveGroupMembershipRow.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceMembershipSyncRun.java
  • core/src/main/java/com/orgmemory/core/knowledge/KnowledgeEvidenceScopeResolver.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorMembershipMember.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorSourceProfile.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/package-info.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceSummary.java
  • core/src/main/java/com/orgmemory/core/knowledge/GraphIndexingCoordinator.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorReconciler.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceMembershipSyncRunRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceConnectionRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorIdentityItem.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorAclGrant.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorSourceRevisionCoordinator.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorIngestionContext.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingStatus.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceConnection.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/SourceObject.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalKind.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingView.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMapping.java
  • core/src/main/java/com/orgmemory/core/knowledge/sourceledger/KnowledgeIngestionService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclEntry.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclHead.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclEntryRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclRotationRef.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/AclCaptureStatus.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/AclAuthority.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclEntryCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshotSealRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalType.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshotRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshotRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalView.java
  • core/src/main/java/com/orgmemory/core/knowledge/SourceIdentityObservation.java
  • core/src/main/java/com/orgmemory/core/knowledge/ConnectorIdentityResolution.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipMemberRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingMethod.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/RotateSourceAclCommand.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshot.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclHeadRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshotSealRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalMappingService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipalAdminService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshot.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipHeadRepository.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceAclSnapshotSeal.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipHead.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipMember.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourcePrincipal.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipService.java
  • core/src/main/java/com/orgmemory/core/knowledge/acl/SourceGroupMembershipSnapshotSeal.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/admin/AdminUserController.java
  • apps/api/src/main/java/com/orgmemory/api/admin/AdminSourceAccessController.java
  • apps/api/src/main/java/com/orgmemory/api/source/SourceResponse.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/admin/AdminUserController.java
  • apps/api/src/main/java/com/orgmemory/api/admin/AdminSourceAccessController.java
  • apps/api/src/main/java/com/orgmemory/api/source/SourceResponse.java
📚 Learning: 2026-07-27T19:32:49.877Z
Learnt from: kl3inIT
Repo: kl3inIT/OrgMemory PR: 96
File: integrations/connectors/src/main/java/com/orgmemory/connectors/slack/SlackConnectorBatchSource.java:0-0
Timestamp: 2026-07-27T19:32:49.877Z
Learning: When reviewing connector component checkpointing completeness logic, ensure it clearly distinguishes authorization-evidence gaps from intentional content-scope limits. Authorization evidence gaps mean the connector cannot validate required permissions/membership for the source and should mark the relevant permission/membership component(s) as incomplete; intentional content-scope limits (e.g., configured channel subset filters or bounded thread history) should not be treated as authorization gaps. For Slack sources specifically: if permission and membership data are incomplete for the Slack access gap, mark the permission/membership component incomplete; do not downgrade completeness solely due to configured channel subsets or bounded thread history. For Google Drive: if sharing is unreadable (e.g., insufficient access to view sharing metadata), mark the permission component incomplete.

Applied to files:

  • integrations/connectors/src/main/java/com/orgmemory/connectors/slack/SlackConnectorBatchSource.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/googledrive/GoogleDriveConnectorBatchSource.java
  • integrations/connectors/src/main/java/com/orgmemory/connectors/github/GitHubConnectorBatchSource.java
🔇 Additional comments (81)
core/src/main/java/com/orgmemory/core/knowledge/acl/AclAuthority.java (1)

1-1: LGTM!

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

1-1: LGTM!

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

1-1: LGTM!

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

1-1: LGTM!

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

1-1: LGTM!

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

1-1: LGTM!

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

1-1: LGTM!

Also applies to: 19-19

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

1-1: LGTM!

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

1-3: LGTM!

Also applies to: 30-30, 51-51

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

1-3: LGTM!

Also applies to: 14-14, 23-23

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

3-14: LGTM!

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

1-8: 🗄️ Data Integrity & Integration

Check all non-ACL modules before allowing this repository exposure.

No non-ACL Java module uses SourcePrincipalMappingRepository currently. If this package remains externally reachable, keep access through a narrow read or command facade so mappings cannot be deleted without SourcePrincipalMappingService.revoke and the audit record.

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

1-1: LGTM!

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

1-1: LGTM!

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

1-1: LGTM!

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

1-1: LGTM!

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

1-1: LGTM!

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

1-1: LGTM!

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

1-8: LGTM!

Also applies to: 28-28, 53-53

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

1-3: LGTM!

Also applies to: 17-17

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

1-7: LGTM!

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

1-1: LGTM!

Also applies to: 13-13

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

1-7: LGTM!

core/src/main/java/com/orgmemory/core/knowledge/ConnectorIdentityResolution.java (2)

3-5: LGTM!


15-27: 🗄️ Data Integrity & Integration

No change needed. ConnectorIdentityResolution is used only by code in com.orgmemory.core.knowledge packages, and all non-empty construction happens in ConnectorReconciler. An empty resolution is already sufficient for the only external stubbed construction available now.

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

1-1: LGTM!

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

21-21: LGTM!

Also applies to: 82-82, 164-165, 180-196

apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorPruningIntegrationTests.java (1)

3-4: LGTM!

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

3-16: LGTM!

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

3-4: LGTM!

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

3-5: LGTM!

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

3-4: LGTM!

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

3-4: LGTM!

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

3-4: LGTM!

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

3-4: LGTM!

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

3-5: LGTM!

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

3-4: LGTM!

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

1-1: LGTM!

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

1-3: LGTM!

Also applies to: 17-17

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

1-3: LGTM!

Also applies to: 14-14

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

1-1: LGTM!

Also applies to: 15-15

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

1-7: LGTM!

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

1-1: LGTM!

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

32-37: LGTM!

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

7-7: LGTM!

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

3-3: 🗄️ Data Integrity & Integration

No change needed. SourcePrincipalKind is public, and the connector-facing APIs using it are also public.

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

1-1: LGTM!

Also applies to: 19-19, 98-98

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

1-9: LGTM!

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

1-1: LGTM!

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

1-1: LGTM!

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

1-3: LGTM!

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

3-4: LGTM!

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

1-3: LGTM!

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

1-3: LGTM!

integrations/connectors/src/main/java/com/orgmemory/connectors/github/GitHubConnectorBatchSource.java (1)

3-4: LGTM!

integrations/connectors/src/main/java/com/orgmemory/connectors/googledrive/GoogleDriveConnectorBatchSource.java (1)

3-4: LGTM!

integrations/connectors/src/main/java/com/orgmemory/connectors/googledrive/GoogleDrivePermissionMapper.java (1)

3-5: LGTM!

integrations/connectors/src/main/java/com/orgmemory/connectors/slack/SlackConnectorBatchSource.java (1)

3-4: LGTM!

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

1-1: LGTM!

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

1-8: LGTM!

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

3-4: LGTM!

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

3-4: LGTM!

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

3-4: LGTM!

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

3-5: LGTM!

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

3-4: LGTM!

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

8-8: LGTM!

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

3-4: LGTM!

Also applies to: 13-13

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

13-13: LGTM!

Also applies to: 30-30

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

6-6: LGTM!

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

14-14: LGTM!

Also applies to: 32-32

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

3-7: LGTM!

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

3-3: LGTM!

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

3-3: LGTM!

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

3-8: LGTM!

Also applies to: 24-25

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

3-6: LGTM!

apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorContentEditIntegrationTests.java (1)

3-4: LGTM!

apps/worker/src/test/java/com/orgmemory/worker/connector/ConnectorIdentityTrustIntegrationTests.java (1)

3-4: LGTM!

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

3-3: LGTM!

integrations/connectors/src/test/java/com/orgmemory/connectors/github/GitHubConnectorBatchSourceTests.java (1)

3-4: LGTM!

integrations/connectors/src/test/java/com/orgmemory/connectors/googledrive/GoogleDriveConnectorBatchSourceTests.java (1)

3-4: LGTM!

integrations/connectors/src/test/java/com/orgmemory/connectors/slack/SlackConnectorBatchSourceTests.java (1)

3-4: LGTM!

Also applies to: 100-130

Comment thread ARCHITECTURE.md
Comment on lines +122 to +125
The `core.knowledge.acl` nested module owns source ACL snapshots and heads,
external-principal mappings, and group-membership evidence; it is also
temporarily open while connector and source-ledger callers are routed through
intentional facades.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Document the current dependency state, not the planned facade state.

The PR objectives identify facade routing as migration debt. Lines 122-125 state that connector and source-ledger callers are already routed through intentional facades. State that core.knowledge.acl remains open because those callers still have direct migration dependencies. Move the planned facade routing to an active increment or roadmap.

Proposed wording
- it is also temporarily open while connector and source-ledger callers are routed through intentional facades.
+ it is currently open because connector and source-ledger callers still have direct dependencies during the facade migration.

As per coding guidelines: ARCHITECTURE.md must contain implemented facts only; intended or selected-but-unimplemented behavior belongs in vision, roadmap, or an active increment.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
The `core.knowledge.acl` nested module owns source ACL snapshots and heads,
external-principal mappings, and group-membership evidence; it is also
temporarily open while connector and source-ledger callers are routed through
intentional facades.
The `core.knowledge.acl` nested module owns source ACL snapshots and heads,
external-principal mappings, and group-membership evidence; it is currently
open because connector and source-ledger callers still have direct
dependencies during the facade migration.
🤖 Prompt for 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.

In `@ARCHITECTURE.md` around lines 122 - 125, Update the `core.knowledge.acl`
architecture description to state that connector and source-ledger callers still
have direct migration dependencies, rather than claiming they use intentional
facades. Move the planned facade routing out of `ARCHITECTURE.md` into the
appropriate active increment or roadmap documentation.

Source: Coding guidelines

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