@planu/cli 0.68.0 → 0.70.0

package/dist/engine/token-optimizer/reconciler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciler.js","sourceRoot":"","sources":["../../../src/engine/token-optimizer/reconciler.ts"],"names":[],"mappings":"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"}

package/dist/storage/token-ledger-store.d.ts

@@ -0,0 +1,26 @@
+import type { LedgerEntry, LedgerFilter, LedgerAggregation, MonthlyLedger } from '../types/index.js';
+/**
+ * Append a new entry to the current month's ledger file.
+ */
+export declare function recordEntry(projectHash: string, dataDir: string, entry: LedgerEntry): Promise<void>;
+/**
+ * Load and filter ledger entries according to the given filter criteria.
+ */
+export declare function getEntries(projectHash: string, dataDir: string, filter: LedgerFilter): Promise<LedgerEntry[]>;
+/**
+ * Compute aggregated statistics for filtered ledger entries.
+ */
+export declare function getAggregation(projectHash: string, dataDir: string, filter: LedgerFilter): Promise<LedgerAggregation>;
+/**
+ * Load the current month's ledger including recomputed aggregation.
+ */
+export declare function getCurrentMonthLedger(projectHash: string, dataDir: string): Promise<MonthlyLedger>;
+/**
+ * Return the list of months for which ledger files exist (YYYY-MM format).
+ */
+export declare function getHistoricalMonths(projectHash: string, dataDir: string): Promise<string[]>;
+/**
+ * Archive months older than ROTATION_MONTHS into a summary.json file.
+ */
+export declare function rotateLedger(projectHash: string, dataDir: string): Promise<void>;
+//# sourceMappingURL=token-ledger-store.d.ts.map

package/dist/storage/token-ledger-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-ledger-store.d.ts","sourceRoot":"","sources":["../../src/storage/token-ledger-store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACd,MAAM,mBAAmB,CAAC;AAwR3B;;GAEG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,WAAW,EAAE,CAAC,CA2BxB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAG5B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC,CASxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE3F;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCtF"}

package/dist/storage/token-ledger-store.js

