housekeeping

Author: zalepa

.github/workflows/release.yml

@@ -0,0 +1,28 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Get version from tag
+        id: version
+        run: echo "tag=${GITHUB_REF#refs/tags/}" >> "$GITHUB_OUTPUT"
+
+      - name: Build zip
+        run: zip "scfs-chrome-${{ steps.version.outputs.tag }}.zip" manifest.json content.js styles.css
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: "scfs-chrome-${{ steps.version.outputs.tag }}.zip"
+          generate_release_notes: true

.gitignore

@@ -0,0 +1 @@
+scfs-chrome-v*.zip

Makefile

@@ -0,0 +1,21 @@
+VERSION := $(shell python3 -c "import json; print(json.load(open('manifest.json'))['version'])")
+ZIP_NAME := scfs-chrome-v$(VERSION).zip
+DIST_FILES := manifest.json content.js styles.css
+
+.PHONY: zip tag release clean
+
+zip: $(ZIP_NAME)
+
+$(ZIP_NAME): $(DIST_FILES)
+	@rm -f $(ZIP_NAME)
+	zip $(ZIP_NAME) $(DIST_FILES)
+	@echo "Built $(ZIP_NAME)"
+
+tag:
+	git tag -a "v$(VERSION)" -m "v$(VERSION)"
+	git push origin "v$(VERSION)"
+
+release: zip tag
+
+clean:
+	rm -f scfs-chrome-v*.zip

README.md

@@ -0,0 +1,56 @@
+# SCFS Issue Scores — Chrome Extension
+
+A Chrome extension that adds AI-powered sentiment scores to [SeeClickFix](https://seeclickfix.com) service requests for Jersey City. Each issue gets an **Interaction** score and an **Outcome** score so you can quickly see how the city is handling reports.
+
+## What it does
+
+**On the issues map/list view** — scores appear inline on each issue card with a progress bar and filter buttons (Negative / Positive / Unscored):
+
+![Map view with inline scores](screenshots/index.png)
+
+**On an individual issue page** — a banner appears at the top showing Interaction and Outcome sentiment with confidence percentages:
+
+![Individual issue with score banner](screenshots/individual.png)
+
+## Install from a release (recommended)
+
+1. Go to the [Releases page](https://github.com/HackJerseyCity/scfs-chrome/releases) and download the latest `scfs-chrome-vX.X.zip`
+2. Unzip the file
+3. Open Chrome and go to `chrome://extensions`
+4. Turn on **Developer mode** (toggle in the top-right corner)
+5. Click **Load unpacked**
+6. Select the unzipped folder
+7. Visit [seeclickfix.com](https://seeclickfix.com/web_portal/PTzvqioTdUqpwQchKJx1dMyo/issues/map) — scores will appear automatically
+
+## Install from source
+
+```sh
+git clone https://github.com/HackJerseyCity/scfs-chrome.git
+cd scfs-chrome
+```
+
+Then follow steps 3–7 above, pointing "Load unpacked" at the cloned repo directory.
+
+## Updating
+
+When a new release is available:
+
+1. Download and unzip the new release (or `git pull` if you installed from source)
+2. Go to `chrome://extensions`
+3. Click the reload icon on the SCFS Issue Scores card
+
+## How it works
+
+The extension runs a content script on `seeclickfix.com` pages. It extracts issue IDs from the page, fetches sentiment scores from the SCFS API (`scfs-api.hackjc.org`), and injects the results into the page. Scores are cached per session to avoid redundant API calls.
+
+## Development
+
+```sh
+make zip        # Build a distributable zip
+make tag        # Tag the current version from manifest.json and push
+make release    # Tag + zip (for use with GitHub Actions)
+```
+
+## License
+
+MIT