[#2524] Add new --author-dedup-mode flag for deduplicating authors by yizhong187 · Pull Request #2532 · reposense/RepoSense

yizhong187 · 2026-02-04T06:23:23Z

Proposed commit message

Add deduplication flag

Allows for deduplating authors without specifying all authors to
display in repo (all authors are displayed, and deduplication is
applied onto them based on author-config)

Manual Testing

Add author-config.csv into the config folder with the below content:

Repository's Location,Branch,Author's Git Host ID,Author's Emails,Author's Display Name,Author's Git Author Name,Ignore Glob List
,,YuLetian,,Yu Letian,Letian;Le Tian;Luoqi,

Add repo-config.csv into the config folder with the below content:

Repository's Location,Branch,File formats,Find Previous Authors,Ignore Glob List,Ignore standalone config,Ignore Commits List,Ignore Authors List,Shallow Cloning,File Size Limit,Ignore File Size Limit,Skip Ignored File Analysis,Since Date,Until Date
https://github.com/AY2526S1-CS2103T-W11-1/tp.git,master,,,,,,,,,,,01/01/2025,

Run ./gradlew run -Dargs="--config config --view --since 1/1/2025 --until 31/1/2026 --author-dedup-mode"
There should be only one "Le Tian" present.

…uthors

Copilot

Pull request overview

This PR adds a new --author-dedup-mode flag that allows users to deduplicate authors based on author-config.csv while displaying all commit authors in the report. This addresses issue #2524, which identified that the current approach requires listing ALL authors in author-config.csv even when only one author needs deduplication.

Changes:

Added --author-dedup-mode CLI flag that enables author deduplication based on configured aliases
Modified ReportGenerator.updateAuthorList() to add all commit authors when dedup mode is enabled, skipping those that match configured aliases
Added documentation for the new flag in the CLI reference guide

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/main/java/reposense/parser/ArgsParser.java	Adds CLI flag definition and parsing logic for --author-dedup-mode
src/main/java/reposense/model/CliArguments.java	Adds isAuthorDedupMode field, getter, and builder method; updates equals() method
src/main/java/reposense/model/RepoConfiguration.java	Adds isAuthorDedupMode field, setter/getter, and static configuration method; includes formatting fixes for parameter alignment
src/main/java/reposense/RepoSense.java	Propagates the isAuthorDedupMode flag to repo configurations
src/main/java/reposense/report/ReportGenerator.java	Implements core deduplication logic in updateAuthorList() method
src/test/java/reposense/parser/ArgsParserTest.java	Adds tests to verify the CLI flag is parsed correctly
docs/ug/cli.md	Documents the new flag with usage instructions and requirements

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-02-05T09:15:34Z

@@ -335,7 +342,8 @@ public static CliArguments parse(String[] args) throws HelpScreenException, Pars
                .originalityThreshold(originalityThreshold)
                .isPortfolio(isPortfolio)
                .isFreshClonePerformed(shouldPerformFreshCloning)
-                .isOnlyTextRefreshed(shouldRefreshOnlyText);
+                .isOnlyTextRefreshed(shouldRefreshOnlyText)
+                .isAuthorDedupMode(isAuthorDedupMode);


There's no validation to ensure that the --author-dedup-mode flag is used correctly. According to the documentation, this flag "must be used in conjunction with the --config flag and requires an author-config.csv file to be present." However, the code doesn't enforce this requirement.

If a user specifies --author-dedup-mode with --repos (instead of --config), or if they use --author-dedup-mode with --config but no author-config.csv exists, the flag will be silently ignored without any warning or error message. This could lead to user confusion.

Consider adding validation in ArgsParser.parse() to check if isAuthorDedupMode is true, and if so, verify that:

configFolderPath is not the default path (or that --config was explicitly provided)

Optionally, check if the author-config.csv file exists and warn if it doesn't

Alternatively, you could add a warning log in ReportGenerator.updateAuthorList() when isAuthorDedupMode is true but the conditions aren't met.

@yizhong187 agreed, and i think it should just be limited to a warning. meaning if dedup flag is used but config flag is absent or config csv is absent, you can consider displaying a warning saying the dedup flag will be ignored. giving an error might be too much

Copilot · 2026-02-05T09:15:34Z

+    @Test
+    public void parse_withAuthorDedupMode_success() throws Exception {
+        String input = new InputBuilder()
+                .addRepos(TEST_REPO_REPOSENSE, TEST_REPO_BETA)
+                .add("--author-dedup-mode")
+                .build();
+        CliArguments cliArguments = ArgsParser.parse(translateCommandline(input));
+
+        Assertions.assertTrue(cliArguments.isAuthorDedupMode());
+    }
+
+    @Test
+    public void parse_withoutAuthorDedupMode_success() throws Exception {
+        String input = new InputBuilder().addRepos(TEST_REPO_REPOSENSE, TEST_REPO_BETA).build();
+        CliArguments cliArguments = ArgsParser.parse(translateCommandline(input));
+
+        Assertions.assertFalse(cliArguments.isAuthorDedupMode());
+    }


The test coverage for the author deduplication mode is insufficient. While these tests verify that the CLI flag is parsed correctly, there are no integration tests that verify the core deduplication logic in ReportGenerator.updateAuthorList().

Consider adding tests that verify:

When author-config.csv contains configured authors with aliases, those aliases are correctly deduplicated

Authors not in author-config.csv are added as new authors

The interaction between configured authors and commit authors works as expected

Looking at RepoConfigurationTest.java, there's a pattern for testing updateAuthorList() using reflection (see the test repoConfig_removeIgnoredAuthors_success). A similar test should be added for author dedup mode to ensure the feature works correctly end-to-end.

@yizhong187 might be out of scope - i dont see tests for the originality threshold config flag, for example. at the very least if you want to add tests for this feature, it shouldn't be part of the ParserTest file

CYX22222003

LGMT in general, just some small nitpicks to fix.

CYX22222003 · 2026-02-18T15:54:21Z

Run the system tests locally on Windows. LGTM.

github-actions · 2026-03-09T05:42:36Z

The following links are for previewing this pull request:

Dashboard Preview: https://dashboard-2532-pr-reposense-reposense.surge.sh
Docs Preview: https://docs-2532-pr-reposense-reposense.surge.sh

yizhong187 added 2 commits February 1, 2026 19:18

[reposense#2524] Add new --author-dedup-mode flag for deduplicating a…

97d7077

…uthors

[reposense#2524] Add dedup-author-mode flag in user guide

51cfbe2

yizhong187 marked this pull request as ready for review February 4, 2026 06:23

yizhong187 requested review from CYX22222003, FisherSkyi, ashmitahaldar, jonasongg and lyuanww February 4, 2026 06:23

damithc requested a review from Copilot February 5, 2026 09:09

Copilot started reviewing on behalf of damithc February 5, 2026 09:09 View session

Copilot AI reviewed Feb 5, 2026

View reviewed changes

CYX22222003 approved these changes Feb 6, 2026

View reviewed changes

Comment thread src/main/java/reposense/report/ReportGenerator.java Outdated

yizhong187 and others added 5 commits February 8, 2026 22:20

[reposense#2524] Add warning for wrong uses of author-dedup

71b1408

[reposense#2524] Extract gitId to local variable in ReportGenerator

cc9a476

[reposense#2524] Fix styling issue

eb0f9c7

[reposense#2524] Fix styling issue

976fba3

Merge branch 'master' into author-dedup-mode

c9ff151

jonasongg approved these changes Feb 15, 2026

View reviewed changes

CYX22222003 and others added 5 commits February 16, 2026 23:52

Merge branch 'master' into author-dedup-mode

7803e26

[reposense#2524] Add test

1db88fe

[reposense#2524] FIX CHECKSTYLE

f988ea8

[reposense#2524] Add new line at EOF

3ee7695

Merge branch 'master' into author-dedup-mode

dcf8f76

yizhong187 requested review from CYX22222003 and jonasongg February 18, 2026 15:35

CYX22222003 approved these changes Feb 18, 2026

View reviewed changes

jonasongg approved these changes Mar 5, 2026

View reviewed changes

jonasongg added the s.ToMerge label Mar 5, 2026

yizhong187 and others added 2 commits March 9, 2026 09:23

Merge branch 'master' into author-dedup-mode

a3edd20

Merge branch 'master' into author-dedup-mode

65ada75

CYX22222003 merged commit 4ced2e8 into reposense:master Mar 9, 2026
10 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[#2524] Add new --author-dedup-mode flag for deduplicating authors#2532

[#2524] Add new --author-dedup-mode flag for deduplicating authors#2532
CYX22222003 merged 14 commits into
reposense:masterfrom
yizhong187:author-dedup-mode

yizhong187 commented Feb 4, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Feb 5, 2026

Uh oh!

jonasongg Feb 6, 2026

Uh oh!

yizhong187 Feb 8, 2026

Uh oh!

Copilot AI Feb 5, 2026

Uh oh!

jonasongg Feb 6, 2026

Uh oh!

CYX22222003 left a comment

Uh oh!

Uh oh!

CYX22222003 Feb 18, 2026

Uh oh!

Uh oh!

github-actions Bot commented Mar 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Conversation

yizhong187 commented Feb 4, 2026

Proposed commit message

Manual Testing

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

jonasongg Feb 6, 2026

Choose a reason for hiding this comment

Uh oh!

yizhong187 Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

jonasongg Feb 6, 2026

Choose a reason for hiding this comment

Uh oh!

CYX22222003 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

CYX22222003 Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Mar 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants