docs(packages): add npm package readmes

## Summary
Add package-level READMEs so npmjs package pages render useful install and
usage docs, and finish the move to trusted publishing in CI.

## Changes
- add README.md files for the CLI, parser, ESLint plugin, and TSDoc packages
- update publish workflow to use GitHub OIDC trusted publishing
- document trusted publishing in AGENTS.md
- add a changeset for the README-bearing package releases

## Why
The newly published npm packages had blank package pages because the package
artifacts contained no package-level README files.

## Testing
- pnpm lint
- npm pack --json ./packages/cli
- npm pack --json ./packages/parser
- npm pack --json ./packages/eslint-plugin
- npm pack --json ./packages/tsdoc

Author: 4ndr3wxh1ll

.changeset/late-hounds-bow.md

@@ -0,0 +1,8 @@
+---
+"@recallnet/codecontext-cli": patch
+"@recallnet/codecontext-parser": patch
+"@recallnet/codecontext-eslint-plugin": patch
+"@recallnet/codecontext-tsdoc": patch
+---
+
+Add package-level READMEs so npmjs package pages render useful install and usage docs.

.github/workflows/publish-packages.yml

@@ -28,6 +28,7 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: write
+      id-token: write
 
     steps:
       - uses: actions/checkout@v4
@@ -85,5 +86,3 @@ jobs:
       - name: Publish packages
         if: steps.changesets.outputs.has_changesets == 'true'
         run: pnpm changeset publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

AGENTS.md

@@ -7,6 +7,8 @@
 - The publish automation lives in
   `.github/workflows/publish-packages.yml`.
 - The canonical public registry is npmjs, not GitHub Packages.
+- npmjs publishing uses GitHub Actions trusted publishing via OIDC, not an
+  `NPM_TOKEN` secret.
 - That workflow only publishes when CI succeeds on `main` and there is at
   least one pending file in `.changeset/`.
 - If there is no pending changeset, the workflow does nothing, even if code in

packages/cli/README.md

@@ -0,0 +1,30 @@
+# @recallnet/codecontext-cli
+
+CLI for querying `@context` annotations in source code.
+
+## Install
+
+```bash
+npm install -D @recallnet/codecontext-cli @recallnet/codecontext-parser
+```
+
+## Common commands
+
+```bash
+npx codecontext --scope src/file.ts
+npx codecontext --diff HEAD src/file.ts
+npx codecontext --report
+npx codecontext --staged
+```
+
+## Packages
+
+- `@recallnet/codecontext-cli`: CLI commands and repo scanning
+- `@recallnet/codecontext-parser`: parser and staleness logic
+- `@recallnet/codecontext-eslint-plugin`: ESLint integration
+- `@recallnet/codecontext-tsdoc`: TSDoc tag definitions
+
+## Docs
+
+- Repo: https://github.com/recallnet/codecontext
+- Full README: https://github.com/recallnet/codecontext/blob/main/README.md

packages/eslint-plugin/README.md

@@ -0,0 +1,22 @@
+# @recallnet/codecontext-eslint-plugin
+
+ESLint rules for validating `@context` annotations and related freshness checks.
+
+## Install
+
+```bash
+npm install -D @recallnet/codecontext-eslint-plugin @recallnet/codecontext-parser eslint
+```
+
+## Configure
+
+```js
+import codecontext from "@recallnet/codecontext-eslint-plugin";
+
+export default [codecontext.configs.recommended];
+```
+
+## Docs
+
+- Repo: https://github.com/recallnet/codecontext
+- Full README: https://github.com/recallnet/codecontext/blob/main/README.md

packages/parser/README.md

@@ -0,0 +1,24 @@
+# @recallnet/codecontext-parser
+
+Core parser for `@context` tags and supporting refs.
+
+## Install
+
+```bash
+npm install -D @recallnet/codecontext-parser
+```
+
+## Use
+
+```ts
+import { buildFileContext, parseContextTags } from "@recallnet/codecontext-parser";
+
+const ctx = buildFileContext("src/file.ts");
+console.log(ctx.tags);
+```
+
+## Docs
+
+- Repo: https://github.com/recallnet/codecontext
+- Full README: https://github.com/recallnet/codecontext/blob/main/README.md
+- Spec: https://github.com/recallnet/codecontext/blob/main/packages/spec/SPEC.md

packages/tsdoc/README.md

@@ -0,0 +1,24 @@
+# @recallnet/codecontext-tsdoc
+
+TSDoc tag definitions for `codecontext`.
+
+## Install
+
+```bash
+npm install -D @recallnet/codecontext-tsdoc
+```
+
+## Use
+
+Reference the bundled config from your TSDoc or API Extractor setup:
+
+```json
+{
+  "extends": ["./node_modules/@recallnet/codecontext-tsdoc/tsdoc-base.json"]
+}
+```
+
+## Docs
+
+- Repo: https://github.com/recallnet/codecontext
+- Full README: https://github.com/recallnet/codecontext/blob/main/README.md