@planu/cli 0.99.0 → 1.0.1

package/dist/engine/living-specs/file-scanner.js

@@ -0,0 +1,56 @@
+// engine/living-specs/file-scanner.ts — File existence, line count, export extraction (SPEC-330)
+import { readFile, access } from 'node:fs/promises';
+const EXPORT_REGEX = /export\s+(?:async\s+)?(?:function|class|const)\s+(\w+)/g;
+const FILE_PATH_REGEX = /\b(?:src|tests)\/[\w/.-]+\.ts\b/g;
+/**
+ * Scan a single file: check existence, count lines, extract exports.
+ */
+export async function scanFile(filePath) {
+    try {
+        await access(filePath);
+    }
+    catch {
+        return { path: filePath, exists: false, lineCount: 0, exportsFound: [] };
+    }
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        const lineCount = content.split('\n').length;
+        const exportsFound = extractExports(content);
+        return { path: filePath, exists: true, lineCount, exportsFound };
+    }
+    catch {
+        return { path: filePath, exists: true, lineCount: 0, exportsFound: [] };
+    }
+}
+/**
+ * Extract all exported symbol names from file content.
+ */
+function extractExports(content) {
+    const found = [];
+    let match;
+    const regex = new RegExp(EXPORT_REGEX.source, 'g');
+    while ((match = regex.exec(content)) !== null) {
+        const name = match[1];
+        if (name !== undefined && !found.includes(name)) {
+            found.push(name);
+        }
+    }
+    return found;
+}
+/**
+ * Extract all file paths referenced in technical.md content (src/ and tests/ paths).
+ * Deduplicates results.
+ */
+export function extractFilePaths(technicalMdContent) {
+    const found = [];
+    const regex = new RegExp(FILE_PATH_REGEX.source, 'g');
+    let match;
+    while ((match = regex.exec(technicalMdContent)) !== null) {
+        const p = match[0];
+        if (!found.includes(p)) {
+            found.push(p);
+        }
+    }
+    return found;
+}
+//# sourceMappingURL=file-scanner.js.map

package/dist/engine/living-specs/file-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-scanner.js","sourceRoot":"","sources":["../../../src/engine/living-specs/file-scanner.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,YAAY,GAAG,yDAAyD,CAAC;AAC/E,MAAM,eAAe,GAAG,kCAAkC,CAAC;AAE3D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAC3E,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAC7C,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QAC7C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAC1E,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,OAAe;IACrC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAA6B,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnD,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,kBAA0B;IACzD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtD,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACzD,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/engine/living-specs/index.d.ts

@@ -0,0 +1,9 @@
+import type { LivingSpecReconcileResult } from '../../types/index.js';
+/**
+ * Auto-reconcile a spec against its actual implementation files.
+ * Reads technical.md for file paths, spec.md for criteria,
+ * scans files, matches criteria, updates progress.md.
+ * Never throws -- returns partial result on error.
+ */
+export declare function reconcileSpec(specId: string, projectPath: string): Promise<LivingSpecReconcileResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/living-specs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/living-specs/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAkFtE;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,yBAAyB,CAAC,CAoEpC"}

package/dist/engine/living-specs/index.js

