@planu/cli 0.15.2

package/dist/tools/audit.js

@@ -0,0 +1,161 @@
+// tools/audit.ts — Quality evaluation (SOLID, clean code, architecture, security)
+// Uses the auditor engine to scan code and report findings with scores.
+import { specStore, knowledgeStore } from '../storage/index.js';
+import { auditCode } from '../engine/auditor.js';
+import { calcQualityScore } from '../engine/auditor-scoring.js';
+import { parseProjectQualityRules } from '../engine/auditor-claude-md.js';
+import { auditSolidityProject } from '../engine/solidity-auditor.js';
+import { t, ti } from '../i18n/index.js';
+import { createBasicPhaseEvent } from '../engine/phase-tracker.js';
+import { calculateDoraMetrics, hasEnoughHistory, generateRecommendations, classifyMetric, } from '../engine/dora-metrics.js';
+export async function handleAudit(args) {
+    const { path, projectId, categories, specId } = args;
+    // 1. Load project knowledge
+    const knowledge = await knowledgeStore.getKnowledge(projectId);
+    if (!knowledge) {
+        return {
+            content: [{ type: 'text', text: t('project.notFound') }],
+            isError: true,
+        };
+    }
+    const projectPath = knowledge.projectPath;
+    // 2. Determine audit categories
+    const auditCategories = categories ?? knowledge.qualityProfile.enabledCategories;
+    // 3. Get quality profile for custom rules
+    const qualityProfile = knowledge.qualityProfile;
+    // 4. If specId is provided, load spec for context-aware auditing
+    let specContext = null;
+    if (specId) {
+        const spec = await specStore.getSpec(projectId, specId);
+        if (spec) {
+            specContext = spec.title;
+        }
+    }
+    // 5. Load CLAUDE.md custom rules and merge into profile
+    const claudeMdRules = await parseProjectQualityRules(projectPath);
+    const mergedProfile = {
+        ...qualityProfile,
+        customRules: [...qualityProfile.customRules, ...claudeMdRules],
+    };
+    // 5b. Run audit engine
+    const result = await auditCode(path, projectPath, auditCategories, mergedProfile);
+    // 5c. Calculate weighted quality score per category (SPEC-010)
+    const qualityScore = calcQualityScore(result.findings);
+    // 5c-b. SPEC-015b: Run Solidity audit for smart contract projects
+    const isSolidity = knowledge.projectCategory === 'smart-contract' ||
+        (knowledge.framework !== null &&
+            ['hardhat', 'foundry', 'anchor', 'move'].includes(knowledge.framework)) ||
+        /* v8 ignore next 3 */
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        (knowledge.stack ?? []).some((s) => ['solidity', 'hardhat', 'foundry'].includes(s.toLowerCase()));
+    const solidityAudit = isSolidity ? await auditSolidityProject(path) : null;
+    // 5d. Load Constitution and flag strict auto-enforceable principles as critical
+    const constitution = await knowledgeStore.getConstitution(projectId);
+    const constitutionViolations = [];
+    if (constitution) {
+        for (const p of constitution.principles) {
+            if (p.enforceLevel === 'strict' && p.autoEnforceable) {
+                constitutionViolations.push({
+                    principleId: p.id,
+                    file: path,
+                    description: `Verify compliance with strict principle: "${p.principle}"`,
+                    severity: 'error',
+                });
+            }
+        }
+    }
+    // 5e. SPEC-033: Calculate DORA metrics if at least 30 days of history
+    const hasDoraHistory = await hasEnoughHistory(projectPath, 30);
+    const doraMetrics = hasDoraHistory ? await calculateDoraMetrics(projectPath, 30) : null;
+    const doraRecommendations = doraMetrics ? generateRecommendations(doraMetrics) : [];
+    // 6. Build output
+    const output = {
+        path,
+        projectId,
+        ...(specId ? { specId, specContext } : {}),
+        filesAnalyzed: result.filesAnalyzed,
+        score: result.score,
+        summary: {
+            byCategory: result.summary.byCategory,
+            topIssues: result.summary.topIssues,
+            strengths: result.summary.strengths,
+        },
+        findings: result.findings.map((f) => ({
+            file: f.file,
+            ...(f.line ? { line: f.line } : {}),
+            category: f.category,
+            severity: f.severity,
+            rule: f.rule,
+            message: f.message,
+            suggestion: f.suggestion,
+            ...(f.reference ? { reference: f.reference } : {}),
+        })),
+        categoriesChecked: auditCategories,
+        gradeLetter: scoreToGrade(result.score),
+        constitutionViolations,
+        ...(solidityAudit !== null ? { solidityAudit } : {}),
+        ...(doraMetrics !== null
+            ? {
+                engineeringMetrics: {
+                    dora: {
+                        deploymentFrequency: doraMetrics.deploymentFrequency,
+                        deploymentFrequencyTier: classifyMetric('deploymentFrequency', doraMetrics.deploymentFrequency),
+                        leadTimeHours: doraMetrics.leadTimeHours,
+                        leadTimeTier: classifyMetric('leadTimeHours', doraMetrics.leadTimeHours),
+                        changeFailureRate: doraMetrics.changeFailureRate,
+                        changeFailureTier: classifyMetric('changeFailureRate', doraMetrics.changeFailureRate),
+                        mttrHours: doraMetrics.mttrHours,
+                        mttrTier: classifyMetric('mttrHours', doraMetrics.mttrHours),
+                        overallTier: doraMetrics.tier,
+                        periodDays: 30,
+                        commitsAnalyzed: doraMetrics.commitsAnalyzed,
+                        note: 'Calculated from local git history. Accuracy is an approximation.',
+                    },
+                    recommendations: doraRecommendations,
+                },
+            }
+            : {}),
+        qualityScore: {
+            overall: qualityScore.overall,
+            gradeLetter: scoreToGrade(qualityScore.overall),
+            categories: qualityScore.categories.map((c) => ({
+                category: c.category,
+                score: c.score,
+                weight: c.weight,
+                issueCount: c.issueCount,
+                worstSeverity: c.worstSeverity,
+                suggestions: c.suggestions,
+            })),
+            customRulesChecked: claudeMdRules.length,
+        },
+    };
+    return {
+        phaseEvent: createBasicPhaseEvent('audit', 'completed', 100, 'validating'),
+        content: [
+            {
+                type: 'text',
+                text: ti('tools.audit.success', {
+                    score: String(result.score),
+                    findingsCount: String(result.findings.length),
+                }),
+            },
+            { type: 'text', text: JSON.stringify(output, null, 2) },
+        ],
+    };
+}
+function scoreToGrade(score) {
+    if (score >= 90) {
+        return 'A';
+    }
+    if (score >= 80) {
+        return 'B';
+    }
+    if (score >= 70) {
+        return 'C';
+    }
+    if (score >= 60) {
+        return 'D';
+    }
+    return 'F';
+}
+//# sourceMappingURL=audit.js.map