@@ -0,0 +1,354 @@
+// storage/token-ledger-store.ts — Token usage ledger persistence (SPEC-182)
+import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { withFileLock } from './file-mutex.js';
+const MAX_FILE_SIZE_MB = 10;
+const ROTATION_MONTHS = 6;
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+function getLedgerDir(projectHash, dataDir) {
+    return join(dataDir, 'projects', projectHash, 'token-ledger');
+}
+function getLedgerPath(projectHash, dataDir, month) {
+    return join(getLedgerDir(projectHash, dataDir), `${month}.json`);
+}
+function getSummaryPath(projectHash, dataDir) {
+    return join(getLedgerDir(projectHash, dataDir), 'summary.json');
+}
+function currentMonth() {
+    return new Date().toISOString().slice(0, 7); // YYYY-MM
+}
+function ensureDir(dirPath) {
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+}
+// ---------------------------------------------------------------------------
+// Date range helpers
+// ---------------------------------------------------------------------------
+function getStartOfToday() {
+    const d = new Date();
+    d.setHours(0, 0, 0, 0);
+    return d.toISOString();
+}
+function getStartOfWeek() {
+    const d = new Date();
+    d.setDate(d.getDate() - 6);
+    d.setHours(0, 0, 0, 0);
+    return d.toISOString();
+}
+function getStartOfMonth() {
+    const d = new Date();
+    d.setDate(1);
+    d.setHours(0, 0, 0, 0);
+    return d.toISOString();
+}
+function filterByPeriod(entries, period) {
+    if (!period || period === 'all_time') {
+        return entries;
+    }
+    let cutoff;
+    if (period === 'today') {
+        cutoff = getStartOfToday();
+    }
+    else if (period === 'week') {
+        cutoff = getStartOfWeek();
+    }
+    else {
+        cutoff = getStartOfMonth();
+    }
+    return entries.filter((e) => e.timestamp >= cutoff);
+}
+// ---------------------------------------------------------------------------
+// Low-level file I/O
+// ---------------------------------------------------------------------------
+function readMonthFile(filePath) {
+    if (!existsSync(filePath)) {
+        return [];
+    }
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed)) {
+            return [];
+        }
+        return parsed;
+    }
+    catch {
+        return [];
+    }
+}
+function writeMonthFile(filePath, entries) {
+    ensureDir(dirname(filePath));
+    const json = JSON.stringify(entries, null, 2);
+    const sizeMb = Buffer.byteLength(json, 'utf-8') / (1024 * 1024);
+    if (sizeMb > MAX_FILE_SIZE_MB) {
+        // Keep newest entries, drop oldest
+        const sorted = [...entries].sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+        const trimmed = trimToMaxSize(sorted);
+        writeFileSync(filePath, JSON.stringify(trimmed, null, 2), 'utf-8');
+        return;
+    }
+    writeFileSync(filePath, json, 'utf-8');
+}
+function trimToMaxSize(sorted) {
+    const maxBytes = MAX_FILE_SIZE_MB * 1024 * 1024;
+    const trimmed = [];
+    let totalSize = 0;
+    for (const entry of sorted) {
+        const entrySize = Buffer.byteLength(JSON.stringify(entry), 'utf-8');
+        if (totalSize + entrySize > maxBytes) {
+            break;
+        }
+        trimmed.push(entry);
+        totalSize += entrySize;
+    }
+    return trimmed;
+}
+// ---------------------------------------------------------------------------
+// Aggregation computation
+// ---------------------------------------------------------------------------
+function computeAggregation(entries) {
+    if (entries.length === 0) {
+        return emptyAggregation();
+    }
+    const tokensByTool = {};
+    const costByTool = {};
+    const tokensByModel = {};
+    const costByModel = {};
+    const tools = new Set();
+    const models = new Set();
+    const sessions = new Set();
+    let totalTokens = 0;
+    let totalInputTokens = 0;
+    let totalOutputTokens = 0;
+    let totalCostUsd = 0;
+    let totalEstimatedCostUsd = 0;
+    let totalActualForAccuracy = 0;
+    let totalEstimatedForAccuracy = 0;
+    let estimationCount = 0;
+    for (const e of entries) {
+        totalTokens += e.totalTokens;
+        totalInputTokens += e.inputTokens;
+        totalOutputTokens += e.outputTokens;
+        totalCostUsd += e.costUsd;
+        if (e.estimatedCostUsd !== undefined) {
+            totalEstimatedCostUsd += e.estimatedCostUsd;
+        }
+        if (e.estimatedTokens !== undefined) {
+            totalActualForAccuracy += e.totalTokens;
+            totalEstimatedForAccuracy += e.estimatedTokens;
+            estimationCount++;
+        }
+        tools.add(e.toolName);
+        models.add(e.model);
+        sessions.add(e.sessionId);
+        tokensByTool[e.toolName] = (tokensByTool[e.toolName] ?? 0) + e.totalTokens;
+        costByTool[e.toolName] = (costByTool[e.toolName] ?? 0) + e.costUsd;
+        tokensByModel[e.model] = (tokensByModel[e.model] ?? 0) + e.totalTokens;
+        costByModel[e.model] = (costByModel[e.model] ?? 0) + e.costUsd;
+    }
+    const count = entries.length;
+    const estimationAccuracy = computeEstimationAccuracy(totalActualForAccuracy, totalEstimatedForAccuracy, estimationCount);
+    const overEstimationPercent = computeOverEstimationPercent(totalActualForAccuracy, totalEstimatedForAccuracy, estimationCount);
+    return {
+        totalTokens,
+        totalInputTokens,
+        totalOutputTokens,
+        totalCostUsd,
+        totalEstimatedCostUsd,
+        entryCount: count,
+        uniqueTools: tools.size,
+        uniqueModels: models.size,
+        uniqueSessions: sessions.size,
+        avgTokensPerCall: count > 0 ? totalTokens / count : 0,
+        avgCostPerCall: count > 0 ? totalCostUsd / count : 0,
+        tokensByTool,
+        costByTool,
+        tokensByModel,
+        costByModel,
+        estimationAccuracy,
+        overEstimationPercent,
+    };
+}
+function computeEstimationAccuracy(actual, estimated, count) {
+    if (count === 0 || actual === 0) {
+        return 100;
+    }
+    const accuracy = 100 - (Math.abs(estimated - actual) / actual) * 100;
+    return Math.max(0, Math.min(100, accuracy));
+}
+function computeOverEstimationPercent(actual, estimated, count) {
+    if (count === 0 || actual === 0) {
+        return 0;
+    }
+    return ((estimated - actual) / actual) * 100;
+}
+function emptyAggregation() {
+    return {
+        totalTokens: 0,
+        totalInputTokens: 0,
+        totalOutputTokens: 0,
+        totalCostUsd: 0,
+        totalEstimatedCostUsd: 0,
+        entryCount: 0,
+        uniqueTools: 0,
+        uniqueModels: 0,
+        uniqueSessions: 0,
+        avgTokensPerCall: 0,
+        avgCostPerCall: 0,
+        tokensByTool: {},
+        costByTool: {},
+        tokensByModel: {},
+        costByModel: {},
+        estimationAccuracy: 100,
+        overEstimationPercent: 0,
+    };
+}
+// ---------------------------------------------------------------------------
+// Multi-month entry loading (for all_time filter)
+// ---------------------------------------------------------------------------
+function loadAllMonthEntries(projectHash, dataDir) {
+    const months = listAvailableMonths(projectHash, dataDir);
+    const all = [];
+    for (const month of months) {
+        const filePath = getLedgerPath(projectHash, dataDir, month);
+        all.push(...readMonthFile(filePath));
+    }
+    return all;
+}
+function listAvailableMonths(projectHash, dataDir) {
+    const dir = getLedgerDir(projectHash, dataDir);
+    if (!existsSync(dir)) {
+        return [];
+    }
+    try {
+        return readdirSync(dir)
+            .filter((f) => /^\d{4}-\d{2}\.json$/.test(f))
+            .map((f) => f.slice(0, 7))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Append a new entry to the current month's ledger file.
+ */
+export async function recordEntry(projectHash, dataDir, entry) {
+    const month = currentMonth();
+    const filePath = getLedgerPath(projectHash, dataDir, month);
+    await withFileLock(filePath, () => {
+        const entries = readMonthFile(filePath);
+        entries.push(entry);
+        writeMonthFile(filePath, entries);
+        return Promise.resolve();
+    });
+}
+/**
+ * Load and filter ledger entries according to the given filter criteria.
+ */
+export function getEntries(projectHash, dataDir, filter) {
+    let entries;
+    if (!filter.period || filter.period === 'all_time') {
+        entries = loadAllMonthEntries(projectHash, dataDir);
+    }
+    else {
+        const month = currentMonth();
+        const filePath = getLedgerPath(projectHash, dataDir, month);
+        entries = readMonthFile(filePath);
+    }
+    entries = filterByPeriod(entries, filter.period);
+    if (filter.specId) {
+        entries = entries.filter((e) => e.specId === filter.specId);
+    }
+    if (filter.toolName) {
+        entries = entries.filter((e) => e.toolName === filter.toolName);
+    }
+    if (filter.model) {
+        entries = entries.filter((e) => e.model === filter.model);
+    }
+    if (filter.sessionId) {
+        entries = entries.filter((e) => e.sessionId === filter.sessionId);
+    }
+    return Promise.resolve(entries);
+}
+/**
+ * Compute aggregated statistics for filtered ledger entries.
+ */
+export async function getAggregation(projectHash, dataDir, filter) {
+    const entries = await getEntries(projectHash, dataDir, filter);
+    return computeAggregation(entries);
+}
+/**
+ * Load the current month's ledger including recomputed aggregation.
+ */
+export function getCurrentMonthLedger(projectHash, dataDir) {
+    const month = currentMonth();
+    const filePath = getLedgerPath(projectHash, dataDir, month);
+    const entries = readMonthFile(filePath);
+    return Promise.resolve({
+        month,
+        entries,
+        aggregation: computeAggregation(entries),
+    });
+}
+/**
+ * Return the list of months for which ledger files exist (YYYY-MM format).
+ */
+export function getHistoricalMonths(projectHash, dataDir) {
+    return Promise.resolve(listAvailableMonths(projectHash, dataDir));
+}
+/**
+ * Archive months older than ROTATION_MONTHS into a summary.json file.
+ */
+export async function rotateLedger(projectHash, dataDir) {
+    const months = listAvailableMonths(projectHash, dataDir);
+    const cutoff = new Date();
+    cutoff.setMonth(cutoff.getMonth() - ROTATION_MONTHS);
+    const cutoffStr = cutoff.toISOString().slice(0, 7);
+    const toArchive = months.filter((m) => m < cutoffStr);
+    if (toArchive.length === 0) {
+        return;
+    }
+    const summaryPath = getSummaryPath(projectHash, dataDir);
+    await withFileLock(summaryPath, () => {
+        const existing = readSummary(summaryPath);
+        for (const month of toArchive) {
+            const filePath = getLedgerPath(projectHash, dataDir, month);
+            const entries = readMonthFile(filePath);
+            const agg = computeAggregation(entries);
+            existing[month] = agg;
+            // Remove the detailed file after archiving
+            try {
+                writeFileSync(filePath, '[]', 'utf-8');
+            }
+            catch {
+                // ignore
+            }
+        }
+        writeFileSync(summaryPath, JSON.stringify(existing, null, 2), 'utf-8');
+        return Promise.resolve();
+    });
+}
+function readSummary(summaryPath) {
+    if (!existsSync(summaryPath)) {
+        return {};
+    }
+    try {
+        const raw = readFileSync(summaryPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            return {};
+        }
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=token-ledger-store.js.map

package/dist/storage/token-ledger-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-ledger-store.js","sourceRoot":"","sources":["../../src/storage/token-ledger-store.ts"],"names":[],"mappings":"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"}

package/dist/tools/register-token-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-token-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-token-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2B1D"}
+{"version":3,"file":"register-token-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-token-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqE1D"}

package/dist/tools/register-token-tools.js

@@ -1,7 +1,10 @@
 // tools/register-token-tools.ts — Registers token optimization tools on the MCP server (SPEC-082)
+import { z } from 'zod';
 import { safe } from './safe-handler.js';
 import { handleTokenUsage } from './token-usage-handler.js';
+import { handleTokenIntelligence } from './token-intelligence-handler.js';
 import { TokenUsagePeriodEnum, TokenUsageGroupByEnum } from './schemas/token-optimization.js';
+import { TokenIntelligencePeriodEnum, TokenIntelligenceGroupByEnum, TokenIntelligenceViewEnum, } from './schemas/token-intelligence.js';
 export function registerTokenTools(server) {
     server.registerTool('token_usage', {
         description: 'View token consumption metrics, cache performance, and optimization savings. ' +
@@ -13,5 +16,23 @@ export function registerTokenTools(server) {
         },
         annotations: { title: 'Token Usage', readOnlyHint: true },
     }, safe(async (args) => handleTokenUsage(args)));
+    server.registerTool('token_intelligence', {
+        description: 'Advanced token analytics dashboard with cost tracking, budget monitoring, estimation ' +
+            'accuracy, trend detection, and anomaly alerts. Shows real spending data persisted across sessions.',
+        inputSchema: {
+            period: TokenIntelligencePeriodEnum.optional().describe('Time period filter. Type: today | week | month | all_time. Defaults to month.'),
+            groupBy: TokenIntelligenceGroupByEnum.optional().describe('Group breakdown by: tool | model | spec | day. Defaults to tool.'),
+            view: TokenIntelligenceViewEnum.optional().describe('Dashboard view: summary | detailed | budget | reconciliation | trends. Defaults to summary.'),
+            specId: z
+                .string()
+                .optional()
+                .describe('Filter by a specific spec ID (e.g. SPEC-180). Shows only ledger entries tagged to that spec.'),
+            projectPath: z
+                .string()
+                .optional()
+                .describe('Absolute path to the project root. Defaults to current working directory.'),
+        },
+        annotations: { title: 'Token Intelligence', readOnlyHint: true },
+    }, safe(async (args) => handleTokenIntelligence(args)));
 }
 //# sourceMappingURL=register-token-tools.js.map

package/dist/tools/register-token-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"register-token-tools.js","sourceRoot":"","sources":["../../src/tools/register-token-tools.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAGlG,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAE9F,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,WAAW,EACT,+EAA+E;YAC/E,oFAAoF;QACtF,WAAW,EAAE;YACX,MAAM,EAAE,oBAAoB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC9C,gFAAgF;gBAC9E,8BAA8B,CACjC;YACD,OAAO,EAAE,qBAAqB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAChD,+DAA+D,CAChE;SACF;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,IAAI,EAAE;KAC1D,EACD,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAClB,gBAAgB,CACd,IAGC,CACF,CACF,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"register-token-tools.js","sourceRoot":"","sources":["../../src/tools/register-token-tools.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAGlG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC9F,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AAEzC,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,WAAW,EACT,+EAA+E;YAC/E,oFAAoF;QACtF,WAAW,EAAE;YACX,MAAM,EAAE,oBAAoB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC9C,gFAAgF;gBAC9E,8BAA8B,CACjC;YACD,OAAO,EAAE,qBAAqB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAChD,+DAA+D,CAChE;SACF;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,IAAI,EAAE;KAC1D,EACD,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAClB,gBAAgB,CACd,IAGC,CACF,CACF,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EACT,uFAAuF;YACvF,oGAAoG;QACtG,WAAW,EAAE;YACX,MAAM,EAAE,2BAA2B,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACrD,+EAA+E,CAChF;YACD,OAAO,EAAE,4BAA4B,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACvD,kEAAkE,CACnE;YACD,IAAI,EAAE,yBAAyB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACjD,6FAA6F,CAC9F;YACD,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,8FAA8F,CAC/F;YACH,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,2EAA2E,CAAC;SACzF;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,IAAI,EAAE;KACjE,EACD,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAClB,uBAAuB,CACrB,IAMC,CACF,CACF,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/schemas/index.d.ts

@@ -11,6 +11,7 @@ export { DeleteActionEnum, DeleteItemTypeEnum, TrashActionEnum } from './delete.
 export { SecurityReportTimeRangeEnum, SecurityReportFormatEnum } from './runtime-security.js';
 export { WorkerStatusInputSchema, ConfigureWorkersInputSchema } from './workers-schema.js';
 export { TokenUsagePeriodEnum, TokenUsageGroupByEnum } from './token-optimization.js';
+export { TokenIntelligencePeriodEnum, TokenIntelligenceGroupByEnum, TokenIntelligenceViewEnum, } from './token-intelligence.js';
 export { ConfigureLLMProvidersActionEnum, LoadBalancingStrategyEnum, } from './llm-provider-schemas.js';
 export { PluginActionEnum } from './plugins-schemas.js';
 export { ListSpecsOutputSchema, EstimateOutputSchema, ValidateOutputSchema, CheckReadinessOutputSchema, LicenseStatusOutputSchema, } from './output-schemas.js';

package/dist/tools/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE9F,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE7F,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEpF,OAAO,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAE9F,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAE3F,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEtF,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAE9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE9F,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE7F,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEpF,OAAO,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAE9F,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAE3F,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEtF,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAE9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/tools/schemas/index.js

@@ -12,6 +12,7 @@ export { DeleteActionEnum, DeleteItemTypeEnum, TrashActionEnum } from './delete.
 export { SecurityReportTimeRangeEnum, SecurityReportFormatEnum } from './runtime-security.js';
 export { WorkerStatusInputSchema, ConfigureWorkersInputSchema } from './workers-schema.js';
 export { TokenUsagePeriodEnum, TokenUsageGroupByEnum } from './token-optimization.js';
+export { TokenIntelligencePeriodEnum, TokenIntelligenceGroupByEnum, TokenIntelligenceViewEnum, } from './token-intelligence.js';
 export { ConfigureLLMProvidersActionEnum, LoadBalancingStrategyEnum, } from './llm-provider-schemas.js';
 export { PluginActionEnum } from './plugins-schemas.js';
 export { ListSpecsOutputSchema, EstimateOutputSchema, ValidateOutputSchema, CheckReadinessOutputSchema, LicenseStatusOutputSchema, } from './output-schemas.js';

package/dist/tools/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/schemas/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE9F,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE7F,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEpF,OAAO,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAE9F,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAE3F,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEtF,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAE9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/schemas/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE9F,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE7F,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEpF,OAAO,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAE9F,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAE3F,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEtF,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAE9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/tools/schemas/token-intelligence.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export declare const TokenIntelligencePeriodEnum: z.ZodEnum<{
+    today: "today";
+    all_time: "all_time";
+    week: "week";
+    month: "month";
+}>;
+export declare const TokenIntelligenceGroupByEnum: z.ZodEnum<{
+    spec: "spec";
+    tool: "tool";
+    day: "day";
+    model: "model";
+}>;
+export declare const TokenIntelligenceViewEnum: z.ZodEnum<{
+    summary: "summary";
+    budget: "budget";
+    detailed: "detailed";
+    reconciliation: "reconciliation";
+    trends: "trends";
+}>;
+//# sourceMappingURL=token-intelligence.d.ts.map

package/dist/tools/schemas/token-intelligence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-intelligence.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/token-intelligence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,2BAA2B;;;;;EAKrC,CAAC;AAEJ,eAAO,MAAM,4BAA4B;;;;;EAKtC,CAAC;AAEJ,eAAO,MAAM,yBAAyB;;;;;;EAQnC,CAAC"}

package/dist/tools/schemas/token-intelligence.js

@@ -0,0 +1,18 @@
+// schemas/token-intelligence.ts — Zod schemas for token_intelligence tool (SPEC-182)
+import { z } from 'zod';
+export const TokenIntelligencePeriodEnum = z
+    .enum(['today', 'week', 'month', 'all_time'])
+    .describe('Time period filter: today (current calendar day), week (last 7 days), ' +
+    'month (current calendar month), all_time (all recorded history)');
+export const TokenIntelligenceGroupByEnum = z
+    .enum(['tool', 'model', 'spec', 'day'])
+    .describe('Group results by: tool (per MCP tool name), model (per AI model), ' +
+    'spec (per spec ID), day (daily breakdown)');
+export const TokenIntelligenceViewEnum = z
+    .enum(['summary', 'detailed', 'budget', 'reconciliation', 'trends'])
+    .describe('Dashboard view: summary (high-level overview with top consumers), ' +
+    'detailed (full per-tool and per-model breakdown), ' +
+    'budget (spending vs monthly limits with projections), ' +
+    'reconciliation (estimated vs actual cost accuracy per spec), ' +
+    'trends (usage patterns over time, week-over-week changes, and anomaly alerts)');
+//# sourceMappingURL=token-intelligence.js.map

package/dist/tools/schemas/token-intelligence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-intelligence.js","sourceRoot":"","sources":["../../../src/tools/schemas/token-intelligence.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;KAC5C,QAAQ,CACP,wEAAwE;IACtE,iEAAiE,CACpE,CAAC;AAEJ,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;KACtC,QAAQ,CACP,oEAAoE;IAClE,2CAA2C,CAC9C,CAAC;AAEJ,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;KACnE,QAAQ,CACP,oEAAoE;IAClE,oDAAoD;IACpD,wDAAwD;IACxD,+DAA+D;IAC/D,+EAA+E,CAClF,CAAC"}

package/dist/tools/suggest-tooling/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/handler.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,mBAAmB,EAMnB,UAAU,EACX,MAAM,sBAAsB,CAAC;AA+B9B,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA2RzF"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/tools/suggest-tooling/handler.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,mBAAmB,EAMnB,UAAU,EACX,MAAM,sBAAsB,CAAC;AA+B9B,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAwUzF"}

package/dist/tools/suggest-tooling/handler.js

@@ -1,6 +1,7 @@
 // tools/suggest-tooling/handler.ts — MCP tool handler for suggest_tooling
 import { t, ti } from '../../i18n/index.js';
 import { knowledgeStore } from '../../storage/index.js';
+import { discoverTools } from '../../engine/discovery/tech-discovery.js';
 import { detectCSSFramework } from '../../engine/detectors/css-framework-detector.js';
 import { fetchRecommendedSkills } from './skills-fetcher.js';
 import { getPlatformTooling } from './platform-tooling-catalog.js';
@@ -247,11 +248,48 @@ export async function handleSuggestTooling(args) {
     ]
         .filter((section) => section.length > 0)
         .map((section) => ({ type: 'text', text: section.join('\n') }));
+    // SPEC-181: Dynamic technology discovery — search live registries
+    const detectedPatterns = [];
+    if (knowledge.localFirst?.isLocalFirst) {
+        detectedPatterns.push('local-first');
+    }
+    if (knowledge.aiNativeDetection?.inferenceMode) {
+        detectedPatterns.push('ai-native');
+    }
+    if (knowledge.otelDetection?.isInstalled) {
+        detectedPatterns.push('observability');
+    }
+    if (knowledge.externalServices.some((s) => ['vercel', 'netlify', 'lambda', 'cloudflare'].some((p) => s.toLowerCase().includes(p)))) {
+        detectedPatterns.push('serverless');
+    }
+    if (knowledge.architecture.primary === 'microservices') {
+        detectedPatterns.push('microservices');
+    }
+    if (knowledge.architecture.primary === 'event-driven') {
+        detectedPatterns.push('event-driven');
+    }
+    let discoverySection = [];
+    if (detectedPatterns.length > 0) {
+        try {
+            const dataDir = `data/global`;
+            const discovered = await discoverTools(detectedPatterns, knowledge.language, dataDir);
+            if (discovered.length > 0) {
+                const discLines = [
+                    '\n## 🔍 Discovered (live from npm/GitHub)',
+                    ...discovered.map((d) => `- **${d.name}** — ${d.description} ([${d.source}](${d.url}))${d.weeklyDownloads ? ` · ${d.weeklyDownloads.toLocaleString()} dl/week` : ''}${d.stars ? ` · ⭐ ${d.stars.toLocaleString()}` : ''}`),
+                ];
+                discoverySection = [{ type: 'text', text: discLines.join('\n') }];
+            }
+        }
+        catch {
+            // best-effort — never fail suggest_tooling because of discovery
+        }
+    }
     // SPEC-174: Version verification notice — always appended to tooling output
     const versionNotice = {
         type: 'text',
         text: '\n\n> **⚠️ Version Notice:** The versions shown are defaults from our registry. Always verify against official sources (npm, Maven Central, Docker Hub, pub.dev, crates.io) before adopting.',
     };
-    return { content: [...content, ...additionalSections, versionNotice] };
+    return { content: [...content, ...additionalSections, ...discoverySection, versionNotice] };
 }
 //# sourceMappingURL=handler.js.map