RawFeed VS Code Extension

RawFeed: RawCapture logs, local JSON imports, fix prompts, and architecture checks inside VS Code.

Features

Dashboard

• The Dashboard view brings connection controls, analytics, observed error summaries, local JSON upload, architecture maps, and AI prompt/report actions into one page.
• Analytics includes refresh, issue categories, top URLs, trend buckets, and buttons to generate a fix plan for AI or copy the AI task.
• Observed Error Summary is sorted by priority and can generate an error fix checklist or focused fix plan for AI.
• Architecture Map supports fetching saved RawFeed maps, selecting/copying an AI guide, uploading local architecture JSON, and generating an AI fix plan.

Error Logs

• View recent issues from the configured RawFeed project with severity, title, URL/file, environment, timestamp, and status.
• Use the visible Upload JSON Error Log row in the Error Logs sidebar to import a local RawCapture JSON export.
• Use Remove Uploaded JSON to clear the current upload and start with a new file.
• Use Filter Project Domains to keep project-owned errors and hide unrelated third-party domains.
• After upload, issues are grouped into likely fix groups instead of shown as one noisy flat list.
• Metrics appear under the upload controls: project issue count, filtered count, severity counts, category counts, and top domains.
• Select a fix group to open an error detail report with examples and a Codex-ready fix task.
• Select an individual issue to open a focused local prompt.
• Refresh logs and open issues in RawFeed web dashboard.

AI Fix Suggestions

• Command: "RawFeed: Suggest Fix"
• Works from selected RawCapture issue or selected text in editor.
• Collects context: active file path, selected text, nearby lines, workspace name, detected framework/package info.
• Shows suggestion in webview with summary, likely cause, affected files, steps, and patch guidance.

Architecture Checklist

• Command: "RawFeed: Run Architecture Checklist"
• Scans workspace for readiness checks: package.json, .env files, Next.js detection, TypeScript config, Supabase folders, API routes, middleware, test folders, README, security/audit docs.
• Shows pass/warn/fail results in sidebar tree and readable report.
• Use Select Architecture Guide to choose the primary saved RawFeed architecture map for AI fixes.
• Use Copy Architecture Guide for AI to copy the active saved map guidance and write .rawfeed/architecture-guide.md.
• Use Upload Architecture JSON to load a RawFeed architecture export into the IDE.
• The Architecture view shows completion, maturity, risk, layer readiness, warnings, and checklist sections from the uploaded JSON.
• Use Copy Architecture AI Brief to open/copy a Codex-ready architecture brief for Codex or any AI assistant.
• When a workspace is open, the brief is also written to .rawfeed/architecture-brief.md.

AI Fix Plan

• Command: RawFeed: Generate Fix Plan for AI
• Creates .rawfeed/fix-plan.md from one selected RawCapture issue/group, 24h metrics, the active Architecture Guide, active file paths, likely cause, fix steps, and verification commands.
• The plan is local markdown only and redacts editor tokens, bearer values, and common secret fields.
• Command: RawFeed: Generate Architecture Fix Plan for AI
• Combines the active Architecture Guide, uploaded Architecture JSON, and uploaded JSON Error Log into .rawfeed/context.md.
• Maps runtime error groups to likely architecture layers such as API, UX/Performance, Security/Integrations, and Ops.
• Connects matching runtime evidence to architecture warnings where possible.
• Writes .rawfeed/fix-plan.md, opens it, and copies it to clipboard for Codex or any AI assistant.

RawCapture Checks

