Files
rust-discovery/migrations/0022_job_unknown_closure.sql
T

52 lines
3.0 KiB
PL/PgSQL

-- Human WebUI closure of an unknown job attempt (user decision 2026-11-17).
-- The effect remains unknown. The attempt becomes final, is never retried and
-- is never reinterpreted as success, failure or nonstart. The original state,
-- revision and result are retained immutably in the closure row.
ALTER TABLE jobs DROP CONSTRAINT jobs_state_check;
ALTER TABLE jobs ADD CONSTRAINT jobs_state_check CHECK(state IN ('queued','accepted','running','verifying','awaiting_reboot','succeeded','failed','cancelled','expired','unknown','closed_unknown'));
CREATE TABLE job_unknown_closures (
tenant_id uuid NOT NULL,
closure_id uuid PRIMARY KEY,
job_id uuid NOT NULL,
attempt_id uuid NOT NULL,
grant_id uuid,
original_state text NOT NULL CHECK(original_state='unknown'),
original_revision bigint NOT NULL CHECK(original_revision>=0),
original_result jsonb,
principal text NOT NULL CHECK(length(principal) BETWEEN 1 AND 256),
session_hash text NOT NULL CHECK(session_hash ~ '^[0-9a-f]{64}$'),
approval_origin text NOT NULL,
testsimulation boolean NOT NULL,
reason text NOT NULL CHECK(length(reason) BETWEEN 1 AND 1024),
created_at timestamptz NOT NULL DEFAULT now(),
UNIQUE(tenant_id,job_id),
FOREIGN KEY(tenant_id,job_id,attempt_id) REFERENCES jobs(tenant_id,job_id,attempt_id),
CHECK((approval_origin='dev_test_browser_simulation' AND testsimulation) OR (approval_origin='human_webui' AND NOT testsimulation))
);
ALTER TABLE job_unknown_closures ENABLE ROW LEVEL SECURITY;
ALTER TABLE job_unknown_closures FORCE ROW LEVEL SECURITY;
CREATE POLICY tenant_scope ON job_unknown_closures USING(tenant_id::text=current_setting('app.tenant_id',true)) WITH CHECK(tenant_id::text=current_setting('app.tenant_id',true));
GRANT SELECT,INSERT ON job_unknown_closures TO rmm_app;
CREATE TRIGGER immutable_content BEFORE UPDATE OR DELETE ON job_unknown_closures FOR EACH ROW EXECUTE FUNCTION immutable_plan();
-- A job enters closed_unknown only from unknown with a matching closure row,
-- and a closed job never changes state, revision or result again.
CREATE FUNCTION guard_closed_unknown() RETURNS trigger LANGUAGE plpgsql
SET search_path=pg_catalog,public AS $$
DECLARE c job_unknown_closures%ROWTYPE;
BEGIN
IF OLD.state='closed_unknown' THEN
IF NEW.state IS DISTINCT FROM OLD.state OR NEW.revision IS DISTINCT FROM OLD.revision OR NEW.result IS DISTINCT FROM OLD.result THEN
RAISE EXCEPTION 'JOB_CLOSED_UNKNOWN_IMMUTABLE';
END IF;
ELSIF NEW.state='closed_unknown' THEN
SELECT * INTO c FROM job_unknown_closures WHERE tenant_id=NEW.tenant_id AND job_id=NEW.job_id;
IF NOT FOUND OR OLD.state IS DISTINCT FROM 'unknown' OR c.attempt_id IS DISTINCT FROM NEW.attempt_id
OR c.original_revision IS DISTINCT FROM OLD.revision OR c.original_result IS DISTINCT FROM OLD.result
OR NEW.revision IS DISTINCT FROM OLD.revision+1 THEN
RAISE EXCEPTION 'JOB_CLOSED_UNKNOWN_REQUIRES_CLOSURE';
END IF;
END IF;
RETURN NEW;
END $$;
CREATE TRIGGER guard_closed_unknown BEFORE UPDATE ON jobs FOR EACH ROW EXECUTE FUNCTION guard_closed_unknown();