Skip to content

docs: rewrite the README around the security boundary and how to load it - #6

Merged
bibeshpyakurel merged 1 commit into
mainfrom
docs/readme-refresh
Sep 21, 2026
Merged

bibeshpyakurel merged 1 commit into
mainfrom
docs/readme-refresh

Conversation

@bibeshpyakurel

Copy link
Copy Markdown
Owner

JobInsight is a Chrome extension with no hosted demo, so the README now says that plainly and puts the unpacked-install steps where a live demo link would otherwise be.

Added: a one-line description, CI / license / top-language badges (each verified 200), What it demonstrates technically, a Stack table, a backend Quick start, Status and License.

The five technical bullets, and where each is grounded:

  • The proxy keeps the OpenAI key out of the client, and CI tests the extension-origin gate on /api/analyze — backend/server.js:120 and the comment in .github/workflows/ci.yml
  • MV3 content script / service worker / popup split — manifest.json
  • 7-day per-job cache — JOB_CACHE_TTL = 7 * 24 * 60 * 60 * 1000 in content/linkedin-scraper.js:24
  • Six fixed structured fields rather than prose — the existing "What it shows" list
  • Manifest validation and per-script syntax checks in CI — .github/workflows/ci.yml

Chrome MV3, the Express proxy, Google OAuth, GPT-4o-mini and the 7-day cache all appear in the master career document (§5) and in the Software Engineer, ML/AI and IT resumes.

Backend quick start commands are copied verbatim from backend/package.json. The existing screenshots/LinkedInFeed.png is kept and still renders. No metric was invented — the only number is the existing per-analysis cost estimate, carried over unchanged.

Screenshots the owner needs to capture are listed in the README's Screenshots section, each with its target path and a pre-written, commented-out image line. Nothing in the README references an image that does not exist.

Only README.md (and a docs/screenshots/README.md placeholder) is touched, to stay clear of the concurrent .project.json / LICENSE work.

🤖 Generated with Claude Code

JobInsight is a Chrome extension with no hosted demo, so the README now says
that plainly and puts the unpacked-install steps where a live demo link would
be. Adds a one-line description, CI/license/language badges, and five bullets on
the decisions worth noticing — the Express proxy that keeps the OpenAI key out
of the client and the origin gate CI tests, the MV3 content script / service
worker / popup split, the 7-day per-job cache, structured six-field extraction,
and the manifest validation that catches breaks invisible until reinstall.

Backend quick start commands are taken verbatim from backend/package.json.
The existing LinkedInFeed.png screenshot is kept; two further shots that would
help are named with their paths and commented-out image lines.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@bibeshpyakurel
bibeshpyakurel merged commit 4809ab8 into main Sep 21, 2026
6 checks passed
@bibeshpyakurel
bibeshpyakurel deleted the docs/readme-refresh branch September 21, 2026 13:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant