expandai 0.0.4 → 0.0.6

package/src/CommandPath.ts

@@ -1,30 +0,0 @@
-/**
- * Telemetry-safe command-path extraction. Only tokens that sit in legal
- * command-path positions of the tree below are ever reported — never
- * free-form args, URLs, or queries. The walk stops at the first token that
- * isn't a subcommand of the current node, so positional user input can't
- * leak even when it happens to equal a command word
- * (`expandai search snap_abc login` reports just `search`). Choice-arg
- * values (hosts, scopes) are positional data and deliberately absent.
- */
-const COMMAND_TREE = new Map<string, ReadonlySet<string>>([
-	['fetch', new Set()],
-	['search', new Set()],
-	['login', new Set()],
-	['whoami', new Set()],
-	['logout', new Set()],
-	['init', new Set()],
-	['status', new Set()],
-	['uninstall', new Set()],
-	['mcp', new Set(['run', 'install', 'uninstall'])],
-	['skill', new Set(['install', 'uninstall'])],
-	['hook', new Set(['claude-code', 'opencode', 'install', 'uninstall'])],
-	['telemetry', new Set(['status', 'enable', 'disable'])],
-])
-
-export function commandFromArgv(argv: readonly string[]): string {
-	const [first, second] = argv.slice(2)
-	const subcommands = first === undefined ? undefined : COMMAND_TREE.get(first)
-	if (first === undefined || subcommands === undefined) return '(none)'
-	return second !== undefined && subcommands.has(second) ? `${first} ${second}` : first
-}

package/src/Commands/Fetch.ts

@@ -1,188 +0,0 @@
-import { Args, Command, HelpDoc, Options } from '@effect/cli'
-import { DEFAULT_PLAYGROUND_HOST, resolvePlaygroundHost } from '@expandai/sdk/Playground'
-import { Console, Effect, Match, Option, Schema, String } from 'effect'
-import { ApiClient } from '../ApiClient.js'
-import { withCitationFooter } from '../Hook/SnapshotNote.js'
-import { highlightMarkdownAnsi, shouldColorizeMarkdown } from '../MarkdownAnsi.js'
-import { renderSnippets, withCitationUrls } from '../Snippets.js'
-
-export class MarkdownUnavailable extends Schema.TaggedError<MarkdownUnavailable>()('MarkdownUnavailable', {
-	url: Schema.String,
-}) {
-	get message() {
-		return `No markdown content was returned for ${this.url}`
-	}
-}
-
-export class SnippetsUnavailable extends Schema.TaggedError<SnippetsUnavailable>()('SnippetsUnavailable', {
-	url: Schema.String,
-	query: Schema.String,
-}) {
-	get message() {
-		return `No snippets were returned for ${this.url} matching '${this.query}'`
-	}
-}
-
-// `Options.text('format').pipe(Options.withDefault('text'))` is optional, so
-// when the user types `expandai fetch --format` (no value) the parser falls
-// through to the default and `--format` is fed to the URL positional. WHATWG's
-// URL parser accepts `https://--format` as a host-only URL, so without this
-// guard the bogus value reaches the API. Reject flag-looking input up front,
-// and require a hostname with a dot (or `localhost`) so `fetch help` etc. fail
-// here with a clear message instead of via the API's schema decoder.
-//
-// `Args.mapEffect` is preferred over `Args.withSchema` because the latter
-// renders failures with `ParseResult.TreeFormatter`, which dumps the full
-// schema-decode trace.
-export const parseUrlArg = Effect.fn('Fetch.parseUrlArg')(function* (raw: string) {
-	if (raw.startsWith('-')) {
-		return yield* Effect.fail(HelpDoc.p(`Missing argument <url> (received '${raw}')`))
-	}
-	const candidate = raw.startsWith('http://') || raw.startsWith('https://') ? raw : `https://${raw}`
-	const parsed = yield* Effect.try({
-		try: () => new URL(candidate),
-		catch: () => HelpDoc.p(`Invalid URL '${raw}'`),
-	})
-	if (!parsed.hostname.includes('.') && parsed.hostname !== 'localhost') {
-		return yield* Effect.fail(HelpDoc.p(`URL must contain a valid domain (got '${raw}')`))
-	}
-	return parsed
-})
-
-const url = Args.text({ name: 'url' }).pipe(Args.mapEffect(parseUrlArg))
-
-const format = Options.text('format').pipe(
-	Options.withDefault('text'),
-	Options.withDescription('Output format (text or json)'),
-	Options.withSchema(Schema.Literal('text', 'json')),
-)
-
-const search = Options.text('search').pipe(
-	Options.optional,
-	Options.withDescription('Semantic search query. Returns relevant snippets instead of markdown.'),
-)
-
-const maxResults = Options.integer('max-results').pipe(
-	Options.withDefault(5),
-	Options.withDescription('Maximum snippets to return when using --search (default: 5)'),
-	Options.withSchema(Schema.Int.pipe(Schema.greaterThanOrEqualTo(1), Schema.lessThanOrEqualTo(50))),
-)
-
-const minScore = Options.float('min-score').pipe(
-	Options.withDefault(0.6),
-	Options.withDescription('Minimum snippet relevance score from 0 to 1 when using --search (default: 0.6)'),
-	Options.withSchema(Schema.Number.pipe(Schema.greaterThanOrEqualTo(0), Schema.lessThanOrEqualTo(1))),
-)
-
-const fetchConfig = {
-	url,
-	format,
-	search,
-	maxResults,
-	minScore,
-}
-
-interface FetchCommandConfig {
-	readonly url: URL
-	readonly format: 'text' | 'json'
-	readonly search: Option.Option<string>
-	readonly maxResults: number
-	readonly minScore: number
-}
-
-export const FetchCommand: Command.Command<'fetch', never, unknown, FetchCommandConfig> = Command.make(
-	'fetch',
-	fetchConfig,
-).pipe(
-	Command.withDescription('Fetch content from a URL as markdown or snippets'),
-	Command.withHandler(
-		Effect.fnUntraced(function* ({ format, maxResults, minScore, search, url }) {
-			const client = yield* ApiClient
-			const query = Option.getOrUndefined(search)
-			const fetchRequest =
-				query === undefined
-					? {
-							params: {},
-							payload: {
-								url: url.toString(),
-								include: { markdown: true },
-							},
-						}
-					: {
-							params: {},
-							payload: {
-								url: url.toString(),
-								include: { markdown: true, json: true },
-								search: {
-									query,
-									maxResults,
-									minScore,
-								},
-							},
-						}
-
-			const output =
-				format === 'text' && query === undefined
-					? yield* client.fetchFetch(fetchRequest).pipe(
-							Effect.flatMap((markdown) =>
-								String.isNonEmpty(markdown)
-									? Effect.succeed(markdown)
-									: Effect.fail(new MarkdownUnavailable({ url: url.toString() })),
-							),
-							// Interactive terminals get ANSI-highlighted markdown. Piped output is
-							// being read by an agent, so it also carries the citation contract —
-							// this is the third fetch path (with the hook and the MCP tools) and
-							// was the only one that shipped evidence ids without telling anyone
-							// to use them.
-							Effect.map((markdown) =>
-								shouldColorizeMarkdown() ? highlightMarkdownAnsi(markdown) : withCitationFooter(markdown),
-							),
-						)
-					: yield* client.fetchFetchResult(fetchRequest).pipe(
-							Effect.flatMap((fetched) =>
-								Match.value(format).pipe(
-									Match.when('text', () => {
-										const snippets = fetched.data?.search?.snippets ?? []
-										return snippets.length === 0
-											? Effect.fail(new SnippetsUnavailable({ url: url.toString(), query: query ?? '' }))
-											: Effect.succeed(
-													renderSnippets(
-														fetched.meta.snapshotId,
-														resolvePlaygroundHost(fetched.meta.playground, DEFAULT_PLAYGROUND_HOST),
-														snippets,
-													),
-												)
-									}),
-									Match.when('json', () => {
-										// Snippets carry a citation link in every other output path
-										// (text here, and both MCP tools). Without it a JSON consumer
-										// cannot cite what it just searched.
-										const search = fetched.data?.search
-										const cited =
-											search == null
-												? fetched
-												: {
-														...fetched,
-														data: {
-															...fetched.data,
-															search: {
-																...search,
-																snippets: withCitationUrls(
-																	fetched.meta.snapshotId,
-																	resolvePlaygroundHost(fetched.meta.playground, DEFAULT_PLAYGROUND_HOST),
-																	search.snippets,
-																),
-															},
-														},
-													}
-										return Schema.encode(Schema.parseJson(Schema.Unknown, { space: 2 }))(cited)
-									}),
-									Match.exhaustive,
-								),
-							),
-						)
-
-			yield* Console.log(output)
-		}, Effect.provide(ApiClient.Default)),
-	),
-)

package/src/Commands/Hook.ts

@@ -1,48 +0,0 @@
-import { Args, Command } from '@effect/cli'
-import { Effect } from 'effect'
-import { ClaudeHook } from '../Hook/Claude.js'
-import { OpencodeHook } from '../Hook/Opencode.js'
-import { HookInstaller } from '../Install/Hook.js'
-
-const ClaudeRunCommand = Command.make('claude-code').pipe(
-	Command.withDescription('Run the Claude Code WebFetch hook protocol over stdio'),
-	Command.withHandler(() => Effect.flatMap(ClaudeHook, (hook) => hook.runProtocol())),
-)
-
-const OpencodeRunCommand = Command.make('opencode').pipe(
-	Command.withDescription('Run the OpenCode webfetch plugin protocol over stdio'),
-	Command.withHandler(() => Effect.flatMap(OpencodeHook, (hook) => hook.runProtocol())),
-)
-
-const hostArg = Args.choice([
-	['claude-code', 'claude-code' as const],
-	['opencode', 'opencode' as const],
-])
-const scopeArg = Args.choice([
-	['global', 'global' as const],
-	['project', 'project' as const],
-])
-
-const InstallSubCommand = Command.make('install', { host: hostArg, scope: scopeArg }).pipe(
-	Command.withDescription('Install the expandai MCP server + webfetch hook for the chosen host + scope'),
-	Command.withHandler(({ host, scope }) =>
-		Effect.flatMap(HookInstaller, (installer) => installer.install(host, scope)),
-	),
-)
-
-const UninstallSubCommand = Command.make('uninstall', { host: hostArg, scope: scopeArg }).pipe(
-	Command.withDescription('Remove the expandai MCP server + webfetch hook for the chosen host + scope'),
-	Command.withHandler(({ host, scope }) =>
-		Effect.flatMap(HookInstaller, (installer) => installer.uninstall(host, scope)),
-	),
-)
-
-export const HumanHookCommand = Command.make('hook').pipe(
-	Command.withDescription('expandai hooks for AI coding assistants'),
-	Command.withSubcommands([ClaudeRunCommand, OpencodeRunCommand, InstallSubCommand, UninstallSubCommand]),
-)
-
-export const AgentHookCommand = Command.make('hook').pipe(
-	Command.withDescription('expandai hooks for AI coding assistants'),
-	Command.withSubcommands([ClaudeRunCommand, OpencodeRunCommand]),
-)