infrawise 0.13.0 → 0.13.2

package/README.md

@@ -149,7 +149,7 @@ Add to your editor's MCP config:
 
 | Tool                         | What it provides                                                                                            |
 | ---------------------------- | ----------------------------------------------------------------------------------------------------------- |
-| `get_infra_overview`         | Complete snapshot — all services, counts, high-severity findings, and a `configured` flag                   |
+| `get_infra_overview`         | Complete snapshot — services, counts, high-severity findings, analysis `freshness` (age + stale flag), `configured` flag |
 | `get_graph_summary`          | Full infrastructure graph — all nodes, edges, and findings                                                  |
 | `analyze_function`           | Issues in a specific function — scans, missing indexes, N+1, trigger event shapes, missing IAM permissions  |
 | `suggest_gsi`                | Exact GSI config for a DynamoDB table + attribute                                                           |

package/dist/cli/commands/serve.js

@@ -2,7 +2,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import chalk from 'chalk';
 import ora from 'ora';
-import { loadConfig, readCache, setCacheDir } from '../../core/index.js';
+import { loadConfig, readCache, readCacheTimestamp, setCacheDir } from '../../core/index.js';
 import { createServer, setGraphState, setConfigured } from '../../server/index.js';
 import { log, printHeader } from '../utils.js';
 import { runAnalyze, runCodeRefresh } from './analyze.js';
