Files
clide/sidecar/internal/pql/doc.go
T
jpmschweitzerandClaude Opus 4.7 c39c2df6f5 add Go sidecar and CLI skeleton
cmd/clide/main.go is the single entry; the same binary will later
switch into sidecar-daemon mode via --daemon. internal/cli holds the
dispatch (stdlib flag for now, Cobra arrives with the first real
subcommand in Tier 2). internal/diag mirrors pql's exit-code contract
so the two tools share one mental model for callers. internal/version
exposes the build-info struct that the Makefile's -ldflags -X targets
stamp; Info() is wired to --version so the binary reports both the
declared project.yaml version and the commit it was built from.

The daemon, pty, proc, git, ipc, and pql sub-packages ship as doc.go
stubs naming the subsystem they will own. They keep the layout legible
before the code lands so tier work has a home on arrival.

Module path targets Gitea (git.schweitz.net/jpmschweitzer/clide/sidecar),
matching where the repo lives. Go module resolution works if the host
serves the meta tags; a vanity import path can be added later if
needed.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-20 22:11:54 +02:00

11 lines
381 B
Go

// Package pql is the *only* place Clide contains pql logic. Pure
// shell-outs to the `pql` binary — no re-implementation of pql's
// indexer, ranker, or frontmatter parsing.
//
// See docs/ADRs/0003-pql-as-supporter-tool.md for the wrap-don't-
// duplicate rule and the "pql is a Clide subsystem when present"
// invariant.
//
// Empty for now — lands in Tier 4.
package pql