Add MIT license and GitHub repository polish

Author: baboonzero

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,64 @@
+name: Bug report
+description: Report a reproducible bug in Chrome Activity Reader
+title: "[Bug]: "
+labels:
+  - bug
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What happened?
+      placeholder: Clear and concise bug summary.
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: Provide exact steps.
+      placeholder: |
+        1. Open ...
+        2. Click ...
+        3. Observe ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      placeholder: What should happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+      placeholder: What actually happened?
+    validations:
+      required: true
+
+  - type: input
+    id: chrome_version
+    attributes:
+      label: Chrome version
+      placeholder: e.g. 134.0.x
+    validations:
+      required: true
+
+  - type: input
+    id: extension_version
+    attributes:
+      label: Extension version
+      placeholder: e.g. 0.1.1
+    validations:
+      required: true
+
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Logs / screenshots / artifacts
+      description: Paste console errors, attach screenshots, or list artifact paths.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Project documentation
+    url: https://github.com/baboonzero/chrome-activity-reader/blob/main/README.md
+    about: Review setup, usage, and validation docs before opening an issue.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,44 @@
+name: Feature request
+description: Propose an enhancement for Chrome Activity Reader
+title: "[Feature]: "
+labels:
+  - enhancement
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem statement
+      description: What user problem does this solve?
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: Describe the proposed behavior.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: List alternatives you considered.
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      options:
+        - High
+        - Medium
+        - Low
+    validations:
+      required: true
+
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Mockups / references
+      description: Links, screenshots, or examples.

.github/pull_request_template.md

@@ -0,0 +1,23 @@
+## Summary
+
+Describe what changed and why.
+
+## Changes
+
+- 
+
+## Validation
+
+- [ ] `npm run test:all`
+- [ ] `npm run test:smoke:extension` (if extension runtime behavior changed)
+- [ ] `npm run test:flows:extension` (if navigation/state transitions changed)
+
+## Screenshots / Evidence
+
+If UI or behavior changed, include screenshots or artifact paths.
+
+## Checklist
+
+- [ ] Tests added/updated where needed
+- [ ] Documentation updated where needed
+- [ ] No unrelated changes included

CONTRIBUTING.md

@@ -0,0 +1,31 @@
+# Contributing
+
+Thanks for contributing to Chrome Activity Reader.
+
+## Development Setup
+
+1. Install Node.js 22+
+2. Install dependencies:
+   - `npm install`
+3. Install Playwright browser:
+   - `npx playwright install chromium`
+
+## Run Tests
+
+- `npm run test:all`
+- `npm run test:smoke:extension`
+- `npm run test:flows:extension`
+
+## Pull Request Guidelines
+
+1. Keep changes focused and small.
+2. Add or update tests for behavior changes.
+3. Update docs when user-facing behavior changes.
+4. Ensure all tests pass before opening PR.
+
+## Commit Message Style
+
+Use clear imperative messages, for example:
+
+- `Fix side panel state sync after close`
+- `Add install guide for unpacked Chrome extension`

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Baboonzero
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -5,6 +5,7 @@ Chrome extension that tracks all web tabs (`http/https`) and surfaces attention-
 For complete project history, architecture decisions, execution timeline, built/not-built scope, and current status, see:
 - `project-history.md`
 - `docs/INSTALLATION.md`
+- `docs/GITHUB_METADATA.md`
 
 ## Features
 
@@ -121,3 +122,11 @@ If `default` session fails to start on Windows, use a non-default `--session` na
 
 - Tracking scope is web tabs only (`http/https`), not `chrome://` or extension pages.
 - No content-script capture of in-page click/typing/scroll behavior.
+
+## License
+
+MIT - see `LICENSE`.
+
+## Contributing
+
+See `CONTRIBUTING.md`.

docs/GITHUB_METADATA.md

