FA SDK

Programmatic and CLI tooling extracted from fa-context-kit.

Install

npm i -g @fa-software/context-kit

CLI

fa-cli --help
fa-cli work-next
fa-cli replay-commits 1234

CLI execution goes through src/index.ts only.

API

Root package import is intentionally not supported. Use subpath exports instead.

import { runCli, listCommands } from '@fa-software/context-kit/runtime';

console.log(listCommands());
await runCli(['plan-status']);

import { getCliEventStream } from '@fa-software/context-kit/runtime';

getCliEventStream().onEvent((event) => {
  console.log(event.type, event.command);
});

import { resolveWorkflowRoute } from '@fa-software/context-kit/workflow';
import { parsePlanDocument } from '@fa-software/context-kit/documents';

Architecture

• Source layout is organized into runtime, shared, features, public, and markdown.
• Detailed code organization rules live in ARCHITECTURE.md.

Public Surface

Supported imports:

• @fa-software/context-kit/runtime
• @fa-software/context-kit/workflow
• @fa-software/context-kit/documents

Unsupported import:

• @fa-software/context-kit

Current Features

• git-conventions
• project-detection
• replay
• work-planning
• workflow-documents
• workflow-handoff
• workflow-routing