package-radar 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adrian Carolli
+
+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.

package/README.md

@@ -0,0 +1,199 @@
+<p align="center">
+  <img src="./assets/hero.svg" alt="Package Radar — package news for your codebase" width="100%" />
+</p>
+
+<h3 align="center">
+  Package Radar
+</h3>
+
+<p align="center">
+  Weekly package news for <em>your</em> stack — with source links.<br/>
+  Scan <code>package.json</code>, detect your frameworks, get major release headlines that matter.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/package-radar">
+    <img alt="npm version" src="https://badge.fury.io/js/package-radar.svg?icon=si%3Anpm"/>
+  </a>
+  <a title="License" href="https://github.com/watadarkstar/code-radar/blob/main/LICENSE">
+    <img src="https://img.shields.io/badge/license-MIT-blue.svg" />
+  </a>
+  <a href="https://nodejs.org/">
+    <img alt="node" src="https://img.shields.io/badge/node-%3E%3D20-brightgreen" />
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://x.com/icookandcode" target="_blank">
+    Need help building developer tools? Connect with Adrian on X
+  </a>
+</p>
+
+---
+
+```
+🔍 Scanning your project...
+
+Detected:
+
+✓ React Native 0.82
+✓ Expo SDK 54
+✓ TypeScript 7
+✓ Drizzle ORM
+
+──────────────
+
+🔥 5 things happened this week
+
+1. TypeScript 7
+
+You should care because:
+Your project has 1,342 TypeScript files.
+This release improves incremental builds.
+
+Sources:
+• Announcing TypeScript 7
+  https://devblogs.microsoft.com/typescript/...
+
+Recommendation:
+Worth testing.
+
+──────────────
+```
+
+## Features
+
+- Detects your stack from `package.json` (TypeScript, Expo, React Native, Next.js, Drizzle, and more)
+- Looks up latest versions on npm
+- Uses OpenAI web search for **major** package/framework news
+- Source links on every item (blogs, changelogs, GitHub Releases)
+- Saves your OpenAI API key locally (`~/.package-radar/`) and protects project `.gitignore`
+
+Package Radar focuses on major news — not security audits or CVE noise.
+
+## Requirements
+
+- **Node.js** 20 or later
+- An **OpenAI API key** with access to the Responses API + web search
+
+## Installation
+
+Using npm:
+
+```bash
+npm install -g package-radar
+```
+
+Using yarn:
+
+```bash
+yarn global add package-radar
+```
+
+Or run once without installing:
+
+```bash
+npx package-radar
+```
+
+## Usage
+
+From any Node project directory:
+
+```bash
+package-radar
+```
+
+First run prompts for your OpenAI API key (saved to `~/.package-radar/config.json`). You can also set `OPENAI_API_KEY` in the environment.
+
+```bash
+package-radar config          # save / update API key
+package-radar config --show   # check if a key is configured
+package-radar config --clear  # remove saved key
+package-radar --help
+```
+
+### What happens on each run
+
+1. **Scan** — nearest `package.json`, known frameworks, source file counts  
+2. **Registry** — latest versions on npm for detected packages  
+3. **News** — OpenAI web search for major announcements  
+4. **Report** — why it matters, recommendation, and source URLs  
+5. **Safety** — appends `.package-radar/` to the project `.gitignore` if missing  
+
+### Config & environment
+
+| Variable / path | Required | Description |
+| --- | --- | --- |
+| `OPENAI_API_KEY` | Yes* | Overrides the saved key when set. [Get a key](https://platform.openai.com/api-keys). |
+| `OPENAI_MODEL` | No | Model name (default: `gpt-4.1-mini`). |
+| `~/.package-radar/config.json` | — | Where the API key is stored after `package-radar config`. |
+
+\*Required either as env var or via `package-radar config`.
+
+## Local development
+
+```bash
+git clone https://github.com/watadarkstar/code-radar.git
+cd code-radar
+yarn install
+yarn start          # run via tsx
+yarn build          # emit dist/
+yarn typecheck
+```
+
+| Script | Description |
+| --- | --- |
+| `yarn start` / `yarn radar` / `yarn dev` | Run the CLI from source |
+| `yarn build` | Build with tsup → `dist/` |
+| `yarn typecheck` | `tsc --noEmit` |
+| `yarn clean` | Remove `dist/` |
+| `yarn release:dry` | Dry-run a release |
+| `yarn release` | Version, tag, GitHub release, publish to npm |
+
+## License
+
+[MIT](LICENSE)
+
+## Author
+
+Feel free to ask me questions on Twitter [@icookandcode](https://www.twitter.com/icookandcode)!
+
+## Contributors
+
+Submit a PR to contribute :)
+
+## Release
+
+We use [`release-it`](https://github.com/release-it/release-it) to version, tag, create a GitHub release, and publish to npm.
+
+Prerequisites:
+
+1. Logged into npm: `npm login`
+2. `GH_TOKEN` (or `GITHUB_TOKEN`) with repo access if you want GitHub releases
+3. Clean git working tree on the default branch
+
+Then:
+
+```bash
+yarn run release:dry
+yarn run release
+```
+
+`release:dry` prints what would happen without publishing. `release` bumps the version, runs typecheck + build, commits/tags, creates a GitHub release, and publishes `package-radar` to the npm registry.
+
+---
+
+<div align="center">
+
+**Stay ahead of your stack.**
+
+⭐ **Star this repo** • 💬 **[Contact Adrian](https://x.com/icookandcode)**
+
+_Built with ❤️ by [Adrian](https://x.com/icookandcode)_
+
+</div>
+
+---
+
+**Keywords:** cli, package-radar, package news, dependencies, changelog, npm, openai, typescript, developer-tools

package/assets/hero.svg

@@ -0,0 +1,72 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="630" viewBox="0 0 1200 630" role="img" aria-label="Package Radar placeholder hero">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#0b1220"/>
+      <stop offset="55%" stop-color="#111827"/>
+      <stop offset="100%" stop-color="#0f172a"/>
+    </linearGradient>
+    <linearGradient id="glow" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#22d3ee" stop-opacity="0"/>
+      <stop offset="50%" stop-color="#38bdf8" stop-opacity="0.9"/>
+      <stop offset="100%" stop-color="#a78bfa" stop-opacity="0"/>
+    </linearGradient>
+    <radialGradient id="radarGlow" cx="50%" cy="50%" r="50%">
+      <stop offset="0%" stop-color="#22d3ee" stop-opacity="0.35"/>
+      <stop offset="70%" stop-color="#38bdf8" stop-opacity="0.08"/>
+      <stop offset="100%" stop-color="#38bdf8" stop-opacity="0"/>
+    </radialGradient>
+    <filter id="soft" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="8"/>
+    </filter>
+  </defs>
+
+  <!-- Background -->
+  <rect width="1200" height="630" fill="url(#bg)"/>
+
+  <!-- Subtle grid -->
+  <g stroke="#1f2937" stroke-width="1" opacity="0.55">
+    <path d="M0 90 H1200 M0 180 H1200 M0 270 H1200 M0 360 H1200 M0 450 H1200 M0 540 H1200"/>
+    <path d="M120 0 V630 M240 0 V630 M360 0 V630 M480 0 V630 M600 0 V630 M720 0 V630 M840 0 V630 M960 0 V630 M1080 0 V630"/>
+  </g>
+
+  <!-- Accent bar -->
+  <rect x="0" y="0" width="1200" height="4" fill="url(#glow)"/>
+
+  <!-- Radar graphic -->
+  <g transform="translate(900 315)">
+    <circle r="170" fill="url(#radarGlow)"/>
+    <circle r="150" fill="none" stroke="#1e3a5f" stroke-width="2"/>
+    <circle r="110" fill="none" stroke="#1e3a5f" stroke-width="1.5"/>
+    <circle r="70" fill="none" stroke="#1e3a5f" stroke-width="1.5"/>
+    <circle r="30" fill="none" stroke="#334155" stroke-width="1.5"/>
+    <line x1="-150" y1="0" x2="150" y2="0" stroke="#1e3a5f" stroke-width="1"/>
+    <line x1="0" y1="-150" x2="0" y2="150" stroke="#1e3a5f" stroke-width="1"/>
+
+    <!-- Sweep wedge -->
+    <path d="M0 0 L130 -40 A150 150 0 0 1 40 145 Z" fill="#22d3ee" opacity="0.12"/>
+    <line x1="0" y1="0" x2="130" y2="-40" stroke="#22d3ee" stroke-width="3" stroke-linecap="round"/>
+    <circle r="6" fill="#22d3ee"/>
+
+    <!-- Blips -->
+    <circle cx="55" cy="-70" r="6" fill="#a78bfa">
+      <title>Package signal</title>
+    </circle>
+    <circle cx="55" cy="-70" r="14" fill="none" stroke="#a78bfa" stroke-opacity="0.45" stroke-width="2"/>
+    <circle cx="-80" cy="35" r="5" fill="#38bdf8"/>
+    <circle cx="40" cy="95" r="4" fill="#34d399"/>
+  </g>
+
+  <!-- Copy -->
+  <g fill="#e2e8f0" font-family="ui-sans-serif, system-ui, -apple-system, Segoe UI, sans-serif">
+    <text x="72" y="220" font-size="22" fill="#67e8f9" letter-spacing="4" font-weight="600">CLI · PACKAGE NEWS</text>
+    <text x="72" y="300" font-size="72" font-weight="700" fill="#f8fafc">Package Radar</text>
+    <text x="72" y="360" font-size="28" fill="#94a3b8">Major framework &amp; library news for your stack</text>
+    <text x="72" y="420" font-size="20" fill="#64748b">Scan package.json · Web search · Source links</text>
+  </g>
+
+  <!-- Placeholder tag -->
+  <g transform="translate(72 500)">
+    <rect width="168" height="36" rx="18" fill="#0ea5e9" fill-opacity="0.15" stroke="#38bdf8" stroke-opacity="0.5"/>
+    <text x="84" y="24" text-anchor="middle" font-family="ui-sans-serif, system-ui, sans-serif" font-size="14" fill="#7dd3fc" font-weight="600">PLACEHOLDER HERO</text>
+  </g>
+</svg>

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }