@fprad0/skill-master-mcp 0.0.7 → 0.0.8

package/dist/prompt-router.js

@@ -0,0 +1,308 @@
+import { evaluateSkillMasterActivation, SKILL_MASTER_ALIASES } from './activation.js';
+const normalize = (value) => value
+    .normalize('NFD')
+    .replace(/[\u0300-\u036f]/g, '')
+    .toLowerCase();
+const includesAny = (normalized, terms) => (terms.some((term) => normalized.includes(normalize(term))));
+const DIRECT_TRIGGER_TERMS = [
+    ...SKILL_MASTER_ALIASES,
+    'use o skill master',
+    'use o skill_master',
+    'use skill master',
+    'utilize o skill master',
+];
+const STRONG_TRIGGER_TERMS = [
+    'use o skill',
+    'utilize uma skill',
+    'crie uma skill',
+    'criar skill',
+    'aprenda com isso',
+    'aprender com isso',
+    'atualize o notion',
+    'notion',
+    'pesquise e implemente',
+    'valide npm',
+    'validar npm',
+    'npm install -g',
+    'instale pacote global',
+    'instalar pacote global',
+    'melhore o mcp',
+    'melhorar o mcp',
+    'skill-master',
+    'skill_master',
+    'skill-master-mcp',
+];
+const TECHNICAL_TERMS = [
+    'api',
+    'arquitetura',
+    'automacao',
+    'backend',
+    'bug',
+    'build',
+    'cli',
+    'codigo',
+    'codex',
+    'deploy',
+    'frontend',
+    'github',
+    'implemente',
+    'implementar',
+    'mcp',
+    'npm',
+    'prompt',
+    'refatorar',
+    'release',
+    'repo',
+    'repositorio',
+    'script',
+    'seguranca',
+    'teste',
+    'testes',
+    'typescript',
+    'validar',
+];
+const TRIVIAL_TERMS = [
+    'que horas',
+    'qual a hora',
+    'data de hoje',
+    'traduza esta frase',
+    'corrija esta frase',
+    'reescreva esta frase',
+    'resuma em uma frase',
+];
+const PUBLICATION_TERMS = [
+    'npm publish',
+    'publique',
+    'publicar',
+    'publicacao',
+    'nova versao',
+    'release',
+    'tag',
+    'git push',
+    'disponivel para todos',
+];
+const PUBLICATION_AUTH_TERMS = [
+    'pode publicar',
+    'autorizo publicar',
+    'autorizada a publicacao',
+    'autorizo a publicacao',
+    'publique as atualizacoes',
+    'publicar agora',
+];
+const PUBLICATION_NEGATION_TERMS = [
+    'sem publicar',
+    'sem publicacao',
+    'nao publicar',
+    'nao publique',
+    'não publicar',
+    'não publique',
+    'nao fazer publicacao',
+    'não fazer publicação',
+];
+const LEARNING_TERMS = [
+    'aprenda',
+    'aprender',
+    'skill aprendida',
+    'implementacao bem sucedida',
+    'implementacao de sucesso',
+    'foi sucesso',
+    'crie skills sobre',
+    'aprove uma skill externa',
+    'aprovar skill externa',
+    'skill externa',
+    'transforme uma skill da web',
+    'skill da web',
+];
+const SECRET_TERMS = ['token', 'senha', 'cookie', 'secret', '.env', 'chave'];
+const DESTRUCTIVE_TERMS = ['rm -rf', 'git reset --hard', 'git checkout --', 'apagar tudo', 'deletar tudo'];
+const toRecommendedSkill = (entry, index) => ({
+    order: index + 1,
+    name: entry.skill.name,
+    phase: entry.phase,
+    required: entry.required,
+    score: entry.score,
+    reasons: entry.reasons,
+    source: entry.skill.sourceKind,
+    trusted: entry.skill.trusted,
+    location: entry.skill.location,
+    description: entry.skill.description,
+});
+const filterAvailableSkills = (skills, availableSkills) => {
+    if (!availableSkills?.length)
+        return skills;
+    const allowed = new Set(availableSkills.map((skill) => normalize(skill)));
+    return skills.filter((skill) => allowed.has(normalize(skill.name)));
+};
+const hasPublicationAuthorization = (normalizedPrompt) => (includesAny(normalizedPrompt, PUBLICATION_AUTH_TERMS));
+const hasPublicationNegation = (normalizedPrompt) => (includesAny(normalizedPrompt, PUBLICATION_NEGATION_TERMS));
+const buildSafetyGates = (normalizedPrompt, options) => {
+    const gates = [];
+    const publicationNegated = hasPublicationNegation(normalizedPrompt);
+    const publicationIntent = includesAny(normalizedPrompt, PUBLICATION_TERMS) && !publicationNegated;
+    const publicationAuthorized = hasPublicationAuthorization(normalizedPrompt);
+    if (publicationNegated) {
+        gates.push({
+            code: 'publication_explicitly_disabled',
+            severity: 'info',
+            message: 'O prompt restringe publicacao; manter a execucao somente local.',
+        });
+    }
+    else if (publicationIntent && !publicationAuthorized) {
+        gates.push({
+            code: 'publication_requires_explicit_authorization',
+            severity: 'blocker',
+            message: 'Publicacao, release, tag, push ou pacote novo exigem autorizacao explicita antes de executar.',
+        });
+    }
+    else if (publicationIntent) {
+        gates.push({
+            code: 'publication_authorization_detected',
+            severity: 'warning',
+            message: 'Ha intencao de publicacao; validar pacote, changelog, versao e canal antes de executar.',
+        });
+    }
+    if (includesAny(normalizedPrompt, SECRET_TERMS)) {
+        gates.push({
+            code: 'secret_redaction_required',
+            severity: 'warning',
+            message: 'Revisar e remover tokens, senhas, cookies, chaves e arquivos .env de qualquer artefato gerado.',
+        });
+    }
+    if (includesAny(normalizedPrompt, DESTRUCTIVE_TERMS)) {
+        gates.push({
+            code: 'destructive_command_review_required',
+            severity: 'blocker',
+            message: 'Comandos destrutivos exigem revisao humana e confirmacao explicita antes da execucao.',
+        });
+    }
+    if (includesAny(normalizedPrompt, ['notion'])) {
+        gates.push({
+            code: 'notion_preflight_required',
+            severity: 'info',
+            message: 'Confirmar conexao com Notion antes de criar ou atualizar paginas.',
+        });
+    }
+    if (includesAny(normalizedPrompt, LEARNING_TERMS)) {
+        gates.push({
+            code: 'learned_skill_human_approval_required',
+            severity: 'info',
+            message: 'Skills aprendidas precisam de evidencia, revisao de risco e aprovacao humana antes de ativacao.',
+        });
+    }
+    if (options.riskTolerance === 'low') {
+        gates.push({
+            code: 'low_risk_tolerance_plan_first',
+            severity: 'info',
+            message: 'Modo conservador: planejar e validar antes de executar alteracoes relevantes.',
+        });
+    }
+    return gates;
+};
+const selectExecutionMode = (shouldActivate, normalizedPrompt, gates, options) => {
+    if (gates.some((gate) => gate.severity === 'blocker'))
+        return 'block';
+    if (!shouldActivate)
+        return 'no-op';
+    const publicationExplicitlyDisabled = gates.some((gate) => gate.code === 'publication_explicitly_disabled');
+    const planningTerms = publicationExplicitlyDisabled
+        ? ['planeje', 'planejamento', 'arquitetura', 'pesquise']
+        : ['planeje', 'planejamento', 'arquitetura', 'pesquise', 'release', 'publicar', 'aprovacao'];
+    if (options.riskTolerance === 'low'
+        || includesAny(normalizedPrompt, planningTerms)) {
+        return 'plan';
+    }
+    return 'assist';
+};
+const buildNextAction = (executionMode, recommendedSkills, notionUpdateNeeded, learningOpportunity) => {
+    if (executionMode === 'block') {
+        return 'Parar e pedir aprovacao humana ou remover o risco antes de executar.';
+    }
+    if (executionMode === 'no-op') {
+        return 'Responder normalmente sem acionar fluxo pesado do Skill Master.';
+    }
+    if (recommendedSkills.length > 0) {
+        return `Ler e aplicar a primeira skill recomendada: ${recommendedSkills[0].name}.`;
+    }
+    if (learningOpportunity) {
+        return 'Coletar evidencias antes de preparar uma skill aprendida.';
+    }
+    if (notionUpdateNeeded) {
+        return 'Confirmar conexao com Notion e registrar a continuidade.';
+    }
+    return 'Aplicar a persona Dev Senior Master e executar com validacao real.';
+};
+export const routeSkillMasterPrompt = (skills, prompt, options) => {
+    const scopedSkills = filterAvailableSkills(skills, options.availableSkills);
+    const normalizedPrompt = normalize(`${prompt} ${options.projectContext ?? ''}`);
+    const explicitTrigger = includesAny(normalizedPrompt, DIRECT_TRIGGER_TERMS);
+    const strongTrigger = includesAny(normalizedPrompt, STRONG_TRIGGER_TERMS);
+    const technicalPrompt = includesAny(normalizedPrompt, TECHNICAL_TERMS);
+    const trivialPrompt = includesAny(normalizedPrompt, TRIVIAL_TERMS) && !technicalPrompt && !explicitTrigger;
+    const notionUpdateNeeded = includesAny(normalizedPrompt, ['notion']);
+    const learningOpportunity = includesAny(normalizedPrompt, LEARNING_TERMS);
+    const gates = buildSafetyGates(normalizedPrompt, options);
+    const activation = evaluateSkillMasterActivation(scopedSkills, prompt, {
+        limit: options.limit,
+        sourceKinds: options.sourceKinds,
+    });
+    const hasRecommendations = activation.recommendations.length > 0;
+    const hasBlocker = gates.some((gate) => gate.severity === 'blocker');
+    let shouldActivate = false;
+    const reasons = [];
+    if (options.activationMode === 'manual') {
+        shouldActivate = explicitTrigger || hasBlocker;
+        if (explicitTrigger)
+            reasons.push('modo manual com mencao direta ao Skill Master');
+    }
+    else if (options.activationMode === 'balanced') {
+        shouldActivate = explicitTrigger
+            || hasBlocker
+            || strongTrigger
+            || notionUpdateNeeded
+            || learningOpportunity
+            || (technicalPrompt && hasRecommendations)
+            || activation.shouldActivate;
+        if (explicitTrigger)
+            reasons.push('mencao direta ao Skill Master');
+        if (strongTrigger)
+            reasons.push('gatilho forte de skill, MCP, Notion, pesquisa ou validacao');
+        if (technicalPrompt && hasRecommendations)
+            reasons.push('prompt tecnico com skill aprovada relevante');
+    }
+    else {
+        shouldActivate = !trivialPrompt && (explicitTrigger
+            || hasBlocker
+            || strongTrigger
+            || technicalPrompt
+            || hasRecommendations
+            || notionUpdateNeeded
+            || learningOpportunity);
+        if (shouldActivate)
+            reasons.push('modo always-on-assisted encontrou possivel ganho operacional');
+    }
+    if (trivialPrompt && !explicitTrigger && !hasBlocker) {
+        shouldActivate = false;
+        reasons.push('tarefa trivial sem ganho claro de skill');
+    }
+    if (activation.reasons.length > 0)
+        reasons.push(...activation.reasons);
+    if (hasBlocker)
+        reasons.push('ha gate bloqueante de seguranca ou publicacao');
+    if (reasons.length === 0)
+        reasons.push('nenhum gatilho suficiente para acionar o Skill Master');
+    const recommendedSkills = activation.recommendations.map(toRecommendedSkill);
+    const executionMode = selectExecutionMode(shouldActivate, normalizedPrompt, gates, options);
+    return {
+        shouldActivate,
+        activationMode: options.activationMode,
+        activationReason: [...new Set(reasons)].join('; '),
+        recommendedSkills,
+        personaOverlay: shouldActivate || executionMode === 'block' ? 'Dev Senior Master' : 'none',
+        executionMode,
+        safetyGates: gates,
+        learningOpportunity,
+        notionUpdateNeeded,
+        nextAction: buildNextAction(executionMode, recommendedSkills, notionUpdateNeeded, learningOpportunity),
+    };
+};
+//# sourceMappingURL=prompt-router.js.map