• The RawCapture sidebar fetches selected RawCapture categories through a scoped editor connection.
• Use RawFeed: Setup Editor Connection or the Connect RawFeed Workspace row in the RawCapture sidebar to open the in-editor setup form.
• In the setup form, use Get Token from RawFeed to open https://www.rawfeed.xyz/rawcapture/settings, create an editor connection, paste the one-time rfec_ token, choose readable categories, and save. The token is stored with VS Code SecretStorage.
• Use the canonical www host in production. https://rawfeed.xyz redirects to https://www.rawfeed.xyz, and clients can drop the Authorization bearer token during that redirect.
• The setup form supports the readable categories error, network, log, and security_anomaly.
• The RawFeed activity bar separates Error Logs from RawFeed and Local Error Logs (JSON) into separate panels so remote connection data and uploaded exports are visible independently.
• Use RawFeed: Configure Pull Categories to change the local category request without replacing the server connection.
• Use RawFeed: Refresh Analytics to show server RawCapture analytics when available, with local aggregation from loaded issues as fallback.
• Use RawFeed: Pause Connection, RawFeed: Resume Connection, RawFeed: Stop Connection, and RawFeed: Delete Connection to manage the server connection when the verified connection metadata is available.
• Use RawFeed: Disconnect Workspace to remove only the local token. Use RawFeed: Delete Connection to revoke the server connection and clear the local token.
• Use RawFeed: Upload JSON Error Log to load a local export such as rawfeed-all-YYYY-MM-DD.json. Local uploads convert console errors/warnings, poor Web Vitals, failed/slow network calls, CORS failures, and HTTP 4xx/5xx responses into RawCapture issues.
• Use RawFeed: Set Project Domains to filter imported errors to domains such as rawfeed.xyz or app.rawfeed.xyz.
• Use RawFeed: Generate RawCapture Fix Prompt after import to open and copy a Codex-ready prompt containing the top errors plus a required fix report checklist.
• When a workspace folder is open, upload creates .rawfeed/fix-task.md and .rawfeed/fix-report.md.
• Use RawFeed: Run Verification to run available npm verification scripts and append results to .rawfeed/fix-report.md.
• The Dashboard view has quick buttons for Open Overview, Open FIX Flow, Open Insights Dashboard, and Open AI Prompts.

Setup

1. Clone this repository.
2. Run npm install to install dependencies.
3. Open in VS Code.
4. Press F5 to launch Extension Development Host.

Commands

• RawFeed: Open Dashboard - Open the full RawFeed Dashboard page
• RawFeed: Open Overview - Open the existing full dashboard
• RawFeed: Open FIX Flow - Open the fix workflow only
• RawFeed: Open Insights Dashboard - Open analytics and issue insights only
• RawFeed: Open AI Prompts - Open fetched RawFeed AI prompts only
• RawFeed: Refresh Dashboard - Refresh Dashboard metrics and summaries
• RawFeed: Connect Workspace - Open the RawFeed connection setup form
• RawFeed: Setup Editor Connection - Open the RawFeed connection setup form
• RawFeed: Disconnect Workspace - Remove the local editor token
• RawFeed: Verify Connection - Verify the stored editor token
• RawFeed: Configure Pull Categories - Select local RawCapture categories to request
• RawFeed: Pause Connection - Pause the server editor connection
• RawFeed: Resume Connection - Resume the server editor connection
• RawFeed: Stop Connection - Stop the server editor connection until reactivated
• RawFeed: Delete Connection - Revoke the server editor connection and clear the local token
• RawFeed: View RawCapture Logs - Open RawCapture logs view
• RawFeed: Refresh RawCapture Logs - Refresh logs
• RawFeed: Upload JSON Error Log - Upload a local RawCapture JSON export into the sidebar
• RawFeed: Remove Uploaded JSON - Clear the active uploaded JSON and start over
• RawFeed: Set Project Domains - Filter imported errors by project-owned domains
• RawFeed: Generate RawCapture Fix Prompt - Generate a Codex-ready prompt from imported/fetched RawCapture issues
• RawFeed: Refresh Analytics - Refresh RawCapture analytics
• RawFeed: Generate Fix Plan for AI - Create .rawfeed/fix-plan.md for a selected RawCapture issue/group
• RawFeed: Copy AI Task - Copy the current .rawfeed/fix-plan.md
• RawFeed: Run Verification - Run available npm verification scripts and append results to .rawfeed/fix-report.md
• RawFeed: Suggest Fix - Get AI fix suggestion
• RawFeed: Run Architecture Checklist - Run checklist
• RawFeed: Configure Architectures - Manually set saved RawFeed architecture map IDs
• RawFeed: Refresh Architectures - Refresh saved RawFeed architecture maps
• RawFeed: Select Architecture Guide - Select the active saved architecture map for AI fixes
• RawFeed: Copy Architecture Guide for AI - Copy/write active saved map guidance
• RawFeed: Open Architecture Guide - Open the active saved map in RawFeed or as markdown
• RawFeed: Upload Architecture JSON - Upload a local architecture JSON export
• RawFeed: Copy Architecture AI Brief - Open/copy architecture context for Codex or any AI
• RawFeed: Remove Uploaded Architecture - Clear the active architecture upload
• RawFeed: Generate Architecture Fix Plan for AI - Create .rawfeed/context.md and .rawfeed/fix-plan.md from architecture plus runtime errors