@@ -0,0 +1,56 @@
+# GitHub Metadata and Repo Polish
+
+Use this file as the source of truth for GitHub repository settings.
+
+## Recommended Repository Description
+
+`Chrome extension (MV3) that tracks tab activity across windows and surfaces meaningful work over 1h, 4h, 1d, and 7d with side-panel and dashboard views.`
+
+## Recommended Topics
+
+Add these topics in GitHub:
+
+- `chrome-extension`
+- `manifest-v3`
+- `productivity`
+- `tab-management`
+- `activity-tracker`
+- `browser-extension`
+- `playwright`
+- `automation-testing`
+- `javascript`
+- `indexeddb`
+
+## Suggested Website/Homepage
+
+If you do not have a marketing site, set homepage to:
+
+`https://github.com/baboonzero/chrome-activity-reader`
+
+## Recommended Social Preview
+
+Use a 1280x640 image that includes:
+
+- App name: `Chrome Activity Reader`
+- Tagline: `Track everything. Surface what matters.`
+- Visual cue: side panel + dashboard split mockup
+
+## Labels To Add (Issues/PR Triage)
+
+- `bug`
+- `enhancement`
+- `documentation`
+- `good first issue`
+- `help wanted`
+- `needs reproduction`
+- `priority:high`
+- `priority:medium`
+- `priority:low`
+- `testing`
+
+## Current Defaults Added In This Repo
+
+- MIT license (`LICENSE`)
+- Pull request template (`.github/pull_request_template.md`)
+- Issue templates (`.github/ISSUE_TEMPLATE/*.yml`)
+- Contributing guide (`CONTRIBUTING.md`)

package.json

@@ -13,9 +13,16 @@
     "test:validate:long": "node scripts/long-duration-extension-validation.mjs",
     "test:all": "npm run test:unit && npm run test:e2e"
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
+  "keywords": [
+    "chrome-extension",
+    "mv3",
+    "tab-tracking",
+    "activity-tracker",
+    "productivity",
+    "playwright"
+  ],
+  "author": "Baboonzero",
+  "license": "MIT",
   "devDependencies": {
     "@playwright/test": "^1.58.2",
     "fake-indexeddb": "^6.2.5",

project-history.md

@@ -224,6 +224,17 @@ Chronological execution log:
     - added dedicated guide: `docs/INSTALLATION.md`
     - updated project documentation status and validation references
 
+39. Added open-source licensing and GitHub collaboration polish:
+    - added MIT license (`LICENSE`)
+    - aligned package metadata to MIT in `package.json`
+    - added GitHub metadata guidance (`docs/GITHUB_METADATA.md`) with description/topics
+    - added contribution/collaboration scaffolding:
+      - `CONTRIBUTING.md`
+      - `.github/pull_request_template.md`
+      - `.github/ISSUE_TEMPLATE/bug_report.yml`
+      - `.github/ISSUE_TEMPLATE/feature_request.yml`
+      - `.github/ISSUE_TEMPLATE/config.yml`
+
 ## 4. What Were The Decisions That We Took?
 
 ### Product/Architecture Decisions
@@ -327,6 +338,8 @@ Not in MVP (intentionally out of scope):
 - CI workflow: **configured**
 - Manual acceptance assets: **present**
 - End-user installation guide: **present**
+- Open-source license (MIT): **present**
+- GitHub collaboration templates: **present**
 - Headed long-duration runtime validation with artifacts: **complete**
 - Side panel + all-tab model rollout: **complete**
 - Repo pushed to GitHub: **yes**
@@ -356,6 +369,7 @@ Primary commits:
 - `c59d30f` Add long-duration extension validation with screenshot evidence
 - `6ac346b` Document headed long-run validation and agent-browser evidence
 - `5ba01b2` Remove redundant Most recent view filter
+- `c6935f3` Complete docs and add clear extension install guide
 
 ## 9. File-Level Map Of What Exists
 
@@ -405,6 +419,8 @@ Primary commits:
 - `README.md` (quick start)
 - `project-history.md` (this full build document)
 - `docs/INSTALLATION.md`
+- `docs/GITHUB_METADATA.md`
+- `CONTRIBUTING.md`
 - `docs/APPROACH_AND_PLAN.md`
 - `docs/plans/2026-02-26-chrome-activity-reader-design.md`
 - `docs/plans/2026-02-26-chrome-activity-reader-implementation-plan.md`
@@ -416,6 +432,10 @@ Primary commits:
 ### Operations
 
 - `.github/workflows/ci.yml`
+- `.github/pull_request_template.md`
+- `.github/ISSUE_TEMPLATE/bug_report.yml`
+- `.github/ISSUE_TEMPLATE/feature_request.yml`
+- `.github/ISSUE_TEMPLATE/config.yml`
 - `scripts/extension-flow-matrix-test.mjs`
 - `scripts/manual-acceptance.ps1`
 - `package.json`