live-oidc-401-stale-runtime

Diagnose persistent 401 errors in local OIDC environments by comparing live instances with fresh builds.

1|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/jonnymuir/Umbraco.Prism --skill live-oidc-401-stale-runtime
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: live-oidc-401-stale-runtime
Source: https://github.com/jonnymuir/Umbraco.Prism/tree/main/.claude/skills/live-oidc-401-stale-runtime
Command: npx skills add https://github.com/jonnymuir/Umbraco.Prism --skill live-oidc-401-stale-runtime

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resolves persistent 401 Unauthorized errors in local development environments that occur even after authentication fixes have been applied, specifically when stale child processes or cached JWT validation settings are interfering with the runtime.

Core Features & Use Cases

  • Stale Process Detection: Differentiates between actual authentication bugs and stale local runtime states.
  • Verification Workflow: Provides a structured approach to compare live failing endpoints against fresh builds to isolate the source of the 401.
  • Session Management: Offers guidance on handling OIDC refresh tokens and process-startup timestamps to prevent session rejection after app restarts.

Quick Start

Use the live-oidc-401-stale-runtime skill to verify if your current 401 error is caused by a stale process by comparing the live endpoint response against a fresh instance on a different port.

Frequently Asked Questions about live-oidc-401-stale-runtime

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why do I keep getting a 401 Unauthorized error in my local OIDC environment after fixing the authentication bug?

A persistent 401 Unauthorized error often stems from stale child processes or cached JWT validation logic interfering with the local runtime. You must compare the live failing instance against a fresh build to isolate whether the issue is a stale process state or an actual authentication bug.

How do I verify if a stale process is causing my JWT validation to fail locally?

To verify if a stale process is causing JWT validation failures, compare the response of your live failing endpoint against a fresh application instance running on a different port. This structured workflow isolates whether the 401 rejection originates from stale local runtime state.

What is the best way to debug persistent OIDC 401 errors during local development?

The best way to debug persistent OIDC 401 errors is to systematically compare live application instances against fresh builds. This approach differentiates actual authentication bugs from stale local runtime states by validating authentication fixes across isolated test environments.

Do I need to rebuild my application to resolve OIDC session rejection after app restarts?

You may need a fresh build to resolve OIDC session rejection after app restarts because cached JWT validation settings or stale child processes can persist. Comparing the live endpoint against a newly started instance confirms if the runtime state is the issue.

How does stale process state affect OIDC refresh token handling in local stacks?

Stale process state affects OIDC refresh token handling by retaining outdated validation logic that rejects valid tokens after app restarts. Managing process-startup timestamps and clearing stale child processes ensures the local runtime properly validates refreshed sessions.

Can cached JWT validation settings cause 401 errors even with valid tokens?

Cached JWT validation settings can cause 401 errors even with valid tokens when downstream APIs retain stale validation logic. Differentiating between these cached states and actual authentication failures requires comparing live instances against fresh builds.