@flyingrobots/graft 0.6.1 → 0.7.1

package/src/cli/init-target-hooks.ts

@@ -1,93 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { execFileSync } from "node:child_process";
-import {
-  buildTargetGitHookScript,
-  isRecognizedTargetGitHook,
-  resolveGitHooksPath,
-  TARGET_GIT_TRANSITION_HOOKS,
-} from "../git/target-git-hook-bootstrap.js";
-import { InitAction } from "./init-model.js";
-
-function readGitValue(cwd: string, args: readonly string[]): string | null {
-  try {
-    const value = execFileSync("git", [...args], {
-      cwd,
-      encoding: "utf-8",
-      stdio: ["ignore", "pipe", "ignore"],
-    }).trim();
-    return value.length > 0 ? value : null;
-  } catch {
-    return null;
-  }
-}
-
-function relativeLabel(cwd: string, filePath: string): string {
-  const relative = path.relative(cwd, filePath);
-  if (relative.length === 0 || relative.startsWith("..")) {
-    return filePath;
-  }
-  return relative;
-}
-
-function resolveTargetGitHooksDirectory(cwd: string): {
-  configuredCoreHooksPath: string | null;
-  resolvedHooksPath: string;
-} {
-  const worktreeRoot = readGitValue(cwd, [
-    "rev-parse",
-    "--path-format=absolute",
-    "--show-toplevel",
-  ]);
-  const gitCommonDir = readGitValue(cwd, [
-    "rev-parse",
-    "--path-format=absolute",
-    "--git-common-dir",
-  ]);
-  if (worktreeRoot === null || gitCommonDir === null) {
-    throw new Error("--write-target-git-hooks requires a git worktree");
-  }
-
-  const configuredCoreHooksPath = readGitValue(cwd, ["config", "--get", "core.hooksPath"]);
-  return {
-    configuredCoreHooksPath,
-    resolvedHooksPath: resolveGitHooksPath(
-      worktreeRoot,
-      gitCommonDir,
-      configuredCoreHooksPath,
-    ),
-  };
-}
-
-export function ensureTargetGitHooks(cwd: string): InitAction[] {
-  const { resolvedHooksPath } = resolveTargetGitHooksDirectory(cwd);
-  const actions: InitAction[] = [];
-  fs.mkdirSync(resolvedHooksPath, { recursive: true });
-
-  for (const hookName of TARGET_GIT_TRANSITION_HOOKS) {
-    const hookPath = path.join(resolvedHooksPath, hookName);
-    const label = relativeLabel(cwd, hookPath);
-    const nextContent = buildTargetGitHookScript(hookName);
-    if (!fs.existsSync(hookPath)) {
-      fs.writeFileSync(hookPath, nextContent);
-      fs.chmodSync(hookPath, 0o755);
-      actions.push(InitAction.create(label, "wrote graft target git hook"));
-      continue;
-    }
-
-    const existing = fs.readFileSync(hookPath, "utf-8");
-    if (existing === nextContent) {
-      actions.push(InitAction.exists(label, "already has graft target git hook"));
-      continue;
-    }
-    if (isRecognizedTargetGitHook(existing, hookName)) {
-      fs.writeFileSync(hookPath, nextContent);
-      fs.chmodSync(hookPath, 0o755);
-      actions.push(InitAction.append(label, "updated graft target git hook"));
-      continue;
-    }
-    actions.push(InitAction.exists(label, "external hook preserved"));
-  }
-
-  return actions;
-}

package/src/cli/init.ts

