@planu/cli 4.13.0 → 5.0.0

package/dist/engine/doc-generator/mobile-distribution-guide.js

@@ -1,8 +1,4 @@
-// SPEC-597-EXEMPT: canonical mapping (npm-package↔framework, keyword catalogue)
-// — must enumerate framework names by design; no detection logic to migrate.
-// engine/doc-generator/mobile-distribution-guide.ts — SPEC-013 tech-debt criterion 15
-// Orchestrator: assembles the mobile distribution guide from platform-specific builders.
-// SRP: detection + assembly only. Platform content lives in sibling modules.
+import { technologyValue } from '../technology-registry.js';
 import { buildIOSDistributionSection } from './mobile-distribution-ios.js';
 import { buildAndroidDistributionSection } from './mobile-distribution-android.js';
 // --- Platform detection helpers ---
@@ -14,8 +10,8 @@ function detectFromApps(knowledge, platforms) {
         if (app.mobilePlatform === 'android') {
             platforms.add('android');
         }
-        if (app.mobileFramework === 'flutter') {
-            platforms.add('flutter');
+        if (app.mobileFramework === technologyValue('technology-flutter-be1396')) {
+            platforms.add(technologyValue('technology-flutter-be1396'));
         }
         if (app.mobileFramework === 'react-native') {
             platforms.add('react-native');
@@ -24,8 +20,8 @@ function detectFromApps(knowledge, platforms) {
 }
 function detectFromFramework(knowledge, platforms) {
     const fw = (knowledge.framework ?? '').toLowerCase();
-    if (fw.includes('flutter')) {
-        platforms.add('flutter');
+    if (fw.includes(technologyValue('technology-flutter-be1396'))) {
+        platforms.add(technologyValue('technology-flutter-be1396'));
     }
     if (fw.includes('react-native') || fw.includes('reactnative')) {
         platforms.add('react-native');
@@ -38,8 +34,8 @@ function detectFromFramework(knowledge, platforms) {
 function detectFromStack(knowledge, platforms) {
     for (const tech of knowledge.stack) {
         const lower = tech.toLowerCase();
-        if (lower === 'flutter') {
-            platforms.add('flutter');
+        if (lower === technologyValue('technology-flutter-be1396')) {
+            platforms.add(technologyValue('technology-flutter-be1396'));
         }
         if (lower === 'react-native') {
             platforms.add('react-native');
@@ -58,8 +54,8 @@ function detectFromSpecs(specs, platforms) {
             platforms.add('android');
         }
         const tags = spec.tags.join(' ').toLowerCase();
-        if (tags.includes('flutter')) {
-            platforms.add('flutter');
+        if (tags.includes(technologyValue('technology-flutter-be1396'))) {
+            platforms.add(technologyValue('technology-flutter-be1396'));
         }
         if (tags.includes('react-native') || tags.includes('expo')) {
             platforms.add('react-native');
@@ -222,7 +218,7 @@ function buildPhasedRolloutSection() {
     };
 }
 function addStoreSectionsIfMissing(platforms, sections) {
-    const isCrossPlatform = platforms.includes('flutter') ||
+    const isCrossPlatform = platforms.includes(technologyValue('technology-flutter-be1396')) ||
         platforms.includes('react-native') ||
         platforms.includes('expo');
     if (isCrossPlatform) {
@@ -253,19 +249,19 @@ export function generateMobileDistributionGuide(knowledge, specs, _language) {
             `**Detected platforms:** ${platforms.length > 0 ? platforms.join(', ') : 'none detected — configure manually'}`,
         ].join('\n'),
     });
-    if (platforms.includes('flutter')) {
+    if (platforms.includes(technologyValue('technology-flutter-be1396'))) {
         sections.push(buildFlutterDistributionSection());
     }
     if (platforms.includes('react-native') || platforms.includes('expo')) {
         sections.push(buildReactNativeDistributionSection(isExpo));
     }
     if (platforms.includes('ios') &&
-        !platforms.includes('flutter') &&
+        !platforms.includes(technologyValue('technology-flutter-be1396')) &&
         !platforms.includes('react-native')) {
         sections.push(buildIOSDistributionSection());
     }
     if (platforms.includes('android') &&
-        !platforms.includes('flutter') &&
+        !platforms.includes(technologyValue('technology-flutter-be1396')) &&
         !platforms.includes('react-native')) {
         sections.push(buildAndroidDistributionSection());
     }

package/dist/engine/doc-generator/portal/dirty-flag-map.d.ts

@@ -1,7 +1,7 @@
-import type { PortalPage, StoreType } from '../../../types/portal.js';
+import type { RegeneratedPortalPage, StoreType } from '../../../types/portal.js';
 /**
  * Return the deduplicated set of portal pages that need regeneration
  * when the given stores have changed.
  */
-export declare function getAffectedPages(changedStores: StoreType[]): PortalPage[];
+export declare function getAffectedPages(changedStores: StoreType[]): RegeneratedPortalPage[];
 //# sourceMappingURL=dirty-flag-map.d.ts.map

package/dist/engine/doc-generator/portal/portal-regenerator.js

@@ -25,10 +25,7 @@ export function scheduleRegeneration(projectPath, changedStores) {
         const stores = [...pending];
         pendingStoresPerProject.delete(projectPath);
         debounceTimers.delete(projectPath);
-        regeneratePages(projectPath, stores).catch((err) => {
-            const message = err instanceof Error ? err.message : String(err);
-            console.error('[Planu] Portal regeneration failed for', projectPath, ':', message);
-        });
+        void regeneratePages(projectPath, stores);
     }, 500);
     debounceTimers.set(projectPath, timer);
 }
@@ -76,64 +73,23 @@ async function generatePage(projectPath, page) {
     try {
         const { listSpecs } = await import('../../../storage/spec-store.js');
         const specs = await listSpecs(projectId);
-        return await dispatchPageGenerator(projectPath, projectId, page, specs);
+        return await dispatchPageGenerator(projectPath, page, specs);
     }
     catch {
         return null;
     }
 }
-async function dispatchPageGenerator(projectPath, projectId, page, specs) {
+async function dispatchPageGenerator(projectPath, page, specs) {
     switch (page) {
         case 'index': {
             const { regenerateSpecSummaryHtml } = await import('../../spec-summary-html.js');
             await regenerateSpecSummaryHtml(projectPath, specs);
             return null; // regenerateSpecSummaryHtml writes directly
         }
-        case 'executive-summary': {
-            const { getKnowledge } = await import('../../../storage/knowledge-store.js');
-            const { generateExecutiveSummary } = await import('../executive-summary/executive-summary-generator.js');
-            const knowledge = await getKnowledge(projectId);
-            if (!knowledge) {
-                return null;
-            }
-            const doc = generateExecutiveSummary(knowledge, specs, 'en');
-            return doc.content;
-        }
-        case 'analytics': {
-            const { generateAnalyticsPage } = await import('./analytics-page.js');
-            return generateAnalyticsPage(specs);
-        }
         case 'roadmap': {
             const { generateRoadmapPage } = await import('./roadmap-page.js');
             return generateRoadmapPage(specs);
         }
-        case 'risks': {
-            const { loadAllRiskRegisters } = await import('../../../storage/risk-store.js');
-            const { generateRiskPage } = await import('./risk-page.js');
-            const { projectDataDir } = await import('../../../storage/base-store.js');
-            const dataDir = projectDataDir(projectId);
-            const risks = await loadAllRiskRegisters(dataDir);
-            return generateRiskPage(risks, specs);
-        }
-        case 'decisions': {
-            const { getDecisions } = await import('../../../storage/decision-store.js');
-            const { generateDecisionPage } = await import('./decision-page.js');
-            const decisions = await getDecisions(projectId);
-            return generateDecisionPage(decisions);
-        }
-        case 'architecture': {
-            const { getKnowledge } = await import('../../../storage/knowledge-store.js');
-            const { generateArchitecturePage } = await import('./architecture-page.js');
-            const knowledge = await getKnowledge(projectId);
-            if (!knowledge) {
-                return null;
-            }
-            return generateArchitecturePage(knowledge);
-        }
-        case 'changelog': {
-            const { generateChangelogPage } = await import('./changelog-page.js');
-            return generateChangelogPage(specs);
-        }
     }
 }
 //# sourceMappingURL=portal-regenerator.js.map

package/dist/engine/docs-site-generator/data-collector.d.ts

@@ -1,5 +1,5 @@
 import type { DocSpecSummary, ToolEntry, ProjectMetrics } from '../../types/docs.js';
 export declare function collectSpecs(projectPath: string): Promise<DocSpecSummary[]>;
-export declare function collectTools(projectPath: string): ToolEntry[];
+export declare function collectTools(_projectPath: string): ToolEntry[];
 export declare function collectMetrics(projectPath: string): Promise<ProjectMetrics>;
 //# sourceMappingURL=data-collector.d.ts.map

package/dist/engine/docs-site-generator/data-collector.js

@@ -1,8 +1,8 @@
 // @crash-shield-ignore-file — config/cache reader for Planu-controlled JSON; writer is this codebase, shape guaranteed by build/seed.
 // SPEC-093: Data collector for docs site generator
-import { readFileSync } from 'node:fs';
 import { readdir, readFile, stat } from 'node:fs/promises';
 import { join } from 'node:path';
+import { readCanonicalToolNames } from '../../config/official-sdd-tools.js';
 import { parseFrontmatter } from '../frontmatter-parser.js';
 const SDD_PHASES = {
     Initialize: ['init_project', 'init_constitution', 'set_locale'],
@@ -225,33 +225,12 @@ export async function collectSpecs(projectPath) {
     });
     return results;
 }
-export function collectTools(projectPath) {
-    let plans;
-    try {
-        const plansPath = join(projectPath, 'src', 'config', 'license-plans.json');
-        plans = JSON.parse(readFileSync(plansPath, 'utf-8'));
-    }
-    catch {
-        return [];
-    }
-    const entries = [];
-    for (const tool of plans.freeTools ?? []) {
-        entries.push({
-            name: tool,
-            description: tool.replace(/_/g, ' '),
-            phase: findPhaseForTool(tool),
-            tier: 'free',
-        });
-    }
-    for (const tool of plans.proTools ?? []) {
-        entries.push({
-            name: tool,
-            description: tool.replace(/_/g, ' '),
-            phase: findPhaseForTool(tool),
-            tier: 'pro',
-        });
-    }
-    return entries;
+export function collectTools(_projectPath) {
+    return readCanonicalToolNames().map((tool) => ({
+        name: tool,
+        description: tool.replaceAll('_', ' '),
+        phase: findPhaseForTool(tool),
+    }));
 }
 async function countLinesInDir(dirPath) {
     let total = 0;

package/dist/engine/docs-site-generator/tools-renderer.js

@@ -11,18 +11,11 @@ function groupByPhase(tools) {
     }
     return groups;
 }
-function renderTierBadge(tier) {
-    const cls = tier === 'free' ? 'badge-free' : 'badge-pro';
-    const label = tier === 'free' ? 'Free' : 'Pro';
-    return `<span class="tier-badge ${cls}">${label}</span>`;
-}
 export function renderToolsCatalog(tools) {
-    const freeCount = tools.filter((t) => t.tier === 'free').length;
-    const proCount = tools.filter((t) => t.tier === 'pro').length;
     if (tools.length === 0) {
         return `<div class="tools-catalog">
   <div class="tools-summary">
-    <p>Total: 0 | Free: 0 | Pro: 0</p>
+    <p>Total: 0</p>
   </div>
   <p class="empty">No tools found.</p>
 </div>`;
@@ -34,7 +27,7 @@ export function renderToolsCatalog(tools) {
             .map((tool) => {
             const searchable = `${tool.name} ${tool.description}`.toLowerCase();
             return `    <div class="tool-card" data-searchable="${searchable}">
-      <h3>${tool.name} ${renderTierBadge(tool.tier)}</h3>
+      <h3>${tool.name}</h3>
       <p>${tool.description}</p>
     </div>`;
         })
@@ -47,7 +40,7 @@ ${cards}
         .join('\n');
     return `<div class="tools-catalog">
   <div class="tools-summary">
-    <p>Total: ${String(tools.length)} | Free: ${String(freeCount)} | Pro: ${String(proCount)}</p>
+    <p>Total: ${String(tools.length)}</p>
   </div>
 ${sections}
 </div>`;

package/dist/engine/domain-detector.js

@@ -1,14 +1,11 @@
-// engine/domain-detector.ts — Detects spec domains from title + description (SPEC-290)
-//
-// Analyzes spec text to identify which technical domains apply.
-// Detection is keyword-based and returns evidence for each domain found.
+import { technologyValue } from './technology-registry.js';
 const DOMAIN_KEYWORDS = [
     {
         domain: 'payments',
         keywords: [
             'payment',
             'payments',
-            'stripe',
+            technologyValue('technology-stripe-2bed20'),
             'paypal',
             'billing',
             'invoice',
@@ -168,7 +165,7 @@ const DOMAIN_KEYWORDS = [
             'cron',
             'scheduled task',
             'bull',
-            'celery',
+            technologyValue('technology-celery-ddc517'),
             'sidekiq',
             'job processor',
             'async job',

package/dist/engine/dynamic-knowledge/knowledge-cache.js

@@ -3,13 +3,12 @@
 // Reads/writes data/knowledge/cache.json with per-category TTL
 import { CATEGORY_TTL, } from '../../types/index.js';
 import { readFile, writeFile, mkdir } from 'node:fs/promises';
-import { join, dirname } from 'node:path';
-const CACHE_DIR = 'data/knowledge';
-const CACHE_FILE = 'cache.json';
+import { dirname } from 'node:path';
+import { resolvedStorageArtifactPath } from '../../storage/storage-catalog.js';
 const MAX_ENTRIES = 200;
 const PRUNE_THRESHOLD_DAYS = 30;
 function getCachePath() {
-    return join(process.cwd(), CACHE_DIR, CACHE_FILE);
+    return resolvedStorageArtifactPath('dynamic-knowledge-cache');
 }
 function createEmptyStore() {
     return { version: 1, entries: [], lastPruned: new Date().toISOString() };

package/dist/engine/dynamic-knowledge/knowledge-merger.js

@@ -1,5 +1,6 @@
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
+import { loadTechnologyRegistry } from '../technology-registry.js';
 /** Safely convert an unknown value to string, falling back to a default. */
 function toStr(val, fallback) {
     if (typeof val === 'string') {
@@ -12,7 +13,7 @@ function toStr(val, fallback) {
 }
 /** Map categories to their static fallback JSON files in src/config/ */
 const STATIC_FALLBACK_MAP = {
-    frameworks: ['framework-registry/index.json', 'build-tools-catalog.json'],
+    frameworks: ['build-tools-catalog.json'],
     security: ['known-cves.json', 'security-patterns.json'],
     pricing: ['ai-model-pricing.json', 'llm-providers.json'],
     tooling: ['saas-registry.json', 'mcp-catalog.json'],
@@ -26,7 +27,7 @@ const STATIC_FALLBACK_MAP = {
  */
 export async function loadStaticFallback(category) {
     const files = STATIC_FALLBACK_MAP[category];
-    const items = [];
+    const items = category === 'frameworks' ? technologyKnowledgeItems() : [];
     for (const file of files) {
         try {
             const configDir = join(import.meta.dirname, '../../config');
@@ -41,6 +42,20 @@ export async function loadStaticFallback(category) {
     }
     return items;
 }
+function technologyKnowledgeItems() {
+    const fetchedAt = new Date().toISOString();
+    return loadTechnologyRegistry().frameworks.map((framework) => ({
+        id: `static-frameworks-${framework.id}`,
+        category: 'frameworks',
+        title: framework.displayName,
+        description: `${framework.displayName} ${framework.frameworkVersion}`,
+        sourceUrl: undefined,
+        applicableTargets: ['fullstack'],
+        severity: 'recommended',
+        tags: [framework.ecosystem],
+        fetchedAt,
+    }));
+}
 /**
  * Convert a static JSON config into KnowledgeItem format.
  * Handles various JSON structures found in src/config/.

package/dist/engine/dynamic-knowledge/web-researcher.js

@@ -1,3 +1,4 @@
+import { technologyValue } from '../technology-registry.js';
 /**
  * Perform a web search query and return parsed results.
  * Uses DuckDuckGo HTML search as a free, no-API-key source.
@@ -149,18 +150,18 @@ function extractTags(snippet) {
     const lower = snippet.toLowerCase();
     const tags = [];
     const techKeywords = [
-        'react',
-        'vue',
-        'angular',
-        'svelte',
+        technologyValue('technology-react-275976'),
+        technologyValue('technology-vue-564382'),
+        technologyValue('technology-angular-a39f89'),
+        technologyValue('technology-svelte-c190ac'),
         'next',
-        'nuxt',
-        'express',
-        'nestjs',
-        'django',
-        'fastapi',
-        'rails',
-        'typescript',
+        technologyValue('technology-nuxt-22c407'),
+        technologyValue('technology-express-008231'),
+        technologyValue('technology-nestjs-2d0087'),
+        technologyValue('technology-django-7d8a08'),
+        technologyValue('technology-fastapi-6aee0e'),
+        technologyValue('technology-rails-2e1d59'),
+        technologyValue('technology-typescript-969545'),
         'python',
         'go',
         'rust',
@@ -168,9 +169,9 @@ function extractTags(snippet) {
         'postgres',
         'mysql',
         'mongodb',
-        'redis',
-        'docker',
-        'kubernetes',
+        technologyValue('technology-redis-34fb46'),
+        technologyValue('technology-docker-d548c5'),
+        technologyValue('technology-kubernetes-94abcb'),
         'aws',
         'gcp',
         'azure',

package/dist/engine/dynamic-migration-detector/manifest-readers-extended.js

@@ -1,5 +1,3 @@
-// SPEC-597-EXEMPT: canonical mapping (npm-package↔framework, keyword catalogue)
-// — must enumerate framework names by design; no detection logic to migrate.
 // Planu — Extended manifest readers: rubygems, nuget, pub, swiftpm (SPEC-054)
 // All file I/O via node:fs/promises — no live API calls.
 import { readFile } from 'node:fs/promises';

package/dist/engine/e2e-test-generator.js

@@ -1,3 +1,4 @@
+import { technologyValue } from './technology-registry.js';
 // Planu — E2E Test Generator engine (SPEC-381)
 // Pure functions for generating E2E tests from spec acceptance criteria.
 import { readFile, readdir, mkdir, writeFile } from 'node:fs/promises';
@@ -78,7 +79,7 @@ export function getFrameworkExtension(framework) {
     switch (framework) {
         case 'gherkin':
             return 'feature';
-        case 'playwright':
+        case technologyValue('technology-playwright-7827e8'):
             return 'spec.ts';
         case 'testRigor':
             return 'txt';
@@ -131,7 +132,7 @@ export async function generateE2eTests(specId, projectPath, framework = 'gherkin
         case 'gherkin':
             content = generateGherkin(title, description, criteria);
             break;
-        case 'playwright':
+        case technologyValue('technology-playwright-7827e8'):
             content = generatePlaywright(title, criteria);
             break;
         case 'testRigor':
@@ -198,7 +199,7 @@ export async function getE2eTestStatus(projectPath) {
             framework = 'gherkin';
         }
         else if (ext === '.ts') {
-            framework = 'playwright';
+            framework = technologyValue('technology-playwright-7827e8');
         }
         else {
             framework = 'unknown';

package/dist/engine/ecosystem-absorber/knowledge-cache.js

@@ -1,9 +1,10 @@
 // engine/ecosystem-absorber/knowledge-cache.ts — Reads/writes ecosystem capability cache
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { resolveStorageLayout } from '../../storage/storage-layout.js';
 const CACHE_VERSION = '1';
 const PRUNE_DAYS = 30;
-const DATA_DIR = join(process.cwd(), 'data', 'ecosystem');
+const DATA_DIR = join(resolveStorageLayout().cache, 'ecosystem');
 const CACHE_FILE = join(DATA_DIR, 'capabilities.json');
 function emptyCache() {
     return { lastCrawled: {}, capabilities: [], version: CACHE_VERSION };

package/dist/engine/ecosystem-absorber/platform-crawler.js

@@ -1,7 +1,7 @@
-// engine/ecosystem-absorber/platform-crawler.ts — Crawls external sources for capability signals
+import { technologyValue } from '../technology-registry.js';
 const GITHUB_API_BASE = 'https://api.github.com';
 const CAPABILITY_SIGNALS = {
-    api: ['endpoint', 'api', 'rest', 'graphql', 'webhook', 'http'],
+    api: ['endpoint', 'api', 'rest', technologyValue('technology-graphql-aed31c'), 'webhook', 'http'],
     sdk: ['sdk', 'library', 'package', 'client', 'integration'],
     'tool-use': ['tool', 'function calling', 'tool_use', 'mcp', 'tool call'],
     agent: ['agent', 'autonomous', 'agentic', 'multi-agent', 'swarm'],

package/dist/engine/escalator/retry-counter.js

@@ -3,6 +3,7 @@
 import { join } from 'node:path';
 import { readFile } from 'node:fs/promises';
 import { atomicWriteFile } from '../safety/atomic-write-file.js';
+import { projectDataDir } from '../../storage/base-store.js';
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
@@ -12,7 +13,7 @@ const PURGE_TTL_MS = 7 * 24 * 60 * 60 * 1000;
 // Path helpers
 // ---------------------------------------------------------------------------
 function storePath(projectId) {
-    return join('planu', 'data', 'projects', projectId, 'retry-counters.json');
+    return join(projectDataDir(projectId), 'retry-counters.json');
 }
 function storeKey(k) {
     return `${k.role}::${k.specId}::${k.frontmatterSha}`;

package/dist/engine/evidence-gates/artifact-reader.d.ts

@@ -1,5 +1,20 @@
 import type { Spec } from '../../types/spec/core.js';
-import type { EvidenceArtifacts } from '../../types/evidence-gates.js';
+import type { EvidenceArtifacts, TraceabilityMatrixEvidence } from '../../types/evidence-gates.js';
+/** Digest of canonical artifact content; the provenance envelope is excluded. */
+export declare function evidenceArtifactDigest(artifact: unknown): string;
+export declare function evidenceArtifactCollectionDigest(artifacts: readonly {
+    kind: string;
+    provenance?: unknown;
+}[]): string;
+/** Verify legacy test-backed evidence without admitting prose-only traceability rows. */
+export declare function traceabilityRowHasCurrentTestEvidence(row: TraceabilityMatrixEvidence['rows'][number], args: {
+    projectPath: string;
+}): boolean;
+/** Verify strict command evidence against current repository inputs and the validation ledger. */
+export declare function traceabilityRowHasCurrentCommandEvidence(row: TraceabilityMatrixEvidence['rows'][number], args: {
+    projectId: string;
+    projectPath: string;
+}): boolean;
 export declare function readEvidenceArtifacts(args: {
     spec: Spec;
     projectId: string;