@serviceme/devtools-core 2.0.0 → 2.0.2

package/dist/skill-store.mjs

@@ -1,301 +1,2 @@
-// src/skill-store/index.ts
-import * as fs2 from "fs/promises";
-import * as path2 from "path";
-
-// src/repo-layout/index.ts
-import * as fs from "fs/promises";
-import * as path from "path";
-var MARKER_FILENAME = ".serviceme-repo.json";
-var SUPPORTED_SCHEMA = 1;
-var DEFAULT_REPO_LAYOUT = {
-  schema: SUPPORTED_SCHEMA,
-  include: [],
-  exclude: [],
-  treatFilesAsSkills: false
-};
-async function loadRepoLayout(repoRoot) {
-  const markerPath = path.join(repoRoot, MARKER_FILENAME);
-  let raw;
-  try {
-    raw = await fs.readFile(markerPath, "utf8");
-  } catch {
-    return DEFAULT_REPO_LAYOUT;
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    return null;
-  }
-  if (!parsed || typeof parsed !== "object") return null;
-  const obj = parsed;
-  if (obj.schema !== SUPPORTED_SCHEMA) return null;
-  if (!Array.isArray(obj.include) || obj.include.some((s) => typeof s !== "string")) {
-    return null;
-  }
-  if (!Array.isArray(obj.exclude) || obj.exclude.some((s) => typeof s !== "string")) {
-    return null;
-  }
-  if (typeof obj.treatFilesAsSkills !== "boolean") return null;
-  return {
-    schema: SUPPORTED_SCHEMA,
-    include: obj.include,
-    exclude: obj.exclude,
-    treatFilesAsSkills: obj.treatFilesAsSkills
-  };
-}
-
-// src/skill-store/types.ts
-var SkillNotFoundError = class extends Error {
-  constructor(repoId, skillName) {
-    super(`skill/agent not found: ${repoId}/${skillName}`);
-    this.repoId = repoId;
-    this.skillName = skillName;
-    this.name = "SkillNotFoundError";
-  }
-};
-
-// src/skill-store/index.ts
-function extractFrontmatter(raw) {
-  if (typeof raw !== "string") return null;
-  const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
-  if (!match) return null;
-  const yamlBody = match[1] ?? "";
-  const body = match[2] ?? "";
-  const data = {};
-  const lines = yamlBody.split(/\r?\n/);
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i] ?? "";
-    if (line.trim().length === 0) continue;
-    if (line.trim().startsWith("#")) continue;
-    const kv = line.match(/^([a-zA-Z_][\w-]*)\s*:\s*(.*)$/);
-    if (!kv?.[1]) continue;
-    let value = (kv[2] ?? "").trim();
-    if (typeof value === "string" && /^[>|][+-]?$/.test(value)) {
-      const folded = [];
-      let j = i + 1;
-      for (; j < lines.length; j++) {
-        const next = lines[j] ?? "";
-        if (next.trim().length === 0) {
-          const after = lines[j + 1];
-          if (after !== void 0 && /^[ \t]/.test(after)) {
-            folded.push("");
-            continue;
-          }
-          break;
-        }
-        if (!/^[ \t]/.test(next)) break;
-        folded.push(next.trim());
-      }
-      i = j - 1;
-      value = folded.join(" ").replace(/\s+/g, " ").trim();
-      data[kv[1]] = value;
-      continue;
-    }
-    if (typeof value === "string") {
-      if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
-        value = value.slice(1, -1);
-      }
-    }
-    data[kv[1]] = value;
-  }
-  return { data, body };
-}
-var SkillStore = class {
-  constructor(opts) {
-    /**
-     * Per-instance memo of repo walks. The catalog walk is a recursive
-     * readdir over the whole checkout — the dominant cost of every
-     * list/get — so results (and the in-flight promise) are reused for
-     * the store's lifetime. The handler that owns long-lived stores
-     * bounds staleness by rebuilding the store on a short TTL; within
-     * one store instance the tree is treated as immutable.
-     */
-    this.entriesMemo = /* @__PURE__ */ new Map();
-    this.repoRoots = /* @__PURE__ */ new Map();
-    for (const r of opts.repos) this.repoRoots.set(r.id, r.rootPath);
-  }
-  /** All skills + agents across all registered repos. Repos are walked
-   * concurrently — one slow checkout no longer stretches the total. */
-  async listAll() {
-    const perRepo = await Promise.all(
-      [...this.repoRoots.keys()].map((repoId) => this.listByRepo(repoId))
-    );
-    return perRepo.flat();
-  }
-  /** All skills + agents under a single repo. */
-  async listByRepo(repoId) {
-    const entries = await this.listByRepoCached(repoId);
-    return [...entries];
-  }
-  /** Single entry detail (manifest + all files inside its dir). */
-  async get(repoId, name) {
-    const entries = await this.listByRepoCached(repoId);
-    const found = entries.find((e) => e.name === name);
-    if (!found) throw new SkillNotFoundError(repoId, name);
-    const files = await collectEntryFiles(found);
-    return { ...found, files };
-  }
-  /** All files inside a single entry's directory (manifest + extras). */
-  async getFiles(repoId, name) {
-    const entries = await this.listByRepoCached(repoId);
-    const found = entries.find((e) => e.name === name);
-    if (!found) throw new SkillNotFoundError(repoId, name);
-    return collectEntryFiles(found);
-  }
-  /**
-   * Memoized walk. Sharing the promise collapses concurrent list/get
-   * calls over the same repo into a single traversal; a rejected walk
-   * is dropped so the next call retries from disk.
-   */
-  listByRepoCached(repoId) {
-    const memoized = this.entriesMemo.get(repoId);
-    if (memoized) return memoized;
-    const walk = this.walkRepo(repoId).catch((error) => {
-      this.entriesMemo.delete(repoId);
-      throw error;
-    });
-    this.entriesMemo.set(repoId, walk);
-    return walk;
-  }
-  async walkRepo(repoId) {
-    const root = this.repoRoots.get(repoId);
-    if (!root) return [];
-    const layout = await loadRepoLayout(root) ?? DEFAULT_REPO_LAYOUT;
-    const entries = [];
-    await walkForEntries(root, repoId, entries, layout);
-    return entries;
-  }
-};
-async function collectEntryFiles(found) {
-  const out = [];
-  if (found.dir === found.manifestPath) {
-    const content = await fs2.readFile(found.manifestPath, "utf8");
-    return [{ path: path2.basename(found.manifestPath), content }];
-  }
-  await collectFilesRecursive(found.dir, found.dir, out);
-  out.sort((a, b) => {
-    const aIsManifest = a.path === "SKILL.md" || a.path === "AGENT.md";
-    const bIsManifest = b.path === "SKILL.md" || b.path === "AGENT.md";
-    if (aIsManifest && !bIsManifest) return -1;
-    if (bIsManifest && !aIsManifest) return 1;
-    return a.path.localeCompare(b.path);
-  });
-  return out;
-}
-var SKIP_DIRS = /* @__PURE__ */ new Set([".git", "node_modules", ".vscode", "dist", "build", "out"]);
-var SKIP_TOP_LEVEL_SCAN_DIRS = /* @__PURE__ */ new Set([...SKIP_DIRS, "plugins"]);
-var FLAT_AGENT_FILE_SUFFIX = ".agent.md";
-async function walkForEntries(rootDir, repoId, out, layout = DEFAULT_REPO_LAYOUT) {
-  let dirents;
-  try {
-    dirents = await fs2.readdir(rootDir, { withFileTypes: true });
-  } catch {
-    return;
-  }
-  for (const d of dirents) {
-    if (d.isFile() && d.name.endsWith(FLAT_AGENT_FILE_SUFFIX)) {
-      const filePath = path2.join(rootDir, d.name);
-      const stat2 = await fs2.stat(filePath);
-      const content = await fs2.readFile(filePath, "utf8");
-      const parsed = extractFrontmatter(content);
-      out.push({
-        repoId,
-        name: d.name.slice(0, -FLAT_AGENT_FILE_SUFFIX.length),
-        kind: "agent",
-        manifestPath: filePath,
-        // Sentinel: `dir === manifestPath` marks a flat single-file
-        // entry (no directory of its own — see getFiles()).
-        dir: filePath,
-        frontmatter: parsed?.data ?? {},
-        modifiedAt: stat2.mtime.toISOString()
-      });
-      continue;
-    }
-    if (!d.isDirectory()) continue;
-    if (SKIP_TOP_LEVEL_SCAN_DIRS.has(d.name)) continue;
-    if (layout.exclude.includes(d.name)) continue;
-    const childDir = path2.join(rootDir, d.name);
-    const kind = await detectKind(childDir);
-    if (kind) {
-      const manifestFilename = kind === "skill" ? "SKILL.md" : "AGENT.md";
-      const manifestPath = path2.join(childDir, manifestFilename);
-      const stat2 = await fs2.stat(manifestPath);
-      const content = await fs2.readFile(manifestPath, "utf8");
-      const parsed = extractFrontmatter(content);
-      out.push({
-        repoId,
-        name: d.name,
-        kind,
-        manifestPath,
-        dir: childDir,
-        frontmatter: parsed?.data ?? {},
-        modifiedAt: stat2.mtime.toISOString()
-      });
-      continue;
-    }
-    await walkForEntries(childDir, repoId, out, layout);
-    if (layout.treatFilesAsSkills && layout.include.includes(d.name)) {
-      await surfaceFilesAsSkills(childDir, d.name, repoId, out);
-    }
-  }
-}
-async function surfaceFilesAsSkills(absDir, relName, repoId, out) {
-  let dirents;
-  try {
-    dirents = await fs2.readdir(absDir, { withFileTypes: true });
-  } catch {
-    return;
-  }
-  for (const d of dirents) {
-    if (!d.isFile()) continue;
-    if (!d.name.endsWith(".md")) continue;
-    const filePath = path2.join(absDir, d.name);
-    const stat2 = await fs2.stat(filePath);
-    const content = await fs2.readFile(filePath, "utf8");
-    const parsed = extractFrontmatter(content);
-    const entryName = `${relName}/${d.name.replace(/\.md$/, "")}`;
-    out.push({
-      repoId,
-      name: entryName,
-      kind: "skill",
-      manifestPath: filePath,
-      dir: absDir,
-      frontmatter: parsed?.data ?? {},
-      modifiedAt: stat2.mtime.toISOString()
-    });
-  }
-}
-async function detectKind(dir) {
-  const [hasSkill, hasAgent] = await Promise.all([
-    fs2.access(path2.join(dir, "SKILL.md")).then(() => true).catch(() => false),
-    fs2.access(path2.join(dir, "AGENT.md")).then(() => true).catch(() => false)
-  ]);
-  if (hasSkill) return "skill";
-  if (hasAgent) return "agent";
-  return null;
-}
-async function collectFilesRecursive(absDir, entryRoot, out) {
-  let dirents;
-  try {
-    dirents = await fs2.readdir(absDir, { withFileTypes: true });
-  } catch {
-    return;
-  }
-  for (const d of dirents) {
-    if (SKIP_DIRS.has(d.name)) continue;
-    const full = path2.join(absDir, d.name);
-    if (d.isDirectory()) {
-      await collectFilesRecursive(full, entryRoot, out);
-    } else if (d.isFile()) {
-      const content = await fs2.readFile(full, "utf8");
-      out.push({ path: path2.relative(entryRoot, full), content });
-    }
-  }
-}
-export {
-  SkillNotFoundError,
-  SkillStore,
-  extractFrontmatter
-};
-//# sourceMappingURL=skill-store.mjs.map
+import { n as extractFrontmatter, r as SkillNotFoundError, t as SkillStore } from "./skill-store-Bym2yinU.mjs";
+export { SkillNotFoundError, SkillStore, extractFrontmatter };

