E1: split monolithic files — cmd/nomos (main.go → server.go + mcp.go + workers.go),
internal/mcp/tools.go → entity_tools/ops_tools/knowledge_tools/analysis_tools,
internal/httpapi/impl.go → domain files (entities, events, signals, ontology,
fleet_health, client_context, client_lifecycle, entity_mutations, query_audit).
E2: migrate raw pool.Exec queries to sqlc (entities/relationships queries + generated).
E3: unify SSH — consolidate crypto/ssh dial into actuator/client.go (+client_test).
E4/E5: add tests — db/lifecycle, checkdefaults/build, ontology/preconditions, policy/risk.
80 lines
3.4 KiB
SQL
80 lines
3.4 KiB
SQL
-- Entity read + mutation queries (API paths). Aliased `e` throughout to
|
|
-- avoid ambiguity with joined tables.
|
|
|
|
-- name: GetEntityByID :one
|
|
SELECT e.* FROM entities e WHERE e.id = $1;
|
|
|
|
-- name: GetEntityBySlug :one
|
|
SELECT e.* FROM entities e WHERE e.slug = $1;
|
|
|
|
-- name: ListEntities :many
|
|
WITH RECURSIVE tt AS (
|
|
SELECT name FROM entity_types WHERE sqlc.narg('type')::text IS NULL OR name = sqlc.narg('type')
|
|
UNION
|
|
SELECT et.name FROM entity_types et JOIN tt ON et.parent_type = tt.name
|
|
WHERE sqlc.narg('type')::text IS NOT NULL
|
|
)
|
|
SELECT e.* FROM entities e
|
|
JOIN entity_types et ON et.name = e.type
|
|
WHERE e.type IN (SELECT name FROM tt)
|
|
AND (sqlc.narg('state')::text IS NULL OR e.state = sqlc.narg('state'))
|
|
AND (sqlc.narg('domain')::text IS NULL OR et.domain = sqlc.narg('domain'))
|
|
AND (sqlc.narg('layer')::text IS NULL OR et.layer = sqlc.narg('layer'))
|
|
AND (sqlc.narg('q')::text IS NULL
|
|
OR e.slug ILIKE '%'||sqlc.narg('q')||'%'
|
|
OR e.name ILIKE '%'||sqlc.narg('q')||'%')
|
|
AND (sqlc.narg('cursor')::text IS NULL OR e.slug > sqlc.narg('cursor'))
|
|
ORDER BY e.slug
|
|
LIMIT sqlc.arg('lim');
|
|
|
|
-- name: InsertEntity :one
|
|
INSERT INTO entities (id, slug, type, name, state, attributes)
|
|
VALUES ($1, $2, $3, $4, $5, $6)
|
|
RETURNING *;
|
|
|
|
-- name: UpdateEntity :one
|
|
UPDATE entities SET
|
|
name = COALESCE(sqlc.narg('name'), name),
|
|
state = COALESCE(sqlc.narg('state'), state),
|
|
attributes = COALESCE(sqlc.narg('attributes'), attributes),
|
|
maintenance_until = CASE WHEN sqlc.arg('set_maintenance')::bool
|
|
THEN sqlc.narg('maintenance_until') ELSE maintenance_until END,
|
|
version = version + 1,
|
|
updated_at = now()
|
|
WHERE id = sqlc.arg('id') AND version = sqlc.arg('version')
|
|
RETURNING *;
|
|
|
|
-- name: MergeEntityAttributes :execrows
|
|
-- Shallow-merge a JSON patch into an entity's attributes (the
|
|
-- update_entity_attributes MCP/HTTP surface). Replaces the raw
|
|
-- `attributes = attributes || $2::jsonb` used in entity_tools.go.
|
|
UPDATE entities SET
|
|
attributes = attributes || sqlc.arg('patch')::jsonb,
|
|
updated_at = now()
|
|
WHERE slug = sqlc.arg('slug');
|
|
|
|
-- name: SetEntityState :execrows
|
|
-- Set an entity's lifecycle state by id (the set_entity_state surface, run
|
|
-- after db.ValidateTransition). Replaces the raw
|
|
-- `UPDATE entities SET state = $2 ... WHERE id = $1`.
|
|
UPDATE entities SET
|
|
state = sqlc.arg('state'),
|
|
updated_at = now()
|
|
WHERE id = sqlc.arg('id');
|
|
|
|
-- blast_radius(): the recursive-CTE traversal function's TABLE return type
|
|
-- is opaque to sqlc's analyzer — that one query stays hand-written pgx in
|
|
-- internal/httpapi (see entities.go GetBlastRadius).
|
|
--
|
|
-- Deliberate raw-SQL exceptions (plan E2): the httpapi entity *read* handlers
|
|
-- (ListEntities/GetEntity/GetGraph/queryEntities) project a fixed
|
|
-- `entityCols` column set (entities.* + a LEFT JOIN to entity_status for
|
|
-- health/last_check_at) and scan it positionally into the oapi-generated
|
|
-- gen.Entity shape. sqlc generates its own row struct per query and cannot
|
|
-- emit gen.Entity, so migrating those reads would add a per-call field-by-
|
|
-- field mapping with no compile-time gain and real column-order risk. They
|
|
-- stay hand-written pgx, like blast_radius and the seed/export bulk paths
|
|
-- noted in sqlc.yaml. The mutation/relationship surface (MergeEntityAttributes,
|
|
-- SetEntityState, InsertRelationshipIfAbsent, EndCurrentRelationship) IS
|
|
-- migrated and is what the entity CRUD tools now call.
|