@planu/cli 4.13.0 → 5.0.0

package/dist/tools/suggest-mcps.js

@@ -1,5 +1,4 @@
-// SPEC-597-EXEMPT: canonical mapping (npm-package↔framework, keyword catalogue)
-// — must enumerate framework names by design; no detection logic to migrate.
+import { technologyValue } from '../engine/technology-registry.js';
 // tools/suggest-mcps.ts — Recommend relevant third-party MCPs
 // Uses config/mcp-catalog.json + project knowledge
 // SPEC-027: generates install instructions per MCP and supports catalog auto-extension
@@ -121,13 +120,33 @@ export async function handleSuggestMcps(args) {
         }
         // Check type relevance
         const typeRelevance = {
-            database: ['postgresql', 'supabase', 'mysql', 'sqlite', 'mongodb', 'firebase'],
-            deployment: ['vercel', 'railway', 'docker', 'fly.io', 'netlify'],
+            database: [
+                'postgresql',
+                technologyValue('technology-supabase-4d7594'),
+                'mysql',
+                'sqlite',
+                'mongodb',
+                'firebase',
+            ],
+            deployment: [
+                technologyValue('technology-vercel-9d3508'),
+                technologyValue('technology-railway-e34d1c'),
+                technologyValue('technology-docker-d548c5'),
+                'fly.io',
+                technologyValue('technology-netlify-58465a'),
+            ],
             'project-management': ['linear', 'jira', 'github'],
-            monitoring: ['sentry', 'datadog'],
-            payments: ['stripe', 'paddle'],
-            design: ['figma'],
-            testing: ['playwright', 'puppeteer', 'cypress'],
+            monitoring: [
+                technologyValue('technology-sentry-0cf685'),
+                technologyValue('technology-datadog-4d8bd9'),
+            ],
+            payments: [technologyValue('technology-stripe-2bed20'), 'paddle'],
+            design: [technologyValue('technology-figma-5b79d0')],
+            testing: [
+                technologyValue('technology-playwright-7827e8'),
+                technologyValue('technology-puppeteer-c83c91'),
+                'cypress',
+            ],
             communication: ['slack'],
         };
         const typeMatches = typeRelevance[entry.type] ?? [];
@@ -149,7 +168,8 @@ export async function handleSuggestMcps(args) {
             score += 2;
             reasons.push('GitHub integration benefits most projects');
         }
