@okfit/mcp 0.9.4 → 0.9.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/bin/okfit-mcp.js CHANGED
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import { main } from "../main.js";
3
3
 
4
- //#region src/bin.ts
4
+ // src/bin.ts
5
5
  /**
6
6
  * MCP server entry point for okfit.
7
7
  *
@@ -9,5 +9,4 @@ import { main } from "../main.js";
9
9
  */
10
10
  await main();
11
11
 
12
- //#endregion
13
12
  export { };
package/errors.js CHANGED
@@ -1,7 +1,7 @@
1
1
  import { Remediation } from "@effected/engine";
2
2
  import { ToolRefusal } from "@effected/mcp";
3
3
 
4
- //#region src/errors.ts
4
+ // src/errors.ts
5
5
  /**
6
6
  * The one failure schema every tool declares (N-14): `ToolRefusal` from
7
7
  * `@effected/mcp`.
@@ -17,5 +17,4 @@ import { ToolRefusal } from "@effected/mcp";
17
17
  */
18
18
  const McpToolError = ToolRefusal;
19
19
 
20
- //#endregion
21
20
  export { McpToolError, Remediation };
package/index.d.ts CHANGED
@@ -5,7 +5,6 @@ import { FileSystem, Layer, Path, Schema, Stdio } from "effect";
5
5
  import { ConceptSummary, Distribution, toConceptSummary } from "@okfit/engine";
6
6
  import { ChildProcessSpawner } from "effect/process";
7
7
  import { Toolkit } from "effect/ai";
8
- //#region src/errors.d.ts
9
8
  /**
10
9
  * The one failure schema every tool declares (N-14): `ToolRefusal` from
11
10
  * `@effected/mcp`.
@@ -22,8 +21,6 @@ import { Toolkit } from "effect/ai";
22
21
  export declare const McpToolError: typeof ToolRefusal;
23
22
  /** @public */
24
23
  export type McpToolError = ToolRefusal;
25
- //#endregion
26
- //#region src/resources/conceptResource.d.ts
27
24
  /**
28
25
  * `okf://concept/<id>` — one static resource per concept in the bundle,
29
26
  * built once at server start.
@@ -59,8 +56,6 @@ export type McpToolError = ToolRefusal;
59
56
  * @public
60
57
  */
61
58
  export declare const ConceptResources: (projectRoot: string) => Layer.Layer<never, never, FileSystem.FileSystem | Path.Path | AppDirs | Xdg>;
62
- //#endregion
63
- //#region src/resources/indexResource.d.ts
64
59
  /**
65
60
  * `okf://index` — the bundle's root `index.md`, read from disk.
66
61
  *
@@ -87,8 +82,6 @@ export declare const ConceptResources: (projectRoot: string) => Layer.Layer<neve
87
82
  * @public
88
83
  */
89
84
  export declare const IndexResource: (projectRoot: string) => import("effect/Layer").Layer<never, never, import("@effected/xdg").AppDirs | FileSystem.FileSystem | Path.Path | import("@effected/xdg").Xdg>;
90
- //#endregion
91
- //#region src/schema/tools.d.ts
92
85
  /** One Surface template inside a docs preset, as `describe_vocabulary` reports it. @public */
