@planu/cli 0.72.0 → 0.73.0

package/dist/engine/convention-sync.js

@@ -0,0 +1,156 @@
+// engine/convention-sync.ts — Convention sync health calculator.
+// Combines rules, skills, hooks and convention scanner scores into a single
+// weighted percentage showing how well the project enforces its own conventions.
+import { reconcileRules } from './rules-reconciler.js';
+import { reconcileSkills } from './skills-reconciler.js';
+import { reconcileHooks } from './hooks-reconciler.js';
+import { parseConventions, scanConventions } from './convention-scanner/index.js';
+// ---------------------------------------------------------------------------
+// Weights (must sum to 1.0)
+// ---------------------------------------------------------------------------
+const WEIGHT_RULES = 0.25;
+const WEIGHT_SKILLS = 0.25;
+const WEIGHT_HOOKS = 0.25;
+const WEIGHT_CONVENTIONS = 0.25;
+// Violation count that maps to 0 conventionHealth (linear scale).
+const MAX_VIOLATIONS_FOR_ZERO = 40;
+// ---------------------------------------------------------------------------
+// Convention health score
+// ---------------------------------------------------------------------------
+/**
+ * Derive a 0–100 score from raw violation count.
+ * 0 violations → 100; MAX_VIOLATIONS_FOR_ZERO+ violations → 0.
+ */
+function conventionScoreFromViolations(violationCount) {
+    if (violationCount <= 0) {
+        return 100;
+    }
+    const ratio = Math.min(violationCount / MAX_VIOLATIONS_FOR_ZERO, 1);
+    return Math.max(0, Math.round((1 - ratio) * 100));
+}
+// ---------------------------------------------------------------------------
+// Recommendations
+// ---------------------------------------------------------------------------
+function buildAreaSuggestions(rulesHealth, skillsHealth, hooksHealth, conventionHealth) {
+    const areas = [
+        {
+            label: 'rules',
+            score: rulesHealth,
+            suggestions: [
+                'Run reconcile_rules to auto-generate missing .claude/rules/ files.',
+                'Review stale rules files and remove or update them.',
+            ],
+        },
+        {
+            label: 'skills',
+            score: skillsHealth,
+            suggestions: [
+                'Run reconcile_skills to identify skills your stack recommends.',
+                'Install missing skills with skill_install or remove stale ones.',
+            ],
+        },
+        {
+            label: 'hooks',
+            score: hooksHealth,
+            suggestions: [
+                'Run reconcile_hooks to find missing git hook steps.',
+                'Run configure_hooks to add typecheck, lint, or test steps to hooks.',
+            ],
+        },
+        {
+            label: 'conventions',
+            score: conventionHealth,
+            suggestions: [
+                'Run scan_project to get a detailed list of convention violations.',
+                'Fix critical violations first (architecture imports, naming rules).',
+            ],
+        },
+    ];
+    // Sort by ascending score so lowest-scoring areas come first.
+    return areas.sort((a, b) => a.score - b.score);
+}
+function pickTopRecommendations(areas, maxItems) {
+    const recs = [];
+    for (const area of areas) {
+        if (area.score < 100) {
+            for (const s of area.suggestions) {
+                if (recs.length < maxItems) {
+                    recs.push(s);
+                }
+            }
+        }
+        if (recs.length >= maxItems) {
+            break;
+        }
+    }
+    return recs;
+}
+// ---------------------------------------------------------------------------
+// Summary string
+// ---------------------------------------------------------------------------
+function buildSummary(overallScore, worstArea) {
+    const grade = overallScore >= 90
+        ? 'Excellent'
+        : overallScore >= 75
+            ? 'Good'
+            : overallScore >= 50
+                ? 'Fair'
+                : 'Poor';
+    if (!worstArea || overallScore >= 90) {
+        return `${grade} (${overallScore}/100) — conventions and enforcement mechanisms are in sync.`;
+    }
+    return `${grade} (${overallScore}/100) — worst area: ${worstArea.label} (${worstArea.score}/100). Focus here first.`;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Calculate overall convention sync health by running all four reconcilers
+ * in parallel and combining their scores with equal 25% weights.
+ *
+ * Never throws — returns zero scores on unexpected errors.
+ */
+export async function calculateConventionSync(projectPath, knowledge) {
+    try {
+        const [rulesResult, skillsResult, hooksResult] = await Promise.all([
+            Promise.resolve(reconcileRules(projectPath)),
+            reconcileSkills(projectPath, knowledge),
+            Promise.resolve(reconcileHooks(projectPath)),
+        ]);
+        const rules = parseConventions(projectPath);
+        const violations = scanConventions(projectPath, rules);
+        const rulesHealth = rulesResult.healthScore;
+        const skillsHealth = skillsResult.healthScore;
+        const hooksHealth = hooksResult.healthScore;
+        const conventionHealth = conventionScoreFromViolations(violations.length);
+        const overallScore = Math.round(rulesHealth * WEIGHT_RULES +
+            skillsHealth * WEIGHT_SKILLS +
+            hooksHealth * WEIGHT_HOOKS +
+            conventionHealth * WEIGHT_CONVENTIONS);
+        const areas = buildAreaSuggestions(rulesHealth, skillsHealth, hooksHealth, conventionHealth);
+        const worstArea = areas[0];
+        const summary = buildSummary(overallScore, worstArea);
+        const recommendations = pickTopRecommendations(areas, 4);
+        return {
+            overallScore,
+            rulesHealth,
+            skillsHealth,
+            hooksHealth,
+            conventionHealth,
+            summary,
+            recommendations,
+        };
+    }
+    catch {
+        return {
+            overallScore: 0,
+            rulesHealth: 0,
+            skillsHealth: 0,
+            hooksHealth: 0,
+            conventionHealth: 0,
+            summary: 'Error: could not calculate convention sync health.',
+            recommendations: ['Ensure the project has been initialised with init_project.'],
+        };
+    }
+}
+//# sourceMappingURL=convention-sync.js.map

package/dist/engine/convention-sync.js.map

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

package/dist/engine/doc-generator/portal/portal-regenerator.d.ts

@@ -1,11 +1,12 @@
 import type { StoreType } from '../../../types/portal.js';
 /**
  * Schedule a debounced regeneration (500 ms window).
- * Multiple calls within the window are coalesced.
+ * Multiple calls within the window are coalesced per project.
  */
 export declare function scheduleRegeneration(projectPath: string, changedStores: StoreType[]): void;
 /**
  * Immediately regenerate all portal pages affected by the given store changes.
+ * Creates planu/ directory if it does not exist.
  * Returns the list of page keys that were successfully written.
  * Never throws.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"portal-regenerator.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/portal/portal-regenerator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAOtE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,IAAI,CAiB1F;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,SAAS,EAAE,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CAwBnB"}
+{"version":3,"file":"portal-regenerator.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/portal/portal-regenerator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAOtE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,IAAI,CAuB1F;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,SAAS,EAAE,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CA0BnB"}

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

@@ -1,40 +1,48 @@
 // Planu — Portal regenerator: auto-regen pages when stores change (SPEC-146)
-import { existsSync } from 'node:fs';
-import { writeFile } from 'node:fs/promises';
+import { mkdir, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { hashProjectPath } from '../../../storage/base-store.js';
 import { getAffectedPages } from './dirty-flag-map.js';
-// Debounce state (module-level, intentionally mutable)
-let debounceTimer = null;
-const pendingStores = new Set();
+// Debounce state keyed by projectPath to avoid cross-project interference
+const debounceTimers = new Map();
+const pendingStoresPerProject = new Map();
 /**
  * Schedule a debounced regeneration (500 ms window).
- * Multiple calls within the window are coalesced.
+ * Multiple calls within the window are coalesced per project.
  */
 export function scheduleRegeneration(projectPath, changedStores) {
+    const pending = pendingStoresPerProject.get(projectPath) ?? new Set();
     for (const s of changedStores) {
-        pendingStores.add(s);
+        pending.add(s);
     }
-    if (debounceTimer) {
-        clearTimeout(debounceTimer);
+    pendingStoresPerProject.set(projectPath, pending);
+    const existing = debounceTimers.get(projectPath);
+    if (existing) {
+        clearTimeout(existing);
     }
-    debounceTimer = setTimeout(() => {
-        const stores = [...pendingStores];
-        pendingStores.clear();
-        debounceTimer = null;
+    const timer = setTimeout(() => {
+        const stores = [...pending];
+        pendingStoresPerProject.delete(projectPath);
+        debounceTimers.delete(projectPath);
         regeneratePages(projectPath, stores).catch((err) => {
-            console.error('[Planu] Portal regeneration failed:', err);
+            const message = err instanceof Error ? err.message : String(err);
+            console.error('[Planu] Portal regeneration failed for', projectPath, ':', message);
         });
     }, 500);
+    debounceTimers.set(projectPath, timer);
 }
 /**
  * Immediately regenerate all portal pages affected by the given store changes.
+ * Creates planu/ directory if it does not exist.
  * Returns the list of page keys that were successfully written.
  * Never throws.
  */
 export async function regeneratePages(projectPath, changedStores) {
     const planuDir = join(projectPath, 'planu');
-    if (!existsSync(planuDir)) {
+    try {
+        await mkdir(planuDir, { recursive: true });
+    }
+    catch {
         return [];
     }
     const pages = getAffectedPages(changedStores);

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

@@ -1 +1 @@
-{"version":3,"file":"portal-regenerator.js","sourceRoot":"","sources":["../../../../src/engine/doc-generator/portal/portal-regenerator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"portal-regenerator.js","sourceRoot":"","sources":["../../../../src/engine/doc-generator/portal/portal-regenerator.ts"],"names":[],"mappings":"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"}

package/dist/engine/feedback/triage.d.ts

@@ -0,0 +1,16 @@
+import type { FeedbackEntry, TriageGroup } from '../../types/index.js';
+/**
+ * Compute a similarity score between two strings using Jaccard index on word sets.
+ * Stop words are excluded. Returns a value in [0, 1].
+ */
+export declare function similarityScore(a: string, b: string): number;
+/**
+ * Group similar pending feedback entries into triage groups.
+ * Two entries are grouped if their title similarity exceeds the threshold (default 0.5).
+ */
+export declare function triageFeedback(entries: FeedbackEntry[], threshold?: number): TriageGroup[];
+/**
+ * Format a list of triage groups as a markdown report.
+ */
+export declare function formatTriageReport(groups: TriageGroup[]): string;
+//# sourceMappingURL=triage.d.ts.map

package/dist/engine/feedback/triage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage.d.ts","sourceRoot":"","sources":["../../../src/engine/feedback/triage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA+CnE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAc5D;AAgBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,SAAS,SAAM,GAAG,WAAW,EAAE,CAoCvF;AAoCD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CA2ChE"}

package/dist/engine/feedback/triage.js

@@ -0,0 +1,165 @@
+// ---------------------------------------------------------------------------
+// Stop words excluded from similarity calculation
+// ---------------------------------------------------------------------------
+const STOP_WORDS = new Set([
+    'the',
+    'a',
+    'an',
+    'is',
+    'are',
+    'was',
+    'were',
+    'it',
+    'its',
+    'in',
+    'on',
+    'at',
+    'to',
+    'for',
+    'of',
+    'and',
+    'or',
+    'but',
+    'not',
+    'with',
+    'this',
+    'that',
+    'i',
+    'we',
+    'my',
+    'our',
+    'does',
+    'do',
+    'can',
+    'cannot',
+    'could',
+    'should',
+    'when',
+    'if',
+]);
+// ---------------------------------------------------------------------------
+// Public: Similarity score (Jaccard word overlap)
+// ---------------------------------------------------------------------------
+/**
+ * Compute a similarity score between two strings using Jaccard index on word sets.
+ * Stop words are excluded. Returns a value in [0, 1].
+ */
+export function similarityScore(a, b) {
+    const tokensA = tokenize(a);
+    const tokensB = tokenize(b);
+    if (tokensA.size === 0 && tokensB.size === 0) {
+        return 1;
+    }
+    if (tokensA.size === 0 || tokensB.size === 0) {
+        return 0;
+    }
+    const intersection = [...tokensA].filter((w) => tokensB.has(w)).length;
+    const union = new Set([...tokensA, ...tokensB]).size;
+    return union === 0 ? 0 : intersection / union;
+}
+function tokenize(text) {
+    return new Set(text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter((w) => w.length > 1 && !STOP_WORDS.has(w)));
+}
+// ---------------------------------------------------------------------------
+// Public: Group pending feedback by similarity
+// ---------------------------------------------------------------------------
+/**
+ * Group similar pending feedback entries into triage groups.
+ * Two entries are grouped if their title similarity exceeds the threshold (default 0.5).
+ */
+export function triageFeedback(entries, threshold = 0.5) {
+    const pending = entries.filter((e) => e.status === 'pending');
+    const visited = new Set();
+    const groups = [];
+    for (const entry of pending) {
+        if (visited.has(entry.id)) {
+            continue;
+        }
+        visited.add(entry.id);
+        const similar = [];
+        for (const other of pending) {
+            if (visited.has(other.id)) {
+                continue;
+            }
+            if (similarityScore(entry.title, other.title) > threshold) {
+                similar.push(other);
+                visited.add(other.id);
+            }
+        }
+        const totalCount = 1 + similar.length;
+        const suggestedAction = determineSuggestedAction(totalCount, entry);
+        const suggestedSpecTitle = suggestedAction !== 'dismiss' ? buildSpecTitle(entry, similar) : undefined;
+        groups.push({
+            representative: entry,
+            similar,
+            suggestedAction,
+            suggestedSpecTitle,
+        });
+    }
+    return groups;
+}
+function determineSuggestedAction(count, entry) {
+    if (count >= 3) {
+        return 'create_spec';
+    }
+    if (count >= 2 || entry.specId) {
+        return 'merge_with_existing';
+    }
+    return 'dismiss';
+}
+function buildSpecTitle(representative, similar) {
+    // Use the most-voted entry's title as the base if votes differ
+    const all = [representative, ...similar];
+    const topVoted = all.reduce((best, e) => ((e.votes ?? 0) > (best.votes ?? 0) ? e : best), representative);
+    return topVoted.title;
+}
+// ---------------------------------------------------------------------------
+// Public: Format triage report as markdown
+// ---------------------------------------------------------------------------
+const TYPE_EMOJI = {
+    bug: 'Bug',
+    feature: 'Feature',
+    suggestion: 'Suggestion',
+    dx: 'DX',
+};
+/**
+ * Format a list of triage groups as a markdown report.
+ */
+export function formatTriageReport(groups) {
+    if (groups.length === 0) {
+        return '# Feedback Triage\n\nNo pending feedback to triage.';
+    }
+    const priority = groups.filter((g) => g.suggestedAction === 'create_spec' || 1 + g.similar.length >= 3);
+    const individual = groups.filter((g) => g.suggestedAction !== 'create_spec' && 1 + g.similar.length < 3);
+    const lines = ['# Feedback Triage', ''];
+    if (priority.length > 0) {
+        lines.push('## Priority Groups (3+ similar)', '');
+        for (const group of priority) {
+            const total = 1 + group.similar.length;
+            const ids = [group.representative.id, ...group.similar.map((s) => s.id)].join(', ');
+            lines.push(`### "${group.representative.title}" (${total} reports)`);
+            lines.push(`- Reports: ${ids}`);
+            if (group.suggestedSpecTitle) {
+                lines.push(`- Suggested: Create spec — "${group.suggestedSpecTitle}"`);
+            }
+            lines.push('');
+        }
+    }
+    if (individual.length > 0) {
+        lines.push('## Individual Items', '');
+        lines.push('| ID | Type | Title | Action |');
+        lines.push('|----|------|-------|--------|');
+        for (const group of individual) {
+            const e = group.representative;
+            const typeLabel = TYPE_EMOJI[e.type] ?? e.type;
+            lines.push(`| ${e.id} | ${typeLabel} | ${e.title} | ${group.suggestedAction.replace(/_/g, ' ')} |`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=triage.js.map

package/dist/engine/feedback/triage.js.map

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

package/dist/engine/hooks-reconciler.d.ts

@@ -0,0 +1,7 @@
+import type { HooksReconciliation } from '../types/index.js';
+/**
+ * Analyse git hooks against detected project capabilities and report drift.
+ * Never throws — returns a zero-score result on unexpected errors.
+ */
+export declare function reconcileHooks(projectPath: string): HooksReconciliation;
+//# sourceMappingURL=hooks-reconciler.d.ts.map

package/dist/engine/hooks-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-reconciler.d.ts","sourceRoot":"","sources":["../../src/engine/hooks-reconciler.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,mBAAmB,EAIpB,MAAM,mBAAmB,CAAC;AAyN3B;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CA8CvE"}