@planu/cli 1.11.0 → 1.13.0

package/dist/engine/competitive/gap-analyzer.js

@@ -0,0 +1,214 @@
+// ---------------------------------------------------------------------------
+// Planu unique capabilities — source of truth
+// ---------------------------------------------------------------------------
+const PLANU_CAPABILITIES = [
+    'mcp-protocol',
+    'spec-driven-development',
+    'drift-detection',
+    'drift-watcher',
+    'compliance-reporting',
+    'ears-notation',
+    'workflow-checkpoints',
+    'context-profiles',
+    'competitive-gap-analysis',
+    'velocity-metrics',
+    'auto-fix-health',
+    'license-tiers',
+    'multi-language-docs',
+    'ai-code-alignment',
+    'spec-health-scoring',
+    'spec-history',
+    'bdd-gherkin',
+    'tdd-scaffold',
+    'coverage-gap-analysis',
+    'red-team',
+    'challenge-spec',
+    'require-checkpoint',
+    'approve-checkpoint',
+    'generate-compliance-evidence',
+    'pull-from-notion',
+    'pull-from-asana',
+    'pull-from-monday',
+    'validate-criteria-quality',
+    'rewrite-criteria-ears',
+    'session-checkpoint',
+    'audit-claude-config',
+];
+// ---------------------------------------------------------------------------
+// Stop words for keyword extraction
+// ---------------------------------------------------------------------------
+const STOP_WORDS = new Set([
+    'a',
+    'an',
+    'the',
+    'and',
+    'or',
+    'is',
+    'in',
+    'on',
+    'at',
+    'to',
+    'for',
+    'of',
+    'with',
+    'by',
+    'from',
+    'as',
+    'be',
+    'are',
+    'was',
+    'were',
+    'has',
+    'have',
+    'had',
+    'do',
+    'does',
+    'did',
+    'will',
+    'would',
+    'can',
+    'could',
+    'should',
+    'may',
+    'might',
+    'must',
+    'shall',
+    'it',
+    'its',
+    'this',
+    'that',
+    'which',
+    'who',
+    'what',
+    'when',
+    'where',
+    'how',
+    'not',
+    'no',
+    'so',
+    'if',
+    'but',
+    'yet',
+    'than',
+    'then',
+    'also',
+    'any',
+    'all',
+    'each',
+    'such',
+    'we',
+    'our',
+    'you',
+    'your',
+    'they',
+    'their',
+    'he',
+    'she',
+    'his',
+    'her',
+]);
+/**
+ * Extracts lowercase keywords from free text, removing stop words and
+ * short tokens. Returns a deduplicated array.
+ */
+export function extractKeywords(text) {
+    const tokens = text
+        .toLowerCase()
+        .split(/[\s\-,.:;!?()[\]{}"'/\\|<>@#$%^&*+=~`]+/)
+        .map((t) => t.trim())
+        .filter((t) => t.length >= 3 && !STOP_WORDS.has(t));
+    return [...new Set(tokens)];
+}
+// ---------------------------------------------------------------------------
+// Capability matching helpers
+// ---------------------------------------------------------------------------
+/**
+ * Returns true if any capability in `capabilities` contains `keyword` as a
+ * substring (case-insensitive after normalization).
+ */
+function capabilityMatchesKeyword(capabilities, keyword) {
+    const lower = keyword.toLowerCase();
+    return capabilities.some((cap) => cap.toLowerCase().includes(lower));
+}
+/**
+ * Checks whether a list of capabilities matches at least one of the feature
+ * keywords.
+ */
+function hasFeatureMatch(capabilities, keywords) {
+    return keywords.some((kw) => capabilityMatchesKeyword(capabilities, kw));
+}
+// ---------------------------------------------------------------------------
+// Positioning thresholds
+// ---------------------------------------------------------------------------
+const PARITY_MIN = 2;
+const PARITY_MAX = 4;
+function computePositioning(matchCount) {
+    if (matchCount < PARITY_MIN) {
+        return 'differentiator';
+    }
+    if (matchCount <= PARITY_MAX) {
+        return 'parity';
+    }
+    return 'lagging';
+}
+// ---------------------------------------------------------------------------
+// Main analysis function
+// ---------------------------------------------------------------------------
+/**
+ * Analyzes a feature (expressed as keywords) against all competitors in the
+ * catalog and returns a structured GapAnalysisResult.
+ */
+export function analyzeGap(featureKeywords, catalog) {
+    const allCompetitors = Object.values(catalog.competitors);
+    // Build coverage map: competitorId -> whether they match any keyword
+    const coverage = {};
+    let matchCount = 0;
+    for (const competitor of allCompetitors) {
+        const matched = hasFeatureMatch(competitor.capabilities, featureKeywords);
+        coverage[competitor.id] = matched;
+        if (matched) {
+            matchCount++;
+        }
+    }
+    // Determine positioning
+    const positioning = computePositioning(matchCount);
+    // Compute Planu-unique capabilities: in PLANU_CAPABILITIES but not in any competitor
+    const allCompetitorCaps = allCompetitors.flatMap((c) => c.capabilities.map((cap) => cap.toLowerCase()));
+    const uniqueToPlanu = PLANU_CAPABILITIES.filter((cap) => !allCompetitorCaps.some((cc) => cc.includes(cap.toLowerCase())));
+    // Gaps: feature keywords not covered by Planu or any competitor
+    const planusCapabilitiesLower = PLANU_CAPABILITIES.map((c) => c.toLowerCase());
+    const gaps = featureKeywords.filter((kw) => !capabilityMatchesKeyword(planusCapabilitiesLower, kw) &&
+        !hasFeatureMatch(allCompetitors.flatMap((c) => c.capabilities), [kw]));
+    // Suggestions: derived from weaknesses of competitors that DO have the feature
+    const matchingCompetitors = allCompetitors.filter((c) => coverage[c.id] === true);
+    const suggestionSet = new Set();
+    for (const competitor of matchingCompetitors) {
+        for (const weakness of competitor.weaknesses) {
+            suggestionSet.add(`Differentiate from ${competitor.name}: ${weakness}`);
+        }
+    }
+    const suggestions = [...suggestionSet];
+    // Summary
+    const competitorNames = matchingCompetitors.map((c) => c.name);
+    const positioningLabel = positioning === 'differentiator'
+        ? 'a strong differentiator'
+        : positioning === 'parity'
+            ? 'at parity'
+            : 'potentially lagging';
+    const summary = `Feature analysis: Planu is ${positioningLabel} in this area. ` +
+        (competitorNames.length > 0
+            ? `Competitors with similar capabilities: ${competitorNames.join(', ')}. `
+            : 'No direct competitor matches found. ') +
+        (uniqueToPlanu.length > 0
+            ? `Planu-unique capabilities: ${uniqueToPlanu.slice(0, 5).join(', ')}${uniqueToPlanu.length > 5 ? ` (+${uniqueToPlanu.length - 5} more)` : ''}.`
+            : 'No unique capabilities identified for this query.');
+    return {
+        positioning,
+        coverage,
+        uniqueToPlanu,
+        gaps,
+        suggestions,
+        summary,
+    };
+}
+//# sourceMappingURL=gap-analyzer.js.map

package/dist/engine/competitive/gap-analyzer.js.map

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

package/dist/engine/compliance/auto-remediator.d.ts

@@ -0,0 +1,9 @@
+import type { ComplianceRemediationResult } from '../../types/health.js';
+type RemediationFramework = 'SOC2' | 'GDPR' | 'HIPAA' | 'ISO27001';
+/**
+ * For each compliance gap, creates a stub spec so the team has a tracked
+ * work item. When dryRun=true, returns findings without writing any files.
+ */
+export declare function autoRemediateCompliance(projectPath: string, projectId: string, framework: RemediationFramework, dryRun?: boolean): Promise<ComplianceRemediationResult>;
+export {};
+//# sourceMappingURL=auto-remediator.d.ts.map

package/dist/engine/compliance/auto-remediator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-remediator.d.ts","sourceRoot":"","sources":["../../../src/engine/compliance/auto-remediator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,2BAA2B,EAAgB,MAAM,uBAAuB,CAAC;AAUvF,KAAK,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AA4FnE;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,oBAAoB,EAC/B,MAAM,UAAQ,GACb,OAAO,CAAC,2BAA2B,CAAC,CAoDtC"}

package/dist/engine/compliance/auto-remediator.js

@@ -0,0 +1,118 @@
+// engine/compliance/auto-remediator.ts — Auto-remediation for compliance gaps (SPEC-408)
+import { mkdir, writeFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { specStore } from '../../storage/index.js';
+import { analyzeComplianceGaps } from './gap-analyzer.js';
+const FRAMEWORK_MAP = {
+    SOC2: 'soc2-type2',
+    GDPR: 'gdpr',
+    HIPAA: 'hipaa',
+    ISO27001: 'iso27001',
+};
+// ---------------------------------------------------------------------------
+// Spec file writer
+// ---------------------------------------------------------------------------
+async function specDirExists(specDir) {
+    try {
+        await access(specDir);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function writeStubSpec(projectPath, specId, title, framework, criteria, dryRun) {
+    if (dryRun) {
+        return;
+    }
+    const specDir = join(projectPath, 'planu', 'specs', specId);
+    await mkdir(specDir, { recursive: true });
+    const criteriaLines = criteria.map((c) => `- [ ] ${c}`).join('\n');
+    const now = new Date().toISOString();
+    const specContent = [
+        '---',
+        `id: ${specId}`,
+        `title: "${title}"`,
+        `status: draft`,
+        `tags: [compliance, ${framework.toLowerCase()}, auto-generated]`,
+        `createdAt: ${now}`,
+        '---',
+        '',
+        `# ${title}`,
+        '',
+        `Auto-generated compliance spec for ${framework} framework.`,
+        '',
+        '## Acceptance Criteria',
+        '',
+        criteriaLines,
+        '',
+    ].join('\n');
+    await writeFile(join(specDir, 'spec.md'), specContent, 'utf-8');
+    await writeFile(join(specDir, 'progress.md'), `# ${specId} — Progress\n\nstatus: draft\n`, 'utf-8');
+}
+// ---------------------------------------------------------------------------
+// Manual action builders
+// ---------------------------------------------------------------------------
+function buildManualAction(controlId, controlName, criteria) {
+    return {
+        control: controlId,
+        description: `${controlName} requires manual process implementation`,
+        steps: [
+            `Review control ${controlId}: ${controlName}`,
+            'Identify existing policies and procedures that address this control',
+            'Document evidence in a spec or decision record',
+            ...criteria.map((c) => `Verify: ${c}`),
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * For each compliance gap, creates a stub spec so the team has a tracked
+ * work item. When dryRun=true, returns findings without writing any files.
+ */
+export async function autoRemediateCompliance(projectPath, projectId, framework, dryRun = false) {
+    const catalogFramework = FRAMEWORK_MAP[framework];
+    const specs = await specStore.listSpecs(projectId);
+    const specInputs = specs.map((s) => ({
+        id: s.id,
+        title: s.title,
+        description: '',
+        status: s.status,
+    }));
+    const gapResult = analyzeComplianceGaps(catalogFramework, specInputs);
+    const createdSpecs = [];
+    const alreadyCovered = [];
+    const manualActionRequired = [];
+    const timestamp = Date.now();
+    for (const control of gapResult.coverage) {
+        if (control.status === 'passing') {
+            alreadyCovered.push(control.controlId);
+            continue;
+        }
+        if (control.status === 'missing') {
+            const slugControl = control.controlId.toLowerCase().replace(/[^a-z0-9]/g, '-');
+            const specId = `SPEC-auto-${slugControl}-${timestamp}`;
+            const title = `${framework} ${control.controlId} — ${control.controlName}`;
+            const specDir = join(projectPath, 'planu', 'specs', specId);
+            if (await specDirExists(specDir)) {
+                alreadyCovered.push(control.controlId);
+                continue;
+            }
+            await writeStubSpec(projectPath, specId, title, framework, control.requiredCriteria, dryRun);
+            createdSpecs.push(specId);
+        }
+        else {
+            // partial — manual action to complete coverage
+            manualActionRequired.push(buildManualAction(control.controlId, control.controlName, control.requiredCriteria));
+        }
+    }
+    return {
+        framework,
+        createdSpecs,
+        alreadyCovered,
+        manualActionRequired,
+    };
+}
+//# sourceMappingURL=auto-remediator.js.map

package/dist/engine/compliance/auto-remediator.js.map

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

package/dist/engine/context-profile/profile-catalog.d.ts

@@ -0,0 +1,5 @@
+import type { ContextProfile, WorkPhase } from '../../types/context-profile.js';
+export declare const PROFILE_CATALOG: Record<WorkPhase, ContextProfile>;
+export declare function getProfile(phase: WorkPhase): ContextProfile;
+export declare function getAllProfiles(): ContextProfile[];
+//# sourceMappingURL=profile-catalog.d.ts.map

package/dist/engine/context-profile/profile-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-catalog.d.ts","sourceRoot":"","sources":["../../../src/engine/context-profile/profile-catalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,SAAS,EAAE,cAAc,CAyI7D,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,CAE3D;AAED,wBAAgB,cAAc,IAAI,cAAc,EAAE,CAEjD"}

package/dist/engine/context-profile/profile-catalog.js

@@ -0,0 +1,145 @@
+export const PROFILE_CATALOG = {
+    brainstorm: {
+        phase: 'brainstorm',
+        name: 'Brainstorm Mode',
+        description: 'Explore ideas, capture requirements, define scope',
+        focusTools: [
+            'capture_idea',
+            'clarify_requirements',
+            'elicit_requirements',
+            'suggest_stack',
+            'create_spec',
+            'list_backlog',
+            'promote_idea',
+            'discard_idea',
+            'search_suggestions',
+            'suggest_criteria',
+        ],
+        avoidTools: ['validate', 'lock_spec', 'approve_spec', 'create_release', 'generate_changelog'],
+        tips: [
+            'Use capture_idea for rough thoughts before formalizing',
+            'Use clarify_requirements to interview stakeholders',
+            'Use elicit_requirements for structured requirement gathering',
+            'Use create_spec only when ready to commit to a feature',
+        ],
+        estimatedTokensSaved: 85,
+    },
+    plan: {
+        phase: 'plan',
+        name: 'Planning Mode',
+        description: 'Design specs, estimate effort, check readiness',
+        focusTools: [
+            'create_spec',
+            'decompose_spec',
+            'estimate',
+            'check_readiness',
+            'challenge_spec',
+            'inject_quality_gates',
+            'suggest_criteria',
+            'clarify_requirements',
+            'analyze_spec_dependencies',
+            'critical_path_analyzer',
+        ],
+        avoidTools: ['lock_spec', 'create_release', 'generate_changelog', 'tdd_scaffold'],
+        tips: [
+            'Use challenge_spec to stress-test before approving',
+            'Use check_readiness to verify sufficient detail',
+            'Use inject_quality_gates to add quality checklist automatically',
+            'Use decompose_spec for large specs that should be split',
+        ],
+        estimatedTokensSaved: 82,
+    },
+    implement: {
+        phase: 'implement',
+        name: 'Implementation Mode',
+        description: 'Build features, track progress, manage sessions',
+        focusTools: [
+            'list_specs',
+            'update_status',
+            'lock_spec',
+            'unlock_spec',
+            'tdd_scaffold',
+            'validate',
+            'session_checkpoint',
+            'session_handoff',
+            'planu_status',
+            'generate_tests',
+            'verify_spec_compliance',
+        ],
+        avoidTools: [
+            'create_spec',
+            'elicit_requirements',
+            'create_release',
+            'generate_changelog',
+            'team_analytics',
+        ],
+        tips: [
+            'Use lock_spec before starting to prevent conflicts',
+            'Use session_checkpoint before context resets',
+            'Use validate after implementing to check compliance',
+            'Use update_status to track progress through lifecycle',
+        ],
+        estimatedTokensSaved: 88,
+    },
+    review: {
+        phase: 'review',
+        name: 'Review Mode',
+        description: 'Validate, approve, request changes, verify quality',
+        focusTools: [
+            'validate',
+            'verify_spec_compliance',
+            'spec_quality_score',
+            'approve_spec',
+            'request_changes',
+            'challenge_spec',
+            'check_readiness',
+            'review_pr',
+            'ears_lint',
+            'validate_criteria_quality',
+        ],
+        avoidTools: ['lock_spec', 'create_release', 'tdd_scaffold', 'capture_idea'],
+        tips: [
+            'Use validate to check acceptance criteria compliance',
+            'Use verify_spec_compliance to score code coverage',
+            'Use ears_lint to check criteria quality',
+            'Use approve_spec only when all criteria are verified',
+        ],
+        estimatedTokensSaved: 87,
+    },
+    release: {
+        phase: 'release',
+        name: 'Release Mode',
+        description: 'Prepare releases, generate changelogs, version specs',
+        focusTools: [
+            'generate_changelog',
+            'create_release',
+            'version_spec',
+            'export_specs_markdown',
+            'generate_docs_site',
+            'spec_usage_report',
+            'velocity_report',
+            'update_status',
+        ],
+        avoidTools: [
+            'create_spec',
+            'lock_spec',
+            'tdd_scaffold',
+            'capture_idea',
+            'clarify_requirements',
+        ],
+        tips: [
+            'Use generate_changelog to compile release notes from done specs',
+            'Use create_release to tag and publish the version',
+            'Use velocity_report to measure team performance this cycle',
+            'Mark all specs done before creating the release',
+        ],
+        estimatedTokensSaved: 90,
+    },
+};
+export function getProfile(phase) {
+    return PROFILE_CATALOG[phase];
+}
+export function getAllProfiles() {
+    return Object.values(PROFILE_CATALOG);
+}
+//# sourceMappingURL=profile-catalog.js.map

package/dist/engine/context-profile/profile-catalog.js.map

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

package/dist/engine/critical-path/path-analyzer.d.ts

@@ -0,0 +1,3 @@
+import type { Spec405CriticalPathResult } from '../../types/index.js';
+export declare function analyzeCriticalPath(projectPath: string): Promise<Spec405CriticalPathResult>;
+//# sourceMappingURL=path-analyzer.d.ts.map

package/dist/engine/critical-path/path-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-analyzer.d.ts","sourceRoot":"","sources":["../../../src/engine/critical-path/path-analyzer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,yBAAyB,EAAmB,MAAM,sBAAsB,CAAC;AA8FvF,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAyEjG"}