portal/tools/observer-stop-hook.test.mjs

import { describe, it, expect, beforeEach, afterEach } from 'vitest';
import { writeFileSync, readFileSync, existsSync, mkdtempSync, rmSync, mkdirSync, readdirSync } from 'fs';
import { join } from 'path';
import { tmpdir } from 'os';
import { appendEpisode, buildEpisodeFromContext, buildObserverError, routingGateDecision, buildExecutionTrace, buildEpisode, buildSelfAssessment } from './observer-stop-hook.mjs';

let workdir;

beforeEach(() => {
  workdir = mkdtempSync(join(tmpdir(), 'observer-test-'));
  mkdirSync(join(workdir, 'docs', 'observer'), { recursive: true });
});

afterEach(() => {
  rmSync(workdir, { recursive: true, force: true });
});

const defaultRat = () => ({
  step: 1,
  node_chosen: '#1',
  triggers_matched: [],
  candidates_considered: [],
  boundaries_applied: [],
  hard_floor: { invoked: false, rules: [] },
  task_classification: 'other',
});

// Full schema-v2 episode fixture.
const v2Episode = (overrides = {}) => ({
  schema_version: 2,
  task_id: 'abc-123',
  task_ref: 'abc-123',
  timestamps: { started_at: '2026-05-19T10:00:00+03:00', ended_at: '2026-05-19T10:05:00+03:00' },
  path_type: 'regulated',
  outcome: 'unknown',
  prompt_signal: 'neutral',
  decision_provenance: { kind: 'autonomous', claude_would_have_chosen: null },
  environment: { economy_level: 0, model: 'claude-opus-4-7', post_compaction: false, session_turn: 1, parallel_session: false },
  task_size: { tool_calls: 0, files_touched: 0, files: [] },
  primary_rationale: defaultRat(),
  events: [],
  ...overrides,
});

describe('appendEpisode', () => {
  it('appends one JSONL line to the monthly file', () => {
    appendEpisode(v2Episode(), workdir, '2026-05');
    const content = readFileSync(join(workdir, 'docs', 'observer', 'episodes-2026-05.jsonl'), 'utf-8');
    expect(content).toContain('"task_id":"abc-123"');
    expect(content).toContain('"schema_version":2');
    expect(content.endsWith('\n')).toBe(true);
  });

  it('appends to an existing file without overwrite', () => {
    appendEpisode(v2Episode({ task_id: 'a' }), workdir, '2026-05');
    appendEpisode(v2Episode({ task_id: 'b', outcome: 'partial' }), workdir, '2026-05');
    const lines = readFileSync(join(workdir, 'docs', 'observer', 'episodes-2026-05.jsonl'), 'utf-8').trim().split('\n');
    expect(lines).toHaveLength(2);
    expect(JSON.parse(lines[0]).task_id).toBe('a');
    expect(JSON.parse(lines[1]).task_id).toBe('b');
  });

  it('applies the PII filter before write (including events[])', () => {
    appendEpisode(
      v2Episode({ events: [{ kind: 'error', message: 'call +79991234567 / mail x@y.com' }] }),
      workdir,
      '2026-05'
    );
    const content = readFileSync(join(workdir, 'docs', 'observer', 'episodes-2026-05.jsonl'), 'utf-8');
    expect(content).toContain('+7XXXXXXXXXX');
    expect(content).toContain('***@***');
    expect(content).not.toContain('79991234567');
  });

  it('throws on a missing required field', () => {
    expect(() => appendEpisode({}, workdir, '2026-05')).toThrow(/required/i);
  });

  it('throws on a missing schema-v2 field', () => {
    const ep = v2Episode();
    delete ep.decision_provenance;
    expect(() => appendEpisode(ep, workdir, '2026-05')).toThrow(/schema v2 field missing/i);
  });

  it('throws when prompt_signal is missing (C-7 strict validation)', () => {
    const ep = v2Episode();
    delete ep.prompt_signal;
    expect(() => appendEpisode(ep, workdir, '2026-05')).toThrow(/schema v2 field missing/i);
  });

  it('throws when events is missing (C-7 strict validation)', () => {
    const ep = v2Episode();
    delete ep.events;
    expect(() => appendEpisode(ep, workdir, '2026-05')).toThrow(/schema v2 field missing/i);
  });

  it('throws when schema_version is not 2, 3 or 4', () => {
    expect(() => appendEpisode(v2Episode({ schema_version: 1 }), workdir, '2026-05')).toThrow(/schema_version/i);
  });

  it('throws when a primary_rationale sub-field is missing', () => {
    expect(() =>
      appendEpisode(v2Episode({ primary_rationale: { step: 1, node_chosen: '#1' } }), workdir, '2026-05')
    ).toThrow(/primary_rationale field missing/i);
  });

  it('accepts a minimal observer_error marker', () => {
    appendEpisode(
      {
        schema_version: 2,
        observer_error: true,
        error_message: 'parser blew up',
        timestamps: { started_at: '2026-05-19T10:00:00Z', ended_at: '2026-05-19T10:00:00Z' },
        task_id: 'err-1',
      },
      workdir,
      '2026-05'
    );
    const line = JSON.parse(readFileSync(join(workdir, 'docs', 'observer', 'episodes-2026-05.jsonl'), 'utf-8').trim());
    expect(line.observer_error).toBe(true);
    expect(line.error_message).toBe('parser blew up');
  });

  it('throws when an observer_error marker is missing a field', () => {
    expect(() =>
      appendEpisode({ schema_version: 2, observer_error: true, task_id: 'x' }, workdir, '2026-05')
    ).toThrow(/observer_error marker field missing/i);
  });

  it('persists PII match counts to .pii-counters.json (Task 3)', () => {
    const ep = v2Episode({
      events: [{ kind: 'tool_summary', counts: { Bash: 1 } }],
      task_size: { tool_calls: 1, files_touched: 0, files: ['+71234567890.txt'] },
    });
    appendEpisode(ep, workdir, '2026-05');
    const counterPath = join(workdir, 'docs', 'observer', '.pii-counters.json');
    expect(existsSync(counterPath)).toBe(true);
    const store = JSON.parse(readFileSync(counterPath, 'utf-8'));
    expect(store['2026-05']).toBeDefined();
    expect(store['2026-05'].RU_PHONE).toBeGreaterThanOrEqual(1);
  });
});

describe('buildEpisodeFromContext', () => {
  it('builds a v4 episode on the fallback path (no transcript)', () => {
    const ep = buildEpisodeFromContext({ session_id: 'sess-1', result: 'success' });
    expect(ep.schema_version).toBe(4);
    expect(ep.schema_minor).toBe(1);
    expect(ep.task_id).toBe('sess-1');
    expect(ep.task_ref).toBe('sess-1');
    expect(ep.outcome).toBe('success');
    expect(ep.decision_provenance).toEqual({ kind: 'autonomous', claude_would_have_chosen: null });
    expect(ep.environment).toEqual({
      economy_level: null,
      model: null,
      post_compaction: false,
      session_turn: 0,
      parallel_session: false,
    });
    expect(ep.task_size).toEqual({ tool_calls: 0, files_touched: 0, files: [] });
  });

  it('defaults outcome to unknown when none supplied', () => {
    expect(buildEpisodeFromContext({ session_id: 'x' }).outcome).toBe('unknown');
  });

  it('derives a v4 episode from transcriptText when provided', () => {
    const transcript = [
      JSON.stringify({ type: 'user', message: { role: 'user', content: 'fix the bug' }, timestamp: '2026-05-19T10:00:00Z', sessionId: 'sess-t' }),
      JSON.stringify({ type: 'assistant', message: { role: 'assistant', content: [{ type: 'tool_use', id: 't1', name: 'Skill', input: { skill: 'superpowers:systematic-debugging' } }] }, timestamp: '2026-05-19T10:01:00Z', sessionId: 'sess-t' }),
    ].join('\n');
    const ep = buildEpisodeFromContext({ session_id: 'sess-t' }, transcript);
    expect(ep.schema_version).toBe(4);
    expect(ep.task_id).toBe('sess-t');
    expect(ep.primary_rationale.node_chosen).toBe('superpowers:systematic-debugging');
  });
});

describe('buildExecutionTrace + buildEpisode — Phase 3 Task 16 (spec §5)', () => {
  it('buildExecutionTrace builds chain_gaps when chain is incomplete', () => {
    const t = buildExecutionTrace({ recommended_chain: ['a', 'b', 'c'], invoked: ['a'] });
    expect(t.recommended_chain).toEqual(['a', 'b', 'c']);
    expect(t.invoked).toEqual(['a']);
    expect(t.chain_gaps[0].executed_steps).toBe(1);
    expect(t.chain_gaps[0].expected_steps).toBe(3);
  });

  it('buildExecutionTrace emits no chain_gaps when chain is complete', () => {
    const t = buildExecutionTrace({ recommended_chain: ['a', 'b'], invoked: ['a', 'b'] });
    expect(t.chain_gaps).toEqual([]);
  });

  it('buildExecutionTrace handles empty recommended_chain (no gap)', () => {
    const t = buildExecutionTrace({ recommended_chain: [], invoked: ['x'] });
    expect(t.chain_gaps).toEqual([]);
  });

  it('buildEpisode copies inheritance from state (B5)', () => {
    const ep = buildEpisode({ state: { inheritance: { inherited_from_task_id: 'x', inheritance_age_minutes: 7 } } });
    expect(ep.inheritance.inherited_from_task_id).toBe('x');
    expect(ep.inheritance.inheritance_age_minutes).toBe(7);
  });

  it('buildEpisode omits inheritance when state has none', () => {
    const ep = buildEpisode({ state: {} });
    expect(ep.inheritance).toBeUndefined();
  });

  it('buildEpisode marks schema_minor=3 (Task 20 bump)', () => {
    const ep = buildEpisode({ state: {}, ctx: { session_id: 'sess-x' } });
    expect(ep.schema_version).toBe(4);
    expect(ep.schema_minor).toBe(3);
  });
});