@@ -83,7 +83,7 @@ export async function runServe(options = {}) {
     const cachedFindings = readCache('findings');
     if (cachedGraph && cachedFindings) {
         log.success('Cached analysis loaded', `${cachedGraph.nodes.length} nodes · ${cachedGraph.edges.length} edges · ${cachedFindings.length} finding(s)`);
-        setGraphState(cachedGraph, cachedFindings);
+        setGraphState(cachedGraph, cachedFindings, readCacheTimestamp('graph'));
     }
     else if (config) {
         log.warn('No cache found — running analysis now...');
@@ -91,10 +91,10 @@ export async function runServe(options = {}) {
         await runAnalyze({ repo: repoPath, config: options.config });
         const freshGraph = readCache('graph') ?? { nodes: [], edges: [] };
         const freshFindings = readCache('findings') ?? [];
-        setGraphState(freshGraph, freshFindings);
+        setGraphState(freshGraph, freshFindings, readCacheTimestamp('graph'));
     }
     else {
-        setGraphState({ nodes: [], edges: [] }, []);
+        setGraphState({ nodes: [], edges: [] }, [], null);
     }
     console.log('');
     // Start server

package/dist/cli/commands/stdio.js

@@ -1,7 +1,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { loadConfig, readCache, setCacheDir } from '../../core/index.js';
+import { loadConfig, readCache, readCacheTimestamp, setCacheDir } from '../../core/index.js';
 import { createMcpServer, setGraphState, setConfigured } from '../../server/index.js';
 import { runAnalyze, runCodeRefresh } from './analyze.js';
 const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
@@ -22,16 +22,16 @@ export async function runStdio(configPath) {
     const cachedGraph = readCache('graph', CACHE_TTL_MS);
     const cachedFindings = readCache('findings', CACHE_TTL_MS);
     if (cachedGraph && cachedFindings) {
-        setGraphState(cachedGraph, cachedFindings);
+        setGraphState(cachedGraph, cachedFindings, readCacheTimestamp('graph'));
     }
     else if (config) {
         await runAnalyze({ config: configPath });
         const graph = readCache('graph', CACHE_TTL_MS) ?? { nodes: [], edges: [] };
         const findings = readCache('findings', CACHE_TTL_MS) ?? [];
-        setGraphState(graph, findings);
+        setGraphState(graph, findings, readCacheTimestamp('graph'));
     }
     else {
-        setGraphState({ nodes: [], edges: [] }, []);
+        setGraphState({ nodes: [], edges: [] }, [], null);
     }
     // File watching drives runCodeRefresh, which needs a config — skip it without one.
     // stderr is safe in stdio transport; stdout is reserved for MCP JSON-RPC.

package/dist/core/cache.js

@@ -37,6 +37,20 @@ export function readCache(key, maxAgeMs = 3600000) {
         return null;
     }
 }
+// Returns when the entry was written (ms epoch), ignoring TTL — used to surface
+// analysis freshness. null if the entry is missing or unreadable.
+export function readCacheTimestamp(key) {
+    const filePath = path.join(cacheDir, `${key}.json`);
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        const entry = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+        return typeof entry.timestamp === 'number' ? entry.timestamp : null;
+    }
+    catch {
+        return null;
+    }
+}
 export function clearCache(key) {
     if (key) {
         const filePath = path.join(cacheDir, `${key}.json`);

package/dist/core/index.js

@@ -1,4 +1,4 @@
 export { loadConfig, generateDefaultConfig, InfrawiseConfigSchema, ConfigError } from './config.js';
 export { logger } from './logger.js';
 export { InfrawiseError, DynamoDBError, PostgresConnectionError, RepositoryScanError, formatError, } from './errors.js';
-export { writeCache, readCache, clearCache, setCacheDir } from './cache.js';
+export { writeCache, readCache, readCacheTimestamp, clearCache, setCacheDir } from './cache.js';

package/dist/server/index.js

@@ -12,12 +12,32 @@ import { getTableNodes, getFunctionNodes, getQueueNodes, getTopicNodes, getSecre
 // ── State ────────────────────────────────────────────────────────────────────
 let currentGraph = { nodes: [], edges: [] };
 let currentFindings = [];
+// When the loaded analysis was produced (ms epoch). null when serving an empty
+// graph with no analysis. Surfaced via get_infra_overview so assistants can
+// judge how stale the facts are and decide to refresh.
+let analyzedAt = null;
+// Analysis is considered stale past this age — matches the 24h cache TTL that
+// drives auto-refresh in stdio/start.
+const STALE_AGE_MS = 24 * 60 * 60 * 1000;
 // False when the server booted without an infrawise.yaml (e.g. a hosted MCP
 // runtime). Used to return a "run locally" hint instead of a bare empty graph.
 let configured = true;
-export function setGraphState(graph, findings) {
+export function setGraphState(graph, findings, analyzedAtMs = Date.now()) {
     currentGraph = graph;
     currentFindings = findings;
+    analyzedAt = analyzedAtMs;
+}
+function freshness() {
+    if (analyzedAt === null)
+        return { analyzedAt: null, ageSeconds: null, stale: false };
+    const ageMs = Date.now() - analyzedAt;
+    const stale = ageMs > STALE_AGE_MS;
+    return {
+        analyzedAt: new Date(analyzedAt).toISOString(),
+        ageSeconds: Math.round(ageMs / 1000),
+        stale,
+        ...(stale ? { hint: 'Analysis is stale — run `infrawise analyze` to refresh.' } : {}),
+    };
 }
 export function setConfigured(value) {
     configured = value;
@@ -38,7 +58,7 @@ function logged(name, fn) {
 export function createMcpServer() {
     const mcp = new McpServer({ name: 'infrawise', version });
     mcp.registerTool('get_infra_overview', {
-        description: 'Returns a compact infrastructure snapshot: service counts, all databases, queues, topics, secrets, lambdas, and high-severity findings. Call this first at the start of any database or infrastructure task to understand what services are in scope. Prefer this over get_graph_summary for quick orientation; use get_graph_summary only when you need every node, edge, and finding in full. Also returns a `configured` flag — when false, the server has no infrawise.yaml loaded (e.g. a remotely hosted instance) and all tools return empty results; a `setupHint` explains how to run infrawise locally.',
+        description: 'Returns a compact infrastructure snapshot: service counts, all databases, queues, topics, secrets, lambdas, and high-severity findings. Call this first at the start of any database or infrastructure task to understand what services are in scope. Prefer this over get_graph_summary for quick orientation; use get_graph_summary only when you need every node, edge, and finding in full. Also returns a `configured` flag — when false, the server has no infrawise.yaml loaded (e.g. a remotely hosted instance) and all tools return empty results; a `setupHint` explains how to run infrawise locally. The `freshness` field reports when the analysis ran (`analyzedAt`, `ageSeconds`) and a `stale` flag with a refresh hint once the data is older than 24h.',
         inputSchema: z.object({}),
     }, logged('get_infra_overview', async () => {
         const tables = getTableNodes(currentGraph);
@@ -53,6 +73,7 @@ export function createMcpServer() {
         return toText({
             configured,
             ...(configured ? {} : { setupHint: NOT_CONFIGURED_HINT }),
+            freshness: freshness(),
             summary: {
                 tables: tables.length,
                 functions: functions.length,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "infrawise",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "mcpName": "io.github.Sidd27/infrawise",
   "description": "CLI-first infrastructure intelligence platform — analyzes DynamoDB, PostgreSQL, MySQL, MongoDB, SQS, SNS, SSM, Secrets Manager, Lambda, S3, API Gateway, CloudWatch Logs and exposes findings as an MCP server for Claude Code",
   "keywords": [
@@ -67,6 +67,7 @@
     "record": "bash docs/demo/record.sh",
     "dev": "node dist/cli/index.js serve",
     "release": "node scripts/release.js",
+    "publish-smithery": "node scripts/smithery-publish.mjs",
     "prepare": "simple-git-hooks"
   },
   "simple-git-hooks": {