package/dist/prompt-router.js.map

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

package/dist/success-learning.d.ts

@@ -0,0 +1,147 @@
+import type { ApprovedSkillIndex } from './types.js';
+declare const SUCCESS_SKILL_SCHEMA_VERSION = "skill-master-success-skill-v1";
+declare const SUCCESS_LEARNING_POLICY_VERSION = "success-learning-human-approval-v1";
+export type ExternalSkillCandidate = {
+    name: string;
+    description: string;
+    sourceUrl: string;
+    creatorName: string;
+    creatorUrl: string;
+    reviewStatus: 'pending-human-review' | 'approved' | 'blocked' | 'unapproved';
+    reason: string;
+    riskFlags: string[];
+};
+export type SuccessSkillDraft = {
+    schemaVersion: typeof SUCCESS_SKILL_SCHEMA_VERSION;
+    generatedAt: string;
+    policyVersion: typeof SUCCESS_LEARNING_POLICY_VERSION;
+    status: 'draft' | 'study' | 'rejected' | 'approved' | 'activated';
+    sourceImplementation: {
+        title: string;
+        summary: string;
+        sourceFiles: string[];
+        sourceUrls: string[];
+    };
+    candidateSkill: {
+        name: string;
+        description: string;
+        triggerPhrases: string[];
+        skillMarkdownFile: string;
+        contentHash: string;
+    };
+    evidence: {
+        reusablePattern: string;
+        implementationNotes: string[];
+        validationEvidence: string[];
+    };
+    governance: {
+        requiresHumanApproval: true;
+        approved: boolean;
+        approvedAt?: string;
+        approvedBy?: string;
+        approvalBlockers: string[];
+        riskFlags: string[];
+    };
+    creator?: {
+        name: string;
+        url?: string;
+    };
+    externalCandidates: ExternalSkillCandidate[];
+    decisionLog?: Array<{
+        decidedAt: string;
+        decidedBy: string;
+        decision: 'pending' | 'study' | 'rejected' | 'activated';
+        reason: string;
+        notionUpdateRecommended: boolean;
+    }>;
+};
+export type SuccessSkillReview = {
+    schemaVersion: string;
+    generatedAt?: string;
+    candidateName?: string;
+    recommendation: 'ready-for-human-approval' | 'needs-more-evidence' | 'needs-security-review' | 'invalid';
+    findings: string[];
+    riskFlags: string[];
+    approvalBlockers: string[];
+    externalUnapprovedCandidates: ExternalSkillCandidate[];
+};
+export type UnapprovedSuccessSkillEntry = {
+    filePath: string;
+    generatedAt?: string;
+    candidateName?: string;
+    reason: string;
+    riskFlags: string[];
+    externalCandidates: ExternalSkillCandidate[];
+};
+export type SuccessSkillActivation = {
+    candidateName: string;
+    targetRoot: string;
+    targetDirectory: string;
+    installedSkillPath: string;
+    approvalRecordPath: string;
+    activatedAt: string;
+};
+export type SuccessSkillApprovalPackage = {
+    generatedAt: string;
+    filePath: string;
+    totalDrafts: number;
+    readyForApproval: number;
+    needsReview: number;
+};
+export type SuccessSkillDecision = {
+    candidateName: string;
+    manifestPath: string;
+    decision: 'pending' | 'study' | 'rejected';
+    decidedAt: string;
+    decidedBy: string;
+    reason: string;
+    notionUpdateRecommended: true;
+};
+export declare const readSuccessSkillDraft: (manifestPath: string) => Promise<SuccessSkillDraft | null>;
+export declare const prepareSuccessSkillDraft: ({ title, summary, reusablePattern, implementationNotes, validationEvidence, triggerPhrases, sourceFiles, sourceUrls, candidateName, description, creatorName, creatorUrl, externalCandidates, approvedIndex, outputDir, }: {
+    title: string;
+    summary: string;
+    reusablePattern: string;
+    implementationNotes: string[];
+    validationEvidence: string[];
+    triggerPhrases: string[];
+    sourceFiles: string[];
+    sourceUrls: string[];
+    candidateName?: string;
+    description?: string;
+    creatorName?: string;
+    creatorUrl?: string;
+    externalCandidates: ExternalSkillCandidate[];
+    approvedIndex: ApprovedSkillIndex;
+    outputDir: string;
+}) => Promise<{
+    draft: SuccessSkillDraft;
+    manifestPath: string;
+    skillPath: string;
+}>;
+export declare const reviewSuccessSkillDraft: ({ manifestPath, approvedIndex, }: {
+    manifestPath: string;
+    approvedIndex: ApprovedSkillIndex;
+}) => Promise<SuccessSkillReview>;
+export declare const listUnapprovedSuccessSkills: (directory: string) => Promise<UnapprovedSuccessSkillEntry[]>;
+export declare const listSuccessSkillDraftManifests: (directory: string) => Promise<string[]>;
+export declare const recordSuccessSkillDecision: ({ manifestPath, decision, decidedBy, reason, }: {
+    manifestPath: string;
+    decision: "pending" | "study" | "rejected";
+    decidedBy?: string;
+    reason: string;
+}) => Promise<SuccessSkillDecision>;
+export declare const activateSuccessSkillDraft: ({ manifestPath, approvedIndex, targetRoot, approvedBy, overwrite, }: {
+    manifestPath: string;
+    approvedIndex: ApprovedSkillIndex;
+    targetRoot: string;
+    approvedBy?: string;
+    overwrite?: boolean;
+}) => Promise<SuccessSkillActivation>;
+export declare const prepareSuccessSkillApprovalPackage: ({ directory, outputDir, approvedIndex, }: {
+    directory: string;
+    outputDir: string;
+    approvedIndex: ApprovedSkillIndex;
+}) => Promise<SuccessSkillApprovalPackage>;
+export {};
+//# sourceMappingURL=success-learning.d.ts.map

package/dist/success-learning.d.ts.map

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