@ottili/foundation-command

Search providers, command palette, command parser and the Ottili Workbench (SoT §8.8, §20, §21).

Install

npm install @ottili/foundation-command

This package is part of the Ottili Foundation Framework. See docs/OTTILI_FOUNDATION_FRAMEWORK_SOURCE_OF_TRUTH.md for the canonical spec.

Public API

• CommandPalette and usePaletteShortcut for global search and command invocation.
• Workbench, WorkbenchPanelRegistry, and resolvePanels for the bottom workbench.
• tokenize, parseTokens, resolveCommand, and validateArguments for the Workbench command parser.
• SearchProviderRegistry, planProvider, and mergeAndRank for federated search.

Usage

import { tokenize, parseTokens, resolveCommand } from "@ottili/foundation-command";
import type { FoundationCommand } from "@ottili/foundation-contracts";

const input = "hq deal create --customer cus_123 --value 5000";
const tokens = tokenize(input);
const parsed = parseTokens(tokens, 3); // depth: hq deal create

const commands: FoundationCommand[] = [];
const result = resolveCommand(input, { list: () => commands });

if (result.ok) {
  // result.command and result.parsed
}