chore: pre-launch polish — CI, docs, package.json, status section

CI / workflows:
- Add separate 'website' job to ci.yml — Docusaurus build validated on every PR
- Upgrade deploy-website.yml Node version from 20 to 22
- Node badge in README reverted to >=18 (runtime minimum; CI matrix is 22/24)

package.json:
- Bump version 0.1.0 → 0.1.1
- Fix homepage URL to live docs site (was GitHub README anchor)

README:
- Add "Current Status" section (CLI MVP, local-first, no SaaS, Node >=18/CI 22+24)
- Note npm run preview PR in Roadmap section

SECURITY.md:
- Remove placeholder "[create a security contact email]" line
- Direct security reports to GitHub Security Advisories only

ROADMAP.md:
- Update Done section to v0.1.1 with Transcript Intake Agent + 82 tests
- Add npm run preview as in-review item

website/docs/roadmap.md:
- Sync with ROADMAP.md (v0.1.1, correct test count, preview PR link)

website/docs/safety.md:
- Fix security reporting: use GitHub Security Advisories, not public issues

Author: Akki Parekh

.github/workflows/ci.yml

@@ -40,3 +40,25 @@ jobs:
         run: npm run doctor
         env:
           DEVDOCS_PROVIDER: mock
+
+  website:
+    name: Build Website (Docusaurus)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+          cache-dependency-path: website/package-lock.json
+
+      - name: Install website dependencies
+        run: npm ci
+        working-directory: website
+
+      - name: Build website
+        run: npm run build
+        working-directory: website

.github/workflows/deploy-website.yml

@@ -28,7 +28,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: '22'
           cache: npm
           cache-dependency-path: website/package-lock.json
 

README.md

@@ -4,7 +4,7 @@
 
 **Turn tutorial transcripts into beautiful developer documentation.**
 
-[![Node.js](https://img.shields.io/badge/node-%3E%3D22-brightgreen)](https://nodejs.org)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](https://typescriptlang.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)
 [![OpenAI](https://img.shields.io/badge/OpenAI-supported-412991)](https://platform.openai.com)
@@ -31,6 +31,18 @@
 
 ---
 
+## Current Status
+
+**devdocs-forge-agent is a v0.1.1 CLI MVP** — ready for local testing, open-source contributions, and feedback.
+
+- Runs locally from your terminal — not a hosted SaaS product
+- Mock mode generates real output with no API key required
+- Real providers (OpenAI, Anthropic, Gemini) require your own API key
+- Generated docs are first drafts — always review before publishing
+- CI tests on Node.js 22 and 24 (Ubuntu + macOS); minimum runtime: Node ≥ 18
+
+---
+
 > **⭐ If this project saves you documentation time, please star the repo so more developers can discover it.**
 
 ---
@@ -473,6 +485,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for full setup instructions.
 - [x] 11 documentation output modes
 - [x] Video Intake Guard (URL validation + tech classification + transcript check)
 - [x] `npm run demo` one-command demo
+- [ ] `npm run preview` — local browser preview of generated docs (in review, [PR #6](https://github.com/AnkitParekh007/devdocs-forge-agent/pull/6))
 - [ ] Ollama provider (local LLMs)
 - [ ] OpenRouter provider
 - [ ] Browser UI (React or Angular)

ROADMAP.md

@@ -6,7 +6,7 @@ Want to work on something? Open an issue!
 
 ---
 
-## v0.1.x — Stability (Current)
+## v0.1.x — Stability (Current — v0.1.1)
 
 | Feature | Status |
 |---------|--------|
@@ -20,7 +20,9 @@ Want to work on something? Open an issue!
 | Test suite (Vitest) | ✅ Done |
 | Example transcripts and outputs | ✅ Done |
 | Video Intake Guard (URL validation + tech classification) | ✅ Done |
+| Transcript Intake Agent (clipboard, paste, file import) | ✅ Done |
 | One-command demo (`npm run demo`) | ✅ Done |
+| `npm run preview` — local browser doc preview | 🔄 In review ([PR #6](https://github.com/AnkitParekh007/devdocs-forge-agent/pull/6)) |
 
 ---
 

SECURITY.md

@@ -17,9 +17,7 @@
 
 If you discover a security vulnerability in devdocs-forge-agent, please **do not open a public GitHub issue**.
 
-Instead:
-1. Email: [create a security contact email or use GitHub's private vulnerability reporting]
-2. Or use [GitHub Security Advisories](https://github.com/AnkitParekh007/devdocs-forge-agent/security/advisories/new) (private disclosure)
+Instead, use [GitHub Security Advisories](https://github.com/AnkitParekh007/devdocs-forge-agent/security/advisories/new) (private disclosure).
 
 Include:
 - A description of the vulnerability

package.json

@@ -1,6 +1,6 @@
 {
   "name": "devdocs-forge-agent",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "AI documentation agent that turns tutorial transcripts, demos, and recordings into developer docs",
   "type": "module",
   "bin": {
@@ -63,7 +63,7 @@
     "type": "git",
     "url": "https://github.com/AnkitParekh007/devdocs-forge-agent.git"
   },
-  "homepage": "https://github.com/AnkitParekh007/devdocs-forge-agent#readme",
+  "homepage": "https://ankitparekh007.github.io/devdocs-forge-agent/",
   "bugs": {
     "url": "https://github.com/AnkitParekh007/devdocs-forge-agent/issues"
   }

website/docs/roadmap.md

@@ -7,29 +7,31 @@ description: What's done, what's next, and what's planned for devdocs-forge-agen
 
 # Roadmap
 
-## Done (v0.1.0)
+## Done (v0.1.1 — current)
 
 - [x] Core generation pipeline (TypeScript, ESM, Commander)
 - [x] Mock, OpenAI, Anthropic, Gemini providers
 - [x] 11 output modes: docusaurus, blog, docs, gitbook, readme, faq, troubleshooting, lesson, social, changelog, seo
 - [x] Video Intake Guard — URL validation, tech classification, transcript requirement
+- [x] Transcript Intake Agent — clipboard, stdin paste, file import (.md/.txt/.vtt/.srt), stubs for OAuth + local media
 - [x] `inspect-url` and `validate-source` CLI commands
+- [x] `transcript` command with 5 subcommands
 - [x] `--url` and `--force` flags on generate
 - [x] `npm run demo` one-command demo in mock mode
 - [x] `npm run batch` for directory-level processing
 - [x] `npm run verify` output validation
 - [x] `npm run doctor` setup diagnostics
 - [x] Profile customization (`modes/_profile.md`)
-- [x] Zod config schema with full `video_intake` section
-- [x] 54-test Vitest suite
+- [x] Zod config schema with `video_intake` and `transcript_intake` sections
+- [x] 82-test Vitest suite (Node 22/24, Ubuntu + macOS)
 
 ## In progress / good first issues
 
+- [ ] **`npm run preview`** — local browser preview of generated docs ([PR #6](https://github.com/AnkitParekh007/devdocs-forge-agent/pull/6))
 - [ ] **Ollama provider** — local LLM support ([#1](https://github.com/AnkitParekh007/devdocs-forge-agent/issues/1))
 - [ ] **OpenRouter provider** — access to 200+ models ([#2](https://github.com/AnkitParekh007/devdocs-forge-agent/issues/2))
 - [ ] **Mermaid diagram mode** — architecture diagrams from transcripts ([#3](https://github.com/AnkitParekh007/devdocs-forge-agent/issues/3))
 - [ ] **Better Docusaurus frontmatter** — smarter tag and sidebar_label extraction ([#4](https://github.com/AnkitParekh007/devdocs-forge-agent/issues/4))
-- [ ] **Minimal web preview** — browser preview before publishing ([#5](https://github.com/AnkitParekh007/devdocs-forge-agent/issues/5))
 
 ## Planned (v0.2.0)
 

website/docs/safety.md

@@ -57,6 +57,6 @@ The `review-checklist.md` in every output directory includes:
 
 ## Reporting issues
 
-If you find a security issue, open a [GitHub issue](https://github.com/AnkitParekh007/devdocs-forge-agent/issues) or email the maintainer directly.
+For **security vulnerabilities**, please use [GitHub Security Advisories](https://github.com/AnkitParekh007/devdocs-forge-agent/security/advisories/new) (private disclosure) — do not open a public issue.
 
 For general bugs and feature requests, use [GitHub Issues](https://github.com/AnkitParekh007/devdocs-forge-agent/issues).