package/dist/submit-Cg7wSa3x.mjs

@@ -0,0 +1,84 @@
+import { R as getRepoDir } from "./userHome-CcnAQPG1.mjs";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+//#region src/submit/types.ts
+/** Sentinel error thrown by SubmitClient.submit() / validate(). */
+var SubmitError = class extends Error {
+	constructor(reason, detail, options) {
+		super(`submit failed (${reason}): ${detail}`);
+		this.name = "SubmitError";
+		this.reason = reason;
+		this.detail = detail;
+		this.status = options?.status;
+	}
+};
+//#endregion
+//#region src/submit/index.ts
+var SubmitClient = class {
+	constructor(opts) {
+		this.git = opts.gitClient;
+		this.getRepoBranch = opts.getRepoBranch ?? (() => void 0);
+		this.fetcher = opts.fetcher ?? globalThis.fetch;
+		this.defaultServerBaseUrl = opts.defaultServerBaseUrl ?? "http://localhost:3000";
+	}
+	/**
+	* Validate-only path. Useful for the UI's "Save Draft" flow which
+	* wants to surface validation errors without committing or pushing.
+	*/
+	async validate(req) {
+		const url = `${this.defaultServerBaseUrl}/api/v1/skills/validate`;
+		const res = await this.fetcher(url, {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify(req)
+		});
+		if (!res.ok) throw new SubmitError("network_error", `validate request failed: HTTP ${res.status}`);
+		return await res.json();
+	}
+	/**
+	* Full submit pipeline. Throws `SubmitError` on:
+	*   - validate deny (reason echoed)
+	*   - network failure (network_error)
+	*   - local write failure
+	*   - commit/push failure
+	*/
+	async submit(repoId, skillName, files, opts = {}) {
+		const v = await this.validate({
+			repoId,
+			skillName,
+			files
+		});
+		if (!v.allow) throw new SubmitError(v.reason ?? "unknown", v.detail ?? "validation denied");
+		const localRepoPath = getRepoDir(repoId);
+		const targetDir = path.join(localRepoPath, "skills", skillName);
+		await fs.mkdir(targetDir, { recursive: true });
+		for (const f of files) {
+			const full = path.join(targetDir, f.path);
+			await fs.mkdir(path.dirname(full), { recursive: true });
+			const tmp = `${full}.${process.pid}.${Date.now()}.tmp`;
+			await fs.writeFile(tmp, f.content, "utf8");
+			await fs.rename(tmp, full);
+		}
+		const commitMessage = `feat(skills): add ${skillName}`;
+		const { commitSha } = await this.git.commit(localRepoPath, commitMessage);
+		let pushedRef;
+		let pushedSha;
+		if (!opts.skipPush) {
+			const branch = opts.branch ?? this.getRepoBranch(repoId) ?? "main";
+			const pushResult = await this.git.push(repoId, localRepoPath, branch);
+			pushedRef = pushResult.ref;
+			pushedSha = pushResult.commitSha;
+		}
+		return {
+			repoId,
+			skillName,
+			commitSha,
+			pushedRef,
+			pushedSha
+		};
+	}
+};
+//#endregion
+export { SubmitError as n, SubmitClient as t };
+
+//# sourceMappingURL=submit-Cg7wSa3x.mjs.map

package/dist/submit-Cg7wSa3x.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-Cg7wSa3x.mjs","names":[],"sources":["../src/submit/types.ts","../src/submit/index.ts"],"sourcesContent":["/**\n * Skill & Agent v2 — SubmitClient Types (M4)\n *\n * Mirrors the server's POST /api/v1/skills/validate contract (M2\n * SubmitApi). Defined here as a separate types file so the test\n * fixtures + the client can both import without circular deps.\n */\n\n/** Reasons the server may deny a submission. */\nexport type DenyReason =\n\t| \"repo_not_writable\"\n\t| \"file_too_large\"\n\t| \"path_traversal\"\n\t| \"invalid_frontmatter\"\n\t| \"name_conflict\"\n\t/** Local-client-side errors that don't come from the server. */\n\t| \"network_error\"\n\t| \"write_error\"\n\t| \"commit_error\"\n\t| \"push_error\"\n\t| \"unknown\";\n\n/** Request payload. Identical to the server's SubmitValidationRequest. */\nexport interface SubmitValidationRequest {\n\trepoId: string;\n\tskillName: string;\n\tfiles: Array<{ path: string; content: string }>;\n}\n\n/** Response payload. Identical to the server's SubmitValidationResponse. */\nexport interface SubmitValidationResponse {\n\tallow: boolean;\n\treason?: DenyReason;\n\tdetail?: string;\n}\n\n/** Sentinel error thrown by SubmitClient.submit() / validate(). */\nexport class SubmitError extends Error {\n\treadonly reason: DenyReason;\n\treadonly detail: string;\n\treadonly status?: number;\n\n\tconstructor(reason: DenyReason, detail: string, options?: { status?: number }) {\n\t\tsuper(`submit failed (${reason}): ${detail}`);\n\t\tthis.name = \"SubmitError\";\n\t\tthis.reason = reason;\n\t\tthis.detail = detail;\n\t\tthis.status = options?.status;\n\t}\n}\n","import * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport type { GitClient } from \"../git-client\";\nimport { getRepoDir } from \"../paths/userHome\";\nimport type { SkillFile } from \"../skill-store/types\";\nimport type { SubmitValidationRequest, SubmitValidationResponse } from \"./types\";\nimport { SubmitError } from \"./types\";\n\n// Re-export so consumers (bridge handlers, CLI commands) can detect\n// SubmitError via `instanceof` without reaching into the internal\n// `./types` module.\nexport { SubmitError } from \"./types\";\n\n/**\n * Skill & Agent v2 — SubmitClient (M4)\n *\n * SubmitClient orchestrates the \"validate then push\" flow described\n * in docs/architecture/skill-agent-v2-repo.md §5.7:\n *\n *   1. **validate** — POST the candidate files to the server's\n *      `/api/v1/skills/validate` endpoint (5 deny reasons: repo_not_\n *      writable, file_too_large, path_traversal, invalid_frontmatter,\n *      name_conflict).\n *   2. **write** — materialize the files into the local repo clone at\n *      `~/.serviceme/repos/<repoId>/skills/<name>/` (or `agents/`).\n *   3. **commit** — `git add . && git commit -m \"feat(skills): add <name>\"`.\n *   4. **push** — `git push origin <branch>` via the server proxy.\n *\n * The client is intentionally thin: it does NOT do its own validation\n * (the server is the gate), and it does NOT cache anything across\n * calls. The single source of truth for \"is this submission allowed?\"\n * is the server's validate endpoint.\n *\n * @see docs/architecture/skill-agent-v2-repo.md §5.7 SubmitClient\n */\n\nexport interface SubmitOptions {\n\t/** Override the server's validate URL. Defaults to `http://localhost:3000/api/v1`. */\n\tserverBaseUrl?: string;\n\t/** Override the branch to push. Defaults to the repo's `branch` field. */\n\tbranch?: string;\n\t/** Skip the actual push (for tests + dry-runs). When true, step 4 returns a synthetic PushResult. */\n\tskipPush?: boolean;\n}\n\nexport interface SubmitResult {\n\trepoId: string;\n\tskillName: string;\n\tcommitSha: string;\n\tpushedRef?: string;\n\tpushedSha?: string;\n}\n\nexport interface SubmitClientOptions {\n\tgitClient: GitClient;\n\t/** Lookup the default branch for a repo (config-driven). */\n\tgetRepoBranch?: (repoId: string) => string | undefined;\n\t/** HTTP fetch impl (defaults to the global `fetch`). */\n\tfetcher?: typeof fetch;\n\t/** Default server base URL when no override is supplied. */\n\tdefaultServerBaseUrl?: string;\n}\n\nexport class SubmitClient {\n\tprivate readonly git: GitClient;\n\tprivate readonly getRepoBranch: (repoId: string) => string | undefined;\n\tprivate readonly fetcher: typeof fetch;\n\tprivate readonly defaultServerBaseUrl: string;\n\n\tconstructor(opts: SubmitClientOptions) {\n\t\tthis.git = opts.gitClient;\n\t\tthis.getRepoBranch = opts.getRepoBranch ?? (() => undefined);\n\t\tthis.fetcher = opts.fetcher ?? (globalThis.fetch as typeof fetch);\n\t\tthis.defaultServerBaseUrl = opts.defaultServerBaseUrl ?? \"http://localhost:3000\";\n\t}\n\n\t/**\n\t * Validate-only path. Useful for the UI's \"Save Draft\" flow which\n\t * wants to surface validation errors without committing or pushing.\n\t */\n\tasync validate(req: SubmitValidationRequest): Promise<SubmitValidationResponse> {\n\t\tconst url = `${this.defaultServerBaseUrl}/api/v1/skills/validate`;\n\t\tconst res = await this.fetcher(url, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { \"content-type\": \"application/json\" },\n\t\t\tbody: JSON.stringify(req),\n\t\t});\n\t\tif (!res.ok) {\n\t\t\tthrow new SubmitError(\"network_error\", `validate request failed: HTTP ${res.status}`);\n\t\t}\n\t\treturn (await res.json()) as SubmitValidationResponse;\n\t}\n\n\t/**\n\t * Full submit pipeline. Throws `SubmitError` on:\n\t *   - validate deny (reason echoed)\n\t *   - network failure (network_error)\n\t *   - local write failure\n\t *   - commit/push failure\n\t */\n\tasync submit(\n\t\trepoId: string,\n\t\tskillName: string,\n\t\tfiles: SkillFile[],\n\t\topts: SubmitOptions = {}\n\t): Promise<SubmitResult> {\n\t\t// (1) Validate\n\t\tconst v = await this.validate({ repoId, skillName, files });\n\t\tif (!v.allow) {\n\t\t\tthrow new SubmitError(v.reason ?? \"unknown\", v.detail ?? \"validation denied\");\n\t\t}\n\n\t\t// (2) Write files into the local repo clone\n\t\tconst localRepoPath = getRepoDir(repoId);\n\t\tconst targetDir = path.join(localRepoPath, \"skills\", skillName);\n\t\tawait fs.mkdir(targetDir, { recursive: true });\n\t\tfor (const f of files) {\n\t\t\tconst full = path.join(targetDir, f.path);\n\t\t\tawait fs.mkdir(path.dirname(full), { recursive: true });\n\t\t\tconst tmp = `${full}.${process.pid}.${Date.now()}.tmp`;\n\t\t\tawait fs.writeFile(tmp, f.content, \"utf8\");\n\t\t\tawait fs.rename(tmp, full);\n\t\t}\n\n\t\t// (3) Commit (convention: `feat(skills): add <name>`)\n\t\tconst commitMessage = `feat(skills): add ${skillName}`;\n\t\tconst { commitSha } = await this.git.commit(localRepoPath, commitMessage);\n\n\t\t// (4) Push\n\t\tlet pushedRef: string | undefined;\n\t\tlet pushedSha: string | undefined;\n\t\tif (!opts.skipPush) {\n\t\t\tconst branch = opts.branch ?? this.getRepoBranch(repoId) ?? \"main\";\n\t\t\tconst pushResult = await this.git.push(repoId, localRepoPath, branch);\n\t\t\tpushedRef = pushResult.ref;\n\t\t\tpushedSha = pushResult.commitSha;\n\t\t}\n\n\t\treturn {\n\t\t\trepoId,\n\t\t\tskillName,\n\t\t\tcommitSha,\n\t\t\tpushedRef,\n\t\t\tpushedSha,\n\t\t};\n\t}\n}\n"],"mappings":";;;;;AAqCA,IAAa,cAAb,cAAiC,MAAM;CAKtC,YAAY,QAAoB,QAAgB,SAA+B;EAC9E,MAAM,kBAAkB,OAAO,KAAK,QAAQ;EAC5C,KAAK,OAAO;EACZ,KAAK,SAAS;EACd,KAAK,SAAS;EACd,KAAK,SAAS,SAAS;CACxB;AACD;;;ACcA,IAAa,eAAb,MAA0B;CAMzB,YAAY,MAA2B;EACtC,KAAK,MAAM,KAAK;EAChB,KAAK,gBAAgB,KAAK,wBAAwB,KAAA;EAClD,KAAK,UAAU,KAAK,WAAY,WAAW;EAC3C,KAAK,uBAAuB,KAAK,wBAAwB;CAC1D;;;;;CAMA,MAAM,SAAS,KAAiE;EAC/E,MAAM,MAAM,GAAG,KAAK,qBAAqB;EACzC,MAAM,MAAM,MAAM,KAAK,QAAQ,KAAK;GACnC,QAAQ;GACR,SAAS,EAAE,gBAAgB,mBAAmB;GAC9C,MAAM,KAAK,UAAU,GAAG;EACzB,CAAC;EACD,IAAI,CAAC,IAAI,IACR,MAAM,IAAI,YAAY,iBAAiB,iCAAiC,IAAI,QAAQ;EAErF,OAAQ,MAAM,IAAI,KAAK;CACxB;;;;;;;;CASA,MAAM,OACL,QACA,WACA,OACA,OAAsB,CAAC,GACC;EAExB,MAAM,IAAI,MAAM,KAAK,SAAS;GAAE;GAAQ;GAAW;EAAM,CAAC;EAC1D,IAAI,CAAC,EAAE,OACN,MAAM,IAAI,YAAY,EAAE,UAAU,WAAW,EAAE,UAAU,mBAAmB;EAI7E,MAAM,gBAAgB,WAAW,MAAM;EACvC,MAAM,YAAY,KAAK,KAAK,eAAe,UAAU,SAAS;EAC9D,MAAM,GAAG,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;EAC7C,KAAK,MAAM,KAAK,OAAO;GACtB,MAAM,OAAO,KAAK,KAAK,WAAW,EAAE,IAAI;GACxC,MAAM,GAAG,MAAM,KAAK,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;GACtD,MAAM,MAAM,GAAG,KAAK,GAAG,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE;GACjD,MAAM,GAAG,UAAU,KAAK,EAAE,SAAS,MAAM;GACzC,MAAM,GAAG,OAAO,KAAK,IAAI;EAC1B;EAGA,MAAM,gBAAgB,qBAAqB;EAC3C,MAAM,EAAE,cAAc,MAAM,KAAK,IAAI,OAAO,eAAe,aAAa;EAGxE,IAAI;EACJ,IAAI;EACJ,IAAI,CAAC,KAAK,UAAU;GACnB,MAAM,SAAS,KAAK,UAAU,KAAK,cAAc,MAAM,KAAK;GAC5D,MAAM,aAAa,MAAM,KAAK,IAAI,KAAK,QAAQ,eAAe,MAAM;GACpE,YAAY,WAAW;GACvB,YAAY,WAAW;EACxB;EAEA,OAAO;GACN;GACA;GACA;GACA;GACA;EACD;CACD;AACD"}

