@planu/cli 0.72.0 → 0.73.0

package/dist/storage/feedback-store.js

@@ -0,0 +1,272 @@
+// storage/feedback-store.ts — Feedback Hub persistence (SPEC-188)
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { withFileLock } from './file-mutex.js';
+import { sendFeedbackRemote } from './feedback-remote.js';
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+function getFeedbackPath(dataDir) {
+    return join(dataDir, 'global', 'feedback', 'feedback-ledger.json');
+}
+function ensureDir(dirPath) {
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+}
+// ---------------------------------------------------------------------------
+// Low-level I/O
+// ---------------------------------------------------------------------------
+function readLedger(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 writeLedger(filePath, entries) {
+    ensureDir(dirname(filePath));
+    writeFileSync(filePath, JSON.stringify(entries, null, 2), 'utf-8');
+}
+// ---------------------------------------------------------------------------
+// ID generation
+// ---------------------------------------------------------------------------
+function generateId(entries) {
+    if (entries.length === 0) {
+        return 'FB-001';
+    }
+    const nums = entries
+        .map((e) => {
+        const m = /^FB-(\d+)$/.exec(e.id);
+        return m?.[1] !== undefined ? parseInt(m[1], 10) : 0;
+    })
+        .filter((n) => n > 0);
+    const maxNum = nums.length > 0 ? Math.max(...nums) : 0;
+    return `FB-${String(maxNum + 1).padStart(3, '0')}`;
+}
+// ---------------------------------------------------------------------------
+// Version helper
+// ---------------------------------------------------------------------------
+function readPlanuVersion(dataDir) {
+    // Walk up from dataDir to find package.json
+    const projectRoot = dirname(dataDir.endsWith('/data') ? dataDir : dataDir);
+    const candidates = [
+        join(dataDir, '..', 'package.json'),
+        join(dataDir, '../../package.json'),
+        join(process.cwd(), 'package.json'),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            try {
+                const raw = readFileSync(candidate, 'utf-8');
+                const pkg = JSON.parse(raw);
+                if (typeof pkg.version === 'string') {
+                    return pkg.version;
+                }
+            }
+            catch {
+                // continue
+            }
+        }
+    }
+    void projectRoot;
+    return 'unknown';
+}
+// ---------------------------------------------------------------------------
+// Similarity helper (word overlap)
+// ---------------------------------------------------------------------------
+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',
+]);
+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)));
+}
+function jaccardScore(a, b) {
+    if (a.size === 0 && b.size === 0) {
+        return 1;
+    }
+    const intersection = [...a].filter((w) => b.has(w)).length;
+    const union = new Set([...a, ...b]).size;
+    return union === 0 ? 0 : intersection / union;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Submit a new feedback entry. Auto-generates ID, timestamp, and version.
+ */
+export async function submitFeedback(dataDir, entry) {
+    const filePath = getFeedbackPath(dataDir);
+    const version = readPlanuVersion(dataDir);
+    return withFileLock(filePath, () => {
+        const entries = readLedger(filePath);
+        const id = generateId(entries);
+        const newEntry = {
+            ...entry,
+            id,
+            createdAt: new Date().toISOString(),
+            planuVersion: version,
+        };
+        entries.push(newEntry);
+        writeLedger(filePath, entries);
+        void sendFeedbackRemote({
+            type: newEntry.type,
+            title: newEntry.title,
+            description: newEntry.description,
+            planuVersion: newEntry.planuVersion,
+            stack: newEntry.context?.stack,
+            tags: newEntry.tags,
+        });
+        return Promise.resolve(newEntry);
+    });
+}
+/**
+ * Load and filter feedback entries.
+ */
+export function getFeedback(dataDir, filter) {
+    const filePath = getFeedbackPath(dataDir);
+    let entries = readLedger(filePath);
+    if (filter?.type !== undefined) {
+        entries = entries.filter((e) => e.type === filter.type);
+    }
+    if (filter?.status !== undefined) {
+        entries = entries.filter((e) => e.status === filter.status);
+    }
+    if (filter?.specId !== undefined) {
+        entries = entries.filter((e) => e.specId === filter.specId);
+    }
+    return entries;
+}
+/**
+ * Update an existing feedback entry by ID.
+ */
+export async function updateFeedback(dataDir, id, update) {
+    const filePath = getFeedbackPath(dataDir);
+    return withFileLock(filePath, () => {
+        const entries = readLedger(filePath);
+        const idx = entries.findIndex((e) => e.id === id);
+        if (idx === -1) {
+            return Promise.resolve(null);
+        }
+        const existing = entries[idx];
+        if (existing === undefined) {
+            return Promise.resolve(null);
+        }
+        const merged = { ...existing, ...update, id };
+        entries[idx] = merged;
+        writeLedger(filePath, entries);
+        return Promise.resolve(merged);
+    });
+}
+/**
+ * Mark feedback as resolved, optionally linking spec and PR.
+ */
+export async function resolveFeedback(dataDir, id, specId, prUrl, notes) {
+    return updateFeedback(dataDir, id, {
+        status: 'resolved',
+        resolvedAt: new Date().toISOString(),
+        ...(specId !== undefined ? { specId } : {}),
+        ...(prUrl !== undefined ? { prUrl } : {}),
+        ...(notes !== undefined ? { resolvedNotes: notes } : {}),
+    });
+}
+/**
+ * Compute summary statistics across all feedback.
+ */
+export function getSummary(dataDir) {
+    const entries = readLedger(getFeedbackPath(dataDir));
+    const byType = {
+        bug: 0,
+        feature: 0,
+        suggestion: 0,
+        dx: 0,
+    };
+    const byStatus = {
+        pending: 0,
+        triaged: 0,
+        spec_created: 0,
+        implementing: 0,
+        resolved: 0,
+        dismissed: 0,
+    };
+    let totalResolutionMs = 0;
+    let resolvedCount = 0;
+    for (const e of entries) {
+        byType[e.type] = byType[e.type] + 1;
+        byStatus[e.status] = byStatus[e.status] + 1;
+        if (e.status === 'resolved' && e.resolvedAt) {
+            const created = new Date(e.createdAt).getTime();
+            const resolved = new Date(e.resolvedAt).getTime();
+            if (!isNaN(created) && !isNaN(resolved)) {
+                totalResolutionMs += resolved - created;
+                resolvedCount++;
+            }
+        }
+    }
+    const avgResolutionDays = resolvedCount > 0 ? totalResolutionMs / resolvedCount / (1000 * 60 * 60 * 24) : 0;
+    const topRequests = [...entries]
+        .filter((e) => (e.votes ?? 0) > 0)
+        .sort((a, b) => (b.votes ?? 0) - (a.votes ?? 0))
+        .slice(0, 5)
+        .map((e) => ({ title: e.title, votes: e.votes ?? 0, id: e.id }));
+    return {
+        total: entries.length,
+        byType,
+        byStatus,
+        pending: byStatus.pending,
+        resolved: byStatus.resolved,
+        avgResolutionDays,
+        topRequests,
+    };
+}
+/**
+ * Find feedback entries with title similar to the given string.
+ * Uses Jaccard word overlap. Threshold defaults to 0.3.
+ */
+export function findSimilar(dataDir, title, threshold = 0.3) {
+    const entries = readLedger(getFeedbackPath(dataDir));
+    const queryTokens = tokenize(title);
+    return entries.filter((e) => {
+        const entryTokens = tokenize(e.title);
+        return jaccardScore(queryTokens, entryTokens) >= threshold;
+    });
+}
+//# sourceMappingURL=feedback-store.js.map

package/dist/storage/feedback-store.js.map

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

package/dist/storage/index.d.ts

@@ -16,4 +16,5 @@ export * as errorTelemetryStore from './error-telemetry-store.js';
 export * as specObservabilityStore from './spec-observability-store.js';
 export * as federationStore from './federation-store.js';
 export * as rbacStore from './rbac-store.js';
+export * as conventionBaselineStore from './convention-baseline.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,QAAQ,EACR,SAAS,EACT,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,iBAAiB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,oBAAoB,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,YAAY,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,mBAAmB,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,sBAAsB,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,eAAe,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,QAAQ,EACR,SAAS,EACT,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,iBAAiB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,oBAAoB,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,YAAY,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,mBAAmB,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,sBAAsB,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,eAAe,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,uBAAuB,MAAM,0BAA0B,CAAC"}

package/dist/storage/index.js

@@ -17,4 +17,5 @@ export * as errorTelemetryStore from './error-telemetry-store.js';
 export * as specObservabilityStore from './spec-observability-store.js';
 export * as federationStore from './federation-store.js';
 export * as rbacStore from './rbac-store.js';
+export * as conventionBaselineStore from './convention-baseline.js';
 //# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,OAAO,EACL,eAAe,EACf,QAAQ,EACR,SAAS,EACT,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,iBAAiB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,oBAAoB,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,YAAY,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,mBAAmB,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,sBAAsB,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,eAAe,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,OAAO,EACL,eAAe,EACf,QAAQ,EACR,SAAS,EACT,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,iBAAiB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,oBAAoB,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,YAAY,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,mBAAmB,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,sBAAsB,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,eAAe,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,uBAAuB,MAAM,0BAA0B,CAAC"}

package/dist/tools/convention-sync.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolResult } from '../types/index.js';
+export declare function handleConfigHealth(args: {
+    projectId: string;
+    projectPath: string;
+}): Promise<ToolResult>;
+export declare function registerConfigHealthTool(server: McpServer): void;
+//# sourceMappingURL=convention-sync.d.ts.map

