@nick848/fet 1.0.3 → 1.0.5

package/README.md

@@ -193,6 +193,23 @@ fet sync --change my-change
 fet archive --change my-change
 ```
 
+### Optional GitNexus Graph Support
+
+FET can detect an optional `gitnexus` executable during `fet init` and records the result in `openspec/fet-state.json`. If GitNexus is not installed, init shows a one-time recommendation and continues normally. `fet doctor` reports the current GitNexus status as an informational warning when it is missing.
+
+Generated Cursor and Codex instructions tell the IDE AI to prefer GitNexus graph context before broad repository scans when that context is available. FET does not install GitNexus, generate graphs, or require graph support for any command.
+
+Phase-two graph commands are available under `fet graph`:
+
+- `fet graph status` checks GitNexus, the configured graph path, and records the result.
+- `fet graph setup` writes `.fet/graph-setup.md` with installation and IDE-assisted setup guidance.
+- `fet graph init` runs `gitnexus analyze` to build the first graph.
+- `fet graph refresh` runs `gitnexus analyze` again to refresh graph data.
+- `fet graph doctor` reports graph integration warnings without blocking normal FET commands.
+- `fet graph handoff` writes `.fet/graph-handoff.md` for Cursor, Codex, OpenCode, or other IDE AI tools.
+
+By default FET looks for `gitnexus` on `PATH` and expects the graph directory at `.gitnexus`. Advanced users can override these with `FET_GITNEXUS_EXECUTABLE`, `FET_GITNEXUS_COMMAND`, and `FET_GITNEXUS_GRAPH_PATH`.
+
 ### Global Options
 
 | Option | Description | Example |
@@ -211,6 +228,12 @@ fet archive --change my-change
 | `fet init` | `fet init [--yes]` | Initialize FET and OpenSpec; generate context, state, Cursor rules and Skills, plus Codex workflow guides. |
 | `fet update-context` | `fet update-context [--yes]` | Rescan the project and update FET-managed regions in `AGENTS.md` and `openspec/config.yaml`. |
 | `fet fill-context` | `fet fill-context [--yes]` | Refresh IDE handoff commands that ask Cursor/Codex/OpenCode-style AI to replace `AGENTS.md` placeholders. |
+| `fet graph status` | `fet graph status` | Check optional GitNexus installation and graph status. |
+| `fet graph setup` | `fet graph setup` | Generate GitNexus installation and setup handoff instructions without installing anything. |
+| `fet graph init` | `fet graph init [...args]` | Run `gitnexus analyze` to build the first graph. |
+| `fet graph refresh` | `fet graph refresh [...args]` | Run `gitnexus analyze` again and update recorded graph state. |
+| `fet graph doctor` | `fet graph doctor` | Diagnose optional graph integration health. |
+| `fet graph handoff` | `fet graph handoff` | Generate IDE AI instructions for using graph context before broad scans. |
 | `fet doctor` | `fet doctor [--fix-lock]` | Diagnose OpenSpec, FET state, context files, Cursor and Codex integration, and lock files. |
 | `fet explore` | `fet explore [...args] [--change <id>]` | Run native OpenSpec explore through FET so clarification prompts stay interactive. |
 | `fet propose` | `fet propose <change-id>` | Create a new OpenSpec change through FET's proposal entry point. |
@@ -237,6 +260,8 @@ FET may create or update:
 - `openspec/changes/<change-id>/fet-state.json`
 - `openspec/changes/<change-id>/.fet/verify-instructions.md`
 - `CHANGELOG.md`
+- `.fet/graph-setup.md`
+- `.fet/graph-handoff.md`
 - `.cursor/skills/fet-*/SKILL.md`
 - `.cursor/rules/fet-context.mdc`
 - `.codex/fet/context.md`

package/dist/{chunk-FZOVNHE7.js → chunk-V4ZRBF5L.js}

@@ -8,6 +8,8 @@ var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
   ErrorCode2["OpenSpecUnsupportedVersion"] = "OPENSPEC_UNSUPPORTED_VERSION";
   ErrorCode2["OpenSpecCommandFailed"] = "OPENSPEC_COMMAND_FAILED";
   ErrorCode2["OpenSpecStructureUnknown"] = "OPENSPEC_STRUCTURE_UNKNOWN";
+  ErrorCode2["GraphProviderNotFound"] = "GRAPH_PROVIDER_NOT_FOUND";
+  ErrorCode2["GraphCommandFailed"] = "GRAPH_COMMAND_FAILED";
   ErrorCode2["StateSchemaUnsupported"] = "STATE_SCHEMA_UNSUPPORTED";
   ErrorCode2["StateCorrupted"] = "STATE_CORRUPTED";
   ErrorCode2["LockHeld"] = "LOCK_HELD";
@@ -25,8 +27,10 @@ function exitCodeForError(code) {
       return 2;
     case "OPENSPEC_NOT_FOUND" /* OpenSpecNotFound */:
     case "OPENSPEC_UNSUPPORTED_VERSION" /* OpenSpecUnsupportedVersion */:
+    case "GRAPH_PROVIDER_NOT_FOUND" /* GraphProviderNotFound */:
       return 3;
     case "OPENSPEC_COMMAND_FAILED" /* OpenSpecCommandFailed */:
+    case "GRAPH_COMMAND_FAILED" /* GraphCommandFailed */:
       return 4;
     case "OPENSPEC_STRUCTURE_UNKNOWN" /* OpenSpecStructureUnknown */:
     case "STATE_SCHEMA_UNSUPPORTED" /* StateSchemaUnsupported */:
@@ -101,4 +105,4 @@ export {
   FetError,
   toFetError
 };
-//# sourceMappingURL=chunk-FZOVNHE7.js.map
+//# sourceMappingURL=chunk-V4ZRBF5L.js.map

package/dist/chunk-V4ZRBF5L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/codes.ts","../src/errors/fet-error.ts"],"sourcesContent":["export enum ErrorCode {\n  Unknown = \"UNKNOWN\",\n  InvalidArguments = \"INVALID_ARGUMENTS\",\n  OpenSpecNotFound = \"OPENSPEC_NOT_FOUND\",\n  OpenSpecUnsupportedVersion = \"OPENSPEC_UNSUPPORTED_VERSION\",\n  OpenSpecCommandFailed = \"OPENSPEC_COMMAND_FAILED\",\n  OpenSpecStructureUnknown = \"OPENSPEC_STRUCTURE_UNKNOWN\",\n  GraphProviderNotFound = \"GRAPH_PROVIDER_NOT_FOUND\",\n  GraphCommandFailed = \"GRAPH_COMMAND_FAILED\",\n  StateSchemaUnsupported = \"STATE_SCHEMA_UNSUPPORTED\",\n  StateCorrupted = \"STATE_CORRUPTED\",\n  LockHeld = \"LOCK_HELD\",\n  UserCancelled = \"USER_CANCELLED\",\n  UnsafeScriptApprovalRequired = \"UNSAFE_SCRIPT_APPROVAL_REQUIRED\",\n  ToolAdapterConflict = \"TOOL_ADAPTER_CONFLICT\",\n  ConfigInvalid = \"CONFIG_INVALID\",\n  FileSystemError = \"FILE_SYSTEM_ERROR\"\n}\n\nexport function exitCodeForError(code: ErrorCode): number {\n  switch (code) {\n    case ErrorCode.InvalidArguments:\n    case ErrorCode.ConfigInvalid:\n      return 2;\n    case ErrorCode.OpenSpecNotFound:\n    case ErrorCode.OpenSpecUnsupportedVersion:\n    case ErrorCode.GraphProviderNotFound:\n      return 3;\n    case ErrorCode.OpenSpecCommandFailed:\n    case ErrorCode.GraphCommandFailed:\n      return 4;\n    case ErrorCode.OpenSpecStructureUnknown:\n    case ErrorCode.StateSchemaUnsupported:\n    case ErrorCode.StateCorrupted:\n    case ErrorCode.ToolAdapterConflict:\n    case ErrorCode.FileSystemError:\n      return 5;\n    case ErrorCode.LockHeld:\n      return 6;\n    case ErrorCode.UserCancelled:\n      return 7;\n    case ErrorCode.UnsafeScriptApprovalRequired:\n      return 8;\n    case ErrorCode.Unknown:\n    default:\n      return 1;\n  }\n}\n","import { ErrorCode, exitCodeForError } from \"./codes.js\";\n\nexport interface FetErrorOptions {\n  code: ErrorCode;\n  message: string;\n  details?: unknown;\n  recoverable?: boolean;\n  suggestedCommand?: string;\n  cause?: unknown;\n}\n\nexport class FetError extends Error {\n  readonly code: ErrorCode;\n  readonly exitCode: number;\n  readonly details?: unknown;\n  readonly recoverable: boolean;\n  readonly suggestedCommand?: string;\n  override readonly cause?: unknown;\n\n  constructor(options: FetErrorOptions) {\n    super(options.message);\n    this.name = \"FetError\";\n    this.code = options.code;\n    this.exitCode = exitCodeForError(options.code);\n    this.details = options.details;\n    this.recoverable = options.recoverable ?? true;\n    this.suggestedCommand = options.suggestedCommand;\n    this.cause = options.cause;\n  }\n\n  toJSON() {\n    return {\n      code: this.code,\n      exitCode: this.exitCode,\n      message: this.message,\n      details: this.details,\n      recoverable: this.recoverable,\n      suggestedCommand: this.suggestedCommand\n    };\n  }\n}\n\nexport function toFetError(error: unknown): FetError {\n  if (error instanceof FetError) {\n    return error;\n  }\n\n  if (error instanceof Error) {\n    return new FetError({\n      code: ErrorCode.Unknown,\n      message: error.message,\n      recoverable: false,\n      cause: error\n    });\n  }\n\n  return new FetError({\n    code: ErrorCode.Unknown,\n    message: \"Unknown error\",\n    details: error,\n    recoverable: false\n  });\n}\n"],"mappings":";;;AAAO,IAAK,YAAL,kBAAKA,eAAL;AACL,EAAAA,WAAA,aAAU;AACV,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,gCAA6B;AAC7B,EAAAA,WAAA,2BAAwB;AACxB,EAAAA,WAAA,8BAA2B;AAC3B,EAAAA,WAAA,2BAAwB;AACxB,EAAAA,WAAA,wBAAqB;AACrB,EAAAA,WAAA,4BAAyB;AACzB,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,cAAW;AACX,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,kCAA+B;AAC/B,EAAAA,WAAA,yBAAsB;AACtB,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,qBAAkB;AAhBR,SAAAA;AAAA,GAAA;AAmBL,SAAS,iBAAiB,MAAyB;AACxD,UAAQ,MAAM;AAAA,IACZ,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL;AACE,aAAO;AAAA,EACX;AACF;;;ACpCO,IAAM,WAAN,cAAuB,MAAM;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACS;AAAA,EAElB,YAAY,SAA0B;AACpC,UAAM,QAAQ,OAAO;AACrB,SAAK,OAAO;AACZ,SAAK,OAAO,QAAQ;AACpB,SAAK,WAAW,iBAAiB,QAAQ,IAAI;AAC7C,SAAK,UAAU,QAAQ;AACvB,SAAK,cAAc,QAAQ,eAAe;AAC1C,SAAK,mBAAmB,QAAQ;AAChC,SAAK,QAAQ,QAAQ;AAAA,EACvB;AAAA,EAEA,SAAS;AACP,WAAO;AAAA,MACL,MAAM,KAAK;AAAA,MACX,UAAU,KAAK;AAAA,MACf,SAAS,KAAK;AAAA,MACd,SAAS,KAAK;AAAA,MACd,aAAa,KAAK;AAAA,MAClB,kBAAkB,KAAK;AAAA,IACzB;AAAA,EACF;AACF;AAEO,SAAS,WAAW,OAA0B;AACnD,MAAI,iBAAiB,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,MAAI,iBAAiB,OAAO;AAC1B,WAAO,IAAI,SAAS;AAAA,MAClB;AAAA,MACA,SAAS,MAAM;AAAA,MACf,aAAa;AAAA,MACb,OAAO;AAAA,IACT,CAAC;AAAA,EACH;AAEA,SAAO,IAAI,SAAS;AAAA,IAClB;AAAA,IACA,SAAS;AAAA,IACT,SAAS;AAAA,IACT,aAAa;AAAA,EACf,CAAC;AACH;","names":["ErrorCode"]}