agentwheel 0.2.0 → 0.3.1

package/README.md

@@ -32,9 +32,9 @@ No lock-in. No central gatekeeper. Your packages live in plain git repos, your c
 
 ---
 
-> **Status: early (v0.2).** The install spine and lifecycle core are real and tested — local/git
-> sources, plan/sync/update/drift/uninstall, overlays, eject/remember, and pluggable adapters.
-> Expect sharp edges.
+> **Status: early (v0.3).** The lifecycle core is real and tested — local/git/skillkit/vercel
+> sources, optional registry discovery, plan/sync/update/drift/uninstall, overlays, eject/remember,
+> profiles, rich JSON merge, and pluggable adapters. Expect sharp edges.
 
 ## What it does
 
@@ -102,6 +102,34 @@ A package is a git repo (or folder) with a JSON manifest and a canonical layout:
 Publish by pushing to any git host. A registry exists only for short names and discovery — it's
 optional, and `agentwheel add <url|path>` always works without it.
 
+## How to add a package
+
+The public package registry lives at
+[`NestDevLab/agentwheel-registry`](https://github.com/NestDevLab/agentwheel-registry).
+
+1. Create a public repo with `agentwheel.json` and a standard layout such as `instructions/`, `rules/`, `skills/`, `commands/`, `mcp/`, or `hooks/`.
+2. Open a pull request to `agentwheel-registry` that adds an entry to `index.json`.
+3. Users install by short name:
+
+```bash
+agentwheel registry update
+agentwheel add your-package-name --adapter openclaw
+agentwheel update --dry-run
+agentwheel update
+```
+
+Example registry entry:
+
+```json
+{
+  "name": "your-package-name",
+  "source": "github:your-org/your-agent-package",
+  "type": "package",
+  "description": "Reusable skills, rules, and instructions for agentwheel.",
+  "tags": ["skills", "rules", "instructions"]
+}
+```
+
 ## Customizing without getting overwritten
 
 Drift detection blocks *accidental* edits to generated files. *Intentional* changes have four channels,
@@ -133,7 +161,7 @@ agentwheel sync ./my-pack --adapter-config ./myco-internal.jsonc
 ```
 
 Built-in adapters ship for common runtimes; declarative adapters need no code and stay private.
-(Programmatic adapters, for logic beyond file placement, are planned behind an explicit opt-in.)
+Programmatic adapters, for private runtime logic beyond file placement, require explicit `--allow-adapter-code`.
 
 Copilot support is intentionally file-drop only: instructions, rules, and prompt/command files are
 placed in GitHub-native locations, while raw `SKILL.md` directories stay disabled until there is a
@@ -143,7 +171,7 @@ clear conversion format.
 
 - [x] **v0.1** — install spine: local sources; openclaw/claude/codex adapters; skills/rules/instructions; `plan` · `sync` · `--dry-run` · `uninstall`; manifest + drift + idempotency.
 - [x] **v0.2** — git source driver; `update` (pinned & tracking); overlays/additive/override/eject; `init`; hermes + copilot adapters; commands/mcp/hooks artifacts; OpenClaw semantic plugin planning.
-- [ ] **v0.3** — registry & federation (skill ecosystems, MCP); profiles; programmatic adapters.
+- [x] **v0.3** — skillkit/vercel source drivers; optional registry & federation; programmatic adapters behind `--allow-adapter-code`; rich JSON merge for mcp/hooks/settings; profiles.
 
 ## Design docs
 

package/dist/chunk-N2LZY7LO.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+
+// src/source/identify.ts
+import { homedir } from "os";
+import { resolve } from "path";
+
+// src/utils/fs.ts
+import { createHash } from "crypto";
+import {
+  copyFile,
+  cp,
+  mkdir,
+  readdir,
+  readFile,
+  rename,
+  rm,
+  stat,
+  writeFile
+} from "fs/promises";
+import { dirname, join, relative } from "path";
+async function pathExists(path) {
+  try {
+    await stat(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function hashPath(path) {
+  const stats = await stat(path);
+  if (stats.isFile()) {
+    const content = await readFile(path);
+    return createHash("sha256").update("file\0").update(content).digest("hex");
+  }
+  if (!stats.isDirectory()) {
+    throw new Error(`Unsupported path kind: ${path}`);
+  }
+  const hash = createHash("sha256").update("dir\0");
+  const files = await listFiles(path);
+  for (const file of files) {
+    hash.update(relative(path, file).replaceAll("\\", "/")).update("\0");
+    hash.update(await hashPath(file)).update("\0");
+  }
+  return hash.digest("hex");
+}
+async function listFiles(root) {
+  const out = [];
+  async function walk(dir) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+      if (entry.name === ".git" || entry.name === "node_modules") continue;
+      const full = join(dir, entry.name);
+      if (entry.isDirectory()) {
+        await walk(full);
+      } else if (entry.isFile()) {
+        out.push(full);
+      }
+    }
+  }
+  await walk(root);
+  return out;
+}
+async function atomicCopy(source, dest, kind) {
+  await mkdir(dirname(dest), { recursive: true });
+  const temp = `${dest}.agentwheel-tmp-${process.pid}-${Date.now()}`;
+  await rm(temp, { recursive: true, force: true });
+  if (kind === "file") {
+    await copyFile(source, temp);
+  } else {
+    await cp(source, temp, { recursive: true, dereference: true });
+  }
+  await rm(dest, { recursive: true, force: true });
+  await rename(temp, dest);
+}
+async function writeJsonAtomic(path, data) {
+  await mkdir(dirname(path), { recursive: true });
+  const temp = `${path}.tmp-${process.pid}-${Date.now()}`;
+  await writeFile(temp, `${JSON.stringify(data, null, 2)}
+`, "utf8");
+  await rename(temp, path);
+}
+
+// src/source/identify.ts
+function inferSourceDriverName(source) {
+  if (source.startsWith("skillkit:")) return "skillkit";
+  if (source.startsWith("vercel:")) return "vercel-skills";
+  return source.startsWith("github:") || source.startsWith("git:") ? "git" : "local";
+}
+async function isExplicitSource(source) {
+  if (source.startsWith("github:") || source.startsWith("git:") || source.startsWith("skillkit:") || source.startsWith("vercel:")) {
+    return true;
+  }
+  if (source.startsWith("./") || source.startsWith("../") || source.startsWith("/") || source.startsWith("~/")) {
+    return true;
+  }
+  return pathExists(resolveLocalPath(source));
+}
+function resolveLocalPath(source) {
+  if (source === "~") return homedir();
+  if (source.startsWith("~/")) return resolve(homedir(), source.slice(2));
+  return resolve(source);
+}
+
+export {
+  pathExists,
+  hashPath,
+  atomicCopy,
+  writeJsonAtomic,
+  inferSourceDriverName,
+  isExplicitSource
+};

package/dist/identify-7SEBWCNQ.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import {
+  inferSourceDriverName,
+  isExplicitSource
+} from "./chunk-N2LZY7LO.js";
+export {
+  inferSourceDriverName,
+  isExplicitSource
+};