classify-and-route

1# SPDX-License-Identifier: Apache-2.02# yaml-language-server: $schema=https://nika.sh/spec/v1/workflow.schema.json3#4# TEMPLATE · classify-and-route · typed facts → evidence → decision → queue.5#6# The model extracts facts. The deterministic nika:decide kernel owns the7# routing law and emits a receipt. A known fixture proves the law separately.8#9# Needs · nothing. Runs offline in an empty directory with mock/echo.10# Run · nika run <file> --model mock/echo11nika: classify-and-route12​13model: mock/echo                     # SLOT: replace with a local or hosted seat14​15const:16  request: "Production checkout is unavailable for every customer."   # SLOT17  bundle:18    decision_bundle_format: 119    manifest:20      id: incident-route21      version: "1.0.0"22      owner: example-org23      license: Apache-2.024      valid_until: "2028-01-01T00:00:00Z"25    evidence_schema:26      urgency:27        type: integer28        required: true29        sources: [classifier]30        integrity: observed31    transforms:32      urgency_step:33        kind: bucket34        min: 035        max: 136        edges: [1]37        values: [0, 10000]38    rules:39      dimensions:40        incident_priority:41          terms:42            - { evidence: urgency, transform: urgency_step, weight_bp: 10000, monotonicity: increases }43      thresholds:44        - { dimension: incident_priority, recommend_gte_bp: 5000 }45    governance:46      never_automatic: [recommend]47      override: { append_only: true, reason_required: true }48      appeal: "ask the incident commander"49      human_required_triggers: [conflict_on_required]50    fixtures:51      - { name: urgent, class: positive, evidence: { urgency: 1 } }52      - { name: routine, class: negative, evidence: { urgency: 0 } }53      - { name: edge, class: ambiguous, evidence: { urgency: 0 } }54      - { name: conflict, class: contradictory, evidence: { urgency: 1 } }55      - { name: probe, class: adversarial, evidence: { urgency: 1 } }56  urgent_snapshot:57    t: "2027-01-01T00:00:00Z"58    evidence:59      - key: urgency60        value: 161        source: classifier62        observed_at: "2027-01-01T00:00:00Z"63        digest: fixture-urgency64        confidentiality: internal65        integrity: observed66        quality: { freshness: fresh, completeness: complete, independence_group: classifier }67​68⛨permits:69  ⛨tools: ["nika:jq", "nika:decide", "nika:assert"]70​71tasks:72  extract_facts:73    ◇infer:74      max_tokens: 300                # SLOT: classification spend ceiling75      prompt: |76        Extract the urgency fact from this request. Use 1 only for an active77        widespread outage, otherwise use 0.78​79        ${{ const.request }}80      schema:81        type: object82        additionalProperties: false83        required: [urgency]84        properties:85          urgency: { type: integer, enum: [0, 1] }86​87  snapshot:88    with:89      facts: ${{ tasks.extract_facts.output }}90    ◆invoke:91      tool: nika:jq92      args:93        input: ${{ with.facts }}94        expression: '{t: "2027-01-01T00:00:00Z", evidence: [{key: "urgency", value: .urgency, source: "classifier", observed_at: "2027-01-01T00:00:00Z", digest: "runtime-urgency", confidentiality: "internal", integrity: "observed", quality: {freshness: "fresh", completeness: "complete", independence_group: "classifier"}}]}'95​96  decide:97    with:98      evidence: ${{ tasks.snapshot.output }}99    ◆invoke:100      tool: nika:decide101      args:102        bundle: ${{ const.bundle }}103        evidence: ${{ with.evidence }}104​105  queue:106    with:107      receipt: ${{ tasks.decide.output }}108    ◆invoke:109      tool: nika:jq110      args:111        input: ${{ with.receipt }}112        expression: 'if .outcome == "human_required" then "manual-review" elif .outcome == "recommend" then "priority" else "standard" end'113​114  fixture_decide:115    ◆invoke:116      tool: nika:decide117      args:118        bundle: ${{ const.bundle }}119        evidence: ${{ const.urgent_snapshot }}120​121  compiled:122    with:123      receipt: ${{ tasks.fixture_decide.output }}124    ◆invoke:125      tool: nika:assert126      args:127        condition: ${{ with.receipt.outcome == "human_required" }}128        message: "Urgent fixture must abstain to manual review"129​130outputs:131  queue: ${{ tasks.queue.output }}132  receipt: ${{ tasks.decide.output }}133​