kennel 0.2.12 → 0.2.15

package/kernel/packages/agents/src/types.ts

@@ -1,82 +0,0 @@
-export type AgentClientId = "generic" | "codex" | "claude" | "pi"
-
-export type ClientFilter = AgentClientId | "all"
-
-export type SourceLevel =
-  "project" | "parent" | "repository" | "linked" | "global"
-
-export type AgentSourceStatus = "loaded" | "unreadable" | "unsafe"
-
-export type AgentSource = {
-  /** Physical file identity (resolved realpath), used for deduplication. */
-  id: string
-  /** Canonical physical path shown next to the source text. */
-  path: string
-  /** Literal file paths that resolved to this physical file (e.g. symlinks). */
-  sourcePaths: string[]
-  /** Leaf file name, e.g. AGENTS.md or CLAUDE.local.md. */
-  filename: string
-  /** Physical containing directory. */
-  directory: string
-  /** Where the source sits in the project → parents → global order. */
-  level: SourceLevel
-  /** Read result. Unreadable sources stay visible instead of hidden. */
-  status: AgentSourceStatus
-  /** Full instruction text (empty when the status is not `loaded`). */
-  text: string
-  /** Byte length of the physical file. */
-  size: number
-  /** Clients whose discovery includes this physical file. */
-  clientIds: AgentClientId[]
-  /** True when this file is a per-directory override (AGENTS.override.md). */
-  override: boolean
-  /** All listed sources apply to the selected working folder. */
-  applies: true
-  /** Human reason for an unreadable source. */
-  reason?: string
-}
-
-export type AgentWarning =
-  | {
-      kind: "missing"
-      /** Directory or path that was expected but contained no instruction file. */
-      path: string
-      /** Clients that expected a file here. */
-      clientIds: AgentClientId[]
-      reason: string
-    }
-  | {
-      kind: "unsupported"
-      /** Clients whose configuration is not applied by this preview. */
-      clientIds: AgentClientId[]
-      reason: string
-    }
-
-/**
- * One directory in the ancestor walk: the working folder first, then every
- * parent up to the selected client's boundary. Directories without any
- * instruction file stay visible so the full chain going up is always shown.
- */
-export type AgentChainEntry = {
-  /** Physical directory, ordered from the working folder up to the boundary. */
-  directory: string
-  /** Where the directory sits in the working-folder → boundary order. */
-  level: SourceLevel
-  /** Instruction files found in this directory for the selected client. */
-  filenames: string[]
-}
-
-export type AgentsResolution = {
-  /** Canonical working folder. */
-  folder: string
-  /** Nearest ancestor containing `.git`, or null when none is found. */
-  repositoryRoot: string | null
-  /** Client filter used for this resolution. */
-  client: ClientFilter
-  /** Ordered, deduplicated sources: project, parents, then global. */
-  sources: AgentSource[]
-  /** Non-fatal warnings (missing files, unapplied configuration). */
-  warnings: AgentWarning[]
-  /** The full ancestor walk: working folder up to the client's boundary. */
-  chain: AgentChainEntry[]
-}

package/kernel/packages/agents/src/viewer.tsx