package/dist/submit-CltE6YOZ.js

@@ -0,0 +1,98 @@
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.js");
+const require_userHome = require("./userHome-BquDeFVE.js");
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = require_rolldown_runtime.__toESM(node_fs_promises);
+let node_path = require("node:path");
+node_path = require_rolldown_runtime.__toESM(node_path);
+//#region src/submit/types.ts
+/** Sentinel error thrown by SubmitClient.submit() / validate(). */
+var SubmitError = class extends Error {
+	constructor(reason, detail, options) {
+		super(`submit failed (${reason}): ${detail}`);
+		this.name = "SubmitError";
+		this.reason = reason;
+		this.detail = detail;
+		this.status = options?.status;
+	}
+};
+//#endregion
+//#region src/submit/index.ts
+var SubmitClient = class {
+	constructor(opts) {
+		this.git = opts.gitClient;
+		this.getRepoBranch = opts.getRepoBranch ?? (() => void 0);
+		this.fetcher = opts.fetcher ?? globalThis.fetch;
+		this.defaultServerBaseUrl = opts.defaultServerBaseUrl ?? "http://localhost:3000";
+	}
+	/**
+	* Validate-only path. Useful for the UI's "Save Draft" flow which
+	* wants to surface validation errors without committing or pushing.
+	*/
+	async validate(req) {
+		const url = `${this.defaultServerBaseUrl}/api/v1/skills/validate`;
+		const res = await this.fetcher(url, {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify(req)
+		});
+		if (!res.ok) throw new SubmitError("network_error", `validate request failed: HTTP ${res.status}`);
+		return await res.json();
+	}
+	/**
+	* Full submit pipeline. Throws `SubmitError` on:
+	*   - validate deny (reason echoed)
+	*   - network failure (network_error)
+	*   - local write failure
+	*   - commit/push failure
+	*/
+	async submit(repoId, skillName, files, opts = {}) {
+		const v = await this.validate({
+			repoId,
+			skillName,
+			files
+		});
+		if (!v.allow) throw new SubmitError(v.reason ?? "unknown", v.detail ?? "validation denied");
+		const localRepoPath = require_userHome.getRepoDir(repoId);
+		const targetDir = node_path.join(localRepoPath, "skills", skillName);
+		await node_fs_promises.mkdir(targetDir, { recursive: true });
+		for (const f of files) {
+			const full = node_path.join(targetDir, f.path);
+			await node_fs_promises.mkdir(node_path.dirname(full), { recursive: true });
+			const tmp = `${full}.${process.pid}.${Date.now()}.tmp`;
+			await node_fs_promises.writeFile(tmp, f.content, "utf8");
+			await node_fs_promises.rename(tmp, full);
+		}
+		const commitMessage = `feat(skills): add ${skillName}`;
+		const { commitSha } = await this.git.commit(localRepoPath, commitMessage);
+		let pushedRef;
+		let pushedSha;
+		if (!opts.skipPush) {
+			const branch = opts.branch ?? this.getRepoBranch(repoId) ?? "main";
+			const pushResult = await this.git.push(repoId, localRepoPath, branch);
+			pushedRef = pushResult.ref;
+			pushedSha = pushResult.commitSha;
+		}
+		return {
+			repoId,
+			skillName,
+			commitSha,
+			pushedRef,
+			pushedSha
+		};
+	}
+};
+//#endregion
+Object.defineProperty(exports, "SubmitClient", {
+	enumerable: true,
+	get: function() {
+		return SubmitClient;
+	}
+});
+Object.defineProperty(exports, "SubmitError", {
+	enumerable: true,
+	get: function() {
+		return SubmitError;
+	}
+});
+
+//# sourceMappingURL=submit-CltE6YOZ.js.map

