@planu/cli 0.96.5 → 0.97.0

package/dist/engine/property-test-generator.js.map

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

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

@@ -0,0 +1,21 @@
+import type { EvalScenario, SkillEvalResult } from '../types/skill-eval.js';
+/**
+ * Evaluate a skill file at the given path against the provided scenarios.
+ * Reads .claude/skills/{skillName}.md from the skill path.
+ */
+export declare function evaluateSkill(skillPath: string, scenarios: EvalScenario[]): Promise<SkillEvalResult>;
+/**
+ * Evaluate a rule file at the given path against the provided scenarios.
+ * Reads .claude/rules/{ruleName}.md from the rule path.
+ */
+export declare function evaluateRule(rulePath: string, scenarios: EvalScenario[]): Promise<SkillEvalResult>;
+/**
+ * Resolve the absolute path to a skill file under a project root.
+ * Returns the resolved path (may not exist yet — caller decides how to handle).
+ */
+export declare function resolveSkillPath(projectPath: string, skillName: string): string;
+/**
+ * Resolve the absolute path to a rule file under a project root.
+ */
+export declare function resolveRulePath(projectPath: string, ruleName: string): string;
+//# sourceMappingURL=skill-evaluator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-evaluator.d.ts","sourceRoot":"","sources":["../../src/engine/skill-evaluator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAkB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AA8H5F;;;GAGG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,EAAE,GACxB,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,YAAY,EAAE,GACxB,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG7E"}

package/dist/engine/skill-evaluator.js

@@ -0,0 +1,126 @@
+// engine/skill-evaluator.ts — Evaluates skill and rule quality against test scenarios (SPEC-316)
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Read a file from disk, returning empty string if it does not exist.
+ */
+async function readContent(filePath) {
+    if (!existsSync(filePath)) {
+        return '';
+    }
+    return readFile(filePath, 'utf-8');
+}
+/**
+ * Evaluate a single scenario against the given content.
+ * A criterion passes if it appears (case-insensitive) somewhere in the content
+ * OR in the expectedOutput section of the content.
+ */
+function evaluateScenario(content, scenario) {
+    const lower = content.toLowerCase();
+    const expectedLower = scenario.expectedOutput.toLowerCase();
+    const failures = [];
+    for (const criterion of scenario.criteria) {
+        const criterionLower = criterion.toLowerCase();
+        const inContent = lower.includes(criterionLower);
+        const inExpected = expectedLower.includes(criterionLower);
+        if (!inContent && !inExpected) {
+            failures.push(criterion);
+        }
+    }
+    const total = scenario.criteria.length;
+    const passed = total - failures.length;
+    const score = total === 0 ? 1.0 : passed / total;
+    return {
+        input: scenario.input,
+        passed: failures.length === 0,
+        score,
+        failures,
+    };
+}
+/**
+ * Build recommendations based on scenario results.
+ */
+function buildRecommendations(skillName, results, passRate) {
+    const recommendations = [];
+    if (passRate < 0.5) {
+        recommendations.push(`${skillName} covers fewer than half of tested scenarios — consider a major revision.`);
+    }
+    else if (passRate < 0.8) {
+        recommendations.push(`${skillName} passes ${Math.round(passRate * 100)}% of scenarios — review failing criteria.`);
+    }
+    // Collect the most common missing criteria across all failures
+    const failureCounts = new Map();
+    for (const r of results) {
+        for (const f of r.failures) {
+            failureCounts.set(f, (failureCounts.get(f) ?? 0) + 1);
+        }
+    }
+    const sorted = [...failureCounts.entries()].sort((a, b) => b[1] - a[1]);
+    const top = sorted.slice(0, 3);
+    for (const [criterion, count] of top) {
+        recommendations.push(`Add coverage for "${criterion}" — missing in ${String(count)} scenario(s).`);
+    }
+    if (recommendations.length === 0) {
+        recommendations.push(`${skillName} meets all evaluated criteria — no changes needed.`);
+    }
+    return recommendations;
+}
+/**
+ * Core evaluation logic used by both evaluateSkill and evaluateRule.
+ */
+async function evaluate(filePath, displayName, scenarios) {
+    const content = await readContent(filePath);
+    const scenarioResults = scenarios.map((s) => evaluateScenario(content, s));
+    const passedCount = scenarioResults.filter((r) => r.passed).length;
+    const passRate = scenarios.length === 0 ? 1.0 : passedCount / scenarios.length;
+    const avgScore = scenarioResults.length === 0
+        ? 1.0
+        : scenarioResults.reduce((sum, r) => sum + r.score, 0) / scenarioResults.length;
+    const recommendations = buildRecommendations(displayName, scenarioResults, passRate);
+    return {
+        skillName: displayName,
+        passRate,
+        avgScore,
+        scenarios: scenarioResults,
+        recommendations,
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Evaluate a skill file at the given path against the provided scenarios.
+ * Reads .claude/skills/{skillName}.md from the skill path.
+ */
+export async function evaluateSkill(skillPath, scenarios) {
+    const name = skillPath.split('/').pop() ?? skillPath;
+    return evaluate(skillPath, name.replace(/\.md$/i, ''), scenarios);
+}
+/**
+ * Evaluate a rule file at the given path against the provided scenarios.
+ * Reads .claude/rules/{ruleName}.md from the rule path.
+ */
+export async function evaluateRule(rulePath, scenarios) {
+    const name = rulePath.split('/').pop() ?? rulePath;
+    return evaluate(rulePath, name.replace(/\.md$/i, ''), scenarios);
+}
+/**
+ * Resolve the absolute path to a skill file under a project root.
+ * Returns the resolved path (may not exist yet — caller decides how to handle).
+ */
+export function resolveSkillPath(projectPath, skillName) {
+    const normalized = skillName.endsWith('.md') ? skillName : `${skillName}.md`;
+    return join(projectPath, '.claude', 'skills', normalized);
+}
+/**
+ * Resolve the absolute path to a rule file under a project root.
+ */
+export function resolveRulePath(projectPath, ruleName) {
+    const normalized = ruleName.endsWith('.md') ? ruleName : `${ruleName}.md`;
+    return join(projectPath, '.claude', 'rules', normalized);
+}
+//# sourceMappingURL=skill-evaluator.js.map

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

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

package/dist/engine/spec-quality-scorer.d.ts

@@ -0,0 +1,4 @@
+import type { Spec } from '../types/index.js';
+import type { SpecQualityReport } from '../types/spec-quality.js';
+export declare function scoreSpecQuality(spec: Spec): Promise<SpecQualityReport>;
+//# sourceMappingURL=spec-quality-scorer.d.ts.map

package/dist/engine/spec-quality-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-quality-scorer.d.ts","sourceRoot":"","sources":["../../src/engine/spec-quality-scorer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAIV,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AA8UlC,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmC7E"}

package/dist/engine/spec-quality-scorer.js

@@ -0,0 +1,334 @@
+// engine/spec-quality-scorer.ts — Spec quality scoring logic (SPEC-314)
+import { readFile } from 'node:fs/promises';
+import { stripFrontmatter } from './frontmatter-parser.js';
+// ── Constants ────────────────────────────────────────────────────────────────
+const MAX_DIMENSION_SCORE = 25;
+const VAGUE_WORDS = [
+    'works',
+    'fast',
+    'easy',
+    'good',
+    'simple',
+    'nice',
+    'better',
+    'quickly',
+    'efficiently',
+    'properly',
+    'correctly',
+    'seamlessly',
+    'robust',
+    'scalable',
+    'intuitive',
+];
+const CONTRADICTION_PAIRS = [
+    ['always', 'never'],
+    ['mandatory', 'optional'],
+    ['required', 'not required'],
+    ['must', 'must not'],
+    ['synchronous', 'asynchronous'],
+    ['blocking', 'non-blocking'],
+];
+// ── Internal helpers ─────────────────────────────────────────────────────────
+function gradeFromTotal(total) {
+    if (total >= 90) {
+        return 'A';
+    }
+    if (total >= 75) {
+        return 'B';
+    }
+    if (total >= 60) {
+        return 'C';
+    }
+    if (total >= 45) {
+        return 'D';
+    }
+    return 'F';
+}
+async function readSpecContent(spec) {
+    if (!spec.specPath) {
+        return '';
+    }
+    try {
+        const raw = await readFile(spec.specPath, 'utf-8');
+        return stripFrontmatter(raw);
+    }
+    catch {
+        return '';
+    }
+}
+async function readTechnicalContent(spec) {
+    if (!spec.technicalPath) {
+        return '';
+    }
+    try {
+        const raw = await readFile(spec.technicalPath, 'utf-8');
+        return stripFrontmatter(raw);
+    }
+    catch {
+        return '';
+    }
+}
+function extractCriteriaLines(content) {
+    return content
+        .split('\n')
+        .filter((line) => /^- \[[ x]\]/.test(line.trim()))
+        .map((line) => line.trim());
+}
+// ── Dimension scorers ────────────────────────────────────────────────────────
+function scoreCompleteness(spec, content) {
+    const issues = [];
+    const recommendations = [];
+    let score = 0;
+    // Title present (5 pts)
+    if (spec.title.trim().length > 5) {
+        score += 5;
+    }
+    else {
+        issues.push('Title is missing or too short');
+        recommendations.push('Add a descriptive title (>5 chars)');
+    }
+    // Description / body present (5 pts)
+    const bodyLength = content.trim().length;
+    if (bodyLength > 100) {
+        score += 5;
+    }
+    else {
+        issues.push('Spec body is missing or too brief');
+        recommendations.push('Add a description with context and motivation');
+    }
+    // Acceptance criteria present (5 pts)
+    const criteriaLines = extractCriteriaLines(content);
+    if (criteriaLines.length >= 3) {
+        score += 5;
+    }
+    else if (criteriaLines.length >= 1) {
+        score += 2;
+        issues.push('Less than 3 acceptance criteria found');
+        recommendations.push('Add at least 3 acceptance criteria');
+    }
+    else {
+        issues.push('No acceptance criteria found');
+        recommendations.push('Add acceptance criteria in checkbox format (- [ ] ...)');
+    }
+    // Scope set to non-default (5 pts) — cast to handle partial specs at runtime
+    const scope = spec.scope;
+    if (scope?.trim().length) {
+        score += 5;
+    }
+    else {
+        issues.push('Scope not defined');
+        recommendations.push('Set scope: trivial | feature | cross-module | architectural');
+    }
+    // Estimation present (5 pts) — check devHours is non-zero as a proxy
+    const estimation = spec.estimation;
+    const hasEstimation = (estimation?.devHours ?? 0) > 0;
+    if (hasEstimation) {
+        score += 5;
+    }
+    else {
+        issues.push('No estimation provided');
+        recommendations.push('Add a time estimation using the estimate tool');
+    }
+    return { score, maxScore: MAX_DIMENSION_SCORE, issues, recommendations };
+}
+function scoreTestability(criteriaLines) {
+    const issues = [];
+    const recommendations = [];
+    let score = MAX_DIMENSION_SCORE;
+    if (criteriaLines.length === 0) {
+        return {
+            score: 0,
+            maxScore: MAX_DIMENSION_SCORE,
+            issues: ['No acceptance criteria to evaluate testability'],
+            recommendations: ['Add verifiable acceptance criteria'],
+        };
+    }
+    // Penalize vague words (up to -15 pts)
+    let vagueCount = 0;
+    for (const line of criteriaLines) {
+        const lower = line.toLowerCase();
+        const found = VAGUE_WORDS.filter((w) => {
+            const pattern = new RegExp(`\\b${w}\\b`);
+            return pattern.test(lower);
+        });
+        if (found.length > 0) {
+            vagueCount++;
+            issues.push(`Vague criterion (${found.join(', ')}): "${line.slice(0, 70)}"`);
+        }
+    }
+    const vagueRatio = vagueCount / criteriaLines.length;
+    if (vagueRatio >= 0.5) {
+        score -= 15;
+        recommendations.push('Rewrite criteria using specific, measurable outcomes');
+    }
+    else if (vagueRatio > 0) {
+        score -= Math.round(vagueRatio * 10);
+        recommendations.push('Replace vague words with specific, verifiable conditions');
+    }
+    // Reward for many criteria (bonus up to +5 absorbed in initial 25)
+    if (criteriaLines.length < 3) {
+        score -= 5;
+        recommendations.push('Add more acceptance criteria (aim for 5+)');
+    }
+    return {
+        score: Math.max(0, Math.min(MAX_DIMENSION_SCORE, score)),
+        maxScore: MAX_DIMENSION_SCORE,
+        issues,
+        recommendations,
+    };
+}
+function scoreAmbiguity(content, criteriaLines) {
+    const issues = [];
+    const recommendations = [];
+    let score = MAX_DIMENSION_SCORE;
+    if (content.trim().length === 0) {
+        return {
+            score: 0,
+            maxScore: MAX_DIMENSION_SCORE,
+            issues: ['No spec content to check for ambiguity'],
+            recommendations: ['Add spec content with clear requirements'],
+        };
+    }
+    const lower = content.toLowerCase();
+    // Check for contradiction pairs (-3 pts each, max -9)
+    let contradictions = 0;
+    for (const [termA, termB] of CONTRADICTION_PAIRS) {
+        if (lower.includes(termA) && lower.includes(termB)) {
+            contradictions++;
+            if (contradictions <= 3) {
+                issues.push(`Potential contradiction: "${termA}" and "${termB}" both appear in spec`);
+            }
+        }
+    }
+    if (contradictions > 0) {
+        score -= Math.min(9, contradictions * 3);
+        recommendations.push('Review and resolve contradictory requirements');
+    }
+    // Check for undefined terms (TBD, TODO, FIXME) (-3 pts each, max -9)
+    const undefinedTerms = ['tbd', 'todo', 'fixme', 'placeholder', 'to be defined', 'to be decided'];
+    let undefinedCount = 0;
+    for (const term of undefinedTerms) {
+        if (lower.includes(term)) {
+            undefinedCount++;
+            issues.push(`Undefined placeholder found: "${term}"`);
+        }
+    }
+    if (undefinedCount > 0) {
+        score -= Math.min(9, undefinedCount * 3);
+        recommendations.push('Replace all TBD/TODO/FIXME markers with concrete requirements');
+    }
+    // Check for edge case coverage: criteria with error/failure/invalid/empty (-4 if missing)
+    const edgeCaseKeywords = ['error', 'fail', 'invalid', 'empty', 'null', 'missing', 'timeout'];
+    const hasEdgeCases = criteriaLines.length > 0 &&
+        criteriaLines.some((line) => {
+            const l = line.toLowerCase();
+            return edgeCaseKeywords.some((k) => l.includes(k));
+        });
+    if (criteriaLines.length >= 3 && !hasEdgeCases) {
+        score -= 4;
+        issues.push('No edge case criteria found (error, failure, invalid inputs)');
+        recommendations.push('Add criteria covering error conditions and edge cases');
+    }
+    return {
+        score: Math.max(0, Math.min(MAX_DIMENSION_SCORE, score)),
+        maxScore: MAX_DIMENSION_SCORE,
+        issues,
+        recommendations,
+    };
+}
+function scoreRisk(spec, technicalContent) {
+    const issues = [];
+    const recommendations = [];
+    let score = MAX_DIMENSION_SCORE;
+    // Cross-module dependencies increase risk (-5 if many deps)
+    if (spec.dependencies.length >= 3) {
+        score -= 5;
+        issues.push(`High dependency count (${spec.dependencies.length} deps): ${spec.dependencies.join(', ')}`);
+        recommendations.push('Document dependency risks and verify all deps are done before starting');
+    }
+    else if (spec.dependencies.length > 0) {
+        score -= 2;
+        issues.push(`Has ${spec.dependencies.length} dependencies — verify they are implemented`);
+    }
+    // Architectural scope multiplies risk (-5 if architectural)
+    if (spec.scope === 'architectural') {
+        score -= 5;
+        issues.push('Architectural scope — higher risk of cross-cutting impact');
+        recommendations.push('Ensure ADRs and architecture docs are updated');
+    }
+    else if (spec.scope === 'cross-module') {
+        score -= 2;
+        issues.push('Cross-module scope — coordinate with other teams/specs');
+    }
+    // Missing NFRs in technical content (-5 if technical file exists but no NFRs)
+    if (technicalContent.trim().length > 50) {
+        const lowerTech = technicalContent.toLowerCase();
+        const nfrKeywords = [
+            'performance',
+            'security',
+            'scalability',
+            'reliability',
+            'availability',
+            'latency',
+            'throughput',
+            'sla',
+            'nfr',
+        ];
+        const hasNfrs = nfrKeywords.some((k) => lowerTech.includes(k));
+        if (!hasNfrs) {
+            score -= 5;
+            issues.push('No non-functional requirements found in technical spec');
+            recommendations.push('Document NFRs: performance, security, scalability constraints');
+        }
+    }
+    else if (technicalContent.trim().length === 0) {
+        score -= 5;
+        issues.push('No technical spec file found');
+        recommendations.push('Run create_spec_tech to generate a technical specification');
+    }
+    // Tags with security/perf keywords indicate risk coverage is good (bonus up to +2 absorbed)
+    const riskTags = ['security', 'performance', 'breaking-change', 'migration', 'data-loss'];
+    const hasRiskTags = spec.tags.some((tag) => riskTags.some((rt) => tag.toLowerCase().includes(rt)));
+    if (hasRiskTags && score < MAX_DIMENSION_SCORE) {
+        // Risk tags show awareness — partial recovery
+        score = Math.min(MAX_DIMENSION_SCORE, score + 2);
+    }
+    return {
+        score: Math.max(0, Math.min(MAX_DIMENSION_SCORE, score)),
+        maxScore: MAX_DIMENSION_SCORE,
+        issues,
+        recommendations,
+    };
+}
+// ── Public API ───────────────────────────────────────────────────────────────
+export async function scoreSpecQuality(spec) {
+    const [specContent, technicalContent] = await Promise.all([
+        readSpecContent(spec),
+        readTechnicalContent(spec),
+    ]);
+    const criteriaLines = extractCriteriaLines(specContent);
+    const completenessDetail = scoreCompleteness(spec, specContent);
+    const testabilityDetail = scoreTestability(criteriaLines);
+    const ambiguityDetail = scoreAmbiguity(specContent, criteriaLines);
+    const riskDetail = scoreRisk(spec, technicalContent);
+    const total = completenessDetail.score + testabilityDetail.score + ambiguityDetail.score + riskDetail.score;
+    const qualityScore = {
+        total,
+        completeness: completenessDetail.score,
+        testability: testabilityDetail.score,
+        ambiguity: ambiguityDetail.score,
+        risk: riskDetail.score,
+        grade: gradeFromTotal(total),
+    };
+    return {
+        specId: spec.id,
+        score: qualityScore,
+        dimensions: {
+            completeness: completenessDetail,
+            testability: testabilityDetail,
+            ambiguity: ambiguityDetail,
+            risk: riskDetail,
+        },
+    };
+}
+//# sourceMappingURL=spec-quality-scorer.js.map

package/dist/engine/spec-quality-scorer.js.map

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

package/dist/engine/spec-template-engine.d.ts

@@ -0,0 +1,26 @@
+import type { MarketplaceTemplate, MarketplaceTemplateManifest, MarketplaceTemplateVar } from '../types/spec-marketplace.js';
+/**
+ * List all available templates (builtin only for now).
+ */
+export declare function listTemplates(): Promise<MarketplaceTemplate[]>;
+/**
+ * Search templates by name, description, or tags. Returns all templates when query is empty.
+ */
+export declare function searchTemplates(query: string): Promise<MarketplaceTemplate[]>;
+/**
+ * Apply variable substitution to template content.
+ * Replaces all occurrences of {{variable_name}} with the provided value.
+ * Missing variables fall back to the variable's default, then to the placeholder.
+ */
+export declare function applyVariables(content: string, variables: Record<string, string>, variableDefs: MarketplaceTemplateVar[]): string;
+/**
+ * Instantiate a template by name with the given variables.
+ * Returns the rendered spec.md content, or null if the template does not exist.
+ */
+export declare function applyTemplate(templateName: string, variables: Record<string, string>): Promise<string | null>;
+/**
+ * Build a MarketplaceTemplateManifest from a spec's content and the provided variable names.
+ * Used for the "publish" flow.
+ */
+export declare function buildPublishManifest(specId: string, templateName: string, variableNames: string[], specContent: string): MarketplaceTemplateManifest;
+//# sourceMappingURL=spec-template-engine.d.ts.map

package/dist/engine/spec-template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-template-engine.d.ts","sourceRoot":"","sources":["../../src/engine/spec-template-engine.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EACvB,MAAM,8BAA8B,CAAC;AA6CtC;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAWpE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAenF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,YAAY,EAAE,sBAAsB,EAAE,GACrC,MAAM,CASR;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EAAE,EACvB,WAAW,EAAE,MAAM,GAClB,2BAA2B,CA6B7B"}