93
86
  export declare const DocsPresetSurface: Schema.Struct<{
94
87
  readonly file: Schema.String;
@@ -352,8 +345,6 @@ export declare const ValidateBundleParams: Schema.Struct<{
352
345
  }>;
353
346
  /** @public */
354
347
  export type ValidateBundleParams = typeof ValidateBundleParams.Type;
355
- //#endregion
356
- //#region src/server.d.ts
357
348
  /**
358
349
  * Everything `ServerLayer` still needs from the platform: the four services
359
350
  * `describe_vocabulary`'s declared `Tool.make` dependencies pull through
@@ -432,8 +423,6 @@ export declare const SERVER_INSTRUCTIONS: string;
432
423
  * @public
433
424
  */
434
425
  export declare const ServerLayer: (projectRoot: string, options?: ServerOptions) => Layer.Layer<never, never, PlatformServices>;
435
- //#endregion
436
- //#region src/toolkit.d.ts
437
426
  /**
438
427
  * The six read-only tools (N-10). Tasks C1, C2 and C3 each add two; the
439
428
  * order here is the tool set's own order and is what
@@ -934,8 +923,6 @@ export declare const ToolsLayer: (projectRoot: string, distribution?: Distributi
934
923
  readonly failureMode: "error";
935
924
  }, import("@effected/xdg").AppDirs | import("effect/Crypto").Crypto | import("effect/FileSystem").FileSystem | import("@effected/git").Git | import("@okfit/profiles").GitHistory | import("effect/Path").Path | import("@effected/xdg").Xdg>;
936
925
  }>, never, never>;
937
- //#endregion
938
- //#region src/version.d.ts
939
926
  /**
940
927
  * The version this server reports in `initialize`. Injected by
941
928
  * `@savvy-web/bundler` at build time (K-32); `"0.0.0"` in unbuilt source.
@@ -943,6 +930,5 @@ export declare const ToolsLayer: (projectRoot: string, distribution?: Distributi
943
930
  * @public
944
931
  */
945
932
  export declare const MCP_VERSION: string;
946
- //#endregion
947
933
  export { ConceptSummary, type PlatformServices, Remediation, type ServerOptions, toConceptSummary };
948
934
  //# sourceMappingURL=index.d.ts.map
@@ -1,7 +1,7 @@
1
1
  import { ToolFailure, ToolRefusal } from "@effected/mcp";
2
2
  import { Effect } from "effect";
3
3
 
4
- //#region src/internal/conceptNotFound.ts
4
+ // src/internal/conceptNotFound.ts
5
5
  /**
6
6
  * Maps the engine's `QueryConceptNotFoundError` to the tool-facing failure
7
7
  * `get_concept` and `concept_neighbors` share: a `ToolRefusal` saying the id
@@ -21,5 +21,4 @@ const toConceptLookupFailure = (id, error) => {
21
21
  }));
22
22
  };
23
23
 
24
- //#endregion
25
24
  export { toConceptLookupFailure };
@@ -1,6 +1,6 @@
1
1
  import { LaunchContext } from "@effected/engine";
2
2
 
3
- //#region src/internal/projectRoot.ts
3
+ // src/internal/projectRoot.ts
4
4
  /**
5
5
  * N-21's precedence: `OKFIT_PROJECT_DIR`, else `CLAUDE_PROJECT_DIR`, else
6
6
  * `cwd`. Pure over its `env`/`cwd` arguments so tests never touch
@@ -25,5 +25,4 @@ const resolveMcpProjectRoot = (env, cwd) => LaunchContext.projectDir({
25
25
  cwd
26
26
  });
27
27
 
28
- //#endregion
29
28
  export { resolveMcpProjectRoot };
@@ -2,7 +2,7 @@ import { ToolRefusal } from "@effected/mcp";
2
2
  import { Timestamp } from "@okfit/core";
3
3
  import { DateTime, Effect, Schema } from "effect";
4
4
 
5
- //#region src/internal/resolveNow.ts
5
+ // src/internal/resolveNow.ts
6
6
  /**
7
7
  * An optional ISO-8601 `now` argument, else the Effect clock. Decoding
8
8
  * happens here rather than in the parameter schema so a malformed value
@@ -17,5 +17,4 @@ const resolveNow = (input) => input === void 0 ? DateTime.now : Schema.decodeUnk
17
17
  return ToolRefusal.refuse(String(issue), { hint: "now must be an ISO-8601 instant with an explicit offset, for example 2026-09-06T00:00:00Z." });
18
18
  }));
19
19
 
20
- //#endregion
21
20
  export { resolveNow };
@@ -3,7 +3,7 @@ import { Bundle } from "@okfit/core";
3
3
  import { Effect, Option } from "effect";
4
4
  import { provideConfig, resolveProjectConfig } from "@okfit/engine";
5
5
 
6
- //#region src/internal/toolContext.ts
6
+ // src/internal/toolContext.ts
7
7
  /**
8
8
  * The error's `message` when it has one as a string, else `String(error)`.
9
9
  * A four-line local copy of `CLI/render/json.ts`'s own helper, which is
@@ -66,5 +66,4 @@ const loadToolContext = (projectRoot) => Effect.gen(function* () {
66
66
  };
67
67
  });
68
68
 
69
- //#endregion
70
69
  export { loadToolContext, messageOf, resolveConfigOnly };
@@ -3,7 +3,7 @@ import { ToolRefusal } from "@effected/mcp";
3
3
  import { Effect } from "effect";
4
4
  import { Trust } from "@okfit/profiles";
5
5
 
6
- //#region src/internal/toolSignals.ts
6
+ // src/internal/toolSignals.ts
7
7
  /**
8
8
  * `Trust.signals` with its platform failure (a concept file unreadable while
9
9
  * hashing) collapsed to the tools' one declared failure, a `ToolRefusal`.
@@ -12,5 +12,4 @@ import { Trust } from "@okfit/profiles";
12
12
  */
13
13
  const toolSignals = (bundle, config, now) => Trust.signals(bundle, config, now).pipe(Effect.mapError((cause) => ToolRefusal.refuse(messageOf(cause), { hint: "A concept file could not be read to check its verification; retry once the bundle is readable." })));
14
14
 
15
- //#endregion
16
15
  export { toolSignals };
package/main.d.ts CHANGED
@@ -1,5 +1,4 @@
1
1
  import { Distribution } from "@okfit/engine";
2
- //#region src/main.d.ts
3
2
  /**
4
3
  * Options `@okfit/plugin`'s `okfit-mcp` bin shim (and only it, today) passes
5
4
  * to {@link main}. `distribution` names the meta-package the server was
@@ -31,5 +30,4 @@ export interface MainOptions {
31
30
  * @public
32
31
  */
33
32
  export declare const main: (options?: MainOptions) => Promise<void>;
34
- //#endregion
35
33
  //# sourceMappingURL=main.d.ts.map
package/main.js CHANGED
@@ -1,6 +1,6 @@
1
1
  import { McpGuard } from "@effected/mcp/guard";
2
2
 
3
- //#region src/main.ts
3
+ // src/main.ts
4
4
  /**
5
5
  * The assembled okfit MCP server program.
6
6
  *
@@ -46,5 +46,4 @@ const main = (options = {}) => McpGuard.run({
46
46
  }
47
47
  });
48
48
 
49
- //#endregion
50
49
  export { main };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@okfit/mcp",
3
- "version": "0.9.4",
3
+ "version": "0.9.5",
4
4
  "private": false,
5
5
  "description": "Model Context Protocol server for okfit: query and understand Open Knowledge Format (OKF) bundles from an agent.",
6
6
  "keywords": [
@@ -44,23 +44,23 @@
44
44
  "okfit-mcp": "bin/okfit-mcp.js"
45
45
  },
46
46
  "dependencies": {
47
- "@effect/platform-node": "^4.0.5",
48
- "@effected/config-file": "^0.17.0",
49
- "@effected/engine": "^0.7.0",
50
- "@effected/git": "^0.23.0",
51
- "@effected/glob": "^0.13.0",
52
- "@effected/jsonc": "^0.18.0",
53
- "@effected/markdown": "^0.19.0",
54
- "@effected/mcp": "^0.8.0",
55
- "@effected/schemastore": "^0.24.0",
56
- "@effected/toml": "^0.14.0",
57
- "@effected/walker": "^0.18.0",
58
- "@effected/xdg": "^0.12.0",
59
- "@effected/yaml": "^0.22.0",
60
- "@okfit/core": "0.11.3",
61
- "@okfit/engine": "0.16.3",
62
- "@okfit/profiles": "0.10.4",
63
- "effect": "^4.0.5"
47
+ "@effect/platform-node": "^4.0.6",
48
+ "@effected/config-file": "^0.18.0",
49
+ "@effected/engine": "^0.8.0",
50
+ "@effected/git": "^0.24.0",
51
+ "@effected/glob": "^0.14.0",
52
+ "@effected/jsonc": "^0.19.0",
53
+ "@effected/markdown": "^0.20.0",
54
+ "@effected/mcp": "^0.9.0",
55
+ "@effected/schemastore": "^0.25.0",
56
+ "@effected/toml": "^0.15.0",
57
+ "@effected/walker": "^0.19.0",
58
+ "@effected/xdg": "^0.13.0",
59
+ "@effected/yaml": "^0.23.0",
60
+ "@okfit/core": "0.11.4",
61
+ "@okfit/engine": "0.16.4",
62
+ "@okfit/profiles": "0.10.5",
63
+ "effect": "^4.0.6"
64
64
  },
65
65
  "engines": {
66
66
  "node": ">=24.11.0"
@@ -3,7 +3,7 @@ import { Derive } from "@okfit/core";
3
3
  import { Effect, FileSystem, Layer, Path } from "effect";
4
4
  import { McpSchema, McpServer } from "effect/ai";
5
5
 
6
- //#region src/resources/conceptResource.ts
6
+ // src/resources/conceptResource.ts
7
7
  /**
8
8
  * `okf://concept/<id>` — one static resource per concept in the bundle,
9
9
  * built once at server start.
@@ -59,5 +59,4 @@ const ConceptResources = (projectRoot) => Layer.unwrap(Effect.gen(function* () {
59
59
  }).reduce((acc, layer) => acc.pipe(Layer.merge(layer)), Layer.empty);
60
60
  }).pipe(Effect.tapError((error) => Effect.logError(`okfit-mcp: could not load the bundle to register concept resources: ${error.message}`)), Effect.orElseSucceed(() => Layer.empty)));
61
61
 
62
- //#endregion
63
62
  export { ConceptResources };
@@ -2,7 +2,7 @@ import { loadToolContext } from "../internal/toolContext.js";
2
2
  import { Effect, FileSystem, Path } from "effect";
3
3
  import { McpSchema, McpServer } from "effect/ai";
4
4
 
5
- //#region src/resources/indexResource.ts
5
+ // src/resources/indexResource.ts
6
6
  /**
7
7
  * `okf://index` — the bundle's root `index.md`, read from disk.
8
8
  *
@@ -45,5 +45,4 @@ const IndexResource = (projectRoot) => McpServer.resource({
45
45
  })
46
46
  });
47
47
 
48
- //#endregion
49
48
  export { IndexResource };
package/schema/tools.js CHANGED
@@ -4,7 +4,7 @@ import { Schema } from "effect";
4
4
  import { ContextTag, ContextType, TrustDrift } from "@okfit/engine";
5
5
  import { DriftReason } from "@okfit/profiles";
6
6
 
7
- //#region src/schema/tools.ts
7
+ // src/schema/tools.ts
8
8
  /** One Surface template inside a docs preset, as `describe_vocabulary` reports it. @public */
9
9
  const DocsPresetSurface = Schema.Struct({
10
10
  file: Schema.String,
@@ -137,5 +137,4 @@ const ValidateBundleParams = Schema.Struct({
137
137
  documents: Schema.optionalKey(Schema.Array(ValidateBundleDocument))
138
138
  });
139
139
 
140
- //#endregion
141
140
  export { ConceptNeighborsSuccess, DescribeVocabularySuccess, DocsPreset, DocsPresetSurface, GetConceptSuccess, ListConceptsParams, ListConceptsSuccess, Neighbor, StaleReportParams, StaleReportSuccess, ValidateBundleDocument, ValidateBundleParams };
package/server.js CHANGED
@@ -8,7 +8,7 @@ import { McpProtocol } from "effect/ai";
8
8
  import { GitHistory } from "@okfit/profiles";
9
9
  import { Git } from "@effected/git";
10
10
 
11
- //#region src/server.ts
11
+ // src/server.ts
12
12
  /**
13
13
  * Agent-facing orientation, surfaced verbatim as `instructions` in both the
14
14
  * `initialize` result (2025-11-25 / 2025-06-18) and the `server/discover`
@@ -79,5 +79,4 @@ const ServerLayer = (projectRoot, options = {}) => Layer.mergeAll(McpToolkit.lay
79
79
  ]
80
80
  })));
81
81
 
82
- //#endregion
83
82
  export { SERVER_INSTRUCTIONS, ServerLayer };
package/toolkit.js CHANGED
@@ -6,7 +6,7 @@ import { handleStaleReport, staleReport } from "./tools/staleReport.js";
6
6
  import { handleValidateBundle, validateBundle } from "./tools/validateBundle.js";
7
7
  import { Toolkit } from "effect/ai";
8
8
 
9
- //#region src/toolkit.ts
9
+ // src/toolkit.ts
10
10
  /**
11
11
  * The six read-only tools (N-10). Tasks C1, C2 and C3 each add two; the
12
12
  * order here is the tool set's own order and is what
@@ -33,5 +33,4 @@ const ToolsLayer = (projectRoot, distribution) => OkfitToolkit.toLayer({
33
33
  validate_bundle: (params) => handleValidateBundle(projectRoot, params, distribution)
34
34
  });
35
35
 
36
- //#endregion
37
36
  export { OkfitToolkit, ToolsLayer };
@@ -9,7 +9,7 @@ import { Tool } from "effect/ai";
9
9
  import { ConceptQuery, signalFor } from "@okfit/engine";
10
10
  import { AppDirs, Xdg } from "@effected/xdg";
11
11
 
12
- //#region src/tools/conceptNeighbors.ts
12
+ // src/tools/conceptNeighbors.ts
13
13
  const DESCRIPTION = "Returns the graph neighbours of one concept: everything it links to (outgoing) and everything that links to it (incoming), each with the node kind and, for a concept target, its full summary. Use it after get_concept to walk the bundle's link graph one hop at a time without loading every concept.";
14
14
  /**
15
15
  * `dependencies` mirrors the other tools' (Task B1's Deviation 1): without it
@@ -55,5 +55,4 @@ const handleConceptNeighbors = (projectRoot, params) => Effect.gen(function* ()
55
55
  };
56
56
  });
57
57
 
58
- //#endregion
59
58
  export { conceptNeighbors, handleConceptNeighbors };
@@ -6,7 +6,7 @@ import { Tool } from "effect/ai";
6
6
  import { contextEnvelope } from "@okfit/engine";
7
7
  import { AppDirs, Xdg } from "@effected/xdg";
8
8
 
9
- //#region src/tools/describeVocabulary.ts
9
+ // src/tools/describeVocabulary.ts
10
10
  const DESCRIPTION = "Returns this project's resolved okfit configuration: project root, bundle root, active profile, agent actor, every concept type and tag the config declares, and docs_presets, the active profile's Surface templates (empty without a profile). Call this first, before filtering or writing any concept, to learn which names exist.";
11
11
  /**
12
12
  * `dependencies` names the platform services `handleDescribeVocabulary`
@@ -83,5 +83,4 @@ const handleDescribeVocabulary = (projectRoot) => Effect.gen(function* () {
83
83
  };
84
84
  });
85
85
 
86
- //#endregion
87
86
  export { describeVocabulary, handleDescribeVocabulary };
@@ -9,7 +9,7 @@ import { Tool } from "effect/ai";
9
9
  import { ConceptQuery, signalFor, toTrustDrift } from "@okfit/engine";
10
10
  import { AppDirs, Xdg } from "@effected/xdg";
11
11
 
12
- //#region src/tools/getConcept.ts
12
+ // src/tools/getConcept.ts
13
13
  const DESCRIPTION = "Returns one concept by id: its decoded frontmatter, raw markdown, bundle-relative path, every outgoing link (with where it was written and whether the target is a concept, a file, or missing), and its okfit trust signal: tier, integrity, stale and drift. Accepts a tolerant id, with or without a leading slash or trailing .md.";
14
14
  /**
15
15
  * `dependencies` mirrors `list_concepts`' and `describe_vocabulary`'s
@@ -65,5 +65,4 @@ const handleGetConcept = (projectRoot, params) => Effect.gen(function* () {
65
65
  };
66
66
  });
67
67
 
68
- //#endregion
69
68
  export { getConcept, handleGetConcept };
@@ -10,7 +10,7 @@ import { Tool } from "effect/ai";
10
10
  import { ConceptQuery, signalFor } from "@okfit/engine";
11
11
  import { AppDirs, Xdg } from "@effected/xdg";
12
12
 
13
- //#region src/tools/listConcepts.ts
13
+ // src/tools/listConcepts.ts
14
14
  const DESCRIPTION = "Lists concept summaries, filtered by exact type, tags that must all be present (AND), status, verified (true: current human verification; false: never verified), drifted or stale. Each summary carries tier, integrity and stale. now (ISO-8601 with offset) sets the staleness time. Pages by limit (default 200, max 1000) and offset, with total. An unknown type or tag fails with the valid names.";
15
15
  /**
16
16
  * `dependencies` mirrors `describe_vocabulary`'s (Deviation 1 in Task B1's
@@ -73,5 +73,4 @@ const handleListConcepts = (projectRoot, params) => Effect.gen(function* () {
73
73
  };
74
74
  });
75
75
 
76
- //#endregion
77
76
  export { handleListConcepts, listConcepts };
@@ -10,7 +10,7 @@ import { Tool } from "effect/ai";
10
10
  import { signalFor, toTrustDrift } from "@okfit/engine";
11
11
  import { AppDirs, Xdg } from "@effected/xdg";
12
12
 
13
- //#region src/tools/staleReport.ts
13
+ // src/tools/staleReport.ts
14
14
  const DESCRIPTION = "Lists every stale or drifted concept. items: stale_after passed, each with its summary, the date and whole days past. drifted: human-verified concepts whose content changed since (or was never bound), with the reason and last editor. Uses the current time unless now is given (ISO-8601 with an explicit offset).";
15
15
  /**
16
16
  * `dependencies` mirrors the other tools' (Task B1's Deviation 1):
@@ -64,5 +64,4 @@ const handleStaleReport = (projectRoot, params) => Effect.gen(function* () {
64
64
  };
65
65
  });
66
66
 
67
- //#endregion
68
67
  export { handleStaleReport, staleReport };
@@ -12,7 +12,7 @@ import { GitHistory } from "@okfit/profiles";
12
12
  import { Git } from "@effected/git";
13
13
  import { AppDirs, Xdg } from "@effected/xdg";
14
14
 
15
- //#region src/tools/validateBundle.ts
15
+ // src/tools/validateBundle.ts
16
16
  const DESCRIPTION = "Returns the report `okfit validate --format json` prints, unchanged: each diagnostic's file, code, severity, message and range, the summary counts and the CLI's exit code. Call it after editing any concept file. Optional documents: [{ path, text }] (bundle-relative, e.g. metrics/churn.md) stand in for disk, a file not yet written under an existing directory included; nothing is written.";
17
17
  /**
18
18
  * `dependencies` mirrors the other tools' (Task B1's Deviation 1):
@@ -99,5 +99,4 @@ const handleValidateBundle = (projectRoot, params, distribution) => Effect.gen(f
99
99
  });
100
100
  });
101
101
 
102
- //#endregion
103
102
  export { handleValidateBundle, validateBundle };
package/version.js CHANGED
@@ -1,11 +1,10 @@
1
- //#region src/version.ts
1
+ // src/version.ts
2
2
  /**
3
3
  * The version this server reports in `initialize`. Injected by
4
4
  * `@savvy-web/bundler` at build time (K-32); `"0.0.0"` in unbuilt source.
5
5
  *
6
6
  * @public
7
7
  */
8
- const MCP_VERSION = "0.9.4";
8
+ const MCP_VERSION = "0.9.5";
9
9
 
10
- //#endregion
11
10
  export { MCP_VERSION };