@flyingrobots/graft 0.7.0 → 0.8.0

package/src/api/index.ts

@@ -1,107 +0,0 @@
-import { startDaemonServer } from "../mcp/daemon-server.js";
-import { MCP_TOOL_NAMES } from "../contracts/capabilities.js";
-import { createGraftServer } from "../mcp/server.js";
-import { startStdioServer } from "../mcp/stdio-server.js";
-import { ObservationCache } from "../operations/observation-cache.js";
-import { RepoWorkspace } from "../operations/repo-workspace.js";
-import { StructuredBuffer } from "../operations/structured-buffer.js";
-import type { BufferRange, WarmProjectionBasis, WarmProjectionBundleResult } from "../operations/structured-buffer.js";
-import { GRAFT_VERSION } from "../version.js";
-export { createRepoLocalGraft, type CreateRepoLocalGraftOptions } from "./repo-local-graft.js";
-export { createRepoWorkspace, type CreateRepoWorkspaceOptions } from "./repo-workspace.js";
-export { callGraftTool, parseGraftToolPayload } from "./tool-bridge.js";
-
-export interface CreateStructuredBufferOptions {
-  readonly basis?: WarmProjectionBasis | undefined;
-}
-
-export interface CreateProjectionBundleOptions extends CreateStructuredBufferOptions {
-  readonly viewport?: BufferRange | undefined;
-}
-
-export function createStructuredBuffer(
-  path: string,
-  content: string,
-  options: CreateStructuredBufferOptions = {},
-): StructuredBuffer {
-  return new StructuredBuffer({ path, content, basis: options.basis });
-}
-
-export function createProjectionBundle(
-  path: string,
-  content: string,
-  options: CreateProjectionBundleOptions = {},
-): WarmProjectionBundleResult {
-  const buffer = new StructuredBuffer({ path, content, basis: options.basis });
-  try {
-    return buffer.projectionBundle({ viewport: options.viewport });
-  } finally {
-    buffer.dispose();
-  }
-}
-
-export {
-  GRAFT_VERSION,
-  MCP_TOOL_NAMES,
-  ObservationCache,
-  RepoWorkspace,
-  StructuredBuffer,
-  createGraftServer,
-  startDaemonServer,
-  startStdioServer,
-};
-
-export type {
-  AnchorAffinityResult,
-  BufferDiagnostic,
-  BufferOutlineResult,
-  BufferPoint,
-  BufferRange,
-  BufferSelection,
-  ChangedRegion,
-  DiagnosticsResult,
-  FoldRegion,
-  FoldRegionsResult,
-  InjectionRegion,
-  InjectionResult,
-  NodeLookupResult,
-  NodeSummary,
-  RenameEditPreview,
-  RenamePreviewResult,
-  SelectionStepResult,
-  SemanticSummaryKind,
-  SemanticSummaryResult,
-  StructuredBufferDiffResult,
-  SymbolOccurrence,
-  SymbolOccurrencesResult,
-  SyntaxClass,
-  SyntaxSpan,
-  SyntaxSpanResult,
-  WarmProjectionBundleResult,
-  WarmProjectionParseStatus,
-  WarmProjectionBasis,
-} from "../operations/structured-buffer.js";
-
-export type {
-  StartDaemonServerOptions,
-} from "../mcp/daemon-server.js";
-
-export type {
-  CreateGraftServerOptions,
-  GraftServer,
-  McpToolResult,
-} from "../mcp/server.js";
-
-export type {
-  McpToolName,
-} from "../contracts/capabilities.js";
-
-export type {
-  RepoWorkspaceChangedSinceResult,
-  RepoWorkspaceFileOutlineResult,
-  RepoWorkspaceReadRangeResult,
-  RepoWorkspaceRefusedResult,
-  RepoWorkspaceSafeReadCacheHitResult,
-  RepoWorkspaceSafeReadDiffResult,
-  RepoWorkspaceSafeReadResult,
-} from "../operations/repo-workspace.js";

package/src/api/repo-local-graft.ts

@@ -1,21 +0,0 @@
-import * as path from "node:path";
-import {
-  createGraftServer,
-  type CreateGraftServerOptions,
-  type GraftServer,
-} from "../mcp/server.js";
-
-export interface CreateRepoLocalGraftOptions extends Omit<CreateGraftServerOptions, "mode" | "projectRoot" | "graftDir"> {
-  readonly cwd?: string | undefined;
-  readonly graftDir?: string | undefined;
-}
-
-export function createRepoLocalGraft(options: CreateRepoLocalGraftOptions = {}): GraftServer {
-  const cwd = path.resolve(options.cwd ?? process.cwd());
-  return createGraftServer({
-    ...options,
-    mode: "repo_local",
-    projectRoot: cwd,
-    graftDir: options.graftDir ?? path.join(cwd, ".graft"),
-  });
-}

package/src/api/repo-workspace.ts

@@ -1,34 +0,0 @@
-import * as path from "node:path";
-import { CanonicalJsonCodec } from "../adapters/canonical-json.js";
-import { nodeFs } from "../adapters/node-fs.js";
-import { createRepoPathResolver, toRepoPolicyPath } from "../adapters/repo-paths.js";
-import { ObservationCache } from "../operations/observation-cache.js";
-import { RepoWorkspace } from "../operations/repo-workspace.js";
-import { GovernorTracker } from "../session/tracker.js";
-import type { JsonCodec } from "../ports/codec.js";
-import type { FileSystem } from "../ports/filesystem.js";
-
-export interface CreateRepoWorkspaceOptions {
-  readonly cwd?: string | undefined;
-  readonly graftignorePatterns?: readonly string[] | undefined;
-  readonly fs?: FileSystem | undefined;
-  readonly codec?: JsonCodec | undefined;
-  readonly governor?: GovernorTracker | undefined;
-  readonly cache?: ObservationCache | undefined;
-}
-
-export async function createRepoWorkspace(options: CreateRepoWorkspaceOptions = {}): Promise<RepoWorkspace> {
-  const cwd = path.resolve(options.cwd ?? process.cwd());
-  const fs = options.fs ?? nodeFs;
-  const codec = options.codec ?? new CanonicalJsonCodec();
-  return new RepoWorkspace({
-    projectRoot: cwd,
-    fs,
-    codec,
-    graftignorePatterns: options.graftignorePatterns ?? await RepoWorkspace.loadGraftignorePatterns(fs, cwd),
-    resolvePath: createRepoPathResolver(cwd),
-    toPolicyPath: (resolvedPath) => toRepoPolicyPath(cwd, resolvedPath),
-    ...(options.governor !== undefined ? { governor: options.governor } : {}),
-    ...(options.cache !== undefined ? { cache: options.cache } : {}),
-  });
-}

package/src/api/tool-bridge.ts

@@ -1,22 +0,0 @@
-import type { McpToolName } from "../contracts/capabilities.js";
-import type { JsonObject } from "../contracts/json-object.js";
-import { parseJsonTextObject } from "../adapters/json-text-decoder.js";
-import { getMcpOutputSchema, type McpOutputFor } from "../contracts/output-schemas.js";
-import type { GraftServer, McpToolResult } from "../mcp/server.js";
-
-export function parseGraftToolPayload(result: McpToolResult): JsonObject {
-  const payload = result.content.find((item) => item.type === "text");
-  if (payload === undefined) {
-    throw new Error("Graft tool result did not contain a text payload");
-  }
-  return parseJsonTextObject(payload.text, "Graft tool result");
-}
-
-export async function callGraftTool<K extends McpToolName>(
-  graft: GraftServer,
-  name: K,
-  args: JsonObject,
-): Promise<McpOutputFor<K>> {
-  const parsed = parseGraftToolPayload(await graft.callTool(name, args));
-  return getMcpOutputSchema(name).parse(parsed) as McpOutputFor<K>;
-}

package/src/cli/activity-render.ts

@@ -1,112 +0,0 @@
-import { type z } from "zod";
-import { DIAG_ACTIVITY_CLI_SCHEMA } from "../contracts/output-schemas.js";
-
-type DiagActivityOutput = z.infer<typeof DIAG_ACTIVITY_CLI_SCHEMA>;
-type ActivityGroup = DiagActivityOutput["activityWindow"]["groups"][number];
-type ActivityItem = ActivityGroup["items"][number];
-type AttributionSummary = ActivityItem["attribution"];
-type ContinuityActivityItem = Extract<ActivityItem, { itemKind: "continuity" }>;
-type ReadActivityItem = Extract<ActivityItem, { eventKind: "read" }>;
-type StageActivityItem = Extract<ActivityItem, { eventKind: "stage" }>;
-type TransitionActivityItem = Extract<ActivityItem, { eventKind: "transition" }>;
-
-function trimId(value: string | null | undefined): string {
-  if (value === null || value === undefined || value.length === 0) {
-    return "unknown";
-  }
-  const parts = value.split(":");
-  return parts.at(-1) ?? value;
-}
-
-function shortSha(value: string | null): string {
-  return value === null ? "unknown" : value.slice(0, 7);
-}
-
-function actorLabel(attribution: AttributionSummary): string {
-  const actorId = trimId(attribution.actor.actorId);
-  const actorKind = attribution.actor.actorKind;
-  return actorKind === "unknown" ? `actor:${actorId}` : `${actorKind}:${actorId}`;
-}
-
-function summarizePaths(paths: readonly string[]): string {
-  if (paths.length === 0) {
-    return "no paths";
-  }
-  if (paths.length === 1) {
-    return paths[0] ?? "no paths";
-  }
-  if (paths.length === 2) {
-    return `${paths[0] ?? ""}, ${paths[1] ?? ""}`;
-  }
-  return `${paths[0] ?? ""}, ${paths[1] ?? ""} +${String(paths.length - 2)} more`;
-}
-
-function formatContinuityItem(item: ContinuityActivityItem): string {
-  const origin = item.continuedFromCausalSessionId === null
-    ? ""
-    : ` from session:${trimId(item.continuedFromCausalSessionId)}`;
-  return `${item.occurredAt}  continuity:${item.operation}  ${actorLabel(item.attribution)}  session:${trimId(item.causalSessionId)}  strand:${trimId(item.strandId)}${origin}`;
-}
-
-function formatReadItem(item: ReadActivityItem): string {
-  return `${item.occurredAt}  read:${item.payload.surface}/${item.payload.projection}  ${actorLabel(item.attribution)}  ${summarizePaths(item.footprint.paths)}`;
-}
-
-function formatStageItem(item: StageActivityItem): string {
-  return `${item.occurredAt}  stage:${item.payload.selectionKind}  ${actorLabel(item.attribution)}  ${summarizePaths(item.footprint.paths)}`;
-}
-
-function formatTransitionItem(item: TransitionActivityItem): string {
-  return `${item.occurredAt}  transition  ${actorLabel(item.attribution)}  ${item.payload.summary}`;
-}
-
-function formatActivityItem(item: ActivityItem): string {
-  if ("itemKind" in item) {
-    return formatContinuityItem(item);
-  }
-  if (item.eventKind === "read") {
-    return formatReadItem(item);
-  }
-  if (item.eventKind === "stage") {
-    return formatStageItem(item);
-  }
-  return formatTransitionItem(item);
-}
-
-export function renderActivityView(output: unknown): string {
-  const parsed = DIAG_ACTIVITY_CLI_SCHEMA.parse(output);
-  const lines = [
-    "Activity",
-    `repo: ${parsed.repoId ?? "unknown"}`,
-    `worktree: ${parsed.worktreeId ?? "unknown"}`,
-    `anchor: ${parsed.anchor.headRef ?? parsed.anchor.posture} @ ${shortSha(parsed.anchor.headSha)}`,
-    `truth: ${parsed.truthClass}`,
-    `next: ${parsed.nextAction}`,
-    `degraded: ${parsed.degradedReasons.length === 0 ? "none" : parsed.degradedReasons.join(", ")}`,
-    "",
-    parsed.summary.headline,
-    parsed.summary.anchor,
-    parsed.summary.workspace,
-  ];
-
-  if (parsed.activityWindow.returned === 0) {
-    lines.push("", "No activity items found in the requested window.");
-    return lines.join("\n");
-  }
-
-  lines.push("");
-  lines.push(`window: ${String(parsed.activityWindow.returned)} shown / ${String(parsed.activityWindow.totalMatchingItems)} matching${parsed.activityWindow.truncated ? " (truncated)" : ""}`);
-  lines.push("");
-  lines.push("Groups");
-
-  for (const group of parsed.activityWindow.groups) {
-    lines.push("");
-    lines.push(`${group.label} (${String(group.items.length)})`);
-    lines.push(group.summary);
-    for (const item of group.items) {
-      lines.push(`  ${formatActivityItem(item)}`);
-    }
-  }
-
-  return lines.join("\n").trimEnd();
-}

