diff --git a/.eslintrc.js b/.eslintrc.js
deleted file mode 100644
index bd2cb6a2..00000000
--- a/.eslintrc.js
+++ /dev/null
@@ -1,29 +0,0 @@
-module.exports = {
-  parser: '@typescript-eslint/parser',
-  parserOptions: {
-    project: 'tsconfig.json',
-    sourceType: 'module',
-  },
-  plugins: ['@typescript-eslint/eslint-plugin'],
-  extends: [
-    'plugin:@typescript-eslint/recommended',
-    'plugin:prettier/recommended',
-  ],
-  root: true,
-  env: {
-    node: true,
-    jest: true,
-  },
-  ignorePatterns: [
-    '.eslintrc.js',
-    'src/createChart.ts',
-    '__test__',
-    'script.js',
-  ],
-  rules: {
-    '@typescript-eslint/interface-name-prefix': 'off',
-    '@typescript-eslint/explicit-function-return-type': 'off',
-    '@typescript-eslint/explicit-module-boundary-types': 'off',
-    '@typescript-eslint/no-explicit-any': 'off',
-  },
-};
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 00000000..bbde7821
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## [2026-10-27]
+
+### Added
+
+- `restrictedContributionsCount` in the GraphQL query, plus three opt-in activity graph options:
+  a "+N private" label (`show_private=true`), a year-over-year ghost line for the same window one
+  year earlier (`compare=year`, fetched via an aliased query in the same request), and a 7-day
+  moving average trend line (`trend=true`).
+- Optional `line_width` and `point_size` query params for customizing the graph line and point styling.
+
+### Changed
+
+- Migrated ESLint config to the ESLint 9 flat config format.
+- Set an explicit `rootDir` in `tsconfig.json` to match `tsc`'s existing compiled output and silence the TS6 rootDir-inference warning.
diff --git a/README.md b/README.md
index 4ee2a463..fecfd586 100644
--- a/README.md
+++ b/README.md
@@ -106,6 +106,11 @@ Customize the appearance of your Activity Graph however you want with URL params
 |     `from`     |       date from which the graph starts        |              format `YYYY-MM-DD`               |
 |      `to`      |         date where the graph will end         |              format `YYYY-MM-DD`               |
 |     `grid`     |                   show grid                   |           boolean (default: `true`)            |
+|  `line_width`  |        thickness of the graph's line          |       number (1-10 inclusive, default: `4`)    |
+|  `point_size`  |     diameter of points on the line graph      |      number (1-30 inclusive, default: `10`)    |
+| `show_private` |  adds a "+N private" label for restricted contributions in the window  |  boolean (default: `false`)  |
+|   `compare`    |  overlays a ghost line for the same window one year earlier  |  string (`year`)  |
+|     `trend`    |       overlays a 7-day moving average line        |           boolean (default: `false`)           |
 
 ⚠ **For `custom_title` please make sure that you are using %20 for spaces**
 
diff --git a/__test__/activityGraphFeatures.test.ts b/__test__/activityGraphFeatures.test.ts
new file mode 100644
index 00000000..6bd97839
--- /dev/null
+++ b/__test__/activityGraphFeatures.test.ts
@@ -0,0 +1,218 @@
+import { Utilities, movingAverage } from '../src/utils';
+import { Card } from '../src/GraphCards';
+import { Fetcher } from '../src/fetcher';
+import { UserDetails } from '../src/interfaces/interface';
+import { fakeQueryStringRes } from './fakeInputs';
+
+const flags = (query: Record<string, string>) =>
+    new Utilities({ username: 'u', ...query }).queryOptions();
+
+describe('show_private, compare and trend query options', () => {
+    it('all default to off', () => {
+        const options = flags({});
+        expect(options.show_private).toBe(false);
+        expect(options.compare).toBe(false);
+        expect(options.trend).toBe(false);
+    });
+
+    it('show_private only turns on for "true"', () => {
+        expect(flags({ show_private: 'true' }).show_private).toBe(true);
+        expect(flags({ show_private: 'false' }).show_private).toBe(false);
+        expect(flags({ show_private: 'yes' }).show_private).toBe(false);
+    });
+
+    it('compare only turns on for "year"', () => {
+        expect(flags({ compare: 'year' }).compare).toBe(true);
+        expect(flags({ compare: 'month' }).compare).toBe(false);
+        expect(flags({ compare: 'true' }).compare).toBe(false);
+    });
+
+    it('trend only turns on for "true"', () => {
+        expect(flags({ trend: 'true' }).trend).toBe(true);
+        expect(flags({ trend: 'false' }).trend).toBe(false);
+    });
+});
+
+describe('movingAverage', () => {
+    it('averages over a trailing window, partial at the start', () => {
+        expect(movingAverage([1, 2, 3, 4, 5, 6, 7, 8], 7)).toEqual([
+            1, 1.5, 2, 2.5, 3, 3.5, 4, 5,
+        ]);
+    });
+
+    it('defaults to a 7-day window', () => {
+        expect(movingAverage([7, 7, 7, 7, 7, 7, 7, 0])).toEqual([
+            7, 7, 7, 7, 7, 7, 7, 6,
+        ]);
+    });
+
+    it('returns an array the same length as the input, even for a single value', () => {
+        expect(movingAverage([5])).toEqual([5]);
+        expect(movingAverage([])).toEqual([]);
+    });
+});
+
+describe('getGraphQLQuery with a previous-year comparison', () => {
+    const fetcher = new Fetcher('someone');
+
+    it('adds restrictedContributionsCount to the base query', () => {
+        // @ts-ignore: testing private method
+        const { query } = fetcher.getGraphQLQuery('2024-01-01T00:00:00.000Z', '2024-02-01T00:00:00.000Z');
+        expect(query).toContain('restrictedContributionsCount');
+        expect(query).not.toContain('userPrevious');
+    });
+
+    it('adds an aliased userPrevious query and its variables when asked', () => {
+        // @ts-ignore: testing private method
+        const built = fetcher.getGraphQLQuery(
+            '2024-01-01T00:00:00.000Z',
+            '2024-02-01T00:00:00.000Z',
+            { from: '2023-01-01T00:00:00.000Z', to: '2023-02-01T00:00:00.000Z' },
+        );
+        expect(built.query).toContain('userPrevious: user(login: $LOGIN)');
+        expect(built.query).toContain('$FROM_PREV: DateTime!');
+        expect(built.query).toContain('$TO_PREV: DateTime!');
+        expect(built.variables).toEqual({
+            LOGIN: 'someone',
+            FROM: '2024-01-01T00:00:00.000Z',
+            TO: '2024-02-01T00:00:00.000Z',
+            FROM_PREV: '2023-01-01T00:00:00.000Z',
+            TO_PREV: '2023-02-01T00:00:00.000Z',
+        });
+    });
+});
+
+describe('fetchContributions with compareYear', () => {
+    it('captures restrictedContributionsCount and a length-matched previousYearContributions', async () => {
+        const fetcher = new Fetcher('someone');
+        // @ts-ignore: mocking private method
+        fetcher.fetch = jest.fn().mockResolvedValue({
+            data: {
+                data: {
+                    user: {
+                        name: 'Someone',
+                        contributionsCollection: {
+                            restrictedContributionsCount: 42,
+                            contributionCalendar: {
+                                weeks: [
+                                    {
+                                        contributionDays: [
+                                            { contributionCount: 1, date: '2024-01-01' },
+                                            { contributionCount: 2, date: '2024-01-02' },
+                                            { contributionCount: 3, date: '2024-01-03' },
+                                            { contributionCount: 4, date: '2024-01-04' },
+                                            { contributionCount: 5, date: '2024-01-05' },
+                                        ],
+                                    },
+                                ],
+                            },
+                        },
+                    },
+                    userPrevious: {
+                        contributionsCollection: {
+                            contributionCalendar: {
+                                weeks: [
+                                    {
+                                        contributionDays: [
+                                            { contributionCount: 9, date: '2023-01-01' },
+                                            { contributionCount: 9, date: '2023-01-02' },
+                                            { contributionCount: 9, date: '2023-01-03' },
+                                            { contributionCount: 9, date: '2023-01-04' },
+                                            { contributionCount: 9, date: '2023-01-05' },
+                                            { contributionCount: 9, date: '2023-01-06' },
+                                            { contributionCount: 9, date: '2023-01-07' },
+                                        ],
+                                    },
+                                ],
+                            },
+                        },
+                    },
+                },
+            },
+        });
+
+        const data = (await fetcher.fetchContributions(
+            5,
+            '2024-01-01',
+            '2024-01-05',
+            true,
+        )) as UserDetails;
+
+        expect(data.restrictedContributionsCount).toBe(42);
+        expect(data.previousYearContributions).toHaveLength(data.contributions.length);
+    });
+
+    it('omits previousYearContributions when compareYear is not requested', async () => {
+        const fetcher = new Fetcher('someone');
+        // @ts-ignore: mocking private method
+        fetcher.fetch = jest.fn().mockResolvedValue({
+            data: {
+                data: {
+                    user: {
+                        name: 'Someone',
+                        contributionsCollection: {
+                            restrictedContributionsCount: 0,
+                            contributionCalendar: {
+                                weeks: [
+                                    {
+                                        contributionDays: [
+                                            { contributionCount: 1, date: '2024-01-01' },
+                                        ],
+                                    },
+                                ],
+                            },
+                        },
+                    },
+                },
+            },
+        });
+
+        const data = (await fetcher.fetchContributions(1, '2024-01-01', '2024-01-01')) as UserDetails;
+        expect(data.previousYearContributions).toBeUndefined();
+    });
+});
+
+describe('Card.buildGraph with ghost line, trend line and private label', () => {
+    const days = [
+        { contributionCount: 2, date: '1' },
+        { contributionCount: 1, date: '2' },
+    ];
+
+    it('renders the overlay series and private label when provided', async () => {
+        const svg = await new Card(
+            420,
+            1200,
+            0,
+            fakeQueryStringRes[0].colors,
+            'title',
+            false,
+            true,
+            4,
+            10,
+            [
+                { contributionCount: 5, date: '1' },
+                { contributionCount: 6, date: '2' },
+            ],
+            [1.5, 1.5],
+            '+42 private',
+        ).buildGraph(days);
+
+        expect(svg).toContain('ct-series-ghost');
+        expect(svg).toContain('ct-series-trend');
+        expect(svg).toContain('+42 private');
+    });
+
+    it('omits overlay styling and the label when none are provided', async () => {
+        const svg = await new Card(
+            420,
+            1200,
+            0,
+            fakeQueryStringRes[0].colors,
+            'title',
+        ).buildGraph(days);
+
+        expect(svg).not.toContain('ct-series-ghost');
+        expect(svg).not.toContain('ct-series-trend');
+        expect(svg).not.toContain('private');
+    });
+});
diff --git a/__test__/fakeInputs.ts b/__test__/fakeInputs.ts
index 3346aec1..3fbe0348 100644
--- a/__test__/fakeInputs.ts
+++ b/__test__/fakeInputs.ts
@@ -118,6 +118,11 @@ export let fakeQueryStringRes = [
         from: '',
         to: '',
         grid: true,
+        line_width: 4,
+        point_size: 10,
+        show_private: false,
+        compare: false,
+        trend: false,
     },
     {
         username: 'githubusername',
@@ -138,6 +143,11 @@ export let fakeQueryStringRes = [
         from: '',
         to: '',
         grid: true,
+        line_width: 4,
+        point_size: 10,
+        show_private: false,
+        compare: false,
+        trend: false,
     },
     {
         username: 'githubusername',
@@ -158,6 +168,11 @@ export let fakeQueryStringRes = [
         from: '',
         to: '',
         grid: true,
+        line_width: 4,
+        point_size: 10,
+        show_private: false,
+        compare: false,
+        trend: false,
     },
     {
         username: 'githubusername',
@@ -178,6 +193,11 @@ export let fakeQueryStringRes = [
         from: '',
         to: '',
         grid: true,
+        line_width: 4,
+        point_size: 10,
+        show_private: false,
+        compare: false,
+        trend: false,
     },
     {
         username: 'githubusername',
@@ -198,6 +218,11 @@ export let fakeQueryStringRes = [
         from: '',
         to: '',
         grid: true,
+        line_width: 4,
+        point_size: 10,
+        show_private: false,
+        compare: false,
+        trend: false,
     },
     {
         username: 'githubusername',
@@ -218,6 +243,11 @@ export let fakeQueryStringRes = [
         from: '',
         to: '',
         grid: true,
+        line_width: 4,
+        point_size: 10,
+        show_private: false,
+        compare: false,
+        trend: false,
     },
     {
         username: 'githubusername',
@@ -238,6 +268,11 @@ export let fakeQueryStringRes = [
         from: '',
         to: '',
         grid: true,
+        line_width: 4,
+        point_size: 10,
+        show_private: false,
+        compare: false,
+        trend: false,
     },
     {
         username: 'githubusername',
@@ -258,6 +293,11 @@ export let fakeQueryStringRes = [
         from: '',
         to: '',
         grid: true,
+        line_width: 4,
+        point_size: 10,
+        show_private: false,
+        compare: false,
+        trend: false,
     },
     {
         username: 'githubusername',
@@ -279,6 +319,11 @@ export let fakeQueryStringRes = [
         from: '',
         to: '',
         grid: true,
+        line_width: 4,
+        point_size: 10,
+        show_private: false,
+        compare: false,
+        trend: false,
     },
     {
         username: 'githubusername',
@@ -299,6 +344,11 @@ export let fakeQueryStringRes = [
         from: '',
         to: '',
         grid: true,
+        line_width: 4,
+        point_size: 10,
+        show_private: false,
+        compare: false,
+        trend: false,
     },
 ];
 
@@ -343,6 +393,7 @@ export const expectedQuery = (username: string, from: string, to: string) => {
                 user(login: $LOGIN) {
                   name
                   contributionsCollection(from: $FROM, to: $TO) {
+                    restrictedContributionsCount
                     contributionCalendar {
                       weeks {
                         contributionDays {
diff --git a/__test__/lineWidthPointSize.test.ts b/__test__/lineWidthPointSize.test.ts
new file mode 100644
index 00000000..2d12757c
--- /dev/null
+++ b/__test__/lineWidthPointSize.test.ts
@@ -0,0 +1,53 @@
+import { Utilities } from '../src/utils';
+import { graphStyle } from '../src/styles/graphStyle';
+
+const sizes = (query: Record<string, string>) => {
+    const { line_width, point_size } = new Utilities({ username: 'u', ...query }).queryOptions();
+    return { line_width, point_size };
+};
+
+describe('line_width and point_size', () => {
+    it('keeps upstream defaults when omitted or empty', () => {
+        expect(sizes({})).toEqual({ line_width: 4, point_size: 10 });
+        expect(sizes({ line_width: '', point_size: '' })).toEqual({
+            line_width: 4,
+            point_size: 10,
+        });
+    });
+
+    it('accepts in-range values', () => {
+        expect(sizes({ line_width: '2', point_size: '6' })).toEqual({
+            line_width: 2,
+            point_size: 6,
+        });
+    });
+
+    it('clamps out-of-range values', () => {
+        expect(sizes({ line_width: '999', point_size: '999' })).toEqual({
+            line_width: 10,
+            point_size: 30,
+        });
+        expect(sizes({ line_width: '-5', point_size: '0' })).toEqual({
+            line_width: 1,
+            point_size: 1,
+        });
+    });
+
+    it('falls back to defaults for non-numeric input (no CSS injection)', () => {
+        const res = sizes({ line_width: '4;}</style><script>', point_size: 'NaN' });
+        expect(res).toEqual({ line_width: 4, point_size: 10 });
+        expect(sizes({ line_width: 'Infinity' }).line_width).toBe(4);
+    });
+
+    it('writes the values into the stylesheet', () => {
+        const css = graphStyle('fff', 'fff', 'fff', 'fff', 2, 6);
+        expect(css).toMatch(/\.ct-line \{[^}]*stroke-width: 2px/);
+        expect(css).toMatch(/\.ct-point \{[^}]*stroke-width: 6px/);
+    });
+
+    it('defaults the stylesheet to the upstream 4px line and 10px point', () => {
+        const css = graphStyle('fff', 'fff', 'fff', 'fff');
+        expect(css).toMatch(/\.ct-line \{[^}]*stroke-width: 4px/);
+        expect(css).toMatch(/\.ct-point \{[^}]*stroke-width: 10px/);
+    });
+});
diff --git a/eslint.config.js b/eslint.config.js
new file mode 100644
index 00000000..cdbd5332
--- /dev/null
+++ b/eslint.config.js
@@ -0,0 +1,26 @@
+const tseslint = require('@typescript-eslint/eslint-plugin');
+const tsParser = require('@typescript-eslint/parser');
+const prettierRecommended = require('eslint-plugin-prettier/recommended');
+
+module.exports = [
+    {
+        ignores: ['eslint.config.js', 'src/createChart.ts', '__test__/', 'script.js'],
+    },
+    ...tseslint.configs['flat/recommended'],
+    {
+        files: ['**/*.ts'],
+        languageOptions: {
+            parser: tsParser,
+            parserOptions: {
+                project: 'tsconfig.json',
+                sourceType: 'module',
+            },
+        },
+        rules: {
+            '@typescript-eslint/explicit-function-return-type': 'off',
+            '@typescript-eslint/explicit-module-boundary-types': 'off',
+            '@typescript-eslint/no-explicit-any': 'off',
+        },
+    },
+    prettierRecommended,
+];
diff --git a/plans/README.md b/plans/README.md
new file mode 100644
index 00000000..ff5cd8d3
--- /dev/null
+++ b/plans/README.md
@@ -0,0 +1,149 @@
+# Profile Cards Plan
+
+Self-host the cards on the [KingRaver profile README](https://github.com/KingRaver/KingRaver) and
+add data that shows the full scale of the work. Most of it is private: in the 12 months to
+2026-10-27, 5,851 of 6,988 contributions were private, and the shared stats card only shows 987
+commits.
+
+Target end state: **two Vercel projects behind one base URL.**
+
+- **This project** (`github-readme-activity-graph`) serves `/graph`, `/streak`, and proxy routes
+  to the stats project.
+- **The stats project** (the `KingRaver/github-readme-stats` fork) serves the stats and
+  top-languages cards.
+- Both use the same narrow, read-only token.
+
+Each phase is its own branch and PR.
+
+---
+
+### Phase 0: Finish line_width / point_size
+
+Branch: `feat/phase-0-finish-line-width-point-size`. The code itself (commit 4d29da2) was already
+merged to `main` in PR #1.
+
+- [x] Add a `line_width` row to the README Customization table (number 1–10, default 4)
+- [x] Add a `point_size` row to the README Customization table (number 1–30, default 10)
+- [x] `npm test`, `npm run lint` and `npm run build` pass
+      _2026-10-27: replaced the legacy `.eslintrc.js`, which ESLint 9 ignores, with a flat
+      `eslint.config.js`. It keeps the same rules, ignores and Prettier setup. It drops
+      `interface-name-prefix`, a rule that no longer exists in typescript-eslint v8. Removed the
+      unused `catch` bindings in `src/handlers.ts`. Lint covers 10 files with 0 problems, and
+      `--fix` changes nothing. Build passes. Tests pass 15/15 with `TOKEN` set._
+      _The live-API test in `__test__/utils.test.ts` needs a `TOKEN`. CI supplies it from
+      `secrets.TOKEN`; locally it fails with a 401 unless one is set._
+
+**Done when:** shipped, and the `rho-azure` deployment renders `?line_width=` / `?point_size=`.
+
+---
+
+### Phase 1: Token
+
+- [x] Check the `TOKEN` already set in the Vercel project. It is a fine-grained, read-only token
+      scoped to one repo, which is narrow enough.
+- [x] Confirm private contributions come through with it. On 2026-10-27, `/data` returned 374
+      contributions over 31 days, against GitHub's 379 total, of which 365 were private.
+
+---
+
+### Phase 2: Activity graph data features
+
+Branch: `feat/private-contributions`
+**Depends on:** Phase 0
+
+- [x] Fetch `restrictedContributionsCount` in the existing query
+- [x] Opt-in "+N private" label for the selected window (`show_private=true`)
+- [x] Opt-in year-over-year ghost line (`compare=year`): the same window from last year, fetched
+      in the same request as an aliased query
+      _2026-10-27: adds a `userPrevious: user(...)` alias plus `$FROM_PREV`/`$TO_PREV` variables
+      only when `compare=year`. The fetched previous-year days are trimmed to the same length as
+      the current window and rendered as a dashed, point-less "ghost" line
+      (`.ct-series-ghost`)._
+- [x] Optional 7-day moving average (`trend=true`)
+      _Trailing average (`movingAverage` in `src/utils.ts`), partial window for the first 6 days;
+      rendered as a dotted, point-less "trend" line (`.ct-series-trend`)._
+- [x] Tests in `__test__/` for each new option
+      _New `__test__/activityGraphFeatures.test.ts`: query-option parsing, `movingAverage`, the
+      aliased GraphQL query shape, `Fetcher.fetchContributions` parsing of
+      `restrictedContributionsCount`/`previousYearContributions`, and `Card.buildGraph` rendering
+      (and correctly omitting) the overlay series and private label._
+- [x] README Customization rows for each new option
+      _2026-10-27: `npm run build`, `npm run lint` and `npm test` all pass (28 tests; the one
+      pre-existing failure is the live-API test in `__test__/utils.test.ts`, which needs a
+      `TOKEN` — same documented gap as Phase 0, unrelated to this phase). The
+      `restrictedContributionsCount` field name and the aliased-query syntax follow GitHub's
+      GraphQL schema but haven't been smoke-tested against the live API locally, since no
+      `TOKEN` is set in this environment._
+
+> **Note:** GitHub reports private contributions only as a total for the window. The daily counts
+> already include them, unlabelled. A shaded per-day public/private split would need the
+> paginated per-commit, per-PR lists, which cost far more API quota. The label is the planned
+> version; per-day shading is out of scope unless its cost is measured first.
+
+> **Decision required:** offer Phase 2 and 3 features upstream to
+> `Ashutosh00710/github-readme-activity-graph`, or keep them fork-only? Proceeding fork-only
+> unless told otherwise.
+
+---
+
+### Phase 3: /streak endpoint
+
+Branch: `feat/streak-card`
+**Depends on:** Phase 0
+
+- [ ] Fetch the contribution calendar for every year since the account was created (2021) in one
+      GraphQL request, using aliased yearly queries
+- [ ] Calculate the current streak, longest streak and all-time total
+- [ ] `GET /streak` renders an SVG card using the existing themes and colour params
+- [ ] Tests for the streak maths, including today having no contributions yet and gaps that
+      cross a year boundary
+- [ ] README section for `/streak`
+
+> **Decision required:** keep a separate streak card on the profile, or drop it and let the
+> graph carry that story? Building the endpoint either way; the profile choice is made in
+> Phase 6.
+
+---
+
+### Phase 4: Self-host the stats card
+
+Repo: `KingRaver/github-readme-stats`
+
+- [ ] Bring the fork up to date with `anuraghazra/github-readme-stats`
+- [ ] Deploy it as a second Vercel project with the same kind of narrow, read-only token
+- [ ] Turn on the private commit count (check the parameter name in the current code; probably
+      `count_private`)
+- [ ] Confirm the commit count is above the shared instance's 987
+- [ ] Accept that top-languages counts public repos only. Including private repos would mean
+      giving the token access to their code.
+
+---
+
+### Phase 5: One base URL
+
+Branch: `feat/stats-proxy`
+**Depends on:** Phase 4
+
+- [ ] Add proxy routes to `vercel.json` for `/stats` and `/top-langs`, pointing at the stats
+      project and placed before the `/(.*)` catch-all
+- [ ] Smoke-test both proxied routes on a preview deployment
+
+> **Decision required:** custom subdomain (e.g. `cards.vividvisions.quest`, which is a DNS
+> change) or keep the `vercel.app` URLs? Ask before touching DNS.
+
+---
+
+### Phase 6: Update the profile README
+
+Repo: `KingRaver/KingRaver`
+**Depends on:** Phases 2–5
+
+- [ ] Point every card at the new base URL
+- [ ] Move the typing SVG from `readme-typing-svg.herokuapp.com` to `readme-typing-svg.demolab.com`
+- [ ] Replace the third-party streak card (`github-readme-streak-stats-eight.vercel.app`) per the
+      Phase 3 decision
+- [ ] Add a scheduled Substack "latest posts" workflow (`gautamkrishnar/blog-post-workflow`)
+      next to the snake workflow
+
+> **Decision required:** add uptime or usage badges for Veritus and Voucher.Social? Only with
+> aggregate numbers the operators approve.
diff --git a/src/GraphCards.ts b/src/GraphCards.ts
index da044772..149aa304 100644
--- a/src/GraphCards.ts
+++ b/src/GraphCards.ts
@@ -1,6 +1,7 @@
 import { createGraph } from './createChart';
 import { graphSvg } from './svgs';
-import { Colors, ContributionDay } from './interfaces/interface';
+import { DEFAULT_LINE_WIDTH, DEFAULT_POINT_SIZE, overlaySeriesStyle } from './styles/graphStyle';
+import { Colors, ContributionDay, GraphArgs } from './interfaces/interface';
 
 export class Card {
     constructor(
@@ -11,6 +12,14 @@ export class Card {
         private readonly title = '',
         private readonly area = false,
         private readonly showGrid = true,
+        private readonly lineWidth = DEFAULT_LINE_WIDTH,
+        private readonly pointSize = DEFAULT_POINT_SIZE,
+        // Same window, one year earlier (compare=year) - rendered as a secondary "ghost" line
+        private readonly ghostContributions?: ContributionDay[],
+        // 7-day moving average (trend=true), aligned day-for-day with `days`
+        private readonly trendValues?: number[],
+        // "+N private" label (show_private=true)
+        private readonly privateLabel?: string,
     ) {}
 
     private getOptions() {
@@ -43,6 +52,11 @@ export class Card {
             },
             showArea: this.area,
             fullWidth: true,
+            // the ghost/trend lines never show points or an area fill, regardless of `area`
+            series: {
+                ghost: { showPoint: false, showArea: false },
+                trend: { showPoint: false, showArea: false },
+            },
         };
     }
 
@@ -65,21 +79,45 @@ export class Card {
         //Options to pass in createGraph function
         const options = this.getOptions();
 
+        const series: Array<{ value: number[]; name?: string; className?: string }> = [
+            { value: days.map((day) => day.contributionCount) },
+        ];
+        const hasGhost = !!this.ghostContributions?.length;
+        const hasTrend = !!this.trendValues?.length;
+        if (hasGhost) {
+            series.push({
+                value: this.ghostContributions!.map((day) => day.contributionCount),
+                name: 'ghost',
+                className: 'ct-series-ghost',
+            });
+        }
+        if (hasTrend) {
+            series.push({ value: this.trendValues!, name: 'trend', className: 'ct-series-trend' });
+        }
+
         //Construction of graph from node-chartist
         const line: Promise<string> = await createGraph('line', options, {
             labels: days.map((day) => day.date),
-            series: [{ value: days.map((day) => day.contributionCount) }],
+            series,
         });
 
         //Arguments to construct graphs with rect and other options
-        const args = {
+        const args: GraphArgs = {
             height: this.height,
             width: this.width,
             colors: this.colors,
             title: this.title,
             radius: this.radius,
             line,
+            lineWidth: this.lineWidth,
+            pointSize: this.pointSize,
         };
+        if (hasGhost || hasTrend) {
+            args.extraStyle = overlaySeriesStyle(this.colors.lineColor);
+        }
+        if (this.privateLabel) {
+            args.privateLabel = this.privateLabel;
+        }
 
         return graphSvg(args);
     }
diff --git a/src/fetcher.ts b/src/fetcher.ts
index 25611777..33fd2d7e 100644
--- a/src/fetcher.ts
+++ b/src/fetcher.ts
@@ -11,13 +11,31 @@ export class Fetcher {
         this.username = username;
     }
 
-    private getGraphQLQuery(from: string, to: string) {
+    private getGraphQLQuery(from: string, to: string, previous?: { from: string; to: string }) {
+        const previousYearParams = previous ? ', $FROM_PREV: DateTime!, $TO_PREV: DateTime!' : '';
+        const previousYearBlock = previous
+            ? `
+                userPrevious: user(login: $LOGIN) {
+                  contributionsCollection(from: $FROM_PREV, to: $TO_PREV) {
+                    contributionCalendar {
+                      weeks {
+                        contributionDays {
+                          contributionCount
+                          date
+                        }
+                      }
+                    }
+                  }
+                }`
+            : '';
+
         return {
             query: `
-              query userInfo($LOGIN: String!, $FROM: DateTime!, $TO: DateTime!) {
+              query userInfo($LOGIN: String!, $FROM: DateTime!, $TO: DateTime!${previousYearParams}) {
                 user(login: $LOGIN) {
                   name
                   contributionsCollection(from: $FROM, to: $TO) {
+                    restrictedContributionsCount
                     contributionCalendar {
                       weeks {
                         contributionDays {
@@ -27,13 +45,14 @@ export class Fetcher {
                       }
                     }
                   }
-                }
+                }${previousYearBlock}
               }
             `,
             variables: {
                 LOGIN: this.username,
                 FROM: from,
                 TO: to,
+                ...(previous ? { FROM_PREV: previous.from, TO_PREV: previous.to } : {}),
             },
         };
     }
@@ -53,6 +72,7 @@ export class Fetcher {
         days: number,
         customFromDate?: string,
         customToDate?: string,
+        compareYear?: boolean,
     ): Promise<UserDetails | string> {
         let from = '',
             to = '';
@@ -66,8 +86,16 @@ export class Fetcher {
             to = moment(now).add(1, 'days').utc().toISOString();
         }
 
+        // Same window, one year earlier, fetched via an aliased query in the same request
+        const previous = compareYear
+            ? {
+                  from: moment(from).subtract(1, 'year').toISOString(),
+                  to: moment(to).subtract(1, 'year').toISOString(),
+              }
+            : undefined;
+
         try {
-            const apiResponse = await this.fetch(this.getGraphQLQuery(from, to));
+            const apiResponse = await this.fetch(this.getGraphQLQuery(from, to, previous));
 
             if (apiResponse.data.errors) {
                 console.error('API Error: ', apiResponse.data.errors);
@@ -84,6 +112,9 @@ export class Fetcher {
                     const userData: UserDetails = {
                         contributions: [],
                         name: apiResponse.data.data.user.name,
+                        restrictedContributionsCount:
+                            apiResponse.data.data.user.contributionsCollection
+                                .restrictedContributionsCount,
                     };
                     //filtering the week data from API response
                     const weeks =
@@ -110,6 +141,28 @@ export class Fetcher {
                         const extra = userData.contributions.length - days;
                         userData.contributions.splice(0, extra);
                     }
+
+                    if (previous && apiResponse.data.data.userPrevious) {
+                        const previousYearContributions: ContributionDay[] = [];
+                        apiResponse.data.data.userPrevious.contributionsCollection.contributionCalendar.weeks.map(
+                            (week: Week) =>
+                                week.contributionDays.map((contributionDay: ContributionDay) => {
+                                    contributionDay.date = moment(
+                                        contributionDay.date,
+                                        moment.ISO_8601,
+                                    )
+                                        .date()
+                                        .toString();
+                                    previousYearContributions.push(contributionDay);
+                                }),
+                        );
+                        // align the ghost line's length to the current window's
+                        const extra =
+                            previousYearContributions.length - userData.contributions.length;
+                        if (extra > 0) previousYearContributions.splice(0, extra);
+                        userData.previousYearContributions = previousYearContributions;
+                    }
+
                     return userData;
                 }
             } else {
diff --git a/src/handlers.ts b/src/handlers.ts
index e10d4891..a40049b9 100644
--- a/src/handlers.ts
+++ b/src/handlers.ts
@@ -16,16 +16,17 @@ export class Handlers {
             const fetcher = new Fetcher(utils.username);
             const queryOptions = utils.queryOptions();
             const fetchCalendarData = await fetcher.fetchContributions(
-                utils.queryOptions().days,
+                queryOptions.days,
                 queryOptions.from,
                 queryOptions.to,
+                queryOptions.compare,
             );
 
             const { finalGraph, header } = await utils.buildGraph(fetchCalendarData);
             utils.setHttpHeader(res, header.maxAge);
 
             res.status(200).send(finalGraph);
-        } catch (error) {
+        } catch {
             res.setHeader('Cache-Control', 'no-store, max-age=0');
             res.set('Content-Type', 'image/svg+xml');
             res.send(invalidUserSvg('Something unexpected happened 💥'));
@@ -37,8 +38,12 @@ export class Handlers {
             const utils = new Utilities(req.query);
 
             const fetcher = new Fetcher(utils.username);
+            const queryOptions = utils.queryOptions();
             const fetchCalendarData: UserDetails | string = await fetcher.fetchContributions(
-                utils.queryOptions().days,
+                queryOptions.days,
+                undefined,
+                undefined,
+                queryOptions.compare,
             );
 
             if (typeof fetchCalendarData === 'object') {
@@ -46,7 +51,7 @@ export class Handlers {
             } else {
                 res.send(invalidUserSvg(fetchCalendarData));
             }
-        } catch (error) {
+        } catch {
             res.send(invalidUserSvg('Something unexpected happened 💥'));
         }
     }
diff --git a/src/interfaces/interface.ts b/src/interfaces/interface.ts
index d0dbece5..18573f9c 100644
--- a/src/interfaces/interface.ts
+++ b/src/interfaces/interface.ts
@@ -27,6 +27,11 @@ export class QueryOption {
     radius: number;
     height: number;
     days: number;
+    line_width: number;
+    point_size: number;
+    show_private: boolean;
+    compare: boolean;
+    trend: boolean;
 }
 
 export class ParsedQs {
@@ -49,6 +54,11 @@ export class ParsedQs {
     from?: string;
     to?: string;
     grid?: string;
+    line_width?: string;
+    point_size?: string;
+    show_private?: string;
+    compare?: string;
+    trend?: string;
 }
 
 export class GraphArgs {
@@ -58,11 +68,17 @@ export class GraphArgs {
     title: string;
     radius: number;
     line: Promise<string>;
+    lineWidth?: number;
+    pointSize?: number;
+    extraStyle?: string;
+    privateLabel?: string;
 }
 
 export class UserDetails {
     contributions: Array<ContributionDay>;
     name: string;
+    restrictedContributionsCount?: number;
+    previousYearContributions?: Array<ContributionDay>;
 }
 
 export class ContributionDay {
@@ -79,12 +95,20 @@ export class ResponseOfApi {
         user: {
             name: string;
             contributionsCollection: {
+                restrictedContributionsCount?: number;
                 contributionCalendar: {
                     totalContributions: number;
                     weeks: Array<Week>;
                 };
             };
         };
+        userPrevious?: {
+            contributionsCollection: {
+                contributionCalendar: {
+                    weeks: Array<Week>;
+                };
+            };
+        };
     };
     errors?: Array<{ message: string; type: string }>;
 }
diff --git a/src/styles/graphStyle.ts b/src/styles/graphStyle.ts
index e03813e6..a83b1232 100644
--- a/src/styles/graphStyle.ts
+++ b/src/styles/graphStyle.ts
@@ -1,4 +1,14 @@
-export const graphStyle = (color: string, line: string, point: string, area: string) =>
+export const DEFAULT_LINE_WIDTH = 4;
+export const DEFAULT_POINT_SIZE = 10;
+
+export const graphStyle = (
+    color: string,
+    line: string,
+    point: string,
+    area: string,
+    lineWidth = DEFAULT_LINE_WIDTH,
+    pointSize = DEFAULT_POINT_SIZE,
+) =>
     `
     .ct-label {
       fill: #${color};
@@ -82,14 +92,14 @@ export const graphStyle = (color: string, line: string, point: string, area: str
     }
 
     .ct-point {
-      stroke-width: 10px;
+      stroke-width: ${pointSize}px;
       stroke-linecap: round;
       stroke: #${point};
       animation: blink 1s ease-in-out forwards;
     }
 
     .ct-line {
-      stroke-width: 4px;
+      stroke-width: ${lineWidth}px;
       stroke-dasharray: 5000;
       stroke-dashoffset: 5000;
       stroke: #${line};
@@ -111,6 +121,26 @@ export const graphStyle = (color: string, line: string, point: string, area: str
     }
     `;
 
+// Styling for the optional year-over-year ghost line (compare=year) and
+// 7-day moving average trend line (trend=true); both skip points/area so they
+// stay visually secondary to the main contribution line.
+export const overlaySeriesStyle = (lineColor: string) =>
+    `
+    .ct-series-ghost .ct-line {
+      stroke: #${lineColor};
+      stroke-dasharray: 6px, 4px;
+      opacity: 0.35;
+      animation: none;
+    }
+
+    .ct-series-trend .ct-line {
+      stroke: #${lineColor};
+      stroke-dasharray: 2px, 3px;
+      opacity: 0.6;
+      animation: none;
+    }
+    `;
+
 /** Unused style for dates feature #85 */
 export const diagonalTiltStyle = () => {
     return `
diff --git a/src/svgs.ts b/src/svgs.ts
index 0b585197..b99ef593 100644
--- a/src/svgs.ts
+++ b/src/svgs.ts
@@ -34,7 +34,9 @@ export const graphSvg = (props: GraphArgs) => `
                     props.colors.lineColor,
                     props.colors.pointColor,
                     props.colors.areaColor,
-                )}
+                    props.lineWidth,
+                    props.pointSize,
+                )}${props.extraStyle ?? ''}
                 ${pointAnimation()}
                 ${lineAnimation()}
             </style>
@@ -43,7 +45,12 @@ export const graphSvg = (props: GraphArgs) => `
                 <h1 xmlns="http://www.w3.org/1999/xhtml" class="header">
                     ${props.title}
                 </h1>
-            </foreignObject>
+            </foreignObject>${
+                props.privateLabel
+                    ? `
+            <text x="${props.width - 20}" y="20" text-anchor="end" data-testid="private_label" style="fill:#${props.colors.titleColor ?? props.colors.color}; opacity:.7; font-size:12px;">${props.privateLabel}</text>`
+                    : ''
+            }
             ${props.line}
     </svg>
 `;
diff --git a/src/utils.ts b/src/utils.ts
index ddef898e..2e78d842 100644
--- a/src/utils.ts
+++ b/src/utils.ts
@@ -3,8 +3,16 @@ import { Response } from 'express';
 import { Card } from './GraphCards';
 import { invalidUserSvg } from './svgs';
 import { selectColors } from './styles/themes';
+import { DEFAULT_LINE_WIDTH, DEFAULT_POINT_SIZE } from './styles/graphStyle';
 import { QueryOption, ParsedQs, UserDetails } from './interfaces/interface';
 
+// Trailing N-day average; the window is partial for the first N-1 entries.
+export const movingAverage = (values: number[], window = 7): number[] =>
+    values.map((_, index) => {
+        const slice = values.slice(Math.max(0, index - window + 1), index + 1);
+        return slice.reduce((sum, value) => sum + value, 0) / slice.length;
+    });
+
 export class Utilities {
     public username: string;
     constructor(private readonly queryString: ParsedQs) {
@@ -40,6 +48,13 @@ export class Utilities {
         };
     }
 
+    // Finite number clamped to [min, max]; anything else falls back to the default
+    private clampNumber(value: string | undefined, min: number, max: number, fallback: number) {
+        if (value === undefined || value === '') return fallback;
+        const n = Number(value);
+        return Number.isFinite(n) ? Math.min(Math.max(n, min), max) : fallback;
+    }
+
     private validateDays(days?: string): number {
         const d = Number(days);
         if (typeof d !== 'number') {
@@ -121,6 +136,12 @@ export class Utilities {
                 : 420, // Custom height implementation from range [200, 600], if not specified use default value - 420
             days: isFromValid && isToValid ? days : this.validateDays(this.queryString.days),
             grid: this.queryString.grid === 'false' ? false : true,
+            // Line thickness in range [1, 10], point diameter in range [1, 30]
+            line_width: this.clampNumber(this.queryString.line_width, 1, 10, DEFAULT_LINE_WIDTH),
+            point_size: this.clampNumber(this.queryString.point_size, 1, 30, DEFAULT_POINT_SIZE),
+            show_private: String(this.queryString.show_private) === 'true',
+            compare: String(this.queryString.compare) === 'year',
+            trend: String(this.queryString.trend) === 'true',
             from,
             to,
         };
@@ -146,6 +167,15 @@ export class Utilities {
                 }
             }
 
+            const trendValues = options.trend
+                ? movingAverage(fetchCalendarData.contributions.map((day) => day.contributionCount))
+                : undefined;
+
+            const privateLabel =
+                options.show_private && fetchCalendarData.restrictedContributionsCount
+                    ? `+${fetchCalendarData.restrictedContributionsCount} private`
+                    : undefined;
+
             const graph = new Card(
                 options.height,
                 1200,
@@ -154,6 +184,11 @@ export class Utilities {
                 title,
                 options.area,
                 options.grid,
+                options.line_width,
+                options.point_size,
+                options.compare ? fetchCalendarData.previousYearContributions : undefined,
+                trendValues,
+                privateLabel,
             );
             const getChart = await graph.buildGraph(fetchCalendarData.contributions);
             return {
diff --git a/tsconfig.json b/tsconfig.json
index ce94f59b..b6b6a69d 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -5,6 +5,7 @@
         "lib": ["dom", "es6", "es2017", "esnext.asynciterable"],
         "sourceMap": true,
         "outDir": "./dist",
+        "rootDir": "./src",
         "moduleResolution": "node",
         "removeComments": true,
         "skipLibCheck": true,