@@ -0,0 +1,137 @@
+// engine/living-specs/index.ts -- Main auto-reconcile entry point (SPEC-330)
+import { readFile, writeFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { glob } from 'glob';
+import { scanFile, extractFilePaths } from './file-scanner.js';
+import { extractCriteriaLines, matchCriteria } from './criteria-matcher.js';
+/**
+ * Find the spec directory for a given specId within the project.
+ * Looks for planu/specs/{specId}-SLUG pattern via glob.
+ */
+async function findSpecDir(specId, projectPath) {
+    const suffix = specId + '-*/';
+    const pattern = join(projectPath, 'planu', 'specs', suffix);
+    const dirs = await glob(pattern, { absolute: true });
+    return dirs[0] ?? null;
+}
+/**
+ * Read a file safely, returning empty string on error.
+ */
+async function readSafe(filePath) {
+    try {
+        await access(filePath);
+        return await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Build the drift flags from missing files.
+ */
+function buildDriftFlags(fileResults) {
+    return fileResults.filter((f) => !f.exists).map((f) => 'DRIFT: ' + f.path + ' missing');
+}
+/**
+ * Append or update the Auto-Reconcile section in progress.md.
+ */
+async function updateProgressMd(progressPath, result) {
+    const existing = await readSafe(progressPath);
+    const coveragePct = result.criteriaTotal > 0 ? Math.round((result.criteriaMet / result.criteriaTotal) * 100) : 0;
+    const driftSection = result.driftFlags.length > 0
+        ? '\n### Drift Flags\n\n' + result.driftFlags.map((f) => '- ' + f).join('\n') + '\n'
+        : '';
+    const section = '\n## Auto-Reconcile\n\n' +
+        '> Last reconciled: ' +
+        result.reconciledAt +
+        '\n\n' +
+        '- Files found: ' +
+        String(result.filesFound) +
+        '\n' +
+        '- Files missing: ' +
+        String(result.filesMissing) +
+        '\n' +
+        '- Criteria met: ' +
+        String(result.criteriaMet) +
+        '/' +
+        String(result.criteriaTotal) +
+        ' (' +
+        String(coveragePct) +
+        '%)' +
+        driftSection +
+        '\n';
+    const AUTO_RECONCILE_MARKER = '## Auto-Reconcile';
+    let newContent;
+    if (existing.includes(AUTO_RECONCILE_MARKER)) {
+        newContent = existing.replace(/\n## Auto-Reconcile[\s\S]*?(?=\n## |\n$|$)/, section);
+    }
+    else {
+        newContent = existing + section;
+    }
+    await writeFile(progressPath, newContent, 'utf-8');
+}
+/**
+ * Auto-reconcile a spec against its actual implementation files.
+ * Reads technical.md for file paths, spec.md for criteria,
+ * scans files, matches criteria, updates progress.md.
+ * Never throws -- returns partial result on error.
+ */
+export async function reconcileSpec(specId, projectPath) {
+    const reconciledAt = new Date().toISOString();
+    const empty = {
+        specId,
+        reconciledAt,
+        filesFound: 0,
+        filesMissing: 0,
+        criteriaMet: 0,
+        criteriaTotal: 0,
+        driftFlags: [],
+        fileResults: [],
+        criteriaResults: [],
+    };
+    try {
+        const specDir = await findSpecDir(specId, projectPath);
+        if (specDir === null) {
+            empty.driftFlags.push('DRIFT: spec directory for ' + specId + ' not found');
+            return empty;
+        }
+        const technicalPath = join(specDir, 'technical.md');
+        const specMdPath = join(specDir, 'spec.md');
+        const progressPath = join(specDir, 'progress.md');
+        const [technicalContent, specMdContent] = await Promise.all([
+            readSafe(technicalPath),
+            readSafe(specMdPath),
+        ]);
+        const relativePaths = extractFilePaths(technicalContent);
+        const absolutePaths = relativePaths.map((p) => join(projectPath, p));
+        const fileResults = await Promise.all(absolutePaths.map((p) => scanFile(p)));
+        const fileResultsWithRelative = fileResults.map((fr, i) => ({
+            ...fr,
+            path: relativePaths[i] ?? fr.path,
+        }));
+        const filesFound = fileResultsWithRelative.filter((f) => f.exists).length;
+        const filesMissing = fileResultsWithRelative.filter((f) => !f.exists).length;
+        const criteriaLines = extractCriteriaLines(specMdContent);
+        const criteriaResults = matchCriteria(criteriaLines, fileResultsWithRelative);
+        const criteriaMet = criteriaResults.filter((c) => c.met).length;
+        const driftFlags = buildDriftFlags(fileResultsWithRelative);
+        const result = {
+            specId,
+            reconciledAt,
+            filesFound,
+            filesMissing,
+            criteriaMet,
+            criteriaTotal: criteriaLines.length,
+            driftFlags,
+            fileResults: fileResultsWithRelative,
+            criteriaResults,
+        };
+        await updateProgressMd(progressPath, result);
+        return result;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ...empty, driftFlags: ['ERROR: ' + message] };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/living-specs/index.js.map

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

package/dist/engine/skills-evaluator/eval-store.d.ts

@@ -0,0 +1,4 @@
+import type { SkillsEvalResult } from '../../types/index.js';
+export declare function saveEvalResult(skillName: string, projectPath: string, result: SkillsEvalResult): Promise<void>;
+export declare function loadEvalResult(skillName: string, projectPath: string): Promise<SkillsEvalResult | null>;
+//# sourceMappingURL=eval-store.d.ts.map

package/dist/engine/skills-evaluator/eval-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval-store.d.ts","sourceRoot":"","sources":["../../../src/engine/skills-evaluator/eval-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAQlC"}

package/dist/engine/skills-evaluator/eval-store.js

@@ -0,0 +1,22 @@
+// engine/skills-evaluator/eval-store.ts — Persistence for skill eval results (SPEC-332)
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+function evalResultPath(skillName, projectPath) {
+    return join(projectPath, '.planu', 'skills', skillName, 'eval-results.json');
+}
+export async function saveEvalResult(skillName, projectPath, result) {
+    const filePath = evalResultPath(skillName, projectPath);
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, JSON.stringify(result, null, 2), 'utf-8');
+}
+export async function loadEvalResult(skillName, projectPath) {
+    const filePath = evalResultPath(skillName, projectPath);
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=eval-store.js.map

package/dist/engine/skills-evaluator/eval-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval-store.js","sourceRoot":"","sources":["../../../src/engine/skills-evaluator/eval-store.ts"],"names":[],"mappings":"AAAA,wFAAwF;AAGxF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,SAAS,cAAc,CAAC,SAAiB,EAAE,WAAmB;IAC5D,OAAO,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,mBAAmB,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAiB,EACjB,WAAmB,EACnB,MAAwB;IAExB,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACxD,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAiB,EACjB,WAAmB;IAEnB,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAqB,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/engine/skills-evaluator/index.d.ts

@@ -0,0 +1,5 @@
+import type { SkillsEvalResult, SkillsEvalScenario } from '../../types/index.js';
+export declare function evaluateSkill(skillName: string, projectPath: string): Promise<SkillsEvalResult>;
+export declare function getEvalResults(skillName: string, projectPath: string): Promise<SkillsEvalResult | null>;
+export declare function listScenarios(skillName: string, projectPath: string): Promise<SkillsEvalScenario[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/skills-evaluator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/skills-evaluator/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAejF,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAoC3B;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAElC;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAG/B"}

package/dist/engine/skills-evaluator/index.js

@@ -0,0 +1,54 @@
+// engine/skills-evaluator/index.ts — Public API for skills evaluation framework (SPEC-332)
+import { readSkillContent, parseEvalScenarios } from './skill-reader.js';
+import { runScenario } from './scenario-runner.js';
+import { saveEvalResult, loadEvalResult } from './eval-store.js';
+function buildRecommendation(score) {
+    if (score >= 0.8) {
+        return 'Excellent — skill is well-configured';
+    }
+    if (score >= 0.5) {
+        return 'Good — minor improvements possible';
+    }
+    return 'Needs review — consider updating eval_scenarios';
+}
+export async function evaluateSkill(skillName, projectPath) {
+    const skillContent = await readSkillContent(skillName, projectPath);
+    const scenarios = parseEvalScenarios(skillContent);
+    if (scenarios.length === 0) {
+        const result = {
+            skillName,
+            evaluatedAt: new Date().toISOString(),
+            scenariosRun: 0,
+            scenariosPassed: 0,
+            overallScore: 0,
+            flagged: true,
+            runResults: [],
+            recommendation: 'No eval_scenarios defined in SKILL.md',
+        };
+        await saveEvalResult(skillName, projectPath, result);
+        return result;
+    }
+    const runResults = scenarios.map((scenario) => runScenario(scenario, skillContent));
+    const scenariosPassed = runResults.filter((r) => r.passed).length;
+    const overallScore = runResults.reduce((sum, r) => sum + r.qualityScore, 0) / runResults.length;
+    const result = {
+        skillName,
+        evaluatedAt: new Date().toISOString(),
+        scenariosRun: scenarios.length,
+        scenariosPassed,
+        overallScore,
+        flagged: overallScore < 0.5,
+        runResults,
+        recommendation: buildRecommendation(overallScore),
+    };
+    await saveEvalResult(skillName, projectPath, result);
+    return result;
+}
+export async function getEvalResults(skillName, projectPath) {
+    return loadEvalResult(skillName, projectPath);
+}
+export async function listScenarios(skillName, projectPath) {
+    const skillContent = await readSkillContent(skillName, projectPath);
+    return parseEvalScenarios(skillContent);
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/skills-evaluator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/skills-evaluator/index.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAG3F,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjE,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QACjB,OAAO,sCAAsC,CAAC;IAChD,CAAC;IACD,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QACjB,OAAO,oCAAoC,CAAC;IAC9C,CAAC;IACD,OAAO,iDAAiD,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,SAAiB,EACjB,WAAmB;IAEnB,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACpE,MAAM,SAAS,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAEnD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAqB;YAC/B,SAAS;YACT,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,YAAY,EAAE,CAAC;YACf,eAAe,EAAE,CAAC;YAClB,YAAY,EAAE,CAAC;YACf,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,EAAE;YACd,cAAc,EAAE,uCAAuC;SACxD,CAAC;QACF,MAAM,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IACpF,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IAClE,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;IAEhG,MAAM,MAAM,GAAqB;QAC/B,SAAS;QACT,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,YAAY,EAAE,SAAS,CAAC,MAAM;QAC9B,eAAe;QACf,YAAY;QACZ,OAAO,EAAE,YAAY,GAAG,GAAG;QAC3B,UAAU;QACV,cAAc,EAAE,mBAAmB,CAAC,YAAY,CAAC;KAClD,CAAC;IAEF,MAAM,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAiB,EACjB,WAAmB;IAEnB,OAAO,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,SAAiB,EACjB,WAAmB;IAEnB,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACpE,OAAO,kBAAkB,CAAC,YAAY,CAAC,CAAC;AAC1C,CAAC"}

package/dist/engine/skills-evaluator/scenario-runner.d.ts

@@ -0,0 +1,7 @@
+import type { SkillsEvalScenario, SkillsEvalRunResult } from '../../types/index.js';
+/**
+ * Evaluate a single scenario against the provided skill content.
+ * Pure function — no async, no I/O.
+ */
+export declare function runScenario(scenario: SkillsEvalScenario, skillContent: string): SkillsEvalRunResult;
+//# sourceMappingURL=scenario-runner.d.ts.map

package/dist/engine/skills-evaluator/scenario-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-runner.d.ts","sourceRoot":"","sources":["../../../src/engine/skills-evaluator/scenario-runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEpF;;;GAGG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,kBAAkB,EAC5B,YAAY,EAAE,MAAM,GACnB,mBAAmB,CAyCrB"}

package/dist/engine/skills-evaluator/scenario-runner.js

@@ -0,0 +1,44 @@
+// engine/skills-evaluator/scenario-runner.ts — Pure scenario evaluation logic (SPEC-332)
+/**
+ * Evaluate a single scenario against the provided skill content.
+ * Pure function — no async, no I/O.
+ */
+export function runScenario(scenario, skillContent) {
+    const lower = skillContent.toLowerCase();
+    const keywordsFound = [];
+    const keywordsMissing = [];
+    for (const keyword of scenario.expectedKeywords) {
+        if (lower.includes(keyword.toLowerCase())) {
+            keywordsFound.push(keyword);
+        }
+        else {
+            keywordsMissing.push(keyword);
+        }
+    }
+    let patternsMatched = 0;
+    const patternsTotal = scenario.expectedPatterns.length;
+    for (const pattern of scenario.expectedPatterns) {
+        try {
+            const regex = new RegExp(pattern, 'i');
+            if (regex.test(skillContent)) {
+                patternsMatched++;
+            }
+        }
+        catch {
+            // Invalid regex counts as unmatched
+        }
+    }
+    const keywordRatio = keywordsFound.length / Math.max(scenario.expectedKeywords.length, 1);
+    const patternRatio = patternsMatched / Math.max(patternsTotal, 1);
+    const qualityScore = keywordRatio * 0.6 + patternRatio * 0.4;
+    return {
+        scenarioName: scenario.name,
+        qualityScore,
+        keywordsFound,
+        keywordsMissing,
+        patternsMatched,
+        patternsTotal,
+        passed: qualityScore >= 0.5,
+    };
+}
+//# sourceMappingURL=scenario-runner.js.map

package/dist/engine/skills-evaluator/scenario-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-runner.js","sourceRoot":"","sources":["../../../src/engine/skills-evaluator/scenario-runner.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAIzF;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,QAA4B,EAC5B,YAAoB;IAEpB,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IAEzC,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAChD,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAC1C,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,MAAM,aAAa,GAAG,QAAQ,CAAC,gBAAgB,CAAC,MAAM,CAAC;IAEvD,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACvC,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC7B,eAAe,EAAE,CAAC;YACpB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1F,MAAM,YAAY,GAAG,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,YAAY,GAAG,GAAG,GAAG,YAAY,GAAG,GAAG,CAAC;IAE7D,OAAO;QACL,YAAY,EAAE,QAAQ,CAAC,IAAI;QAC3B,YAAY;QACZ,aAAa;QACb,eAAe;QACf,eAAe;QACf,aAAa;QACb,MAAM,EAAE,YAAY,IAAI,GAAG;KAC5B,CAAC;AACJ,CAAC"}

package/dist/engine/skills-evaluator/skill-reader.d.ts

@@ -0,0 +1,8 @@
+import type { SkillsEvalScenario } from '../../types/index.js';
+export declare function readSkillContent(skillName: string, projectPath: string): Promise<string>;
+/**
+ * Parse eval_scenarios from skill content frontmatter.
+ * Supports block and inline YAML array format.
+ */
+export declare function parseEvalScenarios(skillContent: string): SkillsEvalScenario[];
+//# sourceMappingURL=skill-reader.d.ts.map

package/dist/engine/skills-evaluator/skill-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-reader.d.ts","sourceRoot":"","sources":["../../../src/engine/skills-evaluator/skill-reader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAA6B,MAAM,sBAAsB,CAAC;AAE1F,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO9F;AAkID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAiB7E"}

package/dist/engine/skills-evaluator/skill-reader.js

@@ -0,0 +1,152 @@
+// engine/skills-evaluator/skill-reader.ts — Reads skill files and parses eval scenarios (SPEC-332)
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export async function readSkillContent(skillName, projectPath) {
+    const filePath = join(projectPath, '.planu', 'skills', skillName, 'SKILL.md');
+    try {
+        return await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+/** Extract the YAML frontmatter block from skill content. */
+function extractFrontmatter(content) {
+    const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(content);
+    return match?.[1] ?? '';
+}
+/** Parse a scalar YAML value (quoted or unquoted). */
+function parseScalar(raw) {
+    const trimmed = raw.trim();
+    const isDoubleQuoted = trimmed.startsWith('"') && trimmed.endsWith('"');
+    const isSingleQuoted = trimmed.startsWith("'") && trimmed.endsWith("'");
+    if (isDoubleQuoted || isSingleQuoted) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+/** Parse an inline YAML array: ["a", "b"] or ['a', 'b']. */
+function parseInlineArray(raw) {
+    const inner = raw.trim().replace(/^\[/, '').replace(/\]$/, '').trim();
+    if (!inner) {
+        return [];
+    }
+    return inner.split(',').map((s) => parseScalar(s.trim()));
+}
+function toScenario(partial) {
+    return {
+        name: partial.name ?? '',
+        description: partial.description ?? '',
+        input: partial.input ?? '',
+        expectedKeywords: partial.expectedKeywords ?? [],
+        expectedPatterns: partial.expectedPatterns ?? [],
+    };
+}
+/** Process a named-field line, returning a patch and updated list mode. */
+function processFieldLine(trimmed) {
+    if (trimmed.startsWith('description:')) {
+        return {
+            patch: { description: parseScalar(trimmed.slice('description:'.length).trim()) },
+            listMode: null,
+            done: false,
+        };
+    }
+    if (trimmed.startsWith('input:')) {
+        return {
+            patch: { input: parseScalar(trimmed.slice('input:'.length).trim()) },
+            listMode: null,
+            done: false,
+        };
+    }
+    if (trimmed.startsWith('expectedKeywords:')) {
+        const rest = trimmed.slice('expectedKeywords:'.length).trim();
+        if (rest.startsWith('[')) {
+            return { patch: { expectedKeywords: parseInlineArray(rest) }, listMode: null, done: false };
+        }
+        return { patch: { expectedKeywords: [] }, listMode: 'keywords', done: false };
+    }
+    if (trimmed.startsWith('expectedPatterns:')) {
+        const rest = trimmed.slice('expectedPatterns:'.length).trim();
+        if (rest.startsWith('[')) {
+            return { patch: { expectedPatterns: parseInlineArray(rest) }, listMode: null, done: false };
+        }
+        return { patch: { expectedPatterns: [] }, listMode: 'patterns', done: false };
+    }
+    // Unknown top-level key — end of eval_scenarios block
+    return { patch: {}, listMode: null, done: true };
+}
+/**
+ * Parse all eval_scenarios blocks from YAML frontmatter text.
+ * Returns an array of complete SkillsEvalScenario objects.
+ */
+function parseScenarioLines(lines) {
+    const results = [];
+    let current = null;
+    let listMode = null;
+    for (const rawLine of lines) {
+        const trimmed = rawLine.trimEnd().trim();
+        if (trimmed.startsWith('- name:')) {
+            if (current?.name !== undefined) {
+                results.push(toScenario(current));
+            }
+            current = {
+                name: parseScalar(trimmed.slice('- name:'.length).trim()),
+                description: '',
+                input: '',
+                expectedKeywords: [],
+                expectedPatterns: [],
+            };
+            listMode = null;
+            continue;
+        }
+        if (!current) {
+            continue;
+        }
+        if (listMode === 'keywords' && trimmed.startsWith('- ')) {
+            current = {
+                ...current,
+                expectedKeywords: [...(current.expectedKeywords ?? []), parseScalar(trimmed.slice(2))],
+            };
+        }
+        else if (listMode === 'patterns' && trimmed.startsWith('- ')) {
+            current = {
+                ...current,
+                expectedPatterns: [...(current.expectedPatterns ?? []), parseScalar(trimmed.slice(2))],
+            };
+        }
+        else if (!trimmed.startsWith('-') && !trimmed.startsWith(' ') && trimmed !== '') {
+            const { patch, listMode: newMode, done } = processFieldLine(trimmed);
+            if (done) {
+                break;
+            }
+            current = { ...current, ...patch };
+            listMode = newMode;
+        }
+    }
+    if (current?.name !== undefined) {
+        results.push(toScenario(current));
+    }
+    return results;
+}
+/**
+ * Parse eval_scenarios from skill content frontmatter.
+ * Supports block and inline YAML array format.
+ */
+export function parseEvalScenarios(skillContent) {
+    try {
+        const frontmatter = extractFrontmatter(skillContent);
+        if (!frontmatter) {
+            return [];
+        }
+        const scenariosStart = frontmatter.indexOf('eval_scenarios:');
+        if (scenariosStart === -1) {
+            return [];
+        }
+        const afterKey = frontmatter.slice(scenariosStart + 'eval_scenarios:'.length);
+        return parseScenarioLines(afterKey.split('\n'));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=skill-reader.js.map

package/dist/engine/skills-evaluator/skill-reader.js.map

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

package/dist/engine/trial/index.d.ts

@@ -0,0 +1,25 @@
+import type { TrialStatus, RequestTrialResult } from '../../types/index.js';
+import { isTrialActive as storeIsTrialActive } from '../../storage/trial-store.js';
+/**
+ * Generates a deterministic, anonymous installation ID from machine attributes.
+ * Uses SHA-256(hostname + platform + arch) — no personal data.
+ */
+export declare function getInstallationId(): string;
+/**
+ * Sends a trial activation request to the Planu trial API.
+ * On success the server inserts a row in the `trials` table and returns
+ * a UUID trialKey + expiry date.
+ */
+export declare function requestTrial(email: string): Promise<RequestTrialResult>;
+/**
+ * Returns the current trial status. Fast local read — no network call.
+ */
+export declare function getTrialStatus(): Promise<TrialStatus>;
+export { storeIsTrialActive as isTrialActive };
+/**
+ * Validates the trial key against the server. If the server says the key is
+ * invalid or revoked, marks the trial as expired locally by clearing trialKey.
+ * Fire-and-forget — never awaited by callers.
+ */
+export declare function validateTrialBackground(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/trial/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/trial/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAGL,aAAa,IAAI,kBAAkB,EAEpC,MAAM,8BAA8B,CAAC;AActC;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAMD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwC7E;AAMD;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAe3D;AAMD,OAAO,EAAE,kBAAkB,IAAI,aAAa,EAAE,CAAC;AAM/C;;;;GAIG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CA6B7D"}