Fix tool install-state, inherit program description, declutter Tools cards

- Tool detail showed installed tools as 'Not installed': /deployments/{name}
  populated 'installed' for path deployments but left 'active' null, and
  ToolDetail keyed off 'active'. Now the endpoint sets active=installed for path,
  and ToolDetail reads 'installed' directly (verified: on-PATH ⇒ True, else False).
- A deployment now inherits its program's description by default: copied at
  creation (CLI create + API _save_deployment on new deployments) + a one-time
  patchup of existing ones (29 deployments).
- Tools page cards no longer list deployments (ProgramCard showDeployments=false) —
  the lens already scopes to the tool; the deployment list is a Programs-catalog thing.
This commit is contained in:
2026-07-01 13:07:00 -07:00
parent 183c589b63
commit 0463cd91f1
7 changed files with 64 additions and 33 deletions

View File

@@ -9,9 +9,16 @@ interface ProgramCardProps {
// "/tools" so a tool card opens its tool detail page (a tool is 1:1 with its
// program, same name).
linkBase?: string
// Whether to list the program's deployments. The Programs catalog shows them;
// a kind-specific lens (e.g. Tools) is already looking at one deployment, so off.
showDeployments?: boolean
}
export function ProgramCard({ program, linkBase = "/programs" }: ProgramCardProps) {
export function ProgramCard({
program,
linkBase = "/programs",
showDeployments = true,
}: ProgramCardProps) {
// The dot reflects the uniform lifecycle state (a tool on PATH, a service
// running, a static site served). Lifecycle controls live on the detail page's
// Deployment section, not here — a card just shows state and links through.
@@ -38,19 +45,21 @@ export function ProgramCard({ program, linkBase = "/programs" }: ProgramCardProp
<StackBadge stack={program.stack} />
</div>
{/* A program has no kind of its own — show its deployments (name · kind). */}
{program.deployments.length > 0 ? (
<div className="flex flex-col gap-1 mb-2">
{program.deployments.map((d) => (
<div key={d.name} className="flex items-center gap-1.5 text-xs">
<span className="font-mono text-[var(--muted)]">{d.name}</span>
<KindBadge kind={d.kind} />
</div>
))}
</div>
) : (
<p className="text-xs text-[var(--muted)] italic mb-2">no deployment</p>
)}
{/* A program has no kind of its own — show its deployments (name · kind).
Suppressed on kind-specific lenses (e.g. Tools) which already scope to one. */}
{showDeployments &&
(program.deployments.length > 0 ? (
<div className="flex flex-col gap-1 mb-2">
{program.deployments.map((d) => (
<div key={d.name} className="flex items-center gap-1.5 text-xs">
<span className="font-mono text-[var(--muted)]">{d.name}</span>
<KindBadge kind={d.kind} />
</div>
))}
</div>
) : (
<p className="text-xs text-[var(--muted)] italic mb-2">no deployment</p>
))}
{program.description && (
<p className="text-sm text-[var(--muted)]">{program.description}</p>

View File

@@ -5,9 +5,10 @@ import { ProgramCard } from "./ProgramCard"
interface ProgramListProps {
programs: ProgramSummary[]
linkBase?: string // where each card links (default "/programs")
showDeployments?: boolean // list each program's deployments on the card (default true)
}
export function ProgramList({ programs, linkBase }: ProgramListProps) {
export function ProgramList({ programs, linkBase, showDeployments }: ProgramListProps) {
const [search, setSearch] = useState("")
const filtered = useMemo(() => {
@@ -39,7 +40,12 @@ export function ProgramList({ programs, linkBase }: ProgramListProps) {
) : (
<div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
{filtered.map((program) => (
<ProgramCard key={program.id} program={program} linkBase={linkBase} />
<ProgramCard
key={program.id}
program={program}
linkBase={linkBase}
showDeployments={showDeployments}
/>
))}
</div>
)}

View File

@@ -38,8 +38,9 @@ export function ToolDetailPage() {
<p className="text-sm text-[var(--muted)] -mt-4 mb-6">{deployment.description}</p>
)}
{/* A tool's PATH deployment: install/uninstall is its start/stop. */}
<PathLifecycle name={deployment.id} active={deployment.active} onDone={refetch} />
{/* A tool's PATH deployment: install/uninstall is its start/stop. Its
live state is `installed` (on PATH), which the endpoint sets directly. */}
<PathLifecycle name={deployment.id} installed={deployment.installed} onDone={refetch} />
<div className="bg-[var(--card)] border border-[var(--border)] rounded-lg p-5 mb-6">
<h2 className="text-sm font-semibold text-[var(--muted)] uppercase tracking-wider mb-3">
@@ -65,19 +66,19 @@ export function ToolDetailPage() {
/** Install/uninstall a tool on PATH — the path deployment's lifecycle. */
function PathLifecycle({
name,
active,
installed: installedState,
onDone,
}: {
name: string
active: boolean | null
installed: boolean | null
onDone: () => void
}) {
const { mutate, isPending } = useProgramAction()
const installed = active === true
const installed = installedState === true
const dot =
active === true
installedState === true
? "bg-green-500"
: active === false
: installedState === false
? "bg-[var(--muted)]"
: "bg-transparent border border-[var(--muted)]"
return (

View File

@@ -14,7 +14,7 @@ export function Tools() {
{isLoading ? (
<p className="text-[var(--muted)]">Loading...</p>
) : programs && programs.length > 0 ? (
<ProgramList programs={programs} linkBase="/tools" />
<ProgramList programs={programs} linkBase="/tools" showDeployments={false} />
) : (
<p className="text-[var(--muted)]">No tools yet.</p>
)}