@neat.is/claude-skill 0.4.28-dev.20260713 → 0.4.28

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/SKILL.md +11 -0
  2. package/package.json +1 -1
package/SKILL.md CHANGED
@@ -34,6 +34,17 @@ Sixteen MCP tools, served by `@neat.is/mcp` over stdio — ten read-only graph q
34
34
 
35
35
  The ten read tools read from the live graph the daemon maintains in memory. No fs reads of `graph.json` at request time. The extend tools modify instrumentation files, `package.json`, and the lockfile only; NEAT never calls an LLM and the agent reasons over their output (ADR-084).
36
36
 
37
+ ## Where OBSERVED comes from
38
+
39
+ The observed-facing read tools — `get_observed_dependencies`, `get_divergences`, `get_incident_history`, `get_recent_stale_edges` — reflect two OBSERVED sources, not one:
40
+
41
+ - **OTel spans** — pushed by the instrumented app at runtime. The `/neat extend` tools above are how that gets wired up.
42
+ - **Pull connectors** — NEAT polls a provider's own API and folds what it finds into the same OBSERVED layer. Supabase, Railway, Cloudflare, and Firebase are supported. So an integration NEAT never saw a span for can still carry OBSERVED edges, incidents, and staleness — sourced from the platform, not the trace.
43
+
44
+ Connectors are configured out of band, not through this skill: `neat connector add <provider>` / `list` / `remove <id>` / `test <id>` (ADR-130). Credentials are stored as an env-var reference (`$VAR`) resolved at run time and redacted everywhere, so the agent reads the resulting OBSERVED data but never sees a secret. `GET /:project/connectors` reports each connector's poll health over REST if you need it.
45
+
46
+ A `ServiceNode` also carries a `platform` string when the extractor recognized the host — `'cloudflare'`, `'vercel'`, `'railway'`, or `'supabase'`, read from a `wrangler.toml` / `vercel.json` / `railway.toml` / `supabase/config.toml`. It's a static (EXTRACTED) signal, surfaced as the provider badge on the dashboard's service nodes.
47
+
37
48
  ## Install
38
49
 
39
50
  The simplest path: add the snippet from `claude_code_config.json` to your Claude Code MCP config.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@neat.is/claude-skill",
3
- "version": "0.4.28-dev.20260713",
3
+ "version": "0.4.28",
4
4
  "description": "Claude Code skill drop-in for NEAT — wires the @neat.is/mcp server into Claude's MCP config",
5
5
  "license": "BUSL-1.1",
6
6
  "homepage": "https://neat.is",