pn-api-probe

pn-api-probe

Mission

Before committing to a design or build plan, verify that the runtime APIs, library versions, and key enumerations you intend to use actually exist in the target environment. Training data has a cutoff; runtime has ground truth.

When to use

• At the start of pn-design (step 2, Plan) and pn-build (Phase 0) when the stack involves frequently-updated runtimes (Blender Python API, browser APIs, framework releases, SDK versions).
• When a prior session produced unexpected output that could indicate a version mismatch.
• When discovery spec references a specific runtime version (e.g. Blender 4.x, Next.js 15, Node 22).

Instructions

1. Identify the probe targets. From the discovery spec or plan, extract:

   • Runtime name and version (e.g. Blender 4.3, Node 22.x, React 19)
   • APIs or enumerations in scope (e.g. bpy.ops.render, bpy.context.scene.render.*, React.use())
   • Known deprecation risks (APIs your plan uses that may have changed)

2. Probe live. Use available tools to fetch current state:

   • Web/framework: Search official changelog, release notes, or docs for the version in scope. Target: official docs site, GitHub releases, MDN.
   • Blender Python API: Search the Blender Python API reference for the current version. Check: are the specific bpy.* calls still present? Any renamed or removed enums?
   • Node/npm packages: Check the package's npm page or GitHub releases for the version range in use.
   • Use web search with version-pinned queries, e.g. "Blender 4.3 bpy.context.scene.render use_scene_lights".

3. Emit structured output:

   {
     "runtime_version": "<name and version probed>",
     "available_apis": [
       { "api": "<api or enum>", "status": "confirmed | deprecated | removed | unknown", "notes": "" }
     ],
     "deprecated_apis": [
       { "api": "<api>", "replacement": "<new api or none>", "notes": "" }
     ],
     "version_gaps": [
       { "item": "<feature or API>", "expected": "<what plan assumes>", "actual": "<what probe found>", "impact": "blocking | warning | info" }
     ],
     "recommendation": "proceed | revise_plan | block"
   }