@shiftleftpt/sbd-toe-mcp 0.20.0-beta.20 → 0.20.0-beta.22

package/dist/serving/activation-vocabulary.d.ts

@@ -0,0 +1,99 @@
+import { type Concern } from "../tools/prepare-codegen-context.js";
+export interface ConcernVocabularyEntry {
+    value: Concern;
+    activates_categories: string[];
+    activates_chapters: string[];
+    requirements_at: Record<"L1" | "L2" | "L3", number>;
+}
+export interface ActivatorVocabularyEntry {
+    value: string;
+    activates_concerns: string[];
+    /** P1-A/item 2: valor válido que NÃO activa nada — publicado como tal, nunca omitido. */
+    inert?: true;
+    note: string;
+}
+export interface ActivationVocabulary {
+    provenance: {
+        kg: string;
+        content_type: "derived";
+        produced_by: "activation_vocabulary_builder";
+        source_data: string;
+        note: string;
+    };
+    contract: {
+        serving_semantics: "declarative-first";
+        version: string;
+        note: string;
+    };
+    how_to_use: string[];
+    risk_level: {
+        values: string[];
+        baseline_requirements: Record<string, number>;
+        note: string;
+    };
+    concerns: {
+        closed_set: true;
+        note: string;
+        values: ConcernVocabularyEntry[];
+    };
+    exposure: {
+        closed_set: true;
+        note: string;
+        values: ActivatorVocabularyEntry[];
+    };
+    data_sensitivity: {
+        closed_set: true;
+        note: string;
+        values: ActivatorVocabularyEntry[];
+    };
+    technologies: {
+        closed_set: true;
+        note: string;
+        values: {
+            value: string;
+            activates_chapters: string[];
+            named_rule?: string;
+            note?: string;
+        }[];
+    };
+    changed_files: {
+        closed_set: false;
+        note: string;
+        patterns: {
+            pattern: string;
+            activates_chapters: string[];
+        }[];
+    };
+    roles: {
+        closed_set: true;
+        note: string;
+        values: {
+            value: string;
+            aliases: string[];
+        }[];
+    };
+    phases: {
+        closed_set: true;
+        note: string;
+        values: {
+            value: string;
+            label: string;
+            aliases: string[];
+        }[];
+    };
+    not_activators: {
+        field: string;
+        role: string;
+        note: string;
+    }[];
+}
+/** Categorias v0 que um concern activa — pela mesma via do motor (loader ⊕ suplemento). */
+export declare function categoriesForConcernPublished(concern: Concern): string[];
+/**
+ * Os enums PUBLICADOS dos activadores — a fonte única do que as tools aceitam
+ * (P1-C: o schema é gerado daqui) e do que o vocabulário publica (P1-A/item 2:
+ * incluindo os valores válidos mas INERTES, que antes eram omitidos).
+ */
+export declare const EXPOSURE_VALUES: readonly ["local", "internal", "authenticated", "public"];
+export declare const SENSITIVITY_VALUES: readonly ["low", "personal", "regulated", "secrets"];
+export declare function buildActivationVocabulary(): ActivationVocabulary;

package/dist/serving/activation-vocabulary.js

@@ -0,0 +1,165 @@
+/**
+ * 0.20.0-beta.21 — «declarativo primeiro»: o vocabulário publicado.
+ *
+ * O servidor deixou de adivinhar palavras: PUBLICA a lista fechada de valores que
+ * aceita e, para cada valor, o que ele activa. O LLM — que tem o contexto — lê,
+ * mapeia e DECLARA; o servidor responde ao declarado, de forma reproduzível.
+ *
+ * Regra da casa: nada aqui é escrito à mão. Cada entrada é DERIVADA das mesmas
+ * tabelas/dados que o motor usa (loader do bundle, mapas de concern→categoria/
+ * capítulo, tabela de tecnologias, tabela de padrões de path, activadores
+ * declarados de exposure/data_sensitivity, papéis e fases canónicos do bundle) —
+ * se o motor mudar, o vocabulário muda com ele, ou o teste parte.
+ */
+import { getOntologyData } from "../tools/ontology-loader.js";
+import { VALID_CONCERNS, CONCERN_TO_V0_CATEGORIES_SUPPLEMENT, EXPOSURE_CONCERNS, SENSITIVITY_CONCERNS } from "../tools/prepare-codegen-context.js";
+import { CONCERN_TO_DOMAIN_CHAPTERS, TECHNOLOGY_TO_CHAPTERS, SES008_TECHNOLOGY } from "./selection.js";
+import { PATTERN_RULES } from "../tools/map-review-scope.js";
+import { servedKgReleaseTag } from "../version-info.js";
+/** Categorias v0 que um concern activa — pela mesma via do motor (loader ⊕ suplemento). */
+export function categoriesForConcernPublished(concern) {
+    const ontology = getOntologyData();
+    const set = new Set();
+    for (const c of ontology.concernsMap[concern] ?? [])
+        set.add(c);
+    for (const c of CONCERN_TO_V0_CATEGORIES_SUPPLEMENT[concern] ?? [])
+        set.add(c);
+    return [...set].sort();
+}
+/**
+ * Os enums PUBLICADOS dos activadores — a fonte única do que as tools aceitam
+ * (P1-C: o schema é gerado daqui) e do que o vocabulário publica (P1-A/item 2:
+ * incluindo os valores válidos mas INERTES, que antes eram omitidos).
+ */
+export const EXPOSURE_VALUES = ["local", "internal", "authenticated", "public"];
+export const SENSITIVITY_VALUES = ["low", "personal", "regulated", "secrets"];
+export function buildActivationVocabulary() {
+    const ontology = getOntologyData();
+    const levels = ["L1", "L2", "L3"];
+    const baseline = {};
+    for (const level of levels)
+        baseline[level] = ontology.requirements.filter((r) => r.type === "base" && r.applicable_levels?.[level] === true).length;
+    const concerns = VALID_CONCERNS.map((concern) => {
+        const categories = categoriesForConcernPublished(concern);
+        const counts = {};
+        for (const level of levels)
+            counts[level] = ontology.requirements.filter((r) => categories.includes(r.category) && r.applicable_levels?.[level] === true).length;
+        return {
+            value: concern,
+            activates_categories: categories,
+            activates_chapters: [...(CONCERN_TO_DOMAIN_CHAPTERS[concern] ?? [])],
+            requirements_at: counts
+        };
+    });
+    const roles = ontology.roles
+        .filter((r) => r.canonical)
+        .map((r) => ({ value: r.role_id, aliases: [...r.aliases].sort() }))
+        .sort((a, b) => a.value.localeCompare(b.value));
+    const phases = (ontology.phases ?? [])
+        .filter((p) => p.canonical)
+        .map((p) => ({ value: p.phase_id, label: p.label, aliases: [...p.aliases].sort() }))
+        .sort((a, b) => a.value.localeCompare(b.value));
+    return {
+        provenance: {
+            kg: servedKgReleaseTag(),
+            content_type: "derived",
+            produced_by: "activation_vocabulary_builder",
+            source_data: "data/publish/runtime/{requirements,assignments,roles}.json + ontology concernsMap + tabelas de activação do motor (concern→categoria/capítulo, tecnologia→capítulo, path→capítulo, exposure/data_sensitivity→concern)",
+            note: "Derivado, nunca escrito à mão: o mesmo mapa que o motor usa para seleccionar é o que aqui se publica. Contagens por nível vêm do bundle pinado."
+        },
+        contract: {
+            serving_semantics: "declarative-first",
+            version: "v1.18-beta",
+            note: "Nesta linha (0.20-beta, experiência autorizada pelo lead 2026-09-05) a selecção é função do que o chamador DECLARA. O servidor normaliza o declarado; não decide o que quiseram dizer."
+        },
+        how_to_use: [
+            "1. Tu (LLM) lês o pedido, o código e a conversa — tens o contexto que o servidor nunca terá.",
+            "2. Mapeias o que interpretaste para ESTES valores e DECLARAS: risk_level, concerns, exposure, data_sensitivity, technologies, changed_files.",
+            "3. Chamas select_sbd_toe_requirements com as declarações; o `task` podes enviá-lo à mesma — fica registado para auditoria e NÃO influencia o resultado.",
+            "4. Sem nenhuma declaração o servidor responde needs_input (com este vocabulário e candidatos A CONFIRMAR) — nunca adivinha, nunca devolve zero em silêncio.",
+            "5. Queres a baseline do nível, sem contexto? Pede-a explicitamente: mode='baseline'.",
+            "6. Queres o comportamento inferencial antigo (investigação/estudo de paráfrase)? mode='discover' — exploratório, marcado como tal na resposta."
+        ],
+        risk_level: {
+            values: [...levels],
+            baseline_requirements: baseline,
+            note: "Filtro de nível sobre os requisitos publicados (applicable_levels). Um capítulo nunca se exclui por nível — a exigência escala."
+        },
+        concerns: {
+            closed_set: true,
+            note: "Conjunto fechado. Cada concern activa categorias v0 (baseline cap. 02) e/ou capítulos de domínio. Declara os que a tua leitura do pedido justifica — somam activação, não restringem.",
+            values: concerns
+        },
+        exposure: {
+            closed_set: true,
+            note: "Activador declarado: a superfície exposta impõe concerns por regra publicada.",
+            values: EXPOSURE_VALUES.map((value) => {
+                const list = [...(EXPOSURE_CONCERNS[value] ?? [])];
+                return list.length > 0
+                    ? { value, activates_concerns: list, note: `exposure='${value}' activa ${list.join(", ")} por regra declarada.` }
+                    : {
+                        value,
+                        activates_concerns: [],
+                        inert: true,
+                        note: `exposure='${value}' é um valor VÁLIDO e INERTE: não activa nada. Declarado sozinho não produz selecção — a resposta será needs_input, nunca zero em silêncio.`
+                    };
+            })
+        },
+        data_sensitivity: {
+            closed_set: true,
+            note: "Activador declarado: a natureza dos dados impõe concerns por regra publicada.",
+            values: SENSITIVITY_VALUES.map((value) => {
+                const list = [...(SENSITIVITY_CONCERNS[value] ?? [])];
+                return list.length > 0
+                    ? { value, activates_concerns: list, note: `data_sensitivity='${value}' activa ${list.join(", ")} por regra declarada.` }
+                    : {
+                        value,
+                        activates_concerns: [],
+                        inert: true,
+                        note: `data_sensitivity='${value}' é um valor VÁLIDO e INERTE: não activa nada. Declarado sozinho não produz selecção — a resposta será needs_input, nunca zero em silêncio.`
+                    };
+            })
+        },
+        technologies: {
+            closed_set: true,
+            note: "Conjunto fechado de tecnologias que activam capítulos por TABELA (não por semelhança de texto). O campo livre `stack` só conta quando um destes valores aparece nele como token exacto.",
+            values: [
+                ...Object.entries(TECHNOLOGY_TO_CHAPTERS).map(([value, chapters]) => ({ value, activates_chapters: [...chapters] })),
+                {
+                    value: SES008_TECHNOLOGY,
+                    activates_chapters: [],
+                    named_rule: "SES-008-por-tecnologia",
+                    note: "Não activa capítulos: aciona a regra NOMEADA SES-008 (scope/TTL/revogação de tokens) a qualquer nível — decisão do Author 2026-08-31, agora por tecnologia DECLARADA em vez de casamento de palavras na tarefa."
+                }
+            ]
+        },
+        changed_files: {
+            closed_set: false,
+            note: "Caminhos reais do repositório. A activação é por TABELA de padrões de path publicada abaixo — não há interpretação do conteúdo nem do nome.",
+            patterns: PATTERN_RULES.map((r) => ({ pattern: r.pattern, activates_chapters: [...r.bundles] }))
+        },
+        roles: {
+            closed_set: true,
+            note: "Papéis canónicos do bundle; os aliases publicados são normalização legítima (ex.: sre → devops-sre).",
+            values: roles
+        },
+        phases: {
+            closed_set: true,
+            note: "Fases canónicas do bundle; aliases publicados idem (ex.: implement → develop).",
+            values: phases
+        },
+        not_activators: [
+            {
+                field: "task",
+                role: "recorded_context",
+                note: "Texto livre. Fica no registo para auditoria e NÃO influencia a selecção no modo declarativo (só em mode='discover', exploratório)."
+            },
+            {
+                field: "stack",
+                role: "recorded_context_with_exact_normalisation",
+                note: "Texto livre. Só activa quando contém, como token exacto, um valor de `technologies` — normalizar o declarado é legítimo, adivinhar prosa não."
+            }
+        ]
+    };
+}
+//# sourceMappingURL=activation-vocabulary.js.map

package/dist/serving/activation-vocabulary.js.map

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

package/dist/serving/selection.d.ts

@@ -1,10 +1,33 @@
-import { type ActivationResult, type ActivationTraceEntry, type NormalizedInput } from "../tools/prepare-codegen-context.js";
+import { type ActivationResult, type ActivationTraceEntry, type Concern, type NormalizedInput } from "../tools/prepare-codegen-context.js";
 export type SelectionRiskLevel = "L1" | "L2" | "L3";
+/** Concern → the domain chapter(s) whose catalogue it activates (aligned with the
+ * ontology's `activation_examples` and the applicability model; audited table). */
+export declare const CONCERN_TO_DOMAIN_CHAPTERS: Readonly<Partial<Record<Concern, readonly string[]>>>;
 /** Technology vocabulary → chapters (mirrors map_sbd_toe_applicability). */
 export declare const TECHNOLOGY_TO_CHAPTERS: Readonly<Record<string, readonly string[]>>;
+/**
+ * 0.20.0-beta.21: a regra do Author sobrevive à mudança de fronteira — passa a ser
+ * accionada pela TECNOLOGIA DECLARADA (`technologies: ["jwt"]`, valor publicado no
+ * vocabulário) em vez de por regex sobre a prosa da tarefa. Em `discover` o gatilho
+ * lexical histórico continua a valer.
+ */
+export declare const SES008_TECHNOLOGY = "jwt";
 /** 0.19.0 (ronda 3): estabilidade da origem — lexical = casamento de termos da
  * redacção (revogável por reescrever a frase); declared = concern explícito, regra
  * nomeada, sinal de contexto declarado ou dado do bundle. */
+/**
+ * 0.20.0-beta.21 — modos de selecção («declarativo primeiro», experiência da linha beta
+ * autorizada pelo lead 2026-09-05).
+ *
+ * - `declarative` (DEFAULT): a selecção é função APENAS do que o chamador declarou —
+ *   risk_level, concerns, exposure, data_sensitivity, changed_files, technologies. O
+ *   `task` fica registado para auditoria e não influencia o resultado. Sem nenhuma
+ *   declaração ⇒ `needs_input` (nunca zero, nunca adivinhar).
+ * - `baseline`: devolve a baseline do nível por PEDIDO EXPLÍCITO (nunca como fallback).
+ * - `discover`: comportamento inferencial histórico, COM os avisos todos, marcado
+ *   exploratório — instrumento do oráculo histórico e do estudo de paráfrase.
+ */
+export type SelectionMode = "declarative" | "baseline" | "discover";
 export type SelectionBasis = "declared" | "lexical";
 export declare function basisOfSource(source: string): SelectionBasis;
 export interface SelectionTraceEntry {
@@ -37,6 +60,36 @@ export interface ActivatedChapter {
     source: "changed_file" | "technology" | "concern" | "stack";
     trigger: string;
 }
+/** Declarações que a selecção aceita — o vocabulário está em sbd://toe/activation-vocabulary. */
+export interface DeclaredActivators {
+    concerns: string[];
+    exposure?: string;
+    data_sensitivity?: string;
+    technologies: string[];
+    changed_files: string[];
+}
+/** Resposta a uma chamada sem declarações: pedido de declaração, não resultado. */
+export interface NeedsInput {
+    reason: string;
+    /** P1-A: declarações válidas que não activaram nada (ex.: exposure=local, data_sensitivity=low). */
+    inert_declarations?: string[];
+    declared: DeclaredActivators;
+    vocabulary_resource: string;
+    candidates_to_confirm: {
+        note: string;
+        from_task_text: string[];
+    };
+    example: {
+        tool: string;
+        with: string;
+        note: string;
+    };
+    baseline_escape_hatch: {
+        tool: string;
+        with: string;
+        note: string;
+    };
+}
 export interface SelectionResult {
     risk_level: SelectionRiskLevel;
     eligible_count: number;
@@ -69,6 +122,16 @@ export interface SelectionResult {
     activation: ActivationResult;
     input: NormalizedInput;
     notes: string[];
+    /** Modo efectivo desta selecção (0.20.0-beta.21). */
+    mode: SelectionMode;
+    /** Presente quando nada foi declarado no modo declarativo: pedido de declaração + aula. */
+    needs_input?: NeedsInput;
+    /** O `task` é contexto registado, não motor (excepto em discover). */
+    task_record: {
+        text: string;
+        role: "recorded_context";
+        affects_selection: boolean;
+    };
 }
 export interface SelectionContextInput {
     task?: string;
@@ -78,6 +141,8 @@ export interface SelectionContextInput {
     data_sensitivity?: string;
     concerns?: string[];
     changed_files?: string[];
+    /** 0.20.0-beta.21 — default `declarative`. */
+    mode?: SelectionMode;
     technologies?: string[];
 }
 /**
@@ -85,5 +150,9 @@ export interface SelectionContextInput {
  * eligible exclusion is listed with a reason.
  */
 export declare function runSelection(context: SelectionContextInput): SelectionResult;
+/** Tecnologias declaradas normalizadas: valor do vocabulário fechado, ou token exacto dentro do `stack`. */
+/** Tokens do vocabulário FECHADO presentes no `stack` declarado (P1-D: dão rasto). */
+export declare function stackTokensFromVocabulary(stack: string | undefined): string[];
+export declare function normalizeDeclaredTechnologies(technologies: readonly string[], stack: string | undefined): string[];
 /** Variant for callers that already ran the activation engine (prepare). */
-export declare function runSelectionWithActivation(input: NormalizedInput, activation: ActivationResult, technologies?: readonly string[]): SelectionResult;
+export declare function runSelectionWithActivation(input: NormalizedInput, activation: ActivationResult, technologiesRaw?: readonly string[], mode?: SelectionMode): SelectionResult;