@@ -1,122 +0,0 @@
-import * as path from "node:path";
-import { appendIfMissing, ensureTargetGitHooks, mergeClaudeHooksConfig, mergeClaudeMcpConfig, mergeClineMcpConfig, mergeCodexMcpConfig, mergeContinueMcpConfig, mergeCursorMcpConfig, mergeWindsurfMcpConfig, writeIfMissing } from "./init-bootstrap.js";
-import { writeCliError } from "./cli-error.js";
-import { GRAFT_HOOKS_CONFIG, GRAFT_MCP_SERVER, InitFailure, InitResult, ParsedInitArgs } from "./init-model.js";
-import { emitInitJson, renderInitText } from "./init-render.js";
-
-const GRAFTIGNORE_TEMPLATE = `# Graft ignore patterns — files matching these are refused by safe_read.
-# Syntax: same as .gitignore (glob matching via picomatch).
-
-# Examples:
-# *.generated.ts
-# vendor/**
-# data/**/*.json
-`;
-
-const READ_GUIDANCE_MARKER = "## File reads";
-
-const AGENT_SNIPPET = `## File reads
-
-This project uses [graft](https://github.com/flyingrobots/graft) as
-a context governor. Prefer graft's MCP tools over native file reads:
-
-- Use \`safe_read\` instead of \`Read\` for file contents
-- Use \`file_outline\` to see structure before reading
-- Use \`read_range\` with jump table entries for targeted reads
-- Use \`graft_diff\` instead of \`git diff\` for structural changes
-- Use \`explain\` if you get an unfamiliar reason code
-- Call \`set_budget\` at session start if context is tight
-
-These tools enforce read policy, cache observations, and track
-session metrics. Native reads bypass all of that.
-`;
-
-const GITIGNORE_ENTRY = "\n# Graft runtime data\n.graft/\n";
-
-interface Writer {
-  write(chunk: string): unknown;
-}
-
-export interface RunInitOptions {
-  cwd?: string | undefined;
-  args?: readonly string[] | undefined;
-  stdout?: Writer | undefined;
-  stderr?: Writer | undefined;
-}
-
-function initProject(cwd: string, args: ParsedInitArgs): InitResult {
-  const actions = [
-    writeIfMissing(path.join(cwd, ".graftignore"), GRAFTIGNORE_TEMPLATE, ".graftignore"),
-    appendIfMissing(path.join(cwd, ".gitignore"), ".graft/", GITIGNORE_ENTRY, ".gitignore"),
-    appendIfMissing(path.join(cwd, "CLAUDE.md"), READ_GUIDANCE_MARKER, `\n${AGENT_SNIPPET}`, "CLAUDE.md"),
-  ];
-
-  if (args.writeClaudeMcp) {
-    actions.push(mergeClaudeMcpConfig(cwd));
-  }
-  if (args.writeClaudeHooks) {
-    actions.push(mergeClaudeHooksConfig(cwd));
-  }
-  if (args.writeTargetGitHooks) {
-    actions.push(...ensureTargetGitHooks(cwd));
-  }
-  if (args.writeCodexMcp) {
-    actions.push(mergeCodexMcpConfig(cwd));
-    actions.push(
-      appendIfMissing(
-        path.join(cwd, "AGENTS.md"),
-        READ_GUIDANCE_MARKER,
-        `\n${AGENT_SNIPPET}`,
-        "AGENTS.md",
-      ),
-    );
-  }
-  if (args.writeCursorMcp) {
-    actions.push(mergeCursorMcpConfig(cwd));
-  }
-  if (args.writeWindsurfMcp) {
-    actions.push(mergeWindsurfMcpConfig(cwd));
-  }
-  if (args.writeContinueMcp) {
-    actions.push(mergeContinueMcpConfig(cwd));
-  }
-  if (args.writeClineMcp) {
-    actions.push(mergeClineMcpConfig(cwd));
-  }
-
-  return new InitResult(cwd, actions, GRAFT_HOOKS_CONFIG, GRAFT_MCP_SERVER);
-}
-
-export function runInit(options: RunInitOptions = {}): void {
-  const cwd = options.cwd ?? process.cwd();
-  const args = options.args ?? process.argv.slice(3);
-  const stdout = options.stdout ?? process.stdout;
-  const stderr = options.stderr ?? process.stderr;
-
-  try {
-    const parsed = ParsedInitArgs.parse(args);
-    const result = initProject(cwd, parsed);
-    if (parsed.json) {
-      emitInitJson(result.toJSON(), stdout);
-      return;
-    }
-    renderInitText(result, parsed, stdout);
-  } catch (err: unknown) {
-    const message = err instanceof Error ? err.message : String(err);
-    process.exitCode = 1;
-    if (args.includes("--json")) {
-      emitInitJson(new InitFailure(cwd, message), stdout);
-      return;
-    }
-    writeCliError(stderr, message, {
-      usage:
-        "graft init [--json] [--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: [
-        "Use explicit --write-*-mcp flags to bootstrap project-local client config files.",
-        "Use --write-target-git-hooks only inside a git worktree.",
-      ],
-    });
-  }
-}

package/src/cli/json-document.ts

