@interactive-inc/claude-funnel 0.4.1 → 0.8.0

package/lib/modules/schedule/funnel-schedule.ts

@@ -1,34 +0,0 @@
-import type { FunnelScheduleStore } from "@/modules/connectors/funnel-schedule-store"
-import type { ScheduleEntry } from "@/modules/connectors/schedule-connector-schema"
-
-type Deps = {
-  store: FunnelScheduleStore
-}
-
-export class FunnelSchedule {
-  private readonly store: FunnelScheduleStore
-
-  constructor(deps: Deps) {
-    this.store = deps.store
-    Object.freeze(this)
-  }
-
-  listEntries(connector: string): ScheduleEntry[] {
-    const config = this.store.get(connector)
-
-    if (!config) throw new Error(`connector "${connector}" not found`)
-
-    return config.entries
-  }
-
-  addEntry(
-    connector: string,
-    entry: Omit<ScheduleEntry, "id"> & { id?: string },
-  ): ScheduleEntry {
-    return this.store.addEntry(connector, entry)
-  }
-
-  removeEntry(connector: string, id: string): void {
-    this.store.removeEntry(connector, id)
-  }
-}

package/lib/modules/settings/funnel-settings-store.ts

@@ -1,56 +0,0 @@
-import { homedir } from "node:os"
-import { dirname, join } from "node:path"
-import { FunnelFileSystem } from "@/modules/fs/funnel-file-system"
-import { NodeFunnelFileSystem } from "@/modules/fs/node-funnel-file-system"
-import { FunnelSettingsReader } from "@/modules/settings/funnel-settings-reader"
-import { settingsSchema } from "@/modules/settings/settings-schema"
-import type { Settings } from "@/modules/settings/settings-schema"
-
-export const FUNNEL_DIR = join(homedir(), ".funnel")
-export const SETTINGS_PATH = join(FUNNEL_DIR, "settings.json")
-
-type Deps = {
-  path?: string
-  fs?: FunnelFileSystem
-}
-
-const defaultFs = new NodeFunnelFileSystem()
-
-export class FunnelSettingsStore extends FunnelSettingsReader {
-  private readonly path: string
-  private readonly fs: FunnelFileSystem
-
-  constructor(deps: Deps = {}) {
-    super()
-    this.path = deps.path ?? SETTINGS_PATH
-    this.fs = deps.fs ?? defaultFs
-    Object.freeze(this)
-  }
-
-  read(): Settings {
-    if (!this.fs.existsSync(this.path)) {
-      return {
-        channels: [],
-        repositories: [],
-        profiles: [],
-      }
-    }
-
-    const content = this.fs.readFileSync(this.path)
-    const parsed = JSON.parse(content)
-    const result = settingsSchema.safeParse(parsed)
-
-    if (!result.success) {
-      throw new Error(
-        `invalid settings.json (${this.path}): ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join(", ")}`,
-      )
-    }
-
-    return result.data
-  }
-
-  write(settings: Settings): void {
-    this.fs.mkdirSync(dirname(this.path), { recursive: true })
-    this.fs.writeFileSync(this.path, `${JSON.stringify(settings, null, 2)}\n`)
-  }
-}

package/lib/modules/settings/settings-schema.ts

@@ -1,33 +0,0 @@
-import { z } from "zod"
-
-export const channelConfigSchema = z.object({
-  name: z.string(),
-  connectors: z.array(z.string()).default([]),
-})
-
-export type ChannelConfig = z.infer<typeof channelConfigSchema>
-
-export const repositoryConfigSchema = z.object({
-  name: z.string(),
-  path: z.string(),
-})
-
-export type RepositoryConfig = z.infer<typeof repositoryConfigSchema>
-
-export const profileConfigSchema = z.object({
-  name: z.string(),
-  channel: z.string(),
-  repo: z.string().optional(),
-  subAgent: z.string().optional(),
-  envFiles: z.array(z.string()).optional(),
-})
-
-export type ProfileConfig = z.infer<typeof profileConfigSchema>
-
-export const settingsSchema = z.object({
-  channels: z.array(channelConfigSchema).default([]),
-  repositories: z.array(repositoryConfigSchema).default([]),
-  profiles: z.array(profileConfigSchema).default([]),
-})
-
-export type Settings = z.infer<typeof settingsSchema>

package/lib/modules/tui/app.tsx

@@ -1,44 +0,0 @@
-import { useKeyboard, useRenderer, useTerminalDimensions } from "@opentui/react"
-
-const zinc = {
-  50: "#fafafa",
-  600: "#52525b",
-  950: "#09090b",
-} as const
-
-const LABEL = "funnel"
-
-export function App() {
-  const renderer = useRenderer()
-
-  const dimensions = useTerminalDimensions()
-
-  useKeyboard((key) => {
-    if (key.name === "q" || key.name === "escape" || (key.ctrl && key.name === "c")) {
-      renderer.destroy()
-    }
-  })
-
-  const marginLeft = Math.max(0, Math.floor((dimensions.width - LABEL.length) / 2))
-
-  const marginTop = Math.max(0, Math.floor(dimensions.height / 2) - 1)
-
-  return (
-    <box
-      style={{
-        width: "100%",
-        height: "100%",
-        flexDirection: "column",
-        backgroundColor: zinc[950],
-      }}
-    >
-      <box style={{ height: marginTop, backgroundColor: zinc[950] }} />
-      <text fg={zinc[50]} bg={zinc[950]} style={{ marginLeft }}>
-        {LABEL}
-      </text>
-      <text fg={zinc[600]} bg={zinc[950]} position="absolute" bottom={0}>
-        press q to quit
-      </text>
-    </box>
-  )
-}

package/lib/modules/tui/tui.tsx

@@ -1,13 +0,0 @@
-import { createCliRenderer } from "@opentui/core"
-import { createRoot } from "@opentui/react"
-import { App } from "@/modules/tui/app"
-
-export async function launchTui(): Promise<void> {
-  const renderer = await createCliRenderer()
-
-  createRoot(renderer).render(<App />)
-
-  await new Promise<void>((resolve) => {
-    renderer.once("destroy", () => resolve())
-  })
-}

package/lib/routes/channels/add.help.ts

@@ -1,3 +0,0 @@
-export const help = `funnel channels add — add a channel
-
-usage: funnel channels add <name> [--connector <c>]...`

package/lib/routes/channels/add.ts

@@ -1,21 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/channels/add.help"
-
-export const channelsAddHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string() })),
-  zValidator("query", z.object({ connector: z.string().optional() }), help),
-  (c) => {
-    const param = c.req.valid("param")
-    const query = c.req.valid("query")
-    const funnel = c.var.funnel
-
-    funnel.channels.add({
-      name: param.name,
-      connectors: query.connector ? [query.connector] : [],
-    })
-
-    return c.text(`added channel "${param.name}"`)
-  },
-)

package/lib/routes/channels/connectors-attach.help.ts

@@ -1,3 +0,0 @@
-export const help = `funnel channels <name> connectors attach — subscribe to a connector
-
-usage: funnel channels <name> connectors attach <connector>`

package/lib/routes/channels/connectors-attach.ts

@@ -1,17 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/channels/connectors-attach.help"
-
-export const channelsConnectorsAttachHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string(), connector: z.string() })),
-  zValidator("query", z.object({}), help),
-  (c) => {
-    const param = c.req.valid("param")
-    const funnel = c.var.funnel
-
-    funnel.channels.attachConnector(param.name, param.connector)
-
-    return c.text(`attached connector "${param.connector}" to channel "${param.name}"`)
-  },
-)

package/lib/routes/channels/connectors-detach.help.ts

@@ -1,3 +0,0 @@
-export const help = `funnel channels <name> connectors detach — unsubscribe from a connector
-
-usage: funnel channels <name> connectors detach <connector>`

package/lib/routes/channels/connectors-detach.ts

@@ -1,17 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/channels/connectors-detach.help"
-
-export const channelsConnectorsDetachHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string(), connector: z.string() })),
-  zValidator("query", z.object({}), help),
-  (c) => {
-    const param = c.req.valid("param")
-    const funnel = c.var.funnel
-
-    funnel.channels.detachConnector(param.name, param.connector)
-
-    return c.text(`detached connector "${param.connector}" from channel "${param.name}"`)
-  },
-)

package/lib/routes/channels/group.help.ts

@@ -1,16 +0,0 @@
-export const help = `funnel channels — manage subscription boxes
-
-usage: funnel channels [subcommand]
-
-subcommands:
-  (none)                          list
-  add <name>                      add
-  remove <name>                   remove
-  <name>                          show details
-  <name> connectors attach <c>    subscribe to a connector
-  <name> connectors detach <c>    unsubscribe from a connector
-
-examples:
-  funnel channels add prod-inbox
-  funnel channels prod-inbox connectors attach prod-slack
-  funnel channels prod-inbox`

package/lib/routes/channels/group.ts

@@ -1,22 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/channels/group.help"
-
-export const channelsGroupHandler = factory.createHandlers(
-  zValidator("query", z.object({}), help),
-  (c) => {
-    const funnel = c.var.funnel
-    const channels = funnel.channels.list()
-
-    if (channels.length === 0) return c.text("no channels")
-
-    const lines = channels.map((ch) => {
-      const connectors = ch.connectors.length > 0 ? ch.connectors.join(", ") : "(none)"
-
-      return `${ch.name} [${connectors}]`
-    })
-
-    return c.text(lines.join("\n"))
-  },
-)

package/lib/routes/channels/remove.help.ts

@@ -1,3 +0,0 @@
-export const help = `funnel channels remove — remove a channel
-
-usage: funnel channels remove <name>`

package/lib/routes/channels/remove.ts

@@ -1,17 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/channels/remove.help"
-
-export const channelsRemoveHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string() })),
-  zValidator("query", z.object({}), help),
-  (c) => {
-    const param = c.req.valid("param")
-    const funnel = c.var.funnel
-
-    funnel.channels.remove(param.name)
-
-    return c.text(`removed channel "${param.name}"`)
-  },
-)

package/lib/routes/channels/rename.help.ts

@@ -1,5 +0,0 @@
-export const help = `funnel channels rename — rename a channel
-
-usage:
-  funnel channels rename <old> <new>
-  funnel channels <old> rename <new>`

package/lib/routes/channels/rename.ts

@@ -1,17 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/channels/rename.help"
-
-export const channelsRenameHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string(), newName: z.string() })),
-  zValidator("query", z.object({}), help),
-  (c) => {
-    const param = c.req.valid("param")
-    const funnel = c.var.funnel
-
-    funnel.channels.rename(param.name, param["newName"])
-
-    return c.text(`renamed channel "${param.name}" to "${param["newName"]}"`)
-  },
-)

package/lib/routes/channels/routes.ts

@@ -1,19 +0,0 @@
-import { factory } from "@/factory"
-import { channelsAddHandler } from "@/routes/channels/add"
-import { channelsConnectorsAttachHandler } from "@/routes/channels/connectors-attach"
-import { channelsConnectorsDetachHandler } from "@/routes/channels/connectors-detach"
-import { channelsGroupHandler } from "@/routes/channels/group"
-import { channelsRemoveHandler } from "@/routes/channels/remove"
-import { channelsRenameHandler } from "@/routes/channels/rename"
-import { channelsShowHandler } from "@/routes/channels/show"
-
-export const channelsRoutes = factory
-  .createApp()
-  .get("/", ...channelsGroupHandler)
-  .put("/:name/rename/:newName", ...channelsRenameHandler)
-  .put("/rename/:name/:newName", ...channelsRenameHandler)
-  .put("/:name/connectors/attach/:connector", ...channelsConnectorsAttachHandler)
-  .delete("/:name/connectors/detach/:connector", ...channelsConnectorsDetachHandler)
-  .post("/:name", ...channelsAddHandler)
-  .delete("/:name", ...channelsRemoveHandler)
-  .get("/:name", ...channelsShowHandler)

package/lib/routes/channels/show.help.ts

@@ -1 +0,0 @@
-export const help = `funnel channels <name> — show channel details`

package/lib/routes/channels/show.ts

@@ -1,26 +0,0 @@
-import { HTTPException } from "hono/http-exception"
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/channels/show.help"
-
-export const channelsShowHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string() })),
-  zValidator("query", z.object({}), help),
-  (c) => {
-    const param = c.req.valid("param")
-    const funnel = c.var.funnel
-    const channel = funnel.channels.get(param.name)
-
-    if (!channel) {
-      throw new HTTPException(404, { message: `channel "${param.name}" not found` })
-    }
-
-    const lines = [
-      `name: ${channel.name}`,
-      `connectors: ${channel.connectors.length > 0 ? channel.connectors.join(", ") : "(none)"}`,
-    ]
-
-    return c.text(lines.join("\n"))
-  },
-)

package/lib/routes/claude/claude.help.ts