Sidebar Views

RawFeed activity bar container with:

• Dashboard: Unified webview for connection, analytics, error summaries, architecture maps, and AI report buttons
• Connection: Setup form, stored-token status, architecture guide status, verify, refresh, and RawFeed link
• RawCapture: Recent issues/logs
• Analytics: 24h RawCapture totals, severity/category counts, URLs/files, trend, and top issues
• Architecture: Saved Architecture Guide selection plus checklist/import results

API Integration

The extension connects to RawFeed with a read-only rfec_ editor token generated by the web app. VS Code sends it only as an Authorization: Bearer rfec_... header and stores it in SecretStorage.

Extension API Endpoints

• GET /api/ext/verify - Verify connection
• GET /api/ext/rawcapture/issues?category=error&category=network&limit=50 - List selected RawCapture issues
• GET /api/ext/rawcapture/analytics?range=24h - Fetch RawCapture analytics when supported
• GET /api/ext/architecture/plans?id=... - Fetch selected saved architecture maps

The server intersects requested categories with the connection's allowed categories. A request for a disallowed category returns 403.

Owner Management API

• POST /api/rawcapture/projects/{projectId}/editor-connections - Create an editor connection in RawFeed web
• GET /api/rawcapture/projects/{projectId}/editor-connections - List editor connections
• PATCH /api/rawcapture/projects/{projectId}/editor-connections - Pause, stop, resume, or change allowed categories
• DELETE /api/rawcapture/projects/{projectId}/editor-connections?id={connectionId} - Revoke a connection

Configuration

• rawfeed.apiBaseUrl - API base URL. Defaults to https://www.rawfeed.xyz.
• rawfeed.projectId - Project identifier discovered from editor-token verification. Usually managed automatically.
• rawfeed.editorConnectionId - Editor connection identifier discovered from token verification. Usually managed automatically.
• rawfeed.connectionLastVerifiedAt - Last successful editor-token verification timestamp. Usually managed automatically.
• rawfeed.architecturePlanIds - Saved RawFeed architecture map IDs selected for this workspace.
• rawfeed.activeArchitecturePlanId - Primary saved RawFeed architecture map used as AI fix guidance.
• rawfeed.rawcaptureEndpoint - RawCapture logs endpoint path. Defaults to /api/ext/rawcapture/issues.
• rawfeed.rawcaptureLimit - Maximum issues to pull per refresh. Defaults to 50.
• rawfeed.rawcaptureCategories - Readable categories to request. Defaults to error, network, log, and security_anomaly.
• rawfeed.rawcaptureLocalJsonPath - Local RawCapture JSON export path. When set, the RawCapture view reads this file instead of the API.
• rawfeed.projectDomains - Comma-separated domains used to filter imported JSON errors.
• rawfeed.architectureLocalJsonPath - Local architecture JSON export path. When set, the Architecture view reads this file.
• Editor token stored securely using VS Code SecretStorage

Development

• npm run compile - Compile TypeScript
• npm run watch - Watch for changes
• npm run test - Run tests
• npm run pretest - Compile before tests

License

MIT