@@ -1,144 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import {
-  cloneJsonValue,
-  isJsonObjectValue,
-  type JsonArrayValue,
-  type JsonObjectValue,
-  type JsonValue,
-} from "./init-model.js";
-
-function formatJsonField(pointer: readonly string[]): string {
-  return pointer.length === 0 ? "document root" : pointer.join(".");
-}
-
-export class JsonArrayNode {
-  constructor(
-    private readonly value: JsonArrayValue,
-    private readonly label: string,
-    private readonly pointer: readonly string[] = [],
-  ) {}
-
-  static fromUnknown(
-    value: unknown,
-    label: string,
-    pointer: readonly string[] = [],
-  ): JsonArrayNode {
-    if (!Array.isArray(value)) {
-      throw new Error(`${label}: expected ${formatJsonField(pointer)} to be an array`);
-    }
-    return new JsonArrayNode(value as JsonArrayValue, label, pointer);
-  }
-
-  objectItems(): JsonObjectNode[] {
-    return this.value.map((item, index) =>
-      JsonObjectNode.fromUnknown(item, this.label, [...this.pointer, `[${String(index)}]`]),
-    );
-  }
-
-  push(value: JsonValue): void {
-    this.value.push(cloneJsonValue(value));
-  }
-}
-
-export class JsonObjectNode {
-  constructor(
-    private readonly value: JsonObjectValue,
-    private readonly label: string,
-    private readonly pointer: readonly string[] = [],
-  ) {}
-
-  static fromUnknown(
-    value: unknown,
-    label: string,
-    pointer: readonly string[] = [],
-  ): JsonObjectNode {
-    if (!isJsonObjectValue(value)) {
-      throw new Error(`${label}: expected ${formatJsonField(pointer)} to be an object`);
-    }
-    return new JsonObjectNode(value, label, pointer);
-  }
-
-  has(key: string): boolean {
-    return this.value[key] !== undefined;
-  }
-
-  set(key: string, value: JsonValue): void {
-    this.value[key] = cloneJsonValue(value);
-  }
-
-  ensureObject(key: string): JsonObjectNode {
-    const current = this.value[key];
-    if (current === undefined) {
-      const created: JsonObjectValue = {};
-      this.value[key] = created;
-      return new JsonObjectNode(created, this.label, [...this.pointer, key]);
-    }
-    return JsonObjectNode.fromUnknown(current, this.label, [...this.pointer, key]);
-  }
-
-  ensureArray(key: string): JsonArrayNode {
-    const current = this.value[key];
-    if (current === undefined) {
-      const created: JsonArrayValue = [];
-      this.value[key] = created;
-      return new JsonArrayNode(created, this.label, [...this.pointer, key]);
-    }
-    return JsonArrayNode.fromUnknown(current, this.label, [...this.pointer, key]);
-  }
-
-  requireArray(key: string): JsonArrayNode {
-    const current = this.value[key];
-    if (current === undefined) {
-      throw new Error(`${this.label}: expected ${formatJsonField([...this.pointer, key])} to exist`);
-    }
-    return JsonArrayNode.fromUnknown(current, this.label, [...this.pointer, key]);
-  }
-
-  stringValue(key: string): string | undefined {
-    const current = this.value[key];
-    return typeof current === "string" ? current : undefined;
-  }
-
-  toJsonValue(): JsonObjectValue {
-    return this.value;
-  }
-}
-
-export class JsonObjectDocument {
-  constructor(
-    readonly label: string,
-    readonly filePath: string,
-    private readonly rootNode: JsonObjectNode,
-  ) {}
-
-  static create(
-    filePath: string,
-    label: string,
-    root: JsonObjectValue,
-  ): JsonObjectDocument {
-    return new JsonObjectDocument(
-      label,
-      filePath,
-      new JsonObjectNode(cloneJsonValue(root), label),
-    );
-  }
-
-  static open(filePath: string, label: string): JsonObjectDocument {
-    const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8")) as unknown;
-    return new JsonObjectDocument(
-      label,
-      filePath,
-      JsonObjectNode.fromUnknown(parsed, label),
-    );
-  }
-
-  root(): JsonObjectNode {
-    return this.rootNode;
-  }
-
-  write(): void {
-    fs.mkdirSync(path.dirname(this.filePath), { recursive: true });
-    fs.writeFileSync(this.filePath, JSON.stringify(this.rootNode.toJsonValue(), null, 2));
-  }
-}