@@ -1,16 +0,0 @@
-export const help = `funnel claude — launch Claude Code
-
-usage:
-  funnel claude                          launch "default" profile (or the first profile)
-  funnel claude --profile <name>         launch a named profile
-  funnel claude --channel <name> [opts]  raw launch (no profile)
-
-options (override profile / raw):
-  --profile        profile name to launch
-  --channel        channel name to subscribe to
-  --repo           switch working directory to the named repo
-  --sub-agent      sub-agent name (passed to claude --agent)
-  --env-file       additional env file to load (relative path)
-
-Any other arguments are forwarded to the claude CLI.
-On launch the FUNNEL_CHANNEL_ID env var is set and MCP connects to the gateway.`

package/lib/routes/claude/claude.ts

@@ -1,76 +0,0 @@
-import { HTTPException } from "hono/http-exception"
-import { z } from "zod"
-import { factory } from "@/factory"
-import { queryToCliArgs } from "@/modules/router/query-to-cli-args"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/claude/claude.help"
-
-const RESERVED_KEYS = ["profile", "channel", "repo", "sub-agent", "env-file"]
-
-const DEFAULT_PROFILE_NAME = "default"
-
-export const claudeHandler = factory.createHandlers(
-  zValidator(
-    "query",
-    z
-      .object({
-        profile: z.string().optional(),
-        channel: z.string().optional(),
-        repo: z.string().optional(),
-        "sub-agent": z.string().optional(),
-        "env-file": z.string().optional(),
-      })
-      .passthrough(),
-    help,
-  ),
-  async (c) => {
-    const query = c.req.valid("query")
-    const funnel = c.var.funnel
-
-    if (query.profile) {
-      const profile = funnel.profiles.get(query.profile)
-
-      if (!profile) {
-        throw new HTTPException(404, { message: `profile "${query.profile}" not found` })
-      }
-
-      const exitCode = await funnel.claude.launch({
-        channel: query.channel ?? profile.channel,
-        repo: query.repo ?? profile.repo,
-        subAgent: query["sub-agent"] ?? profile.subAgent,
-        envFiles: query["env-file"] ? [query["env-file"]] : profile.envFiles,
-        userArgs: queryToCliArgs(c.req.url, RESERVED_KEYS),
-        profileName: profile.name,
-      })
-
-      process.exit(exitCode)
-    }
-
-    if (query.channel) {
-      const exitCode = await funnel.claude.launch({
-        channel: query.channel,
-        repo: query.repo,
-        subAgent: query["sub-agent"],
-        envFiles: query["env-file"] ? [query["env-file"]] : undefined,
-        userArgs: queryToCliArgs(c.req.url, RESERVED_KEYS),
-      })
-
-      process.exit(exitCode)
-    }
-
-    const defaultProfile = funnel.profiles.get(DEFAULT_PROFILE_NAME) ?? funnel.profiles.list()[0]
-
-    if (!defaultProfile) return c.text(help)
-
-    const exitCode = await funnel.claude.launch({
-      channel: defaultProfile.channel,
-      repo: query.repo ?? defaultProfile.repo,
-      subAgent: query["sub-agent"] ?? defaultProfile.subAgent,
-      envFiles: query["env-file"] ? [query["env-file"]] : defaultProfile.envFiles,
-      userArgs: queryToCliArgs(c.req.url, RESERVED_KEYS),
-      profileName: defaultProfile.name,
-    })
-
-    process.exit(exitCode)
-  },
-)

package/lib/routes/claude/routes.ts

@@ -1,4 +0,0 @@
-import { factory } from "@/factory"
-import { claudeHandler } from "@/routes/claude/claude"
-
-export const claudeRoutes = factory.createApp().get("/", ...claudeHandler)

package/lib/routes/connectors/add.help.ts

@@ -1,28 +0,0 @@
-export const help = `funnel connectors add — add a connector
-
-usage:
-  funnel connectors add <name> --type slack    --bot-token xoxb-... --app-token xapp-...
-  funnel connectors add <name> --type gh       [--poll-interval <seconds>]
-  funnel connectors add <name> --type discord  --bot-token <discord-bot-token>
-  funnel connectors add <name> --type schedule
-
-slack (Socket Mode):
-  --bot-token             Slack Bot Token (starts with xoxb-)
-  --app-token             Slack App Token (starts with xapp-)
-
-gh (GitHub, gh CLI):
-  --poll-interval         polling interval for /notifications (seconds, default 60)
-  note: uses the gh CLI (must be authenticated via gh auth login); no token required
-
-discord (Discord Gateway):
-  --bot-token             Discord Bot Token
-
-schedule (cron-driven prompts):
-  no extra flags at connector level — add entries with:
-    funnel connectors <name> schedules add --cron "* * * * *" --prompt "..."
-
-examples:
-  funnel connectors add prod-slack --type slack --bot-token xoxb-... --app-token xapp-...
-  funnel connectors add my-gh --type gh --poll-interval 30
-  funnel connectors add my-discord --type discord --bot-token MTI...
-  funnel connectors add my-cron --type schedule`

