add pql subsystem — daemon-side client + IPC handlers

PqlClient wraps pql CLI per D-003 (shell-out, never duplicate).
IPC verbs: pql.files, pql.meta, pql.backlinks, pql.outlinks,
pql.tags, pql.schema, pql.query, pql.doctor, pql.decisions.*,
pql.tickets.*, pql.plan.status. 15 new core tests.

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2026-04-22 14:02:47 +02:00
co-authored by Claude
parent e43438d369
commit 93ab6ea3bd
5 changed files with 534 additions and 0 deletions
+227
View File
@@ -0,0 +1,227 @@
/// Registers `pql.*` command handlers on the daemon dispatcher.
///
/// Thin pass-through to [PqlClient] — the daemon is a JSON relay
/// between the IPC socket and the pql CLI. Per D-003, clide wraps
/// pql; it never re-implements.
library;
import '../ipc/envelope.dart';
import '../ipc/schema_v1.dart';
import '../pql/client.dart';
import 'dispatcher.dart';
void registerPqlCommands(DaemonDispatcher d, PqlClient pql) {
d.register('pql.files', (req) async {
try {
final glob = req.args['glob'] as String?;
final limit = (req.args['limit'] as num?)?.toInt();
final files = await pql.files(glob: glob, limit: limit);
return IpcResponse.ok(id: req.id, data: {'files': files});
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
d.register('pql.meta', (req) async {
final path = req.args['path'] as String?;
if (path == null || path.isEmpty) {
return _userError(req.id, 'pql.meta requires a path');
}
try {
final meta = await pql.meta(path);
return IpcResponse.ok(id: req.id, data: meta);
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
d.register('pql.backlinks', (req) async {
final path = req.args['path'] as String?;
if (path == null || path.isEmpty) {
return _userError(req.id, 'pql.backlinks requires a path');
}
try {
final links = await pql.backlinks(path);
return IpcResponse.ok(id: req.id, data: {'links': links});
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
d.register('pql.outlinks', (req) async {
final path = req.args['path'] as String?;
if (path == null || path.isEmpty) {
return _userError(req.id, 'pql.outlinks requires a path');
}
try {
final links = await pql.outlinks(path);
return IpcResponse.ok(id: req.id, data: {'links': links});
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
d.register('pql.tags', (req) async {
try {
final limit = (req.args['limit'] as num?)?.toInt();
final tags = await pql.tags(limit: limit);
return IpcResponse.ok(id: req.id, data: {'tags': tags});
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
d.register('pql.schema', (req) async {
try {
final schema = await pql.schema();
return IpcResponse.ok(id: req.id, data: {'schema': schema});
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
d.register('pql.query', (req) async {
final dsl = req.args['query'] as String?;
if (dsl == null || dsl.isEmpty) {
return _userError(req.id, 'pql.query requires a query string');
}
try {
final limit = (req.args['limit'] as num?)?.toInt();
final results = await pql.query(dsl, limit: limit);
return IpcResponse.ok(id: req.id, data: {'results': results});
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
d.register('pql.doctor', (req) async {
try {
final report = await pql.doctor();
return IpcResponse.ok(id: req.id, data: report);
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
d.register('pql.decisions.sync', (req) async {
try {
final result = await pql.decisionSync();
return IpcResponse.ok(id: req.id, data: result);
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
d.register('pql.decisions.list', (req) async {
try {
final results = await pql.decisionList(
type: req.args['type'] as String?,
domain: req.args['domain'] as String?,
status: req.args['status'] as String?,
);
return IpcResponse.ok(id: req.id, data: {'decisions': results});
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
d.register('pql.decisions.show', (req) async {
final id = req.args['id'] as String?;
if (id == null || id.isEmpty) {
return _userError(req.id, 'pql.decisions.show requires an id');
}
try {
final result = await pql.decisionShow(
id,
withRefs: req.args['withRefs'] as bool? ?? false,
withTickets: req.args['withTickets'] as bool? ?? false,
);
return IpcResponse.ok(id: req.id, data: result);
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
d.register('pql.decisions.coverage', (req) async {
try {
final gaps = await pql.decisionCoverage();
return IpcResponse.ok(id: req.id, data: {'gaps': gaps});
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
d.register('pql.tickets.list', (req) async {
try {
final results = await pql.ticketList(
status: req.args['status'] as String?,
team: req.args['team'] as String?,
assigned: req.args['assigned'] as String?,
decision: req.args['decision'] as String?,
);
return IpcResponse.ok(id: req.id, data: {'tickets': results});
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
d.register('pql.tickets.show', (req) async {
final id = req.args['id'] as String?;
if (id == null || id.isEmpty) {
return _userError(req.id, 'pql.tickets.show requires an id');
}
try {
final result = await pql.ticketShow(
id,
withDecision: req.args['withDecision'] as bool? ?? false,
withBlockers: req.args['withBlockers'] as bool? ?? false,
);
return IpcResponse.ok(id: req.id, data: result);
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
d.register('pql.tickets.board', (req) async {
try {
final board = await pql.ticketBoard(
team: req.args['team'] as String?,
);
return IpcResponse.ok(id: req.id, data: {'columns': board});
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
d.register('pql.plan.status', (req) async {
try {
final status = await pql.planStatus();
return IpcResponse.ok(id: req.id, data: status);
} on PqlException catch (e) {
return _pqlError(req.id, e);
}
});
}
IpcResponse _userError(String id, String message) {
return IpcResponse.err(
id: id,
error: IpcError(
code: IpcExitCode.userError,
kind: IpcErrorKind.userError,
message: message,
),
);
}
IpcResponse _pqlError(String id, PqlException e) {
return IpcResponse.err(
id: id,
error: IpcError(
code: IpcExitCode.toolError,
kind: IpcErrorKind.toolError,
message: e.message,
hint: e.stderr.isNotEmpty ? e.stderr : null,
),
);
}