describe('buildSelfAssessment — Phase 3 Task 17 (spec §4.5)', () => {
  it('marks self_assessment_pending=true when API skipped (apiResult null)', () => {
    const sa = buildSelfAssessment({ apiResult: null });
    expect(sa.self_assessment_pending).toBe(true);
  });

  it('parses a valid JSON apiResult into the four-field schema', () => {
    const sa = buildSelfAssessment({
      apiResult: '{"summary":"chose superpowers:test-driven-development for new code","confidence_in_choice":0.8,"what_could_be_better":null,"lesson_learned":null}',
    });
    expect(sa.summary).toContain('superpowers:test-driven-development');
    expect(sa.confidence_in_choice).toBe(0.8);
    expect(sa.what_could_be_better).toBeNull();
    expect(sa.lesson_learned).toBeNull();
    expect(sa.self_assessment_pending).toBe(false);
  });

  it('strips ```json fence on apiResult', () => {
    const sa = buildSelfAssessment({
      apiResult: '```json\n{"summary":"x","confidence_in_choice":0.5,"what_could_be_better":"y","lesson_learned":"z"}\n```',
    });
    expect(sa.confidence_in_choice).toBe(0.5);
    expect(sa.lesson_learned).toBe('z');
    expect(sa.self_assessment_pending).toBe(false);
  });

  it('marks pending=true with parse_error on malformed apiResult', () => {
    const sa = buildSelfAssessment({ apiResult: 'not json' });
    expect(sa.self_assessment_pending).toBe(true);
    expect(typeof sa.parse_error).toBe('string');
  });

  it('clamps confidence outside [0,1] to null (defensive)', () => {
    const sa = buildSelfAssessment({
      apiResult: '{"summary":"x","confidence_in_choice":5,"what_could_be_better":null,"lesson_learned":null}',
    });
    expect(sa.confidence_in_choice).toBeNull();
  });
});

describe('buildObserverError', () => {
  it('produces a minimal valid observer_error marker', () => {
    const marker = buildObserverError({ session_id: 'sess-e' }, new Error('boom'));
    expect(marker.observer_error).toBe(true);
    expect(marker.schema_version).toBe(4);
    expect(marker.task_id).toBe('sess-e');
    expect(marker.error_message).toContain('boom');
    expect(marker.timestamps.started_at).toBeTruthy();
  });
});

describe('routingGateDecision', () => {
  const NODES = ['discovery-interview', 'brainstorming'];
  const autonomousEp = v2Episode();
  const taggedEp = v2Episode({ decision_provenance: { kind: 'user_directed_method', claude_would_have_chosen: 'brainstorming' } });

  it('blocks when a method was directed but no routing tag is present', () => {
    const gate = routingGateDecision(autonomousEp, 'запусти discovery-interview', NODES, false);
    expect(gate.block).toBe(true);
    expect(gate.reason).toContain('discovery-interview');
  });

  it('does not block when the routing tag is present', () => {
    const gate = routingGateDecision(taggedEp, 'запусти discovery-interview', NODES, false);
    expect(gate.block).toBe(false);
  });

  it('does not block when no method was directed', () => {
    const gate = routingGateDecision(autonomousEp, 'добавь колонку Город', NODES, false);
    expect(gate.block).toBe(false);
  });

  it('does not block when stop_hook_active is true (loop guard)', () => {
    const gate = routingGateDecision(autonomousEp, 'запусти discovery-interview', NODES, true);
    expect(gate.block).toBe(false);
  });

  it('does not block for user_chose_from_options even when prompt mentions a node', () => {
    const choiceEp = v2Episode({
      decision_provenance: {
        kind: 'user_chose_from_options',
        node: 'brainstorming',
        options_offered: ['brainstorming', 'writing-plans'],
        claude_would_have_chosen: 'brainstorming',
      },
    });
    const gate = routingGateDecision(choiceEp, 'запусти brainstorming', NODES, false);
    expect(gate.block).toBe(false);
  });
});