package/lib/routes/connectors/add.ts

@@ -1,64 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/connectors/add.help"
-
-export const connectorsAddHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string() })),
-  zValidator(
-    "query",
-    z.discriminatedUnion("type", [
-      z.object({
-        type: z.literal("slack"),
-        "bot-token": z.string().startsWith("xoxb-"),
-        "app-token": z.string().startsWith("xapp-"),
-      }),
-      z.object({
-        type: z.literal("gh"),
-        "poll-interval": z.string().optional(),
-      }),
-      z.object({
-        type: z.literal("discord"),
-        "bot-token": z.string().min(10),
-      }),
-      z.object({
-        type: z.literal("schedule"),
-      }),
-    ]),
-    help,
-  ),
-  (c) => {
-    const param = c.req.valid("param")
-    const query = c.req.valid("query")
-    const funnel = c.var.funnel
-
-    if (query.type === "slack") {
-      funnel.connectors.add({
-        type: "slack",
-        name: param.name,
-        botToken: query["bot-token"],
-        appToken: query["app-token"],
-      })
-    } else if (query.type === "gh") {
-      funnel.connectors.add({
-        type: "gh",
-        name: param.name,
-        pollInterval: query["poll-interval"] ? Number(query["poll-interval"]) : undefined,
-      })
-    } else if (query.type === "discord") {
-      funnel.connectors.add({
-        type: "discord",
-        name: param.name,
-        botToken: query["bot-token"],
-      })
-    } else {
-      funnel.connectors.add({
-        type: "schedule",
-        name: param.name,
-        entries: [],
-      })
-    }
-
-    return c.text(`added connector "${param.name}"`)
-  },
-)

package/lib/routes/connectors/group.help.ts

@@ -1,14 +0,0 @@
-export const help = `funnel connectors — manage external connections (Slack, etc.)
-
-usage: funnel connectors [subcommand]
-
-subcommands:
-  (none)                       list
-  add <name> --type slack --bot-token <t> --app-token <t>
-  remove <name>
-  <name>                       show details
-
-examples:
-  funnel connectors add prod-slack --type slack --bot-token xoxb-... --app-token xapp-...
-  funnel connectors
-  funnel connectors remove prod-slack`

package/lib/routes/connectors/group.ts

@@ -1,18 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/connectors/group.help"
-
-export const connectorsGroupHandler = factory.createHandlers(
-  zValidator("query", z.object({}), help),
-  (c) => {
-    const funnel = c.var.funnel
-    const connectors = funnel.connectors.list()
-
-    if (connectors.length === 0) return c.text("no connectors")
-
-    const lines = connectors.map((con) => `${con.name} (${con.type})`)
-
-    return c.text(lines.join("\n"))
-  },
-)

package/lib/routes/connectors/remove.help.ts

@@ -1,3 +0,0 @@
-export const help = `funnel connectors remove — remove a connector
-
-usage: funnel connectors remove <name>`

package/lib/routes/connectors/remove.ts

@@ -1,17 +0,0 @@
-import { z } from "zod"
-import { factory } from "@/factory"
-import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/connectors/remove.help"
-
-export const connectorsRemoveHandler = factory.createHandlers(
-  zValidator("param", z.object({ name: z.string() })),
-  zValidator("query", z.object({}), help),
-  (c) => {
-    const param = c.req.valid("param")
-    const funnel = c.var.funnel
-
-    funnel.connectors.remove(param.name)
-
-    return c.text(`removed connector "${param.name}"`)
-  },
-)

package/lib/routes/connectors/rename.help.ts

@@ -1,5 +0,0 @@
-export const help = `funnel connectors rename — rename a connector
-
-usage:
-  funnel connectors rename <old> <new>
-  funnel connectors <old> rename <new>`