First real content for the `clide` Dart package at the repo root.
One AOT-compiled binary (ADR 0005) with two modes:
* `clide --daemon` long-running unix-socket server; listens on
`$XDG_RUNTIME_DIR/clide-$USER.sock` with stale-socket
reclaim, accepts JSON-lines request/response traffic, clean
SIGTERM shutdown unlinks the socket file.
* `clide <subcommand>` one-shot; opens the socket, sends a
request, writes the response JSON to stdout, exits with the
dispatcher's error code per ADR 0006 (0/1/2/3/4). Unknown
subcommands forward to the daemon so extensions can register
their own without CLI changes.
Tier 0 handlers: `ping` (returns pong + version + UTC ts) and
`version`. Both are covered by `test/ipc/` + `test/daemon/`; the
subprocess test builds `bin/clide`, starts it, pings it, SIGTERMs
it, and asserts the socket file disappears.
Co-Authored-By: Claude <noreply@anthropic.com>
36 lines
1017 B
Dart
36 lines
1017 B
Dart
/// clide — Dart core library.
|
|
///
|
|
/// Shared by `bin/clide.dart` (CLI + daemon) and by the Flutter app
|
|
/// under `app/` (which depends on this package via `path: ../`).
|
|
///
|
|
/// See:
|
|
/// * docs/ADRs/0005-dart-core-ptyc-peer.md — layout + language rationale.
|
|
/// * docs/ADRs/0006-cli-and-event-surface.md — CLI + event contract.
|
|
library;
|
|
|
|
export 'src/daemon/dispatcher.dart';
|
|
export 'src/ipc/envelope.dart';
|
|
export 'src/ipc/paths.dart';
|
|
export 'src/ipc/schema_v1.dart';
|
|
export 'src/ipc/server.dart';
|
|
|
|
/// Build-time-stamped version string.
|
|
///
|
|
/// The Makefile's `build` target passes `--define=clideVersion=…` when
|
|
/// invoking `dart compile exe`, stamping `project.yaml`'s `version:`
|
|
/// plus the git short SHA and dirty marker.
|
|
const clideVersion = String.fromEnvironment(
|
|
'clideVersion',
|
|
defaultValue: '2.0.0-dev',
|
|
);
|
|
|
|
const clideCommit = String.fromEnvironment(
|
|
'clideCommit',
|
|
defaultValue: 'unknown',
|
|
);
|
|
|
|
const clideDate = String.fromEnvironment(
|
|
'clideDate',
|
|
defaultValue: 'unknown',
|
|
);
|