@@ -1,370 +0,0 @@
-import { useMemo, useRef, useState } from "react"
-import { useQuery } from "@tanstack/react-query"
-import { ChevronDown, Info, TriangleAlert } from "lucide-react"
-
-import type { FolderPluginViewProps } from "kennel-plugins/client"
-import {
-  Collapsible,
-  CollapsibleContent,
-  CollapsibleTrigger,
-} from "@raggle-ai/ui/components/collapsible"
-import { FolderFilterBar } from "@raggle-ai/ui/components/folder-filter-bar"
-import {
-  Select,
-  SelectContent,
-  SelectItem,
-  SelectTrigger,
-  SelectValue,
-} from "@raggle-ai/ui/components/select"
-import { useFolderFilter } from "@raggle-ai/ui/hooks/use-folder-filter"
-import { cn } from "@raggle-ai/ui/lib/utils"
-
-import type { AgentsResolution, AgentWarning } from "./types.ts"
-import {
-  AgentCard,
-  agentCardClass,
-  CurrentFolderBox,
-  FolderRow,
-} from "./agent-card.tsx"
-import {
-  clientLabel,
-  FILTERS,
-  parseClientFilter,
-  PROFILES,
-} from "./profiles.ts"
-
-export type AgentsPluginData = Pick<
-  AgentsResolution,
-  "chain" | "client" | "sources"
-> & {
-  folder: string
-  repositoryRoot: string | null
-  status: "available"
-  warnings: AgentWarning[]
-  linkedStatus?: "pending" | "ready" | "error"
-}
-
-function ClientSelect({
-  client,
-  href,
-}: {
-  client: string
-  href: (subpath: string) => string
-}) {
-  return (
-    <div className="flex items-center gap-2">
-      <label
-        className="text-[0.78rem] font-medium tracking-wide text-[#6c7a6d]
-          uppercase"
-      >
-        AI client
-      </label>
-      <Select
-        onValueChange={(value) => {
-          window.location.href = href(value)
-        }}
-        value={client}
-      >
-        <SelectTrigger aria-label="AI client" size="sm" className="w-44">
-          <SelectValue placeholder="Select client" />
-        </SelectTrigger>
-        <SelectContent>
-          {FILTERS.map((option) => (
-            <SelectItem key={option.id} value={option.id}>
-              {option.label}
-            </SelectItem>
-          ))}
-        </SelectContent>
-      </Select>
-    </div>
-  )
-}
-
-export function AgentsPluginView({
-  folder,
-  folderId,
-  hostActions,
-  href,
-  request,
-  subpath,
-}: FolderPluginViewProps) {
-  const client = parseClientFilter(subpath || null)
-  const retryLinked = useRef(false)
-  const query = useQuery({
-    enabled: Boolean(folder),
-    gcTime: 5 * 60_000,
-    queryFn: ({ signal }) => {
-      const headers = retryLinked.current
-        ? { "x-kennel-retry-linked": "1" }
-        : undefined
-      retryLinked.current = false
-      return request(subpath, { signal, headers }) as Promise<AgentsPluginData>
-    },
-    queryKey: ["folder", folderId, "agents", subpath ?? ""],
-    staleTime: 15_000,
-    refetchInterval: (query) =>
-      query.state.data?.linkedStatus === "pending" ? 1_000 : false,
-  })
-  const data = query.data as AgentsPluginData | undefined
-  const sources = useMemo(() => data?.sources ?? [], [data])
-  const warnings = useMemo(() => data?.warnings ?? [], [data])
-  // Shared folder filter over each source's containing directory. Source
-  // directories can be the project folder, ancestors, or the global
-  // directory — `allowOutside` surfaces all of them as chips.
-  const filter = useFolderFilter(sources, {
-    allowOutside: true,
-    getFolder: (source) => source.directory,
-    rootFolder: folder,
-  })
-  const profile = PROFILES[client]
-  const [detailsOpen, setDetailsOpen] = useState(false)
-  const [warningsOpen, setWarningsOpen] = useState(false)
-  const currentFolder = data?.folder ?? folder
-  const hasOwnInstructions = sources.some(
-    (source) => source.level === "project",
-  )
-  // The full ancestor walk (working folder first, then parents up to the
-  // client's boundary). The current-folder box covers the first entry, so
-  // the chain list below shows every directory going up from it.
-  const parentChain = useMemo(() => (data?.chain ?? []).slice(1), [data])
-  const projectSources = useMemo(
-    () => filter.visibleItems.filter((source) => source.level === "project"),
-    [filter.visibleItems],
-  )
-  const globalSources = useMemo(
-    () => filter.visibleItems.filter((source) => source.level === "global"),
-    [filter.visibleItems],
-  )
-  const sourcesIn = (directory: string) =>
-    filter.visibleItems.filter((source) => source.directory === directory)
-  const sourceKey = (source: (typeof sources)[number]) =>
-    `${source.id}:${source.clientIds.join(",")}`
-
-  return (
-    <div
-      className="mx-auto grid w-full max-w-5xl min-w-0 grid-cols-1 gap-4 px-4
-        py-5"
-    >
-      <Collapsible onOpenChange={setDetailsOpen} open={detailsOpen}>
-        <header className="flex flex-wrap items-center justify-between gap-3">
-          <h1 className="m-0 text-2xl font-semibold text-[#233025]">Agents</h1>
-          <CollapsibleTrigger asChild>
-            <button
-              aria-expanded={detailsOpen}
-              aria-label={
-                detailsOpen ? "Hide client details" : "Show client details"
-              }
-              className="inline-flex items-center gap-1.5 rounded-md border
-                border-[#e7ebe7] bg-white px-2.5 py-1 text-[0.78rem] font-medium
-                text-[#4a554b] hover:bg-[#f3f5f2] focus-visible:outline-2
-                focus-visible:outline-[#56725e]"
-              type="button"
-            >
-              <Info className="size-4 text-[#6c7a6d]" />
-              Details
-              <ChevronDown
-                className={cn(
-                  "size-3.5 text-[#6c7a6d] transition-transform",
-                  detailsOpen && "rotate-180",
-                )}
-              />
-            </button>
-          </CollapsibleTrigger>
-        </header>
-        <CollapsibleContent
-          className="data-[state=closed]:animate-out
-            data-[state=open]:animate-in"
-        >
-          <p
-            className="m-0 mt-3 flex items-start gap-2 text-[0.72rem]
-              text-[#6c7a6d]"
-          >
-            <TriangleAlert className="mt-0.5 size-3.5 shrink-0" />
-            <span>
-              {profile.note} {profile.limits}
-            </span>
-          </p>
-        </CollapsibleContent>
-      </Collapsible>
-
-      <div className="flex flex-wrap items-center gap-x-4 gap-y-2">
-        <ClientSelect client={client} href={href} />
-        {filter.choices.length > 1 ? (
-          <FolderFilterBar
-            ariaLabel="Filter by instruction folder"
-            choices={filter.choices}
-            onSelect={filter.setSelected}
-            selected={filter.effectiveSelected}
-            total={filter.total}
-          />
-        ) : null}
-      </div>
-
-      {data ? (
-        <section
-          className={agentCardClass}
-          aria-label="Current folder instructions"
-        >
-          {!projectSources.length ? (
-            <CurrentFolderBox
-              createAction={hostActions?.createAgentFile}
-              folder={currentFolder}
-              hasOwn={hasOwnInstructions}
-              onCreated={() => void query.refetch()}
-            />
-          ) : null}
-
-          {projectSources.length ? (
-            <div className="grid grid-cols-1">
-              {projectSources.map((source) => (
-                <AgentCard
-                  hostActions={hostActions}
-                  key={sourceKey(source)}
-                  source={source}
-                  embedded
-                />
-              ))}
-            </div>
-          ) : null}
-        </section>
-      ) : null}
-
-      {data?.linkedStatus === "pending" ? (
-        <p role="status" className="m-0 text-sm text-[#6c7a6d]">
-          Local instructions loaded. Looking for linked project instructions…
-        </p>
-      ) : null}
-      {data?.linkedStatus === "error" ? (
-        <p role="status" className="m-0 text-sm text-[#9c3a3a]">
-          Linked project discovery is unavailable. Local instructions are shown.
-          <button
-            onClick={() => {
-              retryLinked.current = true
-              void query.refetch()
-            }}
-          >
-            Retry linked instructions
-          </button>
-        </p>
-      ) : null}
-      {query.isPending ? (
-        <p className="m-0 text-sm text-[#6c7a6d]">Loading…</p>
-      ) : null}
-      {query.error ? (
-        <p role="alert" className="m-0 text-sm text-[#9c3a3a]">
-          {String(query.error)}{" "}
-          <button onClick={() => void query.refetch()}>
-            Retry instructions
-          </button>
-        </p>
-      ) : null}
-
-      {warnings.length ? (
-        <Collapsible onOpenChange={setWarningsOpen} open={warningsOpen}>
-          <CollapsibleTrigger asChild>
-            <button
-              aria-expanded={warningsOpen}
-              aria-label={warningsOpen ? "Hide warnings" : "Show warnings"}
-              className="inline-flex items-center gap-1.5 rounded-md border
-                border-[#e7ebe7] bg-white px-2.5 py-1 text-[0.78rem] font-medium
-                text-[#4a554b] hover:bg-[#f3f5f2] focus-visible:outline-2
-                focus-visible:outline-[#56725e]"
-              type="button"
-            >
-              <TriangleAlert className="size-4 text-[#6c7a6d]" />
-              Warnings
-              <span
-                className="rounded-full bg-[#f3f5f2] px-1.5 py-0.5
-                  text-[0.68rem] text-[#6c7a6d]"
-              >
-                {warnings.length}
-              </span>
-              <ChevronDown
-                className={cn(
-                  "size-3.5 text-[#6c7a6d] transition-transform",
-                  warningsOpen && "rotate-180",
-                )}
-              />
-            </button>
-          </CollapsibleTrigger>
-          <CollapsibleContent
-            className="data-[state=closed]:animate-out
-              data-[state=open]:animate-in"
-          >
-            <ul className="m-0 mt-3 list-none space-y-1 p-0">
-              {warnings.map((warning) => (
-                <li
-                  className="text-[0.72rem] text-[#6c7a6d]"
-                  key={`${warning.kind}:${"path" in warning ? warning.path : ""}:${warning.clientIds.join(",")}`}
-                >
-                  {"path" in warning ? `${warning.path} — ` : ""}
-                  {warning.reason} (
-                  {warning.clientIds.map((id) => clientLabel(id)).join(", ")})
-                </li>
-              ))}
-            </ul>
-          </CollapsibleContent>
-        </Collapsible>
-      ) : null}
-
-      {parentChain.length ? (
-        <div className="grid grid-cols-1 gap-4">
-          {parentChain.map((entry) => {
-            const entrySources = sourcesIn(entry.directory)
-            return (
-              <section
-                className={cn(agentCardClass, "scroll-mt-6")}
-                aria-label={`Instructions for ${entry.directory}`}
-                id={`agents-folder-${entry.directory}`}
-                key={entry.directory}
-              >
-                {!entrySources.length ? (
-                  <FolderRow
-                    createAction={hostActions?.createAgentFile}
-                    entry={entry}
-                    onCreated={() => void query.refetch()}
-                  />
-                ) : null}
-                {entrySources.length ? (
-                  <div className="grid grid-cols-1">
-                    {entrySources.map((source) => (
-                      <AgentCard
-                        hostActions={hostActions}
-                        key={sourceKey(source)}
-                        source={source}
-                        embedded
-                      />
-                    ))}
-                  </div>
-                ) : null}
-              </section>
-            )
-          })}
-        </div>
-      ) : null}
-
-      {globalSources.length ? (
-        <section className="scroll-mt-6">
-          <div className="flex items-baseline gap-2">
-            <h3
-              className="m-0 text-[0.82rem] font-semibold"
-              style={{ color: "#315c3b" }}
-            >
-              Global instructions
-            </h3>
-            <span className="text-[0.7rem] text-[#6c7a6d]">Global</span>
-          </div>
-          <div className="mt-1 grid grid-cols-1 gap-3">
-            {globalSources.map((source) => (
-              <AgentCard
-                hostActions={hostActions}
-                key={sourceKey(source)}
-                source={source}
-              />
-            ))}
-          </div>
-        </section>
-      ) : null}
-    </div>
-  )
-}

package/kernel/packages/agents/test/profiles.test.mjs

@@ -1,88 +0,0 @@
-import { describe, expect, test } from "bun:test"
-
-import {
-  CLIENT_ORDER,
-  clientLabel,
-  FILTERS,
-  parseClientFilter,
-  PROFILES,
-} from "../src/profiles.ts"
-
-describe("client profiles", () => {
-  test("the filter list is exactly the four clients", () => {
-    expect(FILTERS.map((option) => option.id)).toEqual([
-      "generic",
-      "codex",
-      "claude",
-      "pi",
-    ])
-    expect(FILTERS.some((option) => option.id.includes("repository"))).toBe(
-      false,
-    )
-  })
-
-  test("unknown filter values resolve to pi by default", () => {
-    expect(parseClientFilter(null)).toBe("pi")
-    expect(parseClientFilter(undefined)).toBe("pi")
-    expect(parseClientFilter("")).toBe("pi")
-    expect(parseClientFilter("bogus")).toBe("pi")
-    expect(parseClientFilter("all")).toBe("pi")
-    expect(parseClientFilter("generic")).toBe("generic")
-    expect(parseClientFilter("codex")).toBe("codex")
-    expect(parseClientFilter("claude")).toBe("claude")
-    expect(parseClientFilter("pi")).toBe("pi")
-  })
-
-  test("generic is a root-walking reference view with no verified claim", () => {
-    expect(PROFILES.generic.scope).toBe("root")
-    expect(PROFILES.generic.files).toEqual(["AGENTS.md"])
-    expect(PROFILES.generic.verified).toBe(false)
-  })
-
-  test("codex stops at git, prefers AGENTS.override.md, and honors CODEX_HOME", () => {
-    expect(PROFILES.codex.scope).toBe("git")
-    expect(PROFILES.codex.files).toEqual(["AGENTS.override.md", "AGENTS.md"])
-    expect(PROFILES.codex.filesMode).toBe("first")
-    expect(PROFILES.codex.globalEnv).toBe("CODEX_HOME")
-    expect(PROFILES.codex.globalFiles).toEqual([
-      "AGENTS.override.md",
-      "AGENTS.md",
-    ])
-  })
-
-  test("claude loads the three documented ancestor files and walks to root", () => {
-    expect(PROFILES.claude.scope).toBe("root")
-    expect(PROFILES.claude.files).toEqual([
-      "CLAUDE.md",
-      ".claude/CLAUDE.md",
-      "CLAUDE.local.md",
-    ])
-    expect(PROFILES.claude.filesMode).toBe("all")
-    expect(PROFILES.claude.globalDir).toBe(".claude")
-  })
-
-  test("pi uses the documented first-match candidate list and honors PI_CODING_AGENT_DIR", () => {
-    expect(PROFILES.pi.scope).toBe("root")
-    expect(PROFILES.pi.files).toEqual([
-      "AGENTS.override.md",
-      "AGENTS.md",
-      "AGENTS.MD",
-      "CLAUDE.md",
-      "CLAUDE.MD",
-    ])
-    expect(PROFILES.pi.filesMode).toBe("first")
-    expect(PROFILES.pi.globalEnv).toBe("PI_CODING_AGENT_DIR")
-    expect(PROFILES.pi.globalFiles).toEqual(PROFILES.pi.files)
-  })
-
-  test("client order keeps the stable inventory order", () => {
-    expect(CLIENT_ORDER).toEqual(["generic", "codex", "claude", "pi"])
-  })
-
-  test("labels map back to the client ids", () => {
-    expect(clientLabel("generic")).toBe("Generic")
-    expect(clientLabel("codex")).toBe("Codex")
-    expect(clientLabel("claude")).toBe("Claude Code")
-    expect(clientLabel("pi")).toBe("Pi")
-  })
-})