@modootoday/pmcp 0.5.1 → 0.7.0

package/dist/http.js

@@ -1,7 +1,13 @@
+import {
+  DEFAULT_MODEL_ID,
+  encodeEntries,
+  loadEmbedder
+} from "./chunk-NI2OLZPA.js";
+import "./chunk-ZLELYZHL.js";
 import {
   createSkillServer,
   readCatalog
-} from "./chunk-76UKXVUE.js";
+} from "./chunk-QHFORYIN.js";
 
 // src/http.ts
 import {
@@ -17,6 +23,25 @@ function createSkillHttpHandler(options) {
   let all = load(options);
   const tiersFor = options.tiersFor ?? (() => DEFAULT_TIERS);
   const handlers = /* @__PURE__ */ new Map();
+  let embedder;
+  let encoded = /* @__PURE__ */ new Map();
+  let vectors;
+  const semantic = options.semantic;
+  const encode = async () => {
+    if (!semantic) return "lexical";
+    try {
+      embedder ??= semantic.embedder ?? await loadEmbedder(semantic.modelId, semantic) ?? void 0;
+      if (!embedder)
+        throw new Error("@huggingface/transformers is not installed");
+      encoded = await encodeEntries(embedder, all, encoded);
+      vectors = new Map([...encoded].map(([name, v]) => [name, v.vector]));
+      return "semantic";
+    } catch (error) {
+      semantic.onError?.(error);
+      return "lexical";
+    }
+  };
+  let ready = encode();
   const handlerFor = (tiers) => {
     const key = [...tiers].sort().join(",");
     const cached = handlers.get(key);
@@ -24,6 +49,7 @@ function createSkillHttpHandler(options) {
     const handler = createMcpHandler(
       () => createSkillServer({
         ...options,
+        ...embedder && vectors ? { embedder, vectors } : {},
         loadCatalog: () => visibleTo(all, tiers)
       })
     );
@@ -54,12 +80,17 @@ function createSkillHttpHandler(options) {
     reload() {
       all = load(options);
       handlers.clear();
-    }
+      vectors = void 0;
+      ready = encode();
+    },
+    ready: () => ready
   };
 }
 export {
+  DEFAULT_MODEL_ID,
   DEFAULT_TIERS,
   createSkillHttpHandler,
+  loadEmbedder,
   visibleTo
 };
 //# sourceMappingURL=http.js.map

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { I as IntentCache, S as SkillServerOptions, a as SkillTools } from './server-Dm71qZgM.js';
-export { C as CATALOG_PAGE_MAX, b as CATALOG_PAGE_SIZE, c as CallResponse, d as CatalogItem, e as CatalogResponse, D as DEFAULT_FIND_LIMIT, f as DESCRIBE_FILE_LIMIT, E as Embedder, F as FindOptions, g as FindResult, h as IntentCacheStats, K as KindFilter, M as Match, R as READ_BUDGET_BYTES, i as Ranking, j as ReadResult, k as SkillFilters, l as cosine, m as createSkillTools, n as find, o as lexicalScore, p as normaliseIntent } from './server-Dm71qZgM.js';
+import { I as IntentCache, S as SkillServerOptions, a as SkillTools } from './server-wpYiAJ2n.js';
+export { C as CATALOG_PAGE_MAX, b as CATALOG_PAGE_SIZE, c as CallResponse, d as CatalogItem, e as CatalogResponse, D as DEFAULT_FIND_LIMIT, f as DESCRIBE_FILE_LIMIT, E as Embedder, F as FindOptions, g as FindResult, h as IntentCacheStats, K as KindFilter, M as Match, R as READ_BUDGET_BYTES, i as Ranking, j as ReadResult, k as SkillFilters, l as cosine, m as createSkillTools, n as find, o as lexicalScore, p as normaliseIntent } from './server-wpYiAJ2n.js';
 import { S as SkillEntry } from './catalog-5v7jrGwP.js';
 export { a as ASSET_KINDS, A as AssetKind, C as CatalogOptions, M as MAX_SKILL_DEPTH, b as SKIPPED_DIRS, d as displayPath, k as kindOf, r as readBody, c as readCatalog, e as readFrontmatter, w as withoutBody } from './catalog-5v7jrGwP.js';
 import { McpServer } from '@modelcontextprotocol/server';
@@ -99,6 +99,131 @@ declare function findConfig(start: string): string | null;
  */
 declare function readConfig(path: string): ProjectConfig;
 
+/** What the projector writes. A path is unique across a plan and is the lock key. */
+type Output = {
+    readonly kind: "link";
+    readonly path: string;
+    readonly target: string;
+} | {
+    readonly kind: "file";
+    readonly path: string;
+    readonly content: string;
+}
+/** One key inside a JSON file other content shares. path = file#a.b */
+ | {
+    readonly kind: "json";
+    readonly path: string;
+    readonly file: string;
+    readonly key: readonly string[];
+    readonly value: unknown;
+}
+/** A marked block inside a text file other content shares. path = file#pmcp */
+ | {
+    readonly kind: "block";
+    readonly path: string;
+    readonly file: string;
+    readonly content: string;
+};
+
+/**
+ * The projector's reading of pmcp.toml: which tools to write for, and the
+ * per-asset settings that do not belong in the cross-tool sources under .agents/.
+ */
+
+declare const TOOLS: readonly ["claude", "codex", "gemini", "grok", "antigravity"];
+type Tool = (typeof TOOLS)[number];
+type Invocation = "any" | "user";
+interface PackageRulesSpec {
+    /** Path of the rule file inside each package, e.g. `.agent/rules/PACKAGE.RULE.md`. */
+    readonly file: string;
+    /** Subdirectory of `.claude/rules` the links go in. */
+    readonly dir: string;
+    /** Leading path segments dropped when a link name is derived. */
+    readonly strip: readonly string[];
+}
+interface McpServerSpec {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly env: Readonly<Record<string, string>>;
+    /** Tools the server should expose where a host can narrow them. */
+    readonly tools?: readonly string[];
+}
+interface ProjectSpec {
+    readonly root: string;
+    readonly tools: ReadonlySet<Tool>;
+    readonly skills: Readonly<Record<string, {
+        invocation: Invocation;
+    }>>;
+    readonly agents: Readonly<Record<string, Partial<Record<Tool, Record<string, unknown>>>>>;
+    readonly packageRules: PackageRulesSpec | null;
+    readonly mcp: Readonly<Record<string, McpServerSpec>>;
+}
+declare function readSpec(config: ProjectConfig): ProjectSpec;
+
+/**
+ * Every output the sources imply, read from disk but written nowhere. Sources:
+ * .agents/skills, .agents/agents, .agents/rules, package rule files, and pmcp.toml.
+ */
+
+declare function plan(spec: ProjectSpec, owned?: ReadonlyMap<string, string>): Output[];
+
+/**
+ * Writes or checks a plan. The lock (pmcp.lock) records what this wrote, so a
+ * source removed later takes its outputs with it, and a file someone else wrote
+ * is never overwritten.
+ */
+
+declare const LOCK_FILE = "pmcp.lock";
+interface ProjectResult {
+    /** 0 done or clean, 2 check found problems, 3 refused to overwrite. */
+    readonly code: 0 | 2 | 3;
+    readonly problems: readonly string[];
+    readonly outputs: number;
+    readonly pruned: number;
+}
+/** paths: globs whose fixed prefix holds no tracked file: a rule that loads nowhere. */
+declare function deadGlobs(root: string, outputs: readonly Output[]): string[];
+declare function project(spec: ProjectSpec, options: {
+    readonly check: boolean;
+}): ProjectResult;
+
+/**
+ * Asks each tool what it loads, through its own listing commands only: no
+ * model is called. A tool whose CLI is not installed is skipped, not failed.
+ */
+
+interface RunResult {
+    /** The executable was not found. */
+    readonly missing: boolean;
+    readonly status: number | null;
+    readonly stdout: string;
+}
+type Runner = (command: string, args: readonly string[], cwd: string) => RunResult;
+type Status = "ok" | "fail" | "skip";
+interface Finding {
+    readonly tool: Tool | "project";
+    readonly check: string;
+    readonly status: Status;
+    readonly detail?: string;
+}
+interface DoctorOptions {
+    readonly run: Runner;
+    readonly home: string;
+    readonly only?: ReadonlySet<Tool>;
+}
+declare function doctor(spec: ProjectSpec, options: DoctorOptions): Finding[];
+
+/**
+ * Links each package's path-scoped rule file into .claude/rules/<dir>/. One level
+ * down because Grok Build loads every top-level .claude/rules/*.md unscoped.
+ * Names already in use are kept, so moving the links renames nothing.
+ */
+
+declare class ProjectError extends Error {
+    constructor(message: string);
+}
+declare function deriveName(dir: string, strip: readonly string[]): string;
+
 /**
  * The five tools, spoken over MCP.
  *
@@ -156,4 +281,4 @@ declare function extensionEntry(entry: SkillEntry): SkillExtensionEntry | null;
  */
 declare function registerSkillsExtension(server: McpServer, skills: () => readonly SkillEntry[]): void;
 
-export { CONFIG_FILE, type CatalogSection, ConfigError, DEFAULT_INTENT_CACHE_LIMIT, IntentCache, type IntentCacheOptions, type MetadataValue, type ProjectConfig, type Rejection, SERVER_NAME, SKILLS_EXTENSION, SkillEntry, type SkillExtensionEntry, type SkillResource, SkillServerOptions, SkillTools, assetRoot, createSkillServer, extensionEntry, findConfig, openIntentCache, readConfig, readFrontmatterText, readMarketplace, readMetadata, registerSkillTools, registerSkillsExtension, skillUri };
+export { CONFIG_FILE, type CatalogSection, ConfigError, DEFAULT_INTENT_CACHE_LIMIT, type Finding, IntentCache, type IntentCacheOptions, LOCK_FILE, type McpServerSpec, type MetadataValue, type Output, type PackageRulesSpec, type ProjectConfig, ProjectError, type ProjectResult, type ProjectSpec, type Rejection, type Runner, SERVER_NAME, SKILLS_EXTENSION, SkillEntry, type SkillExtensionEntry, type SkillResource, SkillServerOptions, SkillTools, TOOLS, type Tool, assetRoot, createSkillServer, deadGlobs, deriveName, doctor, extensionEntry, findConfig, openIntentCache, plan, project, readConfig, readFrontmatterText, readMarketplace, readMetadata, readSpec, registerSkillTools, registerSkillsExtension, skillUri };

package/dist/index.js

@@ -1,11 +1,22 @@
 import {
   CONFIG_FILE,
   ConfigError,
-  DEFAULT_INTENT_CACHE_LIMIT,
+  LOCK_FILE,
+  ProjectError,
+  TOOLS,
+  deadGlobs,
+  deriveName,
+  doctor,
   findConfig,
-  openIntentCache,
-  readConfig
-} from "./chunk-XTLANVRL.js";
+  plan,
+  project,
+  readConfig,
+  readSpec
+} from "./chunk-GNJSZCRH.js";
+import {
+  DEFAULT_INTENT_CACHE_LIMIT,
+  openIntentCache
+} from "./chunk-ZLELYZHL.js";
 import {
   ASSET_KINDS,
   CATALOG_PAGE_MAX,
@@ -37,7 +48,7 @@ import {
   registerSkillsExtension,
   skillUri,
   withoutBody
-} from "./chunk-76UKXVUE.js";
+} from "./chunk-QHFORYIN.js";
 export {
   ASSET_KINDS,
   CATALOG_PAGE_MAX,
@@ -47,16 +58,22 @@ export {
   DEFAULT_FIND_LIMIT,
   DEFAULT_INTENT_CACHE_LIMIT,
   DESCRIBE_FILE_LIMIT,
+  LOCK_FILE,
   MAX_SKILL_DEPTH,
+  ProjectError,
   READ_BUDGET_BYTES,
   SERVER_NAME,
   SKILLS_EXTENSION,
   SKIPPED_DIRS,
+  TOOLS,
   assetRoot,
   cosine,
   createSkillServer,
   createSkillTools,
+  deadGlobs,
+  deriveName,
   displayPath,
+  doctor,
   extensionEntry,
   find,
   findConfig,
@@ -64,6 +81,8 @@ export {
   lexicalScore,
   normaliseIntent,
   openIntentCache,
+  plan,
+  project,
   readBody,
   readCatalog,
   readConfig,
@@ -71,6 +90,7 @@ export {
   readFrontmatterText,
   readMarketplace,
   readMetadata,
+  readSpec,
   registerSkillTools,
   registerSkillsExtension,
   skillUri,

package/dist/{server-Dm71qZgM.d.ts → server-wpYiAJ2n.d.ts}

@@ -56,7 +56,10 @@ interface FindResult {
 interface Embedder {
     readonly modelId: string;
     readonly dims: number;
+    /** Encodes an intent, the query side. */
     embed(text: string): Promise<Float32Array>;
+    /** Encodes a description, for models that write the two sides differently. */
+    embedPassage?(text: string): Promise<Float32Array>;
 }
 interface FindOptions {
     readonly entries: readonly SkillEntry[];

package/dist/stdio.js

@@ -3,8 +3,8 @@ import {
   main,
   resolveRoots,
   serve
-} from "./chunk-ICHBC5FM.js";
-import "./chunk-76UKXVUE.js";
+} from "./chunk-POJOFL4L.js";
+import "./chunk-QHFORYIN.js";
 export {
   main,
   resolveRoots,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modootoday/pmcp",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "license": "Elastic-2.0",
   "author": "modootoday",
   "description": "An MCP server that finds the skills your installed packages already ship. Reads SKILL.md out of node_modules by shape rather than by path, so it sees the skills, .agent, .claude, .gemini and .codex conventions alike, and keeps session startup flat as the number of installed skills grows.",