package/dist/tools/convention-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convention-sync.d.ts","sourceRoot":"","sources":["../../src/tools/convention-sync.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAwEpD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,UAAU,CAAC,CAMtB;AAMD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAehE"}

package/dist/tools/convention-sync.js

@@ -0,0 +1,77 @@
+// tools/convention-sync.ts — MCP tool: config_health
+// Shows overall sync percentage between project conventions and their enforcement.
+// READ-ONLY: never modifies files.
+import { z } from 'zod';
+import { calculateConventionSync } from '../engine/convention-sync.js';
+import { getKnowledge } from '../storage/knowledge-store.js';
+import { safeTracked } from './safe-handler.js';
+// ---------------------------------------------------------------------------
+// Zod schema
+// ---------------------------------------------------------------------------
+const configHealthSchema = {
+    projectId: z
+        .string()
+        .max(64)
+        .describe('Project identifier (hash) used to load project knowledge for skills analysis'),
+    projectPath: z.string().max(4096).describe('Absolute path to the project root to analyse'),
+};
+// ---------------------------------------------------------------------------
+// Formatter
+// ---------------------------------------------------------------------------
+function scoreBar(score) {
+    const filled = Math.round(score / 10);
+    return '[' + '█'.repeat(filled) + '░'.repeat(10 - filled) + ']';
+}
+function formatReport(report) {
+    const { overallScore, rulesHealth, skillsHealth, hooksHealth, conventionHealth } = report;
+    const lines = [];
+    lines.push('# Convention Sync Health Report');
+    lines.push('');
+    lines.push(`## Overall Score: ${overallScore}/100  ${scoreBar(overallScore)}`);
+    lines.push('');
+    lines.push(`**${report.summary}**`);
+    lines.push('');
+    lines.push('## Dimension Breakdown');
+    lines.push('');
+    lines.push(`| Dimension       | Score | Bar                        |`);
+    lines.push(`|-----------------|-------|----------------------------|`);
+    lines.push(`| Rules files     | ${String(rulesHealth).padStart(3)}/100 | ${scoreBar(rulesHealth)} |`);
+    lines.push(`| Skills          | ${String(skillsHealth).padStart(3)}/100 | ${scoreBar(skillsHealth)} |`);
+    lines.push(`| Git hooks       | ${String(hooksHealth).padStart(3)}/100 | ${scoreBar(hooksHealth)} |`);
+    lines.push(`| Conventions     | ${String(conventionHealth).padStart(3)}/100 | ${scoreBar(conventionHealth)} |`);
+    lines.push('');
+    if (report.recommendations.length > 0) {
+        lines.push('## Recommendations');
+        lines.push('');
+        for (const rec of report.recommendations) {
+            lines.push(`- ${rec}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+export async function handleConfigHealth(args) {
+    const knowledge = await getKnowledge(args.projectId);
+    const report = await calculateConventionSync(args.projectPath, knowledge);
+    const text = formatReport(report);
+    const isError = report.overallScore === 0;
+    return { content: [{ type: 'text', text }], isError };
+}
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+export function registerConfigHealthTool(server) {
+    server.registerTool('config_health', {
+        description: "Calculate the overall sync percentage between the project's conventions and its enforcement mechanisms (rules files, skills, git hooks, convention violations). Returns a 0–100 weighted score with per-dimension breakdown and prioritised recommendations. READ-ONLY — never modifies files.",
+        inputSchema: configHealthSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            title: 'Config Health',
+        },
+    }, safeTracked('config_health', async (args) => handleConfigHealth(args)));
+}
+//# sourceMappingURL=convention-sync.js.map

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

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

package/dist/tools/create-spec-hu/ac-adapters/convention-adapter.d.ts

@@ -0,0 +1,9 @@
+import type { ProjectKnowledge } from '../../../types/index.js';
+/**
+ * Reads CLAUDE.md and .claude/rules/*.md conventions, then generates
+ * project-specific acceptance criteria that every spec should include.
+ *
+ * Returns `- [ ] ...` lines that enforce the project's own conventions.
+ */
+export declare function generateConventionAcs(knowledge: ProjectKnowledge): string[];
+//# sourceMappingURL=convention-adapter.d.ts.map

package/dist/tools/create-spec-hu/ac-adapters/convention-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convention-adapter.d.ts","sourceRoot":"","sources":["../../../../src/tools/create-spec-hu/ac-adapters/convention-adapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,EAAE,CA0E3E"}

package/dist/tools/create-spec-hu/ac-adapters/convention-adapter.js

@@ -0,0 +1,68 @@
+// tools/create-spec-hu/ac-adapters/convention-adapter.ts — SPEC-191
+// Generates acceptance criteria from project conventions (CLAUDE.md + .claude/rules/)
+import { parseConventions } from '../../../engine/convention-scanner/index.js';
+/**
+ * Reads CLAUDE.md and .claude/rules/*.md conventions, then generates
+ * project-specific acceptance criteria that every spec should include.
+ *
+ * Returns `- [ ] ...` lines that enforce the project's own conventions.
+ */
+export function generateConventionAcs(knowledge) {
+    const projectPath = knowledge.projectPath;
+    if (!projectPath) {
+        return [];
+    }
+    const rules = parseConventions(projectPath);
+    if (rules.length === 0) {
+        return [];
+    }
+    const acs = [];
+    // Group rules by category and generate one AC per category
+    const byCategory = new Map();
+    for (const rule of rules) {
+        const existing = byCategory.get(rule.category) ?? [];
+        existing.push(rule.description);
+        byCategory.set(rule.category, existing);
+    }
+    // Naming conventions
+    const naming = byCategory.get('naming');
+    if (naming) {
+        acs.push('- [ ] All new identifiers follow project naming conventions: ' +
+            naming.slice(0, 3).join('; '));
+    }
+    // i18n conventions
+    const i18n = byCategory.get('i18n');
+    if (i18n) {
+        acs.push('- [ ] No hardcoded user-facing strings — all text uses i18n/translation system');
+    }
+    // Architecture conventions
+    const arch = byCategory.get('architecture');
+    if (arch) {
+        acs.push('- [ ] Import patterns comply with project architecture rules: ' +
+            arch.slice(0, 2).join('; '));
+    }
+    // File limit conventions
+    const fileLimits = byCategory.get('file-limits');
+    if (fileLimits) {
+        acs.push('- [ ] File and function sizes within project limits: ' + fileLimits.slice(0, 2).join('; '));
+    }
+    // Code quality conventions
+    const codeQuality = byCategory.get('code-quality');
+    if (codeQuality) {
+        acs.push('- [ ] Code quality rules enforced: ' + codeQuality.slice(0, 3).join('; '));
+    }
+    // Testing conventions
+    const testing = byCategory.get('testing');
+    if (testing) {
+        acs.push('- [ ] Testing conventions followed: ' + testing.slice(0, 2).join('; '));
+    }
+    // Custom conventions
+    const custom = byCategory.get('custom');
+    if (custom) {
+        for (const desc of custom.slice(0, 3)) {
+            acs.push(`- [ ] ${desc}`);
+        }
+    }
+    return acs;
+}
+//# sourceMappingURL=convention-adapter.js.map

package/dist/tools/create-spec-hu/ac-adapters/convention-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convention-adapter.js","sourceRoot":"","sources":["../../../../src/tools/create-spec-hu/ac-adapters/convention-adapter.ts"],"names":[],"mappings":"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"}

package/dist/tools/create-spec-hu/ac-adapters/custom-template-adapter.d.ts

@@ -0,0 +1,14 @@
+import type { ProjectKnowledge } from '../../../types/index.js';
+/**
+ * Reads `specTemplate` from the project's planu.json and converts each entry
+ * into a `- [ ] ...` acceptance criteria line.
+ *
+ * Supported keys inside `specTemplate`:
+ *  - `acceptanceCriteria` — array of strings, one AC per item
+ *  - `qualityGates`       — array of strings, appended after acceptanceCriteria
+ *
+ * Returns an empty array when planu.json is absent, unreadable, or has no
+ * `specTemplate` section.
+ */
+export declare function generateCustomTemplateAcs(knowledge: ProjectKnowledge): string[];
+//# sourceMappingURL=custom-template-adapter.d.ts.map

package/dist/tools/create-spec-hu/ac-adapters/custom-template-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-template-adapter.d.ts","sourceRoot":"","sources":["../../../../src/tools/create-spec-hu/ac-adapters/custom-template-adapter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,yBAAyB,CAAC;AAkBjF;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAkC/E"}

package/dist/tools/create-spec-hu/ac-adapters/custom-template-adapter.js

@@ -0,0 +1,60 @@
+// tools/create-spec-hu/ac-adapters/custom-template-adapter.ts
+// Generates acceptance criteria from project-defined specTemplate in planu.json
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === 'string');
+}
+function readPlanuJsonConfig(projectPath) {
+    try {
+        const raw = JSON.parse(readFileSync(join(projectPath, 'planu.json'), 'utf-8'));
+        if (typeof raw !== 'object' || raw === null) {
+            return null;
+        }
+        return raw;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Reads `specTemplate` from the project's planu.json and converts each entry
+ * into a `- [ ] ...` acceptance criteria line.
+ *
+ * Supported keys inside `specTemplate`:
+ *  - `acceptanceCriteria` — array of strings, one AC per item
+ *  - `qualityGates`       — array of strings, appended after acceptanceCriteria
+ *
+ * Returns an empty array when planu.json is absent, unreadable, or has no
+ * `specTemplate` section.
+ */
+export function generateCustomTemplateAcs(knowledge) {
+    const projectPath = knowledge.projectPath;
+    if (!projectPath) {
+        return [];
+    }
+    const config = readPlanuJsonConfig(projectPath);
+    if (!config?.specTemplate) {
+        return [];
+    }
+    const { acceptanceCriteria, qualityGates } = config.specTemplate;
+    const acs = [];
+    if (isStringArray(acceptanceCriteria)) {
+        for (const criterion of acceptanceCriteria) {
+            const trimmed = criterion.trim();
+            if (trimmed) {
+                acs.push(`- [ ] ${trimmed}`);
+            }
+        }
+    }
+    if (isStringArray(qualityGates)) {
+        for (const gate of qualityGates) {
+            const trimmed = gate.trim();
+            if (trimmed) {
+                acs.push(`- [ ] ${trimmed}`);
+            }
+        }
+    }
+    return acs;
+}
+//# sourceMappingURL=custom-template-adapter.js.map

package/dist/tools/create-spec-hu/ac-adapters/custom-template-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-template-adapter.js","sourceRoot":"","sources":["../../../../src/tools/create-spec-hu/ac-adapters/custom-template-adapter.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,mBAAmB,CAAC,WAAmB;IAC9C,IAAI,CAAC;QACH,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACxF,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAsB,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CAAC,SAA2B;IACnE,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;IAC1C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC;IAEjE,MAAM,GAAG,GAAa,EAAE,CAAC;IAEzB,IAAI,aAAa,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACtC,KAAK,MAAM,SAAS,IAAI,kBAAkB,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,OAAO,EAAE,CAAC;gBACZ,GAAG,CAAC,IAAI,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,OAAO,EAAE,CAAC;gBACZ,GAAG,CAAC,IAAI,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/tools/create-spec-hu/ac-adapters/index.d.ts

@@ -3,8 +3,12 @@ export { generateArchitectureAcs } from './architecture-adapter.js';
 export { generateStackAcs } from './stack-adapter.js';
 export { generateDatabaseAcs } from './database-adapter.js';
 export { generateTestingAcs } from './testing-adapter.js';
+export { generateConventionAcs } from './convention-adapter.js';
+export { generateCustomTemplateAcs } from './custom-template-adapter.js';
 /**
  * Aggregates ACs from all specialized adapters, deduplicates, and returns the final list.
+ * SPEC-191: Now includes project-specific convention criteria from CLAUDE.md + .claude/rules/.
+ * Custom template ACs (from planu.json specTemplate) are prepended so they appear first.
  *
  * @param knowledge - Detected project knowledge (architecture, stack, DB, testing).
  * @param _specType - Spec type (reserved for future per-type filtering).

package/dist/tools/create-spec-hu/ac-adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/create-spec-hu/ac-adapters/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAMhE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAU/F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/create-spec-hu/ac-adapters/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAQhE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAEzE;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAY/F"}

package/dist/tools/create-spec-hu/ac-adapters/index.js

@@ -1,15 +1,21 @@
-// tools/create-spec-hu/ac-adapters/index.ts
+// tools/create-spec-hu/ac-adapters/index.ts — SPEC-191: convention injection
 // Barrel: aggregates all specialized AC adapters into a single entry point.
 import { generateArchitectureAcs } from './architecture-adapter.js';
 import { generateStackAcs } from './stack-adapter.js';
 import { generateDatabaseAcs } from './database-adapter.js';
 import { generateTestingAcs } from './testing-adapter.js';
+import { generateConventionAcs } from './convention-adapter.js';
+import { generateCustomTemplateAcs } from './custom-template-adapter.js';
 export { generateArchitectureAcs } from './architecture-adapter.js';
 export { generateStackAcs } from './stack-adapter.js';
 export { generateDatabaseAcs } from './database-adapter.js';
 export { generateTestingAcs } from './testing-adapter.js';
+export { generateConventionAcs } from './convention-adapter.js';
+export { generateCustomTemplateAcs } from './custom-template-adapter.js';
 /**
  * Aggregates ACs from all specialized adapters, deduplicates, and returns the final list.
+ * SPEC-191: Now includes project-specific convention criteria from CLAUDE.md + .claude/rules/.
+ * Custom template ACs (from planu.json specTemplate) are prepended so they appear first.
  *
  * @param knowledge - Detected project knowledge (architecture, stack, DB, testing).
  * @param _specType - Spec type (reserved for future per-type filtering).
@@ -17,6 +23,8 @@ export { generateTestingAcs } from './testing-adapter.js';
  */
 export function generateSpecializedAcs(knowledge, _specType) {
     const all = [
+        ...generateCustomTemplateAcs(knowledge),
+        ...generateConventionAcs(knowledge),
         ...generateArchitectureAcs(knowledge),
         ...generateStackAcs(knowledge),
         ...generateDatabaseAcs(knowledge),