package/dist/submit-CltE6YOZ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-CltE6YOZ.js","names":["getRepoDir","path","fs"],"sources":["../src/submit/types.ts","../src/submit/index.ts"],"sourcesContent":["/**\n * Skill & Agent v2 — SubmitClient Types (M4)\n *\n * Mirrors the server's POST /api/v1/skills/validate contract (M2\n * SubmitApi). Defined here as a separate types file so the test\n * fixtures + the client can both import without circular deps.\n */\n\n/** Reasons the server may deny a submission. */\nexport type DenyReason =\n\t| \"repo_not_writable\"\n\t| \"file_too_large\"\n\t| \"path_traversal\"\n\t| \"invalid_frontmatter\"\n\t| \"name_conflict\"\n\t/** Local-client-side errors that don't come from the server. */\n\t| \"network_error\"\n\t| \"write_error\"\n\t| \"commit_error\"\n\t| \"push_error\"\n\t| \"unknown\";\n\n/** Request payload. Identical to the server's SubmitValidationRequest. */\nexport interface SubmitValidationRequest {\n\trepoId: string;\n\tskillName: string;\n\tfiles: Array<{ path: string; content: string }>;\n}\n\n/** Response payload. Identical to the server's SubmitValidationResponse. */\nexport interface SubmitValidationResponse {\n\tallow: boolean;\n\treason?: DenyReason;\n\tdetail?: string;\n}\n\n/** Sentinel error thrown by SubmitClient.submit() / validate(). */\nexport class SubmitError extends Error {\n\treadonly reason: DenyReason;\n\treadonly detail: string;\n\treadonly status?: number;\n\n\tconstructor(reason: DenyReason, detail: string, options?: { status?: number }) {\n\t\tsuper(`submit failed (${reason}): ${detail}`);\n\t\tthis.name = \"SubmitError\";\n\t\tthis.reason = reason;\n\t\tthis.detail = detail;\n\t\tthis.status = options?.status;\n\t}\n}\n","import * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport type { GitClient } from \"../git-client\";\nimport { getRepoDir } from \"../paths/userHome\";\nimport type { SkillFile } from \"../skill-store/types\";\nimport type { SubmitValidationRequest, SubmitValidationResponse } from \"./types\";\nimport { SubmitError } from \"./types\";\n\n// Re-export so consumers (bridge handlers, CLI commands) can detect\n// SubmitError via `instanceof` without reaching into the internal\n// `./types` module.\nexport { SubmitError } from \"./types\";\n\n/**\n * Skill & Agent v2 — SubmitClient (M4)\n *\n * SubmitClient orchestrates the \"validate then push\" flow described\n * in docs/architecture/skill-agent-v2-repo.md §5.7:\n *\n *   1. **validate** — POST the candidate files to the server's\n *      `/api/v1/skills/validate` endpoint (5 deny reasons: repo_not_\n *      writable, file_too_large, path_traversal, invalid_frontmatter,\n *      name_conflict).\n *   2. **write** — materialize the files into the local repo clone at\n *      `~/.serviceme/repos/<repoId>/skills/<name>/` (or `agents/`).\n *   3. **commit** — `git add . && git commit -m \"feat(skills): add <name>\"`.\n *   4. **push** — `git push origin <branch>` via the server proxy.\n *\n * The client is intentionally thin: it does NOT do its own validation\n * (the server is the gate), and it does NOT cache anything across\n * calls. The single source of truth for \"is this submission allowed?\"\n * is the server's validate endpoint.\n *\n * @see docs/architecture/skill-agent-v2-repo.md §5.7 SubmitClient\n */\n\nexport interface SubmitOptions {\n\t/** Override the server's validate URL. Defaults to `http://localhost:3000/api/v1`. */\n\tserverBaseUrl?: string;\n\t/** Override the branch to push. Defaults to the repo's `branch` field. */\n\tbranch?: string;\n\t/** Skip the actual push (for tests + dry-runs). When true, step 4 returns a synthetic PushResult. */\n\tskipPush?: boolean;\n}\n\nexport interface SubmitResult {\n\trepoId: string;\n\tskillName: string;\n\tcommitSha: string;\n\tpushedRef?: string;\n\tpushedSha?: string;\n}\n\nexport interface SubmitClientOptions {\n\tgitClient: GitClient;\n\t/** Lookup the default branch for a repo (config-driven). */\n\tgetRepoBranch?: (repoId: string) => string | undefined;\n\t/** HTTP fetch impl (defaults to the global `fetch`). */\n\tfetcher?: typeof fetch;\n\t/** Default server base URL when no override is supplied. */\n\tdefaultServerBaseUrl?: string;\n}\n\nexport class SubmitClient {\n\tprivate readonly git: GitClient;\n\tprivate readonly getRepoBranch: (repoId: string) => string | undefined;\n\tprivate readonly fetcher: typeof fetch;\n\tprivate readonly defaultServerBaseUrl: string;\n\n\tconstructor(opts: SubmitClientOptions) {\n\t\tthis.git = opts.gitClient;\n\t\tthis.getRepoBranch = opts.getRepoBranch ?? (() => undefined);\n\t\tthis.fetcher = opts.fetcher ?? (globalThis.fetch as typeof fetch);\n\t\tthis.defaultServerBaseUrl = opts.defaultServerBaseUrl ?? \"http://localhost:3000\";\n\t}\n\n\t/**\n\t * Validate-only path. Useful for the UI's \"Save Draft\" flow which\n\t * wants to surface validation errors without committing or pushing.\n\t */\n\tasync validate(req: SubmitValidationRequest): Promise<SubmitValidationResponse> {\n\t\tconst url = `${this.defaultServerBaseUrl}/api/v1/skills/validate`;\n\t\tconst res = await this.fetcher(url, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { \"content-type\": \"application/json\" },\n\t\t\tbody: JSON.stringify(req),\n\t\t});\n\t\tif (!res.ok) {\n\t\t\tthrow new SubmitError(\"network_error\", `validate request failed: HTTP ${res.status}`);\n\t\t}\n\t\treturn (await res.json()) as SubmitValidationResponse;\n\t}\n\n\t/**\n\t * Full submit pipeline. Throws `SubmitError` on:\n\t *   - validate deny (reason echoed)\n\t *   - network failure (network_error)\n\t *   - local write failure\n\t *   - commit/push failure\n\t */\n\tasync submit(\n\t\trepoId: string,\n\t\tskillName: string,\n\t\tfiles: SkillFile[],\n\t\topts: SubmitOptions = {}\n\t): Promise<SubmitResult> {\n\t\t// (1) Validate\n\t\tconst v = await this.validate({ repoId, skillName, files });\n\t\tif (!v.allow) {\n\t\t\tthrow new SubmitError(v.reason ?? \"unknown\", v.detail ?? \"validation denied\");\n\t\t}\n\n\t\t// (2) Write files into the local repo clone\n\t\tconst localRepoPath = getRepoDir(repoId);\n\t\tconst targetDir = path.join(localRepoPath, \"skills\", skillName);\n\t\tawait fs.mkdir(targetDir, { recursive: true });\n\t\tfor (const f of files) {\n\t\t\tconst full = path.join(targetDir, f.path);\n\t\t\tawait fs.mkdir(path.dirname(full), { recursive: true });\n\t\t\tconst tmp = `${full}.${process.pid}.${Date.now()}.tmp`;\n\t\t\tawait fs.writeFile(tmp, f.content, \"utf8\");\n\t\t\tawait fs.rename(tmp, full);\n\t\t}\n\n\t\t// (3) Commit (convention: `feat(skills): add <name>`)\n\t\tconst commitMessage = `feat(skills): add ${skillName}`;\n\t\tconst { commitSha } = await this.git.commit(localRepoPath, commitMessage);\n\n\t\t// (4) Push\n\t\tlet pushedRef: string | undefined;\n\t\tlet pushedSha: string | undefined;\n\t\tif (!opts.skipPush) {\n\t\t\tconst branch = opts.branch ?? this.getRepoBranch(repoId) ?? \"main\";\n\t\t\tconst pushResult = await this.git.push(repoId, localRepoPath, branch);\n\t\t\tpushedRef = pushResult.ref;\n\t\t\tpushedSha = pushResult.commitSha;\n\t\t}\n\n\t\treturn {\n\t\t\trepoId,\n\t\t\tskillName,\n\t\t\tcommitSha,\n\t\t\tpushedRef,\n\t\t\tpushedSha,\n\t\t};\n\t}\n}\n"],"mappings":";;;;;;;;AAqCA,IAAa,cAAb,cAAiC,MAAM;CAKtC,YAAY,QAAoB,QAAgB,SAA+B;EAC9E,MAAM,kBAAkB,OAAO,KAAK,QAAQ;EAC5C,KAAK,OAAO;EACZ,KAAK,SAAS;EACd,KAAK,SAAS;EACd,KAAK,SAAS,SAAS;CACxB;AACD;;;ACcA,IAAa,eAAb,MAA0B;CAMzB,YAAY,MAA2B;EACtC,KAAK,MAAM,KAAK;EAChB,KAAK,gBAAgB,KAAK,wBAAwB,KAAA;EAClD,KAAK,UAAU,KAAK,WAAY,WAAW;EAC3C,KAAK,uBAAuB,KAAK,wBAAwB;CAC1D;;;;;CAMA,MAAM,SAAS,KAAiE;EAC/E,MAAM,MAAM,GAAG,KAAK,qBAAqB;EACzC,MAAM,MAAM,MAAM,KAAK,QAAQ,KAAK;GACnC,QAAQ;GACR,SAAS,EAAE,gBAAgB,mBAAmB;GAC9C,MAAM,KAAK,UAAU,GAAG;EACzB,CAAC;EACD,IAAI,CAAC,IAAI,IACR,MAAM,IAAI,YAAY,iBAAiB,iCAAiC,IAAI,QAAQ;EAErF,OAAQ,MAAM,IAAI,KAAK;CACxB;;;;;;;;CASA,MAAM,OACL,QACA,WACA,OACA,OAAsB,CAAC,GACC;EAExB,MAAM,IAAI,MAAM,KAAK,SAAS;GAAE;GAAQ;GAAW;EAAM,CAAC;EAC1D,IAAI,CAAC,EAAE,OACN,MAAM,IAAI,YAAY,EAAE,UAAU,WAAW,EAAE,UAAU,mBAAmB;EAI7E,MAAM,gBAAgBA,iBAAAA,WAAW,MAAM;EACvC,MAAM,YAAYC,UAAK,KAAK,eAAe,UAAU,SAAS;EAC9D,MAAMC,iBAAG,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;EAC7C,KAAK,MAAM,KAAK,OAAO;GACtB,MAAM,OAAOD,UAAK,KAAK,WAAW,EAAE,IAAI;GACxC,MAAMC,iBAAG,MAAMD,UAAK,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;GACtD,MAAM,MAAM,GAAG,KAAK,GAAG,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE;GACjD,MAAMC,iBAAG,UAAU,KAAK,EAAE,SAAS,MAAM;GACzC,MAAMA,iBAAG,OAAO,KAAK,IAAI;EAC1B;EAGA,MAAM,gBAAgB,qBAAqB;EAC3C,MAAM,EAAE,cAAc,MAAM,KAAK,IAAI,OAAO,eAAe,aAAa;EAGxE,IAAI;EACJ,IAAI;EACJ,IAAI,CAAC,KAAK,UAAU;GACnB,MAAM,SAAS,KAAK,UAAU,KAAK,cAAc,MAAM,KAAK;GAC5D,MAAM,aAAa,MAAM,KAAK,IAAI,KAAK,QAAQ,eAAe,MAAM;GACpE,YAAY,WAAW;GACvB,YAAY,WAAW;EACxB;EAEA,OAAO;GACN;GACA;GACA;GACA;GACA;EACD;CACD;AACD"}

package/dist/submit.d.mts

@@ -1,3 +1,2 @@
-export { c as SubmitClient, d as SubmitClientOptions, e as SubmitError, f as SubmitOptions, g as SubmitResult } from './index-BMk4tqIT.mjs';
-import './types-B9gk3dXH.mjs';
-import 'node:child_process';
+import { a as SubmitError, i as SubmitResult, n as SubmitClientOptions, r as SubmitOptions, t as SubmitClient } from "./index-2rX86yMq.mjs";
+export { SubmitClient, SubmitClientOptions, SubmitError, SubmitOptions, SubmitResult };

package/dist/submit.d.ts

@@ -1,3 +1,2 @@
-export { c as SubmitClient, d as SubmitClientOptions, e as SubmitError, f as SubmitOptions, g as SubmitResult } from './index-CymN0x9Z.js';
-import './types-B9gk3dXH.js';
-import 'node:child_process';
+import { a as SubmitError, i as SubmitResult, n as SubmitClientOptions, r as SubmitOptions, t as SubmitClient } from "./index-Dp6FwWKh.js";
+export { SubmitClient, SubmitClientOptions, SubmitError, SubmitOptions, SubmitResult };