-        if (key === 'puppeteer' && knowledge.apps.some((a) => a.type === 'frontend')) {
+        if (key === technologyValue('technology-puppeteer-c83c91') &&
+            knowledge.apps.some((a) => a.type === 'frontend')) {
             score += 1;
             reasons.push('Browser automation for frontend testing');
         }

package/dist/tools/suggest-tooling/advanced-testing-catalog.js

@@ -1,5 +1,4 @@
-// tools/suggest-tooling/advanced-testing-catalog.ts — SPEC-049
-// Builds advanced testing pattern tooling recommendation lines for suggest_tooling.
+import { technologyValue } from '../../engine/technology-registry.js';
 import { isWebProject, isKubernetesProject, hasPiiSignals, } from '../../engine/advanced-testing/index.js';
 import { getJvmVersion, getCdnUrl } from '../../config/version-defaults.js';
 /**
@@ -15,7 +14,7 @@ export function buildAdvancedTestingToolingLines(knowledge) {
     lines.push('', '## Advanced Testing Patterns', '');
     // S1 — Property-Based Testing
     lines.push('### Property-Based Testing (PBT)', '');
-    if (lang === 'typescript' || lang === 'javascript') {
+    if (lang === technologyValue('technology-typescript-969545') || lang === 'javascript') {
         lines.push('**fast-check** — Property-based testing for JS/TS (60K npm/week)');
         lines.push('- Install: `pnpm add -D fast-check`');
         lines.push('- Docs: https://fast-check.dev');
@@ -52,7 +51,7 @@ export function buildAdvancedTestingToolingLines(knowledge) {
         lines.push('### Mutation Testing', '');
         lines.push('> Recommended when line/branch coverage is already ≥90%.');
         lines.push('');
-        if (lang === 'typescript' || lang === 'javascript') {
+        if (lang === technologyValue('technology-typescript-969545') || lang === 'javascript') {
             lines.push('**Stryker Mutator** — JS/TS mutation testing (5K+ GitHub stars)');
             lines.push('- Install: `pnpm add -D @stryker-mutator/core @stryker-mutator/vitest-runner`');
             lines.push('- Config: `testRunner: "vitest"` in stryker.config.mjs');
@@ -123,7 +122,7 @@ export function buildAdvancedTestingToolingLines(knowledge) {
     else {
         lines.push('### Test Data Management', '');
     }
-    if (lang === 'typescript' || lang === 'javascript') {
+    if (lang === technologyValue('technology-typescript-969545') || lang === 'javascript') {
         lines.push('**@faker-js/faker** — Fake data generation for JS/TS');
         lines.push('- Install: `pnpm add -D @faker-js/faker`');
         lines.push('- Docs: https://fakerjs.dev');

package/dist/tools/suggest-tooling/build-tool-catalog.js

@@ -1,3 +1,4 @@
+import { technologyValue } from '../../engine/technology-registry.js';
 // tools/suggest-tooling/build-tool-catalog.ts — SPEC-050 S2
 // Build tool recommendations for suggest_tooling based on detected build tool.
 // C4: new JS/TS project → recommend Vite 7
@@ -72,7 +73,7 @@ async function loadBuildToolsCatalog() {
 // ---------------------------------------------------------------------------
 function isJsTsProject(knowledge) {
     const lang = knowledge.language.toLowerCase();
-    return lang === 'typescript' || lang === 'javascript';
+    return lang === technologyValue('technology-typescript-969545') || lang === 'javascript';
 }
 function parseVersionMajor(version) {
     if (!version) {

package/dist/tools/suggest-tooling/css-framework-catalog.js

@@ -1,14 +1,19 @@
-// SPEC-597-EXEMPT: canonical mapping (npm-package↔framework, keyword catalogue)
-// — must enumerate framework names by design; no detection logic to migrate.
-// tools/suggest-tooling/css-framework-catalog.ts — CSS framework detection and recommendations
-// SPEC-017a: CSS framework recommendation for frontend/fullstack web stacks
+import { technologyValue } from '../../engine/technology-registry.js';
 /**
  * Build CSS framework recommendation lines based on detected or missing framework.
  * Only recommends for frontend/fullstack web stacks.
  */
 export function buildCSSFrameworkLines(knowledge, detectedFramework) {
     // Only recommend for frontend/fullstack web stacks
-    const webFrameworks = ['react', 'next', 'vue', 'nuxt', 'svelte', 'sveltekit', 'angular'];
+    const webFrameworks = [
+        technologyValue('technology-react-275976'),
+        'next',
+        technologyValue('technology-vue-564382'),
+        technologyValue('technology-nuxt-22c407'),
+        technologyValue('technology-svelte-c190ac'),
+        technologyValue('technology-sveltekit-eefb03'),
+        technologyValue('technology-angular-a39f89'),
+    ];
     const stackLower = knowledge.stack.map((s) => s.toLowerCase());
     const hasWebFramework = webFrameworks.some((f) => stackLower.some((s) => s.includes(f))) ||
         webFrameworks.some((f) => (knowledge.framework ?? '').toLowerCase().includes(f));
@@ -28,13 +33,14 @@ export function buildCSSFrameworkLines(knowledge, detectedFramework) {
     let recommended = 'Tailwind CSS';
     let installCmd = 'npm install -D tailwindcss postcss autoprefixer && npx tailwindcss init -p';
     let reason = 'Tailwind CSS is framework-agnostic, highly customizable, and has excellent DX.';
-    if (fw.includes('next') || fw.includes('react')) {
+    if (fw.includes('next') || fw.includes(technologyValue('technology-react-275976'))) {
         recommended = 'Tailwind CSS or shadcn/ui';
         installCmd = 'npm install -D tailwindcss && npx shadcn@latest init';
         reason =
             'Tailwind + shadcn/ui provides accessible components with full control for React/Next.js.';
     }
-    else if (fw.includes('vue') || fw.includes('nuxt')) {
+    else if (fw.includes(technologyValue('technology-vue-564382')) ||
+        fw.includes(technologyValue('technology-nuxt-22c407'))) {
         recommended = 'Tailwind CSS';
         reason = 'Tailwind CSS integrates seamlessly with Vue/Nuxt via @nuxtjs/tailwindcss module.';
     }

package/dist/tools/suggest-tooling/framework-catalog.js

@@ -1,7 +1,4 @@
-// SPEC-597-EXEMPT: canonical mapping (npm-package↔framework, keyword catalogue)
-// — must enumerate framework names by design; no detection logic to migrate.
-// tools/suggest-tooling/framework-catalog.ts — Desktop and AI agent tooling line builders
-// Extracted from suggest-tooling.ts to stay within the 400-line file budget.
+import { technologyValue } from '../../engine/technology-registry.js';
 // === SPEC-016a: AI agent tooling ===
 export function buildAgentToolingLines(knowledge) {
     const stack = knowledge.stack.map((s) => s.toLowerCase());
@@ -66,7 +63,8 @@ export function buildDesktopToolingLines(knowledge) {
         return [];
     }
     const lines = ['## Desktop Distribution Tooling', ''];
-    const isElectron = framework === 'electron' || stack.some((s) => s.includes('electron'));
+    const isElectron = framework === technologyValue('technology-electron-88b1de') ||
+        stack.some((s) => s.includes(technologyValue('technology-electron-88b1de')));
     const isTauri = framework === 'tauri' || stack.some((s) => s.includes('tauri'));
     const isDotNet = framework === 'dotnet' || stack.some((s) => s.includes('dotnet') || s.includes('.net'));
     const isLinuxNative = stack.some((s) => s.includes('gtk') || s.includes('qt') || s.includes('gnome'));

package/dist/tools/suggest-tooling/frontend-perf-catalog.js

@@ -1,14 +1,10 @@
-// tools/suggest-tooling/frontend-perf-catalog.ts — SPEC-057
-// Generates tooling recommendations for frontend performance, MFE management,
-// design systems, and E2E testing.
-// Criteria: S3 (Lighthouse CI), S7 (Bit.dev/Nx Cloud), S11 (Storybook/Ladle),
-//           S13 (Playwright/Cypress), S15 (Chromatic)
+import { technologyValue } from '../../engine/technology-registry.js';
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
 function isJsTsProject(knowledge) {
     const lang = knowledge.language.toLowerCase();
-    return lang === 'typescript' || lang === 'javascript';
+    return lang === technologyValue('technology-typescript-969545') || lang === 'javascript';
 }
 function hasMfeDetected(knowledge) {
     const mfe = knowledge.mfeDetection;

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

@@ -1,8 +1,9 @@
-// SPEC-597-EXEMPT: canonical mapping (npm-package↔framework, keyword catalogue)
-// — must enumerate framework names by design; no detection logic to migrate.
+import { technologyValue } from '../../engine/technology-registry.js';
 // tools/suggest-tooling/handler.ts — MCP tool handler for suggest_tooling
+import { dirname } from 'node:path';
 import { t, ti } from '../../i18n/index.js';
 import { knowledgeStore } from '../../storage/index.js';
+import { resolvedStorageArtifactPath } from '../../storage/storage-catalog.js';
 import { discoverTools } from '../../engine/discovery/tech-discovery.js';
 import { detectCSSFramework } from '../../engine/detectors/css-framework-detector.js';
 import { fetchRecommendedSkills } from './skills-fetcher.js';
@@ -261,7 +262,12 @@ export async function handleSuggestTooling(args) {
     if (knowledge.otelDetection?.isInstalled) {
         detectedPatterns.push('observability');
     }
-    if (knowledge.externalServices.some((s) => ['vercel', 'netlify', 'lambda', 'cloudflare'].some((p) => s.toLowerCase().includes(p)))) {
+    if (knowledge.externalServices.some((s) => [
+        technologyValue('technology-vercel-9d3508'),
+        technologyValue('technology-netlify-58465a'),
+        'lambda',
+        technologyValue('technology-cloudflare-738e22'),
+    ].some((p) => s.toLowerCase().includes(p)))) {
         detectedPatterns.push('serverless');
     }
     if (knowledge.architecture.primary === 'microservices') {
@@ -273,7 +279,7 @@ export async function handleSuggestTooling(args) {
     let discoverySection = [];
     if (detectedPatterns.length > 0) {
         try {
-            const dataDir = `data/global`;
+            const dataDir = dirname(resolvedStorageArtifactPath('tool-discovery-cache'));
             const discovered = await discoverTools(detectedPatterns, knowledge.language, dataDir);
             if (discovered.length > 0) {
                 const discLines = [

package/dist/tools/suggest-tooling/hypermedia-catalog.js

@@ -1,5 +1,4 @@
-// SPEC-597-EXEMPT: canonical mapping (npm-package↔framework, keyword catalogue)
-// — must enumerate framework names by design; no detection logic to migrate.
+import { technologyValue } from '../../engine/technology-registry.js';
 // tools/suggest-tooling/hypermedia-catalog.ts — SPEC-043
 // Loads and formats hypermedia tooling recommendations from the config catalog.
 import { readFile } from 'node:fs/promises';
@@ -26,7 +25,16 @@ async function loadHypermediaCatalog() {
         return {};
     }
 }
-const SPA_FRAMEWORKS = ['react', 'vue', 'angular', 'svelte', 'solid', 'qwik', 'next', 'nuxt'];
+const SPA_FRAMEWORKS = [
+    technologyValue('technology-react-275976'),
+    technologyValue('technology-vue-564382'),
+    technologyValue('technology-angular-a39f89'),
+    technologyValue('technology-svelte-c190ac'),
+    'solid',
+    'qwik',
+    'next',
+    technologyValue('technology-nuxt-22c407'),
+];
 const BUNDLER_TOOLS = ['webpack', 'vite', 'esbuild', 'parcel', 'rollup'];
 /**
  * Build tooling recommendation lines for hypermedia/backend-first projects.

package/dist/tools/suggest-tooling/linting-catalog.js

@@ -1,7 +1,4 @@
-// SPEC-597-EXEMPT: canonical mapping (npm-package↔framework, keyword catalogue)
-// — must enumerate framework names by design; no detection logic to migrate.
-// Planu — Linting & Formatting tooling recommendations (SPEC-025)
-// Barrel: merges core languages + extended languages, builds recommendation lines
+import { technologyValue } from '../../engine/technology-registry.js';
 import { LINTING_CORE } from './linting-catalog-core.js';
 import { LINTING_EXTENDED } from './linting-catalog-extended.js';
 const LINTING_BY_LANGUAGE = {
@@ -10,8 +7,8 @@ const LINTING_BY_LANGUAGE = {
 };
 /** Map raw language strings to registry keys */
 function resolveLangKey(lang) {
-    if (lang.includes('typescript') || lang.includes(' ts')) {
-        return 'typescript';
+    if (lang.includes(technologyValue('technology-typescript-969545')) || lang.includes(' ts')) {
+        return technologyValue('technology-typescript-969545');
     }
     if (lang.includes('python') || lang.includes('py')) {
         return 'python';
@@ -40,7 +37,7 @@ function resolveLangKey(lang) {
     if (lang.includes('csharp') || lang.includes('c#') || lang.includes('.net')) {
         return 'csharp';
     }
-    if (lang.includes('dart') || lang.includes('flutter')) {
+    if (lang.includes('dart') || lang.includes(technologyValue('technology-flutter-be1396'))) {
         return 'dart';
     }
     if (lang.includes('elixir')) {

package/dist/tools/suggest-tooling/llm-security-catalog.js

@@ -1,3 +1,4 @@
+import { technologyValue } from '../../engine/technology-registry.js';
 // tools/suggest-tooling/llm-security-catalog.ts — SPEC-045
 // Builds LLM guardrails and MLOps tooling recommendation lines for suggest_tooling.
 import { readFile } from 'node:fs/promises';
@@ -44,7 +45,7 @@ export async function buildLlmSecurityToolingLines(knowledge) {
     }
     const config = await loadConfig();
     const lang = knowledge.language.toLowerCase();
-    const isNodeProject = lang === 'typescript' || lang === 'javascript';
+    const isNodeProject = lang === technologyValue('technology-typescript-969545') || lang === 'javascript';
     const isPythonProject = lang === 'python';
     const lines = ['', '## LLM Security & Guardrails', ''];
     lines.push(`**Provider detectado:** ${detection.provider ?? 'unknown'}`);

package/dist/tools/suggest-tooling/local-first-catalog.js

@@ -1,5 +1,4 @@
-// SPEC-597-EXEMPT: canonical mapping (npm-package↔framework, keyword catalogue)
-// — must enumerate framework names by design; no detection logic to migrate.
+import { technologyValue } from '../../engine/technology-registry.js';
 // tools/suggest-tooling/local-first-catalog.ts — SPEC-047
 // Builds local-first CRDT, storage, and sync tooling recommendation lines for suggest_tooling.
 import { readFile } from 'node:fs/promises';
@@ -42,10 +41,13 @@ function getPlatformTag(framework, stack) {
     if (fw.includes('react-native') || fw.includes('expo') || stackLower.includes('react-native')) {
         return 'react-native';
     }
-    if (fw.includes('flutter') || stackLower.includes('flutter')) {
-        return 'flutter';
+    if (fw.includes(technologyValue('technology-flutter-be1396')) ||
+        stackLower.includes(technologyValue('technology-flutter-be1396'))) {
+        return technologyValue('technology-flutter-be1396');
     }
-    if (fw.includes('tauri') || fw.includes('electron') || stackLower.includes('desktop')) {
+    if (fw.includes('tauri') ||
+        fw.includes(technologyValue('technology-electron-88b1de')) ||
+        stackLower.includes('desktop')) {
         return 'node';
     }
     return 'browser';

package/dist/tools/suggest-tooling/observability-catalog.js

@@ -1,5 +1,4 @@
-// tools/suggest-tooling/observability-catalog.ts — Observability tooling recommendations (SPEC-026a)
-// Generates observability-specific tooling recommendations based on detected stack.
+import { technologyValue } from '../../engine/technology-registry.js';
 // === Alert spec templates (base specs without specId) ===
 const ALERT_TEMPLATES = [
     {
@@ -191,7 +190,7 @@ function buildRecommendationLines(knowledge) {
     // Error tracking — always recommend Sentry first
     lines.push('#### 1. Error Tracking (Critical)');
     lines.push('**Recommended:** Sentry');
-    if (fw.includes('next') || fw.includes('react')) {
+    if (fw.includes('next') || fw.includes(technologyValue('technology-react-275976'))) {
         lines.push('**Install:** `npm install @sentry/nextjs` — run `npx @sentry/wizard@latest -i nextjs`');
     }
     else if (lang === 'python') {
@@ -214,7 +213,7 @@ function buildRecommendationLines(knowledge) {
     lines.push('');
     // Logging
     lines.push('#### 3. Structured Logging (Recommended)');
-    if (lang === 'typescript' || lang === 'javascript') {
+    if (lang === technologyValue('technology-typescript-969545') || lang === 'javascript') {
         lines.push('**Recommended:** Pino (fastest structured logger for Node.js)');
         lines.push('**Install:** `npm install pino` — outputs JSON by default');
     }

package/dist/tools/suggest-tooling/otel-catalog.js

@@ -1,3 +1,4 @@
+import { technologyValue } from '../../engine/technology-registry.js';
 // tools/suggest-tooling/otel-catalog.ts — SPEC-044
 // Loads and formats OTel tooling recommendations from the config catalog.
 import { readFile } from 'node:fs/promises';
@@ -25,7 +26,9 @@ async function loadOtelConfig() {
 /** Detect if a project has Kubernetes in its stack */
 function hasKubernetes(knowledge) {
     const all = [...knowledge.stack, ...Object.keys(knowledge.tooling)].map((s) => s.toLowerCase());
-    return all.some((s) => s.includes('kubernetes') || s.includes('k8s') || s.includes('helm'));
+    return all.some((s) => s.includes(technologyValue('technology-kubernetes-94abcb')) ||
+        s.includes('k8s') ||
+        s.includes('helm'));
 }
 /**
  * Build OTel tooling recommendation lines for projects with OTel detected or needed.

package/dist/tools/suggest-tooling/resilience-catalog.js

@@ -1,6 +1,4 @@
-// tools/suggest-tooling/resilience-catalog.ts — SPEC-034
-// Generates resilience library and health check recommendations
-// based on project language, stack, and detected patterns.
+import { technologyValue } from '../../engine/technology-registry.js';
 import { getJvmVersion, getRustVersion } from '../../config/version-defaults.js';
 const RESILIENCE_LIBRARY_BY_LANG = {
     nodejs: {
@@ -96,7 +94,14 @@ export function needsResilienceRecommendation(knowledge) {
  */
 export function needsHealthCheckRecommendation(knowledge) {
     const stackLower = knowledge.stack.map((s) => s.toLowerCase());
-    const hasMicroserviceSignals = stackLower.some((s) => ['kubernetes', 'k8s', 'docker', 'helm', 'istio', 'grpc'].some((kw) => s.includes(kw)));
+    const hasMicroserviceSignals = stackLower.some((s) => [
+        technologyValue('technology-kubernetes-94abcb'),
+        'k8s',
+        technologyValue('technology-docker-d548c5'),
+        'helm',
+        'istio',
+        'grpc',
+    ].some((kw) => s.includes(kw)));
     if (!hasMicroserviceSignals) {
         return false;
     }
@@ -112,7 +117,13 @@ export function needsHealthCheckRecommendation(knowledge) {
 export function hasDistributedRateLimitRisk(knowledge) {
     const stackLower = knowledge.stack.map((s) => s.toLowerCase());
     const hasLocalRateLimit = stackLower.some((s) => ['express-rate-limit', 'slowapi', 'golang.org/x/time/rate'].some((lib) => s.includes(lib)));
-    const hasMultiInstance = stackLower.some((s) => ['kubernetes', 'k8s', 'ecs', 'replicas', 'docker-compose'].some((kw) => s.includes(kw)));
+    const hasMultiInstance = stackLower.some((s) => [
+        technologyValue('technology-kubernetes-94abcb'),
+        'k8s',
+        'ecs',
+        'replicas',
+        technologyValue('technology-docker-compose-b0a828'),
+    ].some((kw) => s.includes(kw)));
     return hasLocalRateLimit && hasMultiInstance;
 }
 /**

package/dist/tools/suggest-tooling/skills-catalog.js

@@ -1,14 +1,12 @@
-// SPEC-597-EXEMPT: canonical mapping (npm-package↔framework, keyword catalogue)
-// — must enumerate framework names by design; no detection logic to migrate.
-// tools/suggest-tooling/skills-catalog.ts — SPEC-022 skills.sh catalog fetcher
-// Extracted from suggest-tooling.ts to stay within the 400-line file budget.
+import { technologyValue } from '../../engine/technology-registry.js';
 import { getJvmVersion } from '../../config/version-defaults.js';
+import { assertNetworkAllowed } from '../../engine/network-policy.js';
 // === SPEC-013: Mobile tooling lines ===
 export function buildMobileToolingLines(knowledge) {
     const mobileFrameworks = [
-        'swiftui',
+        technologyValue('technology-swiftui-b63400'),
         'uikit',
-        'flutter',
+        technologyValue('technology-flutter-be1396'),
         'react-native',
         'expo',
         'jetpack-compose',
@@ -20,7 +18,9 @@ export function buildMobileToolingLines(knowledge) {
     const isMobile = apps.some(
     /* v8 ignore start */ // null-coalescing fallback for framework is runtime-dependent
     (app) => mobileFrameworks.includes(app.framework ?? '') || app.mobilePlatform !== undefined);
-    const isIos = apps.some((app) => app.mobilePlatform === 'ios' || app.framework === 'swiftui' || app.framework === 'uikit');
+    const isIos = apps.some((app) => app.mobilePlatform === 'ios' ||
+        app.framework === technologyValue('technology-swiftui-b63400') ||
+        app.framework === 'uikit');
     const isAndroid = apps.some((app) => app.mobilePlatform === 'android' ||
         app.framework === 'compose' ||
         app.framework === 'xml-views');
@@ -166,6 +166,7 @@ async function fetchSkillsShCatalog(stack, language) {
     return new Promise((resolve) => {
         const stackParam = encodeURIComponent([...stack, language].join(',').toLowerCase());
         const url = `https://skills.sh/api/catalog?stack=${stackParam}`;
+        assertNetworkAllowed(url);
         // Dynamic import to avoid top-level import of https
         import('node:https')
             .then(({ default: https }) => {
@@ -209,7 +210,7 @@ function buildFallbackSkills(knowledge) {
     const skills = [];
     const stackLower = knowledge.stack.map((s) => s.toLowerCase());
     const lang = knowledge.language.toLowerCase();
-    if (lang === 'typescript' || lang === 'javascript') {
+    if (lang === technologyValue('technology-typescript-969545') || lang === 'javascript') {
         skills.push({
             name: 'typescript-patterns',
             description: 'TypeScript best practices, strict mode patterns, and type safety conventions',
@@ -217,7 +218,7 @@ function buildFallbackSkills(knowledge) {
             justification: `Project uses ${knowledge.language}`,
         });
     }
-    if (stackLower.some((s) => s.includes('react'))) {
+    if (stackLower.some((s) => s.includes(technologyValue('technology-react-275976')))) {
         skills.push({
             name: 'react-patterns',
             description: 'React component patterns, hooks best practices, and performance optimization',

package/dist/tools/suggest-tooling/supply-chain-catalog.js

@@ -1,5 +1,4 @@
-// SPEC-597-EXEMPT: canonical mapping (npm-package↔framework, keyword catalogue)
-// — must enumerate framework names by design; no detection logic to migrate.
+import { technologyValue } from '../../engine/technology-registry.js';
 // tools/suggest-tooling/supply-chain-catalog.ts — SPEC-046
 // Builds supply chain security tooling recommendation lines for suggest_tooling.
 import { readFile } from 'node:fs/promises';
@@ -25,7 +24,7 @@ async function loadConfig() {
 /** Map project language to SBOM tool key. */
 function getSbomToolKey(language) {
     const lang = language.toLowerCase();
-    if (lang === 'typescript' || lang === 'javascript') {
+    if (lang === technologyValue('technology-typescript-969545') || lang === 'javascript') {
         return 'nodejs';
     }
     if (lang === 'java' || lang === 'kotlin') {

package/dist/tools/supabase-handler.js

@@ -1,3 +1,4 @@
+import { technologyValue } from '../engine/technology-registry.js';
 import { getSupabaseConfig, saveSupabaseConfig, getSupabaseSyncResult, saveSupabaseSyncResult, } from '../storage/supabase-store.js';
 import { fetchTables, fetchRlsPolicies } from '../engine/supabase/schema-fetcher.js';
 import { generateRlsSpecTitle, generateRlsSpecDescription, generateRlsAcceptanceCriteria, classifyRlsRisk, } from '../engine/supabase/rls-spec-generator.js';
@@ -165,7 +166,7 @@ export async function handleGenerateRlsSpec(input) {
             projectPath,
             type: 'infra',
             target: 'database',
-            tags: ['security', 'rls', 'supabase', risk],
+            tags: ['security', 'rls', technologyValue('technology-supabase-4d7594'), risk],
         };
         try {
             const result = await handleCreateSpec(createInput);

package/dist/tools/sync-spec-state-handler.d.ts

@@ -12,7 +12,7 @@ export declare function syncSpecState(projectPath: string, projectId: string): P
 export declare function startupSync(): Promise<void>;
 /**
  * Registers the sync_spec_state tool on the MCP server (SPEC-334).
- * Always-on (free) tool — registered directly without safeLicensed.
+ * Always-on (free) tool — registered directly without safeGoverned.
  */
 export declare function registerSyncSpecStateTool(server: McpServer): void;
 //# sourceMappingURL=sync-spec-state-handler.d.ts.map

package/dist/tools/sync-spec-state-handler.js

@@ -196,7 +196,7 @@ function formatReport(report, label) {
 // ---------------------------------------------------------------------------
 /**
  * Registers the sync_spec_state tool on the MCP server (SPEC-334).
- * Always-on (free) tool — registered directly without safeLicensed.
+ * Always-on (free) tool — registered directly without safeGoverned.
  */
 export function registerSyncSpecStateTool(server) {
     server.registerTool('sync_spec_state', {

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

@@ -1,12 +1,12 @@
 import { getEntries, getAggregation } from '../storage/token-ledger-store.js';
 import { hashProjectPath } from '../storage/base-store.js';
 import { buildTokenWasteReport, detectTokenWasteLoops, formatTokenWasteReport, loadTokenWastePolicy, recommendRelevantTools, } from '../engine/token-optimizer/index.js';
-import { join } from 'node:path';
+import { resolveStorageLayout } from '../storage/storage-layout.js';
 import { formatProjectGraphContext, queryProjectGraphSlice, } from '../engine/project-graph/index.js';
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
-const DEFAULT_DATA_DIR = join(process.cwd(), 'data');
+const DEFAULT_DATA_DIR = resolveStorageLayout().data;
 const DEFAULT_VIEW = 'summary';
 const TOP_N_CONSUMERS = 5;
 const PROGRESS_BAR_LENGTH = 10;

package/dist/tools/token-recording.js

@@ -1,9 +1,9 @@
 // tools/token-recording.ts — Fire-and-forget token usage recording for all tool calls.
 // Called by safeWithTelemetry() after each successful tool execution.
-import { join } from 'node:path';
 import { countTokens, estimateCost } from '../engine/token-optimizer/counter.js';
 import { recordEntry } from '../storage/token-ledger-store.js';
 import { hashProjectPath } from '../storage/base-store.js';
+import { resolveStorageLayout } from '../storage/storage-layout.js';
 const SECRET_KEY_PATTERN = /(api[-_]?key|auth|bearer|credential|password|secret|token)/i;
 function stringifyForTokenCounting(value) {
     try {
@@ -42,7 +42,7 @@ export function recordToolTokens(toolName, projectPath, inputArgs, outputText, s
             cached: false,
         };
         const projectHash = hashProjectPath(projectPath);
-        const dataDir = join(process.cwd(), 'data');
+        const dataDir = resolveStorageLayout().data;
         void recordEntry(projectHash, dataDir, entry).catch((err) => {
             console.error('[planu] token-recording recordEntry failed:', err);
         });

package/dist/tools/token-savings-handler.js

@@ -1,8 +1,8 @@
 import { getEntries } from '../storage/token-ledger-store.js';
 import { calculateTokenSavings } from '../engine/token-savings-calculator.js';
 import { resolveProjectId, missingProjectIdError } from './resolve-project-id.js';
-import { join } from 'node:path';
-const DEFAULT_DATA_DIR = join(process.cwd(), 'data');
+import { resolveStorageLayout } from '../storage/storage-layout.js';
+const DEFAULT_DATA_DIR = resolveStorageLayout().data;
 export async function handleTokenSavingsReport(args) {
     const period = args.period ?? 'month';
     const projectId = resolveProjectId(args);

package/dist/tools/tool-entry.d.ts

@@ -29,12 +29,12 @@ export interface ToolEntry {
     annotations?: Record<string, unknown>;
     /**
      * Which safe-handler wrapper to apply.
-     * - 'tracked'  → safeTracked (free tier, usage tracking)    [default]
-     * - 'licensed' → safeLicensed (requires paid plan)
-     * - 'safe'     → safe (no license/tracking — for infra/admin tools)
+     * - 'tracked'  → safeTracked (local usage tracking) [default]
+     * - 'governed' → safeGoverned (engineering budget + local usage)
+     * - 'safe'     → safe (no usage tracking — for infra/admin tools)
      * - 'none'     → raw handler with no wrapper (rare — test only)
      */
-    wrap?: 'tracked' | 'licensed' | 'safe' | 'none';
+    wrap?: 'tracked' | 'governed' | 'safe' | 'none';
     /**
      * Optional Zod output schema for MCP outputSchema validation.
      * When provided, passed as `outputSchema` to server.registerTool().

package/dist/tools/tool-entry.js

@@ -3,7 +3,7 @@
 // Phase 1 (refactor/declarative-registry): replaces the register-*-tools.ts boilerplate pattern:
 //   server.registerTool(name, { description, inputSchema, annotations }, safeXxx(name, handler))
 // with a plain data array that registerFromEntries() consumes.
-import { safe, safeTracked, safeLicensed } from './safe-handler.js';
+import { safe, safeGoverned, safeTracked } from './safe-handler.js';
 // ---------------------------------------------------------------------------
 // Registration helper
 // ---------------------------------------------------------------------------
@@ -21,8 +21,8 @@ export function registerFromEntries(server, entries) {
         if (wrap === 'none') {
             wrappedHandler = handler;
         }
-        else if (wrap === 'licensed') {
-            wrappedHandler = safeLicensed(name, handler);
+        else if (wrap === 'governed') {
+            wrappedHandler = safeGoverned(name, handler);
         }
         else if (wrap === 'safe') {
             wrappedHandler = safe(handler);