package/src/cli/cli-error.ts

@@ -1,192 +0,0 @@
-import { writeLine, type Writer } from "./peer-command.js";
-
-const CLI_DOCS_PATH = "docs/CLI.md";
-
-interface CliErrorDetails {
-  readonly usage?: string | undefined;
-  readonly nextSteps?: readonly string[] | undefined;
-  readonly docsPath?: string | undefined;
-}
-
-export function writeCliError(
-  writer: Writer,
-  message: string,
-  details: CliErrorDetails = {},
-): void {
-  writeLine(writer, `Error: ${message}`);
-  if (details.usage !== undefined) {
-    writeLine(writer);
-    writeLine(writer, `Usage: ${details.usage}`);
-  }
-  const nextSteps = details.nextSteps ?? [];
-  if (nextSteps.length > 0) {
-    writeLine(writer);
-    for (const step of nextSteps) {
-      writeLine(writer, step);
-    }
-  }
-  writeLine(writer);
-  writeLine(writer, `See ${details.docsPath ?? CLI_DOCS_PATH} for grouped command help.`);
-}
-
-export function describeCliFailure(argv: readonly string[]): CliErrorDetails {
-  const [group, subcommand] = argv;
-  if (group === undefined) {
-    return {
-      nextSteps: ["Run `graft help` to see the available command groups."],
-    };
-  }
-
-  if (group === "serve") {
-    return {
-      usage: "graft serve [--runtime <repo-local|daemon>] [--socket <path>] [--no-autostart]",
-      nextSteps: [
-        "`graft serve` is repo-local stdio. Use `graft serve --runtime daemon` for the daemon-backed stdio bridge.",
-      ],
-    };
-  }
-
-  if (group === "daemon") {
-    if (subcommand === "status") {
-      return {
-        usage: "graft daemon status [--socket <path>]",
-        nextSteps: ["Start the daemon with `graft daemon` or target another daemon with `--socket <path>`."],
-      };
-    }
-    return {
-      usage: "graft daemon [--socket <path>] | graft daemon status [--socket <path>]",
-      nextSteps: ["Run `graft daemon status` to inspect an already-running daemon without mutating daemon state."],
-    };
-  }
-
-  if (group === "doctor") {
-    return { usage: "graft doctor [--sludge] [--path <path>] [--json]" };
-  }
-
-  if (group === "index") {
-    return {
-      usage: "graft index [--path <path>] [--json]",
-      nextSteps: ["Use `--path <path>` for lazy per-file indexing and `--json` for machine-readable output."],
-    };
-  }
-
-  if (group === "enhance") {
-    return {
-      usage: "git-graft enhance --since <ref> [--head <ref>] [--json]",
-      nextSteps: [
-        "Use `git graft enhance --since <ref>` after package install, or `git-graft enhance --since <ref>` via the direct binary.",
-      ],
-    };
-  }
-
-  if (group === "init") {
-    return {
-      usage:
-        "graft init [--json] [--mcp-runtime <repo-local|daemon>] [--write-claude-mcp] [--write-claude-hooks] "
-        + "[--write-target-git-hooks] [--write-codex-mcp] [--write-cursor-mcp] "
-        + "[--write-windsurf-mcp] [--write-continue-mcp] [--write-cline-mcp]",
-      nextSteps: ["Run `graft help` to confirm the repo-local bootstrap surfaces."],
-    };
-  }
-
-  if (group === "read") {
-    if (subcommand === "safe") {
-      return { usage: "graft read safe <path> [--json]" };
-    }
-    if (subcommand === "outline") {
-      return { usage: "graft read outline <path> [--json]" };
-    }
-    if (subcommand === "range") {
-      return { usage: "graft read range <path> --start <n> --end <n> [--json]" };
-    }
-    if (subcommand === "changed") {
-      return { usage: "graft read changed <path> [--consume] [--json]" };
-    }
-    return {
-      usage: "graft read <safe|outline|range|changed> ...",
-      nextSteps: ["Run `graft help` to see the available read subcommands."],
-    };
-  }
-
-  if (group === "struct") {
-    if (subcommand === "diff") {
-      return { usage: "graft struct diff [--base <ref>] [--head <ref>] [--path <path>] [--json]" };
-    }
-    if (subcommand === "since") {
-      return { usage: "graft struct since <base-ref> [--head <ref>] [--json]" };
-    }
-    if (subcommand === "map") {
-      return { usage: "graft struct map [<directory>] [--json]" };
-    }
-    if (subcommand === "churn") {
-      return { usage: "graft struct churn [--path <path>] [--limit <n>] [--json]" };
-    }
-    if (subcommand === "exports") {
-      return { usage: "graft struct exports [<base-ref> <head-ref>] [--json]" };
-    }
-    if (subcommand === "log") {
-      return { usage: "graft struct log [--path <path>] [--limit <n>] [--json]" };
-    }
-    if (subcommand === "review") {
-      return { usage: "graft struct review [--base <ref>] [--head <ref>] [--json]" };
-    }
-    return {
-      usage: "graft struct <diff|since|map|churn|exports|log|review> ...",
-      nextSteps: ["Run `graft help` to see the available structural subcommands."],
-    };
-  }
-
-  if (group === "symbol") {
-    if (subcommand === "find") {
-      return { usage: "graft symbol find <query> [--kind <kind>] [--path <path>] [--json]" };
-    }
-    if (subcommand === "show") {
-      return { usage: "graft symbol show <symbol> [--path <path>] [--ref <ref>] [--json]" };
-    }
-    if (subcommand === "blame") {
-      return { usage: "graft symbol blame <symbol> [--path <path>] [--json]" };
-    }
-    if (subcommand === "difficulty") {
-      return { usage: "graft symbol difficulty <symbol> [--path <path>] [--limit <n>] [--json]" };
-    }
-    return {
-      usage: "graft symbol <find|show|blame|difficulty> ...",
-      nextSteps: ["Run `graft help` to see the available symbol subcommands."],
-    };
-  }
-
-  if (group === "migrate") {
-    return {
-      usage: "graft migrate local-history [--json]",
-    };
-  }
-
-  if (group === "diag") {
-    if (subcommand === "activity") {
-      return { usage: "graft diag activity [--limit <n>] [--json]" };
-    }
-    if (subcommand === "local-history-dag") {
-      return { usage: "graft diag local-history-dag [--limit <n>] [--json]" };
-    }
-    if (subcommand === "doctor") {
-      return { usage: "graft diag doctor [--sludge] [--path <path>] [--json]" };
-    }
-    if (subcommand === "explain") {
-      return { usage: "graft diag explain <reason-code> [--json]" };
-    }
-    if (subcommand === "stats") {
-      return { usage: "graft diag stats [--json]" };
-    }
-    if (subcommand === "capture") {
-      return { usage: "graft diag capture [--tail <n>] -- <shell command> [--json]" };
-    }
-    return {
-      usage: "graft diag <activity|local-history-dag|doctor|explain|stats|capture> ...",
-      nextSteps: ["Run `graft help` to see the available diagnostic subcommands."],
-    };
-  }
-
-  return {
-    nextSteps: ["Run `graft help` to see the available command groups."],
-  };
-}