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

Clone this repository.
Run npm install to install dependencies.
Open in VS Code.
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

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

RawFeed