+ Repost Companion Privacy Policy
+ Repost Companion is a local manual queue and campaign tracker. It does not read or modify RepostExchange or SoundCloud pages.
+
+ Information stored
+ When you use the extension, it stores track titles, artist names, queue status, and the completion times you enter. This information is kept in Chrome's storage.local on your device so the extension can display your checklist and progress.
+
+ Information sharing
+ The extension does not send this information to the developer or any other server. It contains no analytics, advertising, remote code, account service, or AI connection.
+
+ Permissions
+
+ storage saves your queue and repost log locally in Chrome.
+ Repost Companion requests no website access or host permissions.
+
+ Data removal
+ You can remove individual log entries using the extension. Removing the extension from Chrome removes its local extension data.
+
+ Changes and contact
+ This policy applies to Repost Companion version 1.1.0. A publisher support contact must be added here before public distribution.
+
+
+
diff --git a/repostexchange-companion/store-listing.md b/repostexchange-companion/store-listing.md
new file mode 100644
index 0000000..0798df5
--- /dev/null
+++ b/repostexchange-companion/store-listing.md
@@ -0,0 +1,40 @@
+# Chrome Web Store listing draft
+
+## Name
+
+Repost Companion — Local Queue
+
+## Short description
+
+Keep a private checklist of tracks listened to and reposts completed manually.
+
+## Detailed description
+
+Repost Companion is a small local checklist for a manual RepostExchange session. Add track titles and artists to a queue, mark tracks listened to, and log a repost only after you choose and submit it yourself. The popup shows your local daily progress and rolling 12-hour count.
+
+The extension stores its queue and completion timestamps in Chrome local storage on this device. It does not access RepostExchange or SoundCloud pages, control playback, click buttons, submit comments or reposts, or run in the background. It makes no network requests and has no account, analytics, advertising, or remote AI service.
+
+Repost Companion is an independent productivity tool and is not affiliated with or endorsed by RepostExchange or SoundCloud.
+
+## Single purpose
+
+Help users keep a local manual listening checklist and progress log for reposts they complete themselves.
+
+## Permission justification
+
+- `storage`: save the user's queue and completion timestamps locally in Chrome.
+
+The extension requests no host permissions and does not collect or transmit user data.
+
+## Privacy disclosure
+
+Repost Companion stores track titles, artist names, queue status, and completion timestamps in Chrome local storage on this device. This data is used only to display the checklist and calculate progress. It is not sent to the developer or any other server. The extension includes no analytics, advertising, account system, or remote code.
+
+## Store assets
+
+- 128 px icon: `icons/icon-128.png`
+- Genuine product screenshot: pending local Chrome review. Do not submit this listing until a screenshot of the loaded extension has been added here.
+
+## Support and privacy policy
+
+Add a support contact and host `store-assets/privacy-policy.html` at a stable public URL before submitting. Add a genuine product screenshot. Do not claim Chrome Web Store approval until review is complete.
diff --git a/repostexchange-companion/tests/core.test.cjs b/repostexchange-companion/tests/core.test.cjs
new file mode 100644
index 0000000..bb26520
--- /dev/null
+++ b/repostexchange-companion/tests/core.test.cjs
@@ -0,0 +1,59 @@
+const test = require("node:test");
+const assert = require("node:assert/strict");
+const core = require("../src/core.js");
+
+const HOUR = 60 * 60 * 1000;
+
+test("daily progress uses the machine's local calendar day", () => {
+ const now = new Date(2026, 8, 26, 12, 0, 0).getTime();
+ const entries = [
+ { completedAt: new Date(2026, 8, 26, 1, 0, 0).getTime() },
+ { completedAt: new Date(2026, 8, 25, 23, 59, 0).getTime() },
+ { completedAt: now + HOUR }
+ ];
+ const progress = core.getProgress(entries, now);
+ assert.equal(progress.todayCount, 1);
+ assert.equal(progress.dailyTarget, 20);
+ assert.equal(progress.canLog, true);
+});
+
+test("the rolling cap includes the last twelve hours and frees the oldest slot at expiry", () => {
+ const now = new Date(2026, 8, 26, 12, 0, 0).getTime();
+ const entries = Array.from({ length: 10 }, (_, index) => ({ completedAt: now - (11 - index) * HOUR }));
+ const atCap = core.getProgress(entries, now);
+ assert.equal(atCap.rollingCount, 10);
+ assert.equal(atCap.canLog, false);
+ assert.equal(atCap.nextSlotAt, entries[0].completedAt + core.WINDOW_MS);
+
+ const afterExpiry = core.getProgress(entries, atCap.nextSlotAt);
+ assert.equal(afterExpiry.rollingCount, 9);
+ assert.equal(afterExpiry.canLog, true);
+});
+
+test("a completion exactly twelve hours old no longer counts toward the rolling window", () => {
+ const now = new Date(2026, 8, 26, 12, 0, 0).getTime();
+ const entries = [{ completedAt: now - core.WINDOW_MS }];
+ const progress = core.getProgress(entries, now);
+ assert.equal(progress.rollingCount, 0);
+ assert.equal(progress.canLog, true);
+});
+
+test("the daily target is counted for the local calendar day", () => {
+ const now = new Date(2026, 8, 26, 23, 30, 0).getTime();
+ const first = new Date(2026, 8, 26, 0, 30, 0).getTime();
+ const entries = Array.from({ length: 20 }, (_, index) => ({ completedAt: first + index * 70 * 60 * 1000 }));
+ const progress = core.getProgress(entries, now);
+ assert.equal(progress.todayCount, 20);
+ assert.equal(progress.rollingCount, 10);
+ assert.equal(progress.canLog, false);
+});
+
+test("invalid and future completion timestamps do not affect progress", () => {
+ const now = new Date(2026, 8, 26, 12, 0, 0).getTime();
+ const progress = core.getProgress([
+ { completedAt: "not-a-date" },
+ { completedAt: now + HOUR }
+ ], now);
+ assert.equal(progress.todayCount, 0);
+ assert.equal(progress.rollingCount, 0);
+});