package/dist/tools/audit.js.map

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

package/dist/tools/capture-learning.d.ts

@@ -0,0 +1,3 @@
+import type { CaptureLearningInput, ToolResult } from '../types/index.js';
+export declare function handleCaptureLearning(args: CaptureLearningInput): Promise<ToolResult>;
+//# sourceMappingURL=capture-learning.d.ts.map

package/dist/tools/capture-learning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-learning.d.ts","sourceRoot":"","sources":["../../src/tools/capture-learning.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,oBAAoB,EAGpB,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAqF3F"}

package/dist/tools/capture-learning.js

@@ -0,0 +1,188 @@
+// tools/capture-learning.ts — Capture learned patterns into spec criteria (SPEC-012)
+// Accepts a natural language description, performs semantic dedup against existing
+// spec criteria, and routes new patterns to the most relevant spec.
+import { globalStore } from '../storage/index.js';
+import { extractKeywords, isDuplicate, findBestSpec, formatCriterion, } from '../engine/learning-router.js';
+export async function handleCaptureLearning(args) {
+    const { description, subcommand, lessonType, tags = [] } = args;
+    // --- Subcommand: lesson ---
+    if (subcommand === 'lesson') {
+        return handleLessonCapture(description, lessonType ?? 'bug-pattern', tags);
+    }
+    // --- Main flow: capture pattern into spec criteria ---
+    const patternKeywords = extractKeywords(description);
+    // Build minimal spec descriptors from known specs (static registry)
+    const specDescriptors = buildSpecDescriptors();
+    // 1. Check for semantic duplicates
+    const dupResult = isDuplicate(patternKeywords, specDescriptors);
+    if (dupResult.isDuplicate) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        `Pattern already covered (${String(dupResult.similarity)}% similarity).`,
+                        `Existing spec: ${dupResult.existingSpecId ?? 'unknown'}`,
+                        `Existing criterion: "${dupResult.existingCriterion ?? ''}"`,
+                        'No duplicate criterion inserted.',
+                    ].join('\n'),
+                },
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        action: 'duplicate_detected',
+                        similarity: dupResult.similarity,
+                        existingSpecId: dupResult.existingSpecId,
+                        existingCriterion: dupResult.existingCriterion,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    // 2. Route to best matching spec
+    const targetSpecId = args.specId ?? findBestSpec(patternKeywords, specDescriptors);
+    const formattedCriterion = formatCriterion(description);
+    // 3. Store the pending criterion (persisted as a lesson with 'test-complexity' type
+    //    so it's queryable; future iterations would insert into HU.md)
+    const lessonId = `LEARN-${Date.now().toString(36).toUpperCase()}`;
+    const lesson = {
+        id: lessonId,
+        specId: targetSpecId ?? 'unrouted',
+        type: 'arch-mismatch',
+        description: formattedCriterion,
+        tags: [...patternKeywords.slice(0, 5), 'pending-criterion'],
+        recordedAt: new Date().toISOString(),
+    };
+    await globalStore.saveLessonLearned(lesson);
+    const output = {
+        action: 'criterion_captured',
+        lessonId,
+        targetSpecId: targetSpecId ?? null,
+        formattedCriterion,
+        status: 'pending',
+        message: targetSpecId
+            ? `New criterion added to ${targetSpecId} (status: pending, requires manual review).`
+            : 'No matching spec found. Criterion stored as unrouted pending entry.',
+    };
+    return {
+        content: [
+            {
+                type: 'text',
+                text: output.message,
+            },
+            {
+                type: 'text',
+                text: JSON.stringify(output, null, 2),
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// handleLessonCapture — learn_pattern lesson subcommand
+// ---------------------------------------------------------------------------
+async function handleLessonCapture(description, lessonType, tags) {
+    const keywords = extractKeywords(description);
+    const lessonId = `LESSON-${Date.now().toString(36).toUpperCase()}`;
+    const lesson = {
+        id: lessonId,
+        specId: 'global',
+        type: lessonType,
+        description: description.trim(),
+        tags: [...new Set([...tags, ...keywords.slice(0, 3)])],
+        recordedAt: new Date().toISOString(),
+    };
+    await globalStore.saveLessonLearned(lesson);
+    const output = {
+        action: 'lesson_captured',
+        lessonId,
+        type: lessonType,
+        description: lesson.description,
+        tags: lesson.tags,
+    };
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Lesson captured (${lessonType}): "${lesson.description.slice(0, 80)}..."`,
+            },
+            {
+                type: 'text',
+                text: JSON.stringify(output, null, 2),
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// buildSpecDescriptors — static registry of known specs for routing
+// ---------------------------------------------------------------------------
+function buildSpecDescriptors() {
+    return [
+        {
+            specId: 'SPEC-002',
+            title: 'Create Spec Enhancement',
+            criteria: [],
+            keywords: ['spec', 'create', 'template', 'diagram', 'split', 'hu', 'ficha'],
+        },
+        {
+            specId: 'SPEC-003',
+            title: 'Web Fetcher',
+            criteria: [],
+            keywords: ['web', 'fetch', 'http', 'npm', 'pypi', 'crates', 'registry'],
+        },
+        {
+            specId: 'SPEC-004',
+            title: 'Init Project',
+            criteria: [],
+            keywords: ['init', 'project', 'language', 'framework', 'architecture', 'detection'],
+        },
+        {
+            specId: 'SPEC-005',
+            title: 'DoR DoD Plan',
+            criteria: [],
+            keywords: ['dor', 'dod', 'plan', 'status', 'implementing', 'done', 'red', 'green'],
+        },
+        {
+            specId: 'SPEC-006',
+            title: 'Spec Versioning',
+            criteria: [],
+            keywords: ['version', 'diff', 'cascade', 'drift', 'dependency'],
+        },
+        {
+            specId: 'SPEC-007',
+            title: 'Constitution',
+            criteria: [],
+            keywords: ['constitution', 'principle', 'enforce', 'validation', 'rule'],
+        },
+        {
+            specId: 'SPEC-008',
+            title: 'NLI Engine',
+            criteria: [],
+            keywords: ['nli', 'natural', 'language', 'context', 'intent', 'resolution'],
+        },
+        {
+            specId: 'SPEC-009',
+            title: 'NLI Chains',
+            criteria: [],
+            keywords: ['chain', 'orchestrate', 'phase', 'event', 'experience', 'beginner', 'expert'],
+        },
+        {
+            specId: 'SPEC-010',
+            title: 'Quality Audit',
+            criteria: [],
+            keywords: ['audit', 'quality', 'score', 'solid', 'claude', 'rule'],
+        },
+        {
+            specId: 'SPEC-011',
+            title: 'Auto Learning',
+            criteria: [],
+            keywords: ['learn', 'calibrate', 'registry', 'feedback', 'verified', 'pattern'],
+        },
+        {
+            specId: 'SPEC-012',
+            title: 'Auto Improvement Tokens',
+            criteria: [],
+            keywords: ['token', 'budget', 'improvement', 'override', 'dashboard', 'model'],
+        },
+    ];
+}
+//# sourceMappingURL=capture-learning.js.map

package/dist/tools/capture-learning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-learning.js","sourceRoot":"","sources":["../../src/tools/capture-learning.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,mFAAmF;AACnF,oEAAoE;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,eAAe,EACf,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,8BAA8B,CAAC;AAQtC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAA0B;IACpE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;IAEhE,6BAA6B;IAC7B,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,mBAAmB,CAAC,WAAW,EAAE,UAAU,IAAI,aAAa,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED,wDAAwD;IACxD,MAAM,eAAe,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAErD,oEAAoE;IACpE,MAAM,eAAe,GAAG,oBAAoB,EAAE,CAAC;IAE/C,mCAAmC;IACnC,MAAM,SAAS,GAAG,WAAW,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IAChE,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAC1B,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;wBACJ,4BAA4B,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,gBAAgB;wBACxE,kBAAkB,SAAS,CAAC,cAAc,IAAI,SAAS,EAAE;wBACzD,wBAAwB,SAAS,CAAC,iBAAiB,IAAI,EAAE,GAAG;wBAC5D,kCAAkC;qBACnC,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;gBACD;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,MAAM,EAAE,oBAAoB;wBAC5B,UAAU,EAAE,SAAS,CAAC,UAAU;wBAChC,cAAc,EAAE,SAAS,CAAC,cAAc;wBACxC,iBAAiB,EAAE,SAAS,CAAC,iBAAiB;qBAC/C,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,iCAAiC;IACjC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IACnF,MAAM,kBAAkB,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAExD,oFAAoF;IACpF,mEAAmE;IACnE,MAAM,QAAQ,GAAG,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;IAClE,MAAM,MAAM,GAAkB;QAC5B,EAAE,EAAE,QAAQ;QACZ,MAAM,EAAE,YAAY,IAAI,UAAU;QAClC,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,kBAAkB;QAC/B,IAAI,EAAE,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,mBAAmB,CAAC;QAC3D,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC;IACF,MAAM,WAAW,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG;QACb,MAAM,EAAE,oBAAoB;QAC5B,QAAQ;QACR,YAAY,EAAE,YAAY,IAAI,IAAI;QAClC,kBAAkB;QAClB,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,YAAY;YACnB,CAAC,CAAC,0BAA0B,YAAY,6CAA6C;YACrF,CAAC,CAAC,qEAAqE;KAC1E,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,MAAM,CAAC,OAAO;aACrB;YACD;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,wDAAwD;AACxD,8EAA8E;AAE9E,KAAK,UAAU,mBAAmB,CAChC,WAAmB,EACnB,UAAiC,EACjC,IAAc;IAEd,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,UAAU,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;IAEnE,MAAM,MAAM,GAAkB;QAC5B,EAAE,EAAE,QAAQ;QACZ,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE;QAC/B,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC;IAEF,MAAM,WAAW,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG;QACb,MAAM,EAAE,iBAAiB;QACzB,QAAQ;QACR,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,oBAAoB,UAAU,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM;aACjF;YACD;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,oEAAoE;AACpE,8EAA8E;AAE9E,SAAS,oBAAoB;IAC3B,OAAO;QACL;YACE,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,yBAAyB;YAChC,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC;SAC5E;QACD;YACE,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,aAAa;YACpB,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC;SACxE;QACD;YACE,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,cAAc;YACrB,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,CAAC;SACpF;QACD;YACE,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,cAAc;YACrB,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC;SACnF;QACD;YACE,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,iBAAiB;YACxB,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC;SAChE;QACD;YACE,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,cAAc;YACrB,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,CAAC,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC;SACzE;QACD;YACE,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,YAAY;YACnB,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC;SAC5E;QACD;YACE,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,YAAY;YACnB,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,CAAC;SACzF;QACD;YACE,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,eAAe;YACtB,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC;SACnE;QACD;YACE,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,eAAe;YACtB,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC;SAChF;QACD;YACE,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,yBAAyB;YAChC,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC;SAC/E;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/challenge-spec/agent-challenge-scenarios.d.ts

@@ -0,0 +1,12 @@
+import type { FailureScenario, Spec, ProjectKnowledge } from '../../types/index.js';
+/**
+ * Generate AI agent-specific failure scenarios.
+ * Criteria 4: hallucinations, data leaks, wrong decisions, rate limits, cost.
+ * Criteria 19: prompt injection, infinite loops, hallucinated params, context truncation.
+ */
+export declare function generateAgentChallengeScenarios(spec: Spec, _specContent: string, _knowledge: ProjectKnowledge): FailureScenario[];
+/**
+ * Check whether the spec is an AI agent spec.
+ */
+export declare function isAgentSpec(spec: Spec, specContent: string): boolean;
+//# sourceMappingURL=agent-challenge-scenarios.d.ts.map

package/dist/tools/challenge-spec/agent-challenge-scenarios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-challenge-scenarios.d.ts","sourceRoot":"","sources":["../../../src/tools/challenge-spec/agent-challenge-scenarios.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEpF;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,gBAAgB,GAC3B,eAAe,EAAE,CA2GnB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAapE"}

package/dist/tools/challenge-spec/agent-challenge-scenarios.js

@@ -0,0 +1,107 @@
+// Planu — Agent Challenge Scenarios
+// SPEC-016a criteria 4 and 19: AI agent-specific failure modes for challenge_spec.
+/**
+ * Generate AI agent-specific failure scenarios.
+ * Criteria 4: hallucinations, data leaks, wrong decisions, rate limits, cost.
+ * Criteria 19: prompt injection, infinite loops, hallucinated params, context truncation.
+ */
+export function generateAgentChallengeScenarios(spec, _specContent, _knowledge) {
+    const scenarios = [];
+    // Criterion 19: Hallucinated tool parameters
+    scenarios.push({
+        scenario: `[${spec.id}] Hallucinated Tool Parameters: agent generates plausible-but-incorrect tool call parameters (wrong field names, invalid enum values, fabricated IDs). Tool fails silently or returns unexpected results.`,
+        probability: 'medium',
+        impact: 'high',
+        currentHandling: 'Not addressed in spec',
+        requiredHandling: 'Validate all tool inputs with JSON Schema before execution. Log rejected tool calls for review. Use structured output with strict mode.',
+        dataConsistency: 'Tool call rejections must be idempotent — no partial state from invalid calls.',
+        userExperience: 'Return clear error message explaining what information is needed. Never expose internal tool schemas.',
+    });
+    // Criterion 19: Prompt injection in tool outputs
+    scenarios.push({
+        scenario: `[${spec.id}] Prompt Injection via Tool Outputs: malicious content in tool outputs (web search, database records, user messages) embeds instructions like "Ignore previous instructions and..." to hijack agent behavior.`,
+        probability: 'medium',
+        impact: 'critical',
+        currentHandling: 'Not addressed in spec',
+        requiredHandling: 'Sanitize all tool outputs before injection into prompt. Use separate system/user message boundaries. Implement output filtering for instruction-like patterns.',
+        dataConsistency: 'Injected instructions must not modify persistent state.',
+        userExperience: 'Agent must complete original task, not the injected one. Log suspicious patterns.',
+    });
+    // Criterion 19: Infinite tool call loops
+    scenarios.push({
+        scenario: `[${spec.id}] Infinite Tool Call Loop: agent enters a cycle where tool A result triggers tool B which triggers tool A again. max_iterations not enforced or set too high.`,
+        probability: 'medium',
+        impact: 'high',
+        currentHandling: 'Not addressed in spec',
+        requiredHandling: 'Enforce hard max_iterations limit (default: 10). Track tool call history and detect repeated identical calls. Implement circuit breaker pattern.',
+        dataConsistency: 'Stop execution cleanly — do not apply partial results from interrupted loop.',
+        userExperience: 'Return "reached iteration limit" message with partial results completed so far.',
+    });
+    // Criterion 4: Hallucinations (false facts)
+    scenarios.push({
+        scenario: `[${spec.id}] Factual Hallucination: agent presents fabricated information as fact (wrong dates, non-existent records, incorrect statistics). User acts on false information with real-world consequences.`,
+        probability: 'medium',
+        impact: 'high',
+        currentHandling: 'Not addressed in spec',
+        requiredHandling: 'Ground responses in retrieved context only. Add "sources:" section to all factual claims. Implement hallucination scoring with faithfulness metrics.',
+        dataConsistency: 'Never present unverified data as authoritative.',
+        userExperience: 'Include confidence indicator and source citations in agent responses.',
+    });
+    // Criterion 4: Data leaks
+    scenarios.push({
+        scenario: `[${spec.id}] Sensitive Data Leak: agent retrieves PII, credentials, or business-sensitive data and includes it in responses to unauthorized users. Context window may contain data from other users in shared deployments.`,
+        probability: 'low',
+        impact: 'critical',
+        currentHandling: 'Not addressed in spec',
+        requiredHandling: 'Implement strict data access controls per user session. Scrub PII from agent responses. Isolate context windows per user. Audit all data access.',
+        dataConsistency: 'User A must never access User B data even if both sessions run concurrently.',
+        userExperience: 'Mask sensitive fields (passwords, API keys, SSNs) in all displayed outputs.',
+    });
+    // Criterion 4: Wrong decision from stale data
+    scenarios.push({
+        scenario: `[${spec.id}] Wrong Decision from Stale Data: agent makes critical decision based on cached or outdated data (approves transaction on stale balance, sends duplicate notifications due to eventual consistency).`,
+        probability: 'medium',
+        impact: 'high',
+        currentHandling: 'Not addressed in spec',
+        requiredHandling: 'Refresh critical data at decision time. Implement idempotency keys for all actions. Add confirmation step for high-impact decisions.',
+        dataConsistency: 'All state-changing operations must check current state, not cached state.',
+        userExperience: 'Show data freshness indicator. Require confirmation for irreversible actions.',
+    });
+    // Criterion 4: Rate limits / cost spikes
+    scenarios.push({
+        scenario: `[${spec.id}] Rate Limit Breach and Cost Spike: agent makes excessive API calls in a burst, hitting rate limits and causing service degradation. Worst case: runaway agent generates unexpected billing.`,
+        probability: 'low',
+        impact: 'high',
+        currentHandling: 'Not addressed in spec',
+        requiredHandling: 'Implement token budgeting per session. Add exponential backoff on rate limit errors. Set hard cost cap per request. Alert on unusual token consumption.',
+        dataConsistency: 'Partial results from aborted runs must be rolled back or clearly marked incomplete.',
+        userExperience: 'Inform user of rate limit status. Offer to queue the request for later execution.',
+    });
+    // Criterion 19: Context window truncation behavior
+    scenarios.push({
+        scenario: `[${spec.id}] Context Window Truncation: conversation or tool outputs exceed model context window. Older messages silently truncated. Agent makes decisions based on incomplete information.`,
+        probability: 'medium',
+        impact: 'high',
+        currentHandling: 'Not addressed in spec',
+        requiredHandling: 'Monitor token count during execution. Summarize older context before truncation. Alert when approaching 80% of context limit. Persist critical context externally.',
+        dataConsistency: 'Critical facts must be preserved despite truncation — use explicit memory.',
+        userExperience: 'Notify user when context was summarized. Offer to restore full context from memory.',
+    });
+    return scenarios;
+}
+/**
+ * Check whether the spec is an AI agent spec.
+ */
+export function isAgentSpec(spec, specContent) {
+    const lower = specContent.toLowerCase();
+    const titleLower = spec.title.toLowerCase();
+    return (spec.type === 'agent' ||
+        lower.includes('ai agent') ||
+        lower.includes('agent contract') ||
+        lower.includes('llm') ||
+        lower.includes('tool call') ||
+        titleLower.includes('agent') ||
+        titleLower.includes('assistant') ||
+        titleLower.includes('bot'));
+}
+//# sourceMappingURL=agent-challenge-scenarios.js.map

package/dist/tools/challenge-spec/agent-challenge-scenarios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-challenge-scenarios.js","sourceRoot":"","sources":["../../../src/tools/challenge-spec/agent-challenge-scenarios.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,mFAAmF;AAInF;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAC7C,IAAU,EACV,YAAoB,EACpB,UAA4B;IAE5B,MAAM,SAAS,GAAsB,EAAE,CAAC;IAExC,6CAA6C;IAC7C,SAAS,CAAC,IAAI,CAAC;QACb,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,2MAA2M;QAChO,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,MAAM;QACd,eAAe,EAAE,uBAAuB;QACxC,gBAAgB,EACd,yIAAyI;QAC3I,eAAe,EACb,gFAAgF;QAClF,cAAc,EACZ,uGAAuG;KAC1G,CAAC,CAAC;IAEH,iDAAiD;IACjD,SAAS,CAAC,IAAI,CAAC;QACb,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,+MAA+M;QACpO,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,UAAU;QAClB,eAAe,EAAE,uBAAuB;QACxC,gBAAgB,EACd,gKAAgK;QAClK,eAAe,EAAE,yDAAyD;QAC1E,cAAc,EACZ,mFAAmF;KACtF,CAAC,CAAC;IAEH,yCAAyC;IACzC,SAAS,CAAC,IAAI,CAAC;QACb,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,+JAA+J;QACpL,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,MAAM;QACd,eAAe,EAAE,uBAAuB;QACxC,gBAAgB,EACd,kJAAkJ;QACpJ,eAAe,EAAE,8EAA8E;QAC/F,cAAc,EACZ,iFAAiF;KACpF,CAAC,CAAC;IAEH,4CAA4C;IAC5C,SAAS,CAAC,IAAI,CAAC;QACb,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,gMAAgM;QACrN,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,MAAM;QACd,eAAe,EAAE,uBAAuB;QACxC,gBAAgB,EACd,sJAAsJ;QACxJ,eAAe,EAAE,iDAAiD;QAClE,cAAc,EAAE,uEAAuE;KACxF,CAAC,CAAC;IAEH,0BAA0B;IAC1B,SAAS,CAAC,IAAI,CAAC;QACb,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,iNAAiN;QACtO,WAAW,EAAE,KAAK;QAClB,MAAM,EAAE,UAAU;QAClB,eAAe,EAAE,uBAAuB;QACxC,gBAAgB,EACd,kJAAkJ;QACpJ,eAAe,EAAE,8EAA8E;QAC/F,cAAc,EAAE,6EAA6E;KAC9F,CAAC,CAAC;IAEH,8CAA8C;IAC9C,SAAS,CAAC,IAAI,CAAC;QACb,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,sMAAsM;QAC3N,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,MAAM;QACd,eAAe,EAAE,uBAAuB;QACxC,gBAAgB,EACd,sIAAsI;QACxI,eAAe,EAAE,2EAA2E;QAC5F,cAAc,EAAE,+EAA+E;KAChG,CAAC,CAAC;IAEH,yCAAyC;IACzC,SAAS,CAAC,IAAI,CAAC;QACb,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,8LAA8L;QACnN,WAAW,EAAE,KAAK;QAClB,MAAM,EAAE,MAAM;QACd,eAAe,EAAE,uBAAuB;QACxC,gBAAgB,EACd,yJAAyJ;QAC3J,eAAe,EACb,qFAAqF;QACvF,cAAc,EACZ,mFAAmF;KACtF,CAAC,CAAC;IAEH,mDAAmD;IACnD,SAAS,CAAC,IAAI,CAAC;QACb,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,kLAAkL;QACvM,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,MAAM;QACd,eAAe,EAAE,uBAAuB;QACxC,gBAAgB,EACd,oKAAoK;QACtK,eAAe,EAAE,4EAA4E;QAC7F,cAAc,EACZ,qFAAqF;KACxF,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAU,EAAE,WAAmB;IACzD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,CACL,IAAI,CAAC,IAAI,KAAK,OAAO;QACrB,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC1B,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAChC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QACrB,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC3B,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC5B,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC;QAChC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC3B,CAAC;AACJ,CAAC"}

package/dist/tools/challenge-spec/architecture-challenge-scenarios.d.ts

@@ -0,0 +1,12 @@
+import type { FailureScenario, Spec } from '../../types/index.js';
+/**
+ * Generates aggregate integrity challenges for DDD projects.
+ * Analyzes the spec title and description to generate invariant violation scenarios.
+ */
+export declare function generateDddChallenges(spec: Spec, specContent: string): FailureScenario[];
+/**
+ * Generates pair programming clarity challenge for XP projects.
+ * Evaluates if two developers could implement the spec without additional clarification.
+ */
+export declare function generateXpPairClarityChallenge(spec: Spec, specContent: string): FailureScenario[];
+//# sourceMappingURL=architecture-challenge-scenarios.d.ts.map

package/dist/tools/challenge-spec/architecture-challenge-scenarios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-challenge-scenarios.d.ts","sourceRoot":"","sources":["../../../src/tools/challenge-spec/architecture-challenge-scenarios.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAIlE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe,EAAE,CA2ExF;AAID;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe,EAAE,CAgDjG"}

package/dist/tools/challenge-spec/architecture-challenge-scenarios.js

@@ -0,0 +1,113 @@
+// tools/challenge-spec/architecture-challenge-scenarios.ts — DDD and XP challenges (SPEC-033)
+// === DDD Aggregate Integrity Challenges ===
+/**
+ * Generates aggregate integrity challenges for DDD projects.
+ * Analyzes the spec title and description to generate invariant violation scenarios.
+ */
+export function generateDddChallenges(spec, specContent) {
+    const scenarios = [];
+    // Check if the spec relates to a domain aggregate
+    const hasAggregateContext = /aggregate|domain\s+event|invariant|bounded.context|value\s+object/i.test(specContent) ||
+        /create|update|delete|command/i.test(spec.title);
+    if (!hasAggregateContext) {
+        return scenarios;
+    }
+    // Scenario 1: Aggregate invariant violation on concurrent modification
+    scenarios.push({
+        scenario: `[DDD] Two commands arrive simultaneously targeting the same aggregate in "${spec.title}". ` +
+            'If the spec does not specify optimistic locking or version-based conflict detection, ' +
+            'the last writer wins and invariants may be silently violated.',
+        probability: 'medium',
+        impact: 'high',
+        currentHandling: /version|etag|lock|concurrent/i.test(specContent)
+            ? 'Partially addressed'
+            : 'Not addressed in spec',
+        requiredHandling: 'Add explicit version/ETag to the aggregate. ' +
+            'Spec must declare: "Concurrent modification → return Conflict (409) with current version".',
+        dataConsistency: 'Aggregate invariants must hold under concurrent access',
+        userExperience: 'User sees a conflict error with the option to reload and retry',
+    });
+    // Scenario 2: Resource constraint at zero/limit
+    const hasStockOrBalance = /stock|balance|quantity|limit|capacity/i.test(specContent);
+    if (hasStockOrBalance) {
+        scenarios.push({
+            scenario: `[DDD] The spec for "${spec.title}" does not specify the aggregate behavior ` +
+                'when a resource constraint is at its limit (e.g., stock = 0, balance = 0, capacity full). ' +
+                'What is the aggregate state after the rejection? Does it emit a domain event?',
+            probability: 'high',
+            impact: 'high',
+            currentHandling: /reject|refuse|insufficient|not enough|unavailable/i.test(specContent)
+                ? 'Partially addressed'
+                : 'Not addressed in spec',
+            requiredHandling: 'Add: "When [resource] is at limit, the aggregate rejects the command with [DomainError] ' +
+                'and remains in [state]. No domain event is emitted."',
+            dataConsistency: 'Aggregate must reject commands that would violate invariants',
+            userExperience: 'User sees a specific error message explaining why the action failed',
+        });
+    }
+    // Scenario 3: Cross-boundary domain event without ACL
+    const hasCrossBoundary = /integration|external|downstream|consumer|publish|emit/i.test(specContent);
+    if (hasCrossBoundary) {
+        scenarios.push({
+            scenario: `[DDD] The spec for "${spec.title}" implies integration with another bounded context ` +
+                'but does not specify the ACL, Published Language, or Conformist relationship. ' +
+                'The downstream context may adopt the upstream model without translation, creating coupling.',
+            probability: 'medium',
+            impact: 'medium',
+            currentHandling: /acl|anti.corruption|published.language|conformist/i.test(specContent)
+                ? 'Integration pattern specified'
+                : 'Integration pattern not specified',
+            requiredHandling: 'Spec must declare: "Integration with [DownstreamContext] uses [ACL/Published Language/Conformist]. ' +
+                'Event schema: [schema]. ACL translation logic lives in [module]."',
+            dataConsistency: 'Context boundaries must be respected to prevent model contamination',
+            userExperience: 'Transparent to user — prevents future regressions from coupling',
+        });
+    }
+    return scenarios;
+}
+// === XP Pair Programming Clarity Challenge ===
+/**
+ * Generates pair programming clarity challenge for XP projects.
+ * Evaluates if two developers could implement the spec without additional clarification.
+ */
+export function generateXpPairClarityChallenge(spec, specContent) {
+    const scenarios = [];
+    const ambiguousTerms = [];
+    // Detect potentially ambiguous terms
+    const vaguePatterns = [
+        [/\bappropriate\b/i, '"appropriate" (no definition)'],
+        [/\bsoon\b|\bquickly\b|\bfast\b/i, '"soon/quickly/fast" (no time bound)'],
+        [/\bsome\b/i, '"some" (no quantity)'],
+        [/\bproperly\b|\bcorrectly\b/i, '"properly/correctly" (no definition of proper)'],
+        [/\bif\s+needed\b|\bif\s+applicable\b/i, '"if needed/if applicable" (no condition)'],
+        [/\betc\b|\band\s+so\s+on\b/i, '"etc./and so on" (incomplete list)'],
+        [/\bmight\b|\bcould\b|\bshould\s+consider\b/i, 'weak modal (implies optional behavior)'],
+    ];
+    for (const [pattern, label] of vaguePatterns) {
+        if (pattern.test(specContent)) {
+            ambiguousTerms.push(label);
+        }
+    }
+    // Check if acceptance criteria follow Given/When/Then
+    const hasBehavioralCriteria = /given\s+.+when\s+.+then/is.test(specContent);
+    if (!hasBehavioralCriteria) {
+        ambiguousTerms.push('criteria not in Given/When/Then (XP requires executable acceptance tests)');
+    }
+    if (ambiguousTerms.length > 0) {
+        scenarios.push({
+            scenario: `[XP] Two developers starting a pairing session on "${spec.title}" without prior context ` +
+                'may interpret these terms differently: ' +
+                ambiguousTerms.join('; ') +
+                '. This would require stopping the session to seek clarification.',
+            probability: ambiguousTerms.length >= 3 ? 'high' : 'medium',
+            impact: 'medium',
+            currentHandling: 'Spec contains ambiguous or non-behavioral criteria',
+            requiredHandling: 'Rewrite ambiguous criteria using Given/When/Then with explicit values. ' +
+                'Each acceptance criterion should be independently verifiable as a test.',
+            dataConsistency: 'Not applicable',
+            userExperience: 'Prevents misimplementation and reduces mid-session interruptions',
+        });
+    }
+    return scenarios;
+}
+//# sourceMappingURL=architecture-challenge-scenarios.js.map