@kybernesis/arp-create-adapter 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kybernesis AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# @kybernesis/arp-create-adapter
+
+Scaffolds a conformance-passing ARP framework adapter in TypeScript or Python.
+
+## Install + run
+
+```bash
+npx @kybernesis/arp-create-adapter \
+  --framework my-framework \
+  --language ts \
+  --out ./adapters/my-framework
+```
+
+Generates:
+- `package.json` (or `pyproject.toml`) with correct ARP dependencies
+- `src/` / `arp_adapter_<slug>/` skeleton wiring the 5 ARP integration points
+- A placeholder `MyFrameworkLike` structural type covering the public extension surface you need to depend on (replace with the real framework's shape)
+- `tests/conformance.test.ts` (or `tests/test_conformance.py`) wired for the `@kybernesis/arp-testkit` audit
+- `README.md` + `MIGRATION.md` ready to publish
+
+## Why a structural-type scaffold?
+
+Per Phase-6 Rule 2, adapters **must not fork framework source** — they wrap a documented public extension API. The scaffold picks that up explicitly: you describe your framework as a protocol, wire your framework's real hooks to that protocol, and the adapter's logic is portable across framework versions.
+
+## Programmatic API
+
+```ts
+import { scaffoldAdapter } from '@kybernesis/arp-create-adapter';
+
+await scaffoldAdapter({
+  framework: 'my-framework',
+  displayName: 'My Framework',
+  language: 'ts',
+  out: './adapters/my-framework',
+});
+```
+
+## After scaffolding
+
+1. Replace the `{FrameworkName}Like` placeholder type with your framework's real public interface.
+2. Wire the ARP hooks (`agent.check`, `agent.egress`, etc.) to the framework's actual hook names.
+3. Run the shipped conformance test; add a real integration test that pairs the generated adapter with the ARP reference agents in `examples/`.
+4. See [`docs/ARP-adapter-authoring-guide.md`](../../docs/ARP-adapter-authoring-guide.md) for the full contract + anti-patterns.
+
+Phase-6 in the ARP monorepo validates all five required adapters with this same scaffold structure.

package/dist/cli.cjs

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+'use strict';
+
+var commander = require('commander');
+var path = require('path');
+var fs = require('fs');
+var url = require('url');
+var Handlebars = require('handlebars');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var Handlebars__default = /*#__PURE__*/_interopDefault(Handlebars);
+
+var __filename$1 = url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.cjs', document.baseURI).href)));
+var __dirname$1 = path.dirname(__filename$1);
+var DEFAULT_TEMPLATES_DIR = path.resolve(__dirname$1, "..", "templates");
+async function scaffoldAdapter(options) {
+  const framework = options.framework.trim().toLowerCase();
+  if (!/^[a-z][a-z0-9-]*$/.test(framework)) {
+    throw new Error(
+      `framework slug "${options.framework}" must match /^[a-z][a-z0-9-]*$/`
+    );
+  }
+  const displayName = options.displayName ?? toDisplayName(framework);
+  const arpVersion = options.arpVersion ?? "^0.1.0";
+  const templateRoot = options.templatesDir ? path.resolve(options.templatesDir, options.language) : path.join(DEFAULT_TEMPLATES_DIR, options.language);
+  if (!fs.existsSync(templateRoot)) {
+    throw new Error(`template directory missing: ${templateRoot}`);
+  }
+  const context = {
+    framework,
+    frameworkPascal: toPascal(framework),
+    frameworkCamel: toCamel(framework),
+    frameworkSnake: framework.replace(/-/g, "_"),
+    frameworkUpper: framework.toUpperCase().replace(/-/g, "_"),
+    displayName,
+    arpVersion,
+    /** Best-effort Python-compatible version range — strip leading `^`. */
+    pythonArpVersion: arpVersion.startsWith("^") ? `>=${arpVersion.slice(1)}` : arpVersion,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const created = [];
+  const skipped = [];
+  for (const rel of walk(templateRoot)) {
+    const src = path.join(templateRoot, rel);
+    const dst = path.join(options.out, renderFilename(rel, context));
+    if (fs.existsSync(dst) && !options.force) {
+      skipped.push(dst);
+      continue;
+    }
+    const raw = fs.readFileSync(src, "utf8");
+    const rendered = rel.endsWith(".hbs") ? Handlebars__default.default.compile(raw, { noEscape: true })(context) : raw;
+    fs.mkdirSync(path.dirname(dst), { recursive: true });
+    fs.writeFileSync(dst, rendered);
+    created.push(dst);
+  }
+  const summary = [
+    `Scaffolded @kybernesis/arp-adapter-${framework} (${options.language}) at ${options.out}.`,
+    `Created ${created.length} file(s), skipped ${skipped.length}.`,
+    "",
+    "Next steps:",
+    `  1. cd ${path.relative(process.cwd(), options.out) || options.out}`,
+    options.language === "ts" ? "  2. pnpm install" : "  2. uv sync  # or: python -m pip install -e .",
+    "  3. Implement src/* to map your framework's public extension points to ArpAgent.",
+    "  4. Run the conformance test: pnpm test  (or: uv run pytest)",
+    "  5. See docs/ARP-adapter-authoring-guide.md for the full contract."
+  ].join("\n");
+  return { createdFiles: created, skippedFiles: skipped, summary };
+}
+function walk(dir) {
+  const out = [];
+  function recurse(sub) {
+    const abs = path.join(dir, sub);
+    for (const entry of fs.readdirSync(abs)) {
+      const fullRel = sub ? path.join(sub, entry) : entry;
+      const fullAbs = path.join(dir, fullRel);
+      const st = fs.statSync(fullAbs);
+      if (st.isDirectory()) recurse(fullRel);
+      else out.push(fullRel);
+    }
+  }
+  recurse("");
+  return out;
+}
+function renderFilename(rel, ctx) {
+  const withoutHbs = rel.endsWith(".hbs") ? rel.slice(0, -".hbs".length) : rel;
+  return Handlebars__default.default.compile(withoutHbs, { noEscape: true })(ctx);
+}
+function toPascal(slug) {
+  return slug.split("-").filter(Boolean).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("");
+}
+function toCamel(slug) {
+  const pascal = toPascal(slug);
+  return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+function toDisplayName(slug) {
+  return slug.split("-").filter(Boolean).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join(" ");
+}
+
+// src/cli.ts
+var program = new commander.Command();
+program.name("create-arp-adapter").description("Scaffold a conformance-passing ARP framework adapter.").requiredOption("-f, --framework <slug>", 'Framework slug (kebab-case), e.g. "my-framework"').option("-n, --name <name>", 'Display name (e.g. "My Framework"). Defaults to title-cased slug.').requiredOption("-l, --language <ts|python>", "Target language", "ts").option("-o, --out <path>", "Destination directory (default ./adapters/<slug>)").option("--arp-version <range>", "ARP spec/SDK version range", "^0.1.0").option("--force", "Overwrite existing files", false).action(async (opts) => {
+  if (opts.language !== "ts" && opts.language !== "python") {
+    console.error(`--language must be "ts" or "python", got "${opts.language}"`);
+    process.exit(1);
+  }
+  const out = path.resolve(process.cwd(), opts.out ?? `./adapters/${opts.framework}`);
+  try {
+    const result = await scaffoldAdapter({
+      framework: opts.framework,
+      ...opts.name ? { displayName: opts.name } : {},
+      language: opts.language,
+      out,
+      arpVersion: opts.arpVersion,
+      force: opts.force
+    });
+    console.log(result.summary);
+    if (result.skippedFiles.length > 0) {
+      console.log("\nSkipped (use --force to overwrite):");
+      for (const f of result.skippedFiles) {
+        console.log(`  ${f}`);
+      }
+    }
+  } catch (err) {
+    console.error("create-arp-adapter failed:", err.message);
+    process.exit(2);
+  }
+});
+program.parseAsync(process.argv).catch((err) => {
+  console.error(err);
+  process.exit(3);
+});
+//# sourceMappingURL=cli.cjs.map
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scaffold.ts","../src/cli.ts"],"names":["__filename","fileURLToPath","__dirname","dirname","resolve","join","existsSync","readFileSync","Handlebars","mkdirSync","writeFileSync","relative","readdirSync","statSync","Command"],"mappings":";;;;;;;;;;;;;;AAwCA,IAAMA,YAAA,GAAaC,iBAAA,CAAc,yPAAe,CAAA;AAChD,IAAMC,WAAA,GAAYC,aAAQH,YAAU,CAAA;AAEpC,IAAM,qBAAA,GAAwBI,YAAA,CAAQF,WAAA,EAAW,IAAA,EAAM,WAAW,CAAA;AAElE,eAAsB,gBACpB,OAAA,EACyB;AACzB,EAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,SAAA,CAAU,IAAA,GAAO,WAAA,EAAY;AACvD,EAAA,IAAI,CAAC,mBAAA,CAAoB,IAAA,CAAK,SAAS,CAAA,EAAG;AACxC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,gBAAA,EAAmB,QAAQ,SAAS,CAAA,gCAAA;AAAA,KACtC;AAAA,EACF;AACA,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,WAAA,IAAe,aAAA,CAAc,SAAS,CAAA;AAClE,EAAA,MAAM,UAAA,GAAa,QAAQ,UAAA,IAAc,QAAA;AAEzC,EAAA,MAAM,YAAA,GAAe,OAAA,CAAQ,YAAA,GACzBE,YAAA,CAAQ,OAAA,CAAQ,YAAA,EAAc,OAAA,CAAQ,QAAQ,CAAA,GAC9CC,SAAA,CAAK,qBAAA,EAAuB,OAAA,CAAQ,QAAQ,CAAA;AAChD,EAAA,IAAI,CAACC,aAAA,CAAW,YAAY,CAAA,EAAG;AAC7B,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,4BAAA,EAA+B,YAAY,CAAA,CAAE,CAAA;AAAA,EAC/D;AAEA,EAAA,MAAM,OAAA,GAAU;AAAA,IACd,SAAA;AAAA,IACA,eAAA,EAAiB,SAAS,SAAS,CAAA;AAAA,IACnC,cAAA,EAAgB,QAAQ,SAAS,CAAA;AAAA,IACjC,cAAA,EAAgB,SAAA,CAAU,OAAA,CAAQ,IAAA,EAAM,GAAG,CAAA;AAAA,IAC3C,gBAAgB,SAAA,CAAU,WAAA,EAAY,CAAE,OAAA,CAAQ,MAAM,GAAG,CAAA;AAAA,IACzD,WAAA;AAAA,IACA,UAAA;AAAA;AAAA,IAEA,gBAAA,EAAkB,UAAA,CAAW,UAAA,CAAW,GAAG,CAAA,GACvC,KAAK,UAAA,CAAW,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA,GACxB,UAAA;AAAA,IACJ,WAAA,EAAA,iBAAa,IAAI,IAAA,EAAK,EAAE,WAAA;AAAY,GACtC;AAEA,EAAA,MAAM,UAAoB,EAAC;AAC3B,EAAA,MAAM,UAAoB,EAAC;AAE3B,EAAA,KAAA,MAAW,GAAA,IAAO,IAAA,CAAK,YAAY,CAAA,EAAG;AACpC,IAAA,MAAM,GAAA,GAAMD,SAAA,CAAK,YAAA,EAAc,GAAG,CAAA;AAClC,IAAA,MAAM,MAAMA,SAAA,CAAK,OAAA,CAAQ,KAAK,cAAA,CAAe,GAAA,EAAK,OAAO,CAAC,CAAA;AAC1D,IAAA,IAAIC,aAAA,CAAW,GAAG,CAAA,IAAK,CAAC,QAAQ,KAAA,EAAO;AACrC,MAAA,OAAA,CAAQ,KAAK,GAAG,CAAA;AAChB,MAAA;AAAA,IACF;AACA,IAAA,MAAM,GAAA,GAAMC,eAAA,CAAa,GAAA,EAAK,MAAM,CAAA;AACpC,IAAA,MAAM,QAAA,GAAW,GAAA,CAAI,QAAA,CAAS,MAAM,IAChCC,2BAAA,CAAW,OAAA,CAAQ,GAAA,EAAK,EAAE,QAAA,EAAU,IAAA,EAAM,CAAA,CAAE,OAAO,CAAA,GACnD,GAAA;AACJ,IAAAC,YAAA,CAAUN,aAAQ,GAAG,CAAA,EAAG,EAAE,SAAA,EAAW,MAAM,CAAA;AAC3C,IAAAO,gBAAA,CAAc,KAAK,QAAQ,CAAA;AAC3B,IAAA,OAAA,CAAQ,KAAK,GAAG,CAAA;AAAA,EAClB;AAEA,EAAA,MAAM,OAAA,GAAU;AAAA,IACd,sCAAsC,SAAS,CAAA,EAAA,EAAK,QAAQ,QAAQ,CAAA,KAAA,EAAQ,QAAQ,GAAG,CAAA,CAAA,CAAA;AAAA,IACvF,CAAA,QAAA,EAAW,OAAA,CAAQ,MAAM,CAAA,kBAAA,EAAqB,QAAQ,MAAM,CAAA,CAAA,CAAA;AAAA,IAC5D,EAAA;AAAA,IACA,aAAA;AAAA,IACA,CAAA,QAAA,EAAWC,cAAS,OAAA,CAAQ,GAAA,IAAO,OAAA,CAAQ,GAAG,CAAA,IAAK,OAAA,CAAQ,GAAG,CAAA,CAAA;AAAA,IAC9D,OAAA,CAAQ,QAAA,KAAa,IAAA,GACjB,mBAAA,GACA,gDAAA;AAAA,IACJ,mFAAA;AAAA,IACA,+DAAA;AAAA,IACA;AAAA,GACF,CAAE,KAAK,IAAI,CAAA;AAEX,EAAA,OAAO,EAAE,YAAA,EAAc,OAAA,EAAS,YAAA,EAAc,SAAS,OAAA,EAAQ;AACjE;AAEA,SAAS,KAAK,GAAA,EAAuB;AACnC,EAAA,MAAM,MAAgB,EAAC;AACvB,EAAA,SAAS,QAAQ,GAAA,EAAa;AAC5B,IAAA,MAAM,GAAA,GAAMN,SAAA,CAAK,GAAA,EAAK,GAAG,CAAA;AACzB,IAAA,KAAA,MAAW,KAAA,IAASO,cAAA,CAAY,GAAG,CAAA,EAAG;AACpC,MAAA,MAAM,OAAA,GAAU,GAAA,GAAMP,SAAA,CAAK,GAAA,EAAK,KAAK,CAAA,GAAI,KAAA;AACzC,MAAA,MAAM,OAAA,GAAUA,SAAA,CAAK,GAAA,EAAK,OAAO,CAAA;AACjC,MAAA,MAAM,EAAA,GAAKQ,YAAS,OAAO,CAAA;AAC3B,MAAA,IAAI,EAAA,CAAG,WAAA,EAAY,EAAG,OAAA,CAAQ,OAAO,CAAA;AAAA,WAChC,GAAA,CAAI,KAAK,OAAO,CAAA;AAAA,IACvB;AAAA,EACF;AACA,EAAA,OAAA,CAAQ,EAAE,CAAA;AACV,EAAA,OAAO,GAAA;AACT;AAEA,SAAS,cAAA,CAAe,KAAa,GAAA,EAAqC;AAGxE,EAAA,MAAM,UAAA,GAAa,GAAA,CAAI,QAAA,CAAS,MAAM,CAAA,GAAI,GAAA,CAAI,KAAA,CAAM,CAAA,EAAG,CAAC,MAAA,CAAO,MAAM,CAAA,GAAI,GAAA;AACzE,EAAA,OAAOL,2BAAA,CAAW,QAAQ,UAAA,EAAY,EAAE,UAAU,IAAA,EAAM,EAAE,GAAG,CAAA;AAC/D;AAEA,SAAS,SAAS,IAAA,EAAsB;AACtC,EAAA,OAAO,IAAA,CACJ,MAAM,GAAG,CAAA,CACT,OAAO,OAAO,CAAA,CACd,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,OAAO,CAAC,CAAA,CAAE,aAAY,GAAI,CAAA,CAAE,MAAM,CAAC,CAAC,CAAA,CACjD,IAAA,CAAK,EAAE,CAAA;AACZ;AAEA,SAAS,QAAQ,IAAA,EAAsB;AACrC,EAAA,MAAM,MAAA,GAAS,SAAS,IAAI,CAAA;AAC5B,EAAA,OAAO,MAAA,CAAO,OAAO,CAAC,CAAA,CAAE,aAAY,GAAI,MAAA,CAAO,MAAM,CAAC,CAAA;AACxD;AAEA,SAAS,cAAc,IAAA,EAAsB;AAC3C,EAAA,OAAO,IAAA,CACJ,MAAM,GAAG,CAAA,CACT,OAAO,OAAO,CAAA,CACd,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,OAAO,CAAC,CAAA,CAAE,aAAY,GAAI,CAAA,CAAE,MAAM,CAAC,CAAC,CAAA,CACjD,IAAA,CAAK,GAAG,CAAA;AACb;;;AC/IA,IAAM,OAAA,GAAU,IAAIM,iBAAA,EAAQ;AAE5B,OAAA,CACG,IAAA,CAAK,oBAAoB,CAAA,CACzB,WAAA,CAAY,uDAAuD,CAAA,CACnE,cAAA,CAAe,wBAAA,EAA0B,kDAAkD,EAC3F,MAAA,CAAO,mBAAA,EAAqB,mEAAmE,CAAA,CAC/F,eAAe,4BAAA,EAA8B,iBAAA,EAAmB,IAAI,CAAA,CACpE,OAAO,kBAAA,EAAoB,mDAAmD,CAAA,CAC9E,MAAA,CAAO,yBAAyB,4BAAA,EAA8B,QAAQ,CAAA,CACtE,MAAA,CAAO,WAAW,0BAAA,EAA4B,KAAK,CAAA,CACnD,MAAA,CAAO,OAAO,IAAA,KAOT;AACJ,EAAA,IAAI,IAAA,CAAK,QAAA,KAAa,IAAA,IAAQ,IAAA,CAAK,aAAa,QAAA,EAAU;AAExD,IAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,0CAAA,EAA6C,IAAA,CAAK,QAAQ,CAAA,CAAA,CAAG,CAAA;AAC3E,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAAA,EAChB;AACA,EAAA,MAAM,GAAA,GAAMV,YAAAA,CAAQ,OAAA,CAAQ,GAAA,EAAI,EAAG,KAAK,GAAA,IAAO,CAAA,WAAA,EAAc,IAAA,CAAK,SAAS,CAAA,CAAE,CAAA;AAC7E,EAAA,IAAI;AACF,IAAA,MAAM,MAAA,GAAS,MAAM,eAAA,CAAgB;AAAA,MACnC,WAAW,IAAA,CAAK,SAAA;AAAA,MAChB,GAAI,KAAK,IAAA,GAAO,EAAE,aAAa,IAAA,CAAK,IAAA,KAAS,EAAC;AAAA,MAC9C,UAAU,IAAA,CAAK,QAAA;AAAA,MACf,GAAA;AAAA,MACA,YAAY,IAAA,CAAK,UAAA;AAAA,MACjB,OAAO,IAAA,CAAK;AAAA,KACb,CAAA;AAED,IAAA,OAAA,CAAQ,GAAA,CAAI,OAAO,OAAO,CAAA;AAC1B,IAAA,IAAI,MAAA,CAAO,YAAA,CAAa,MAAA,GAAS,CAAA,EAAG;AAElC,MAAA,OAAA,CAAQ,IAAI,uCAAuC,CAAA;AACnD,MAAA,KAAA,MAAW,CAAA,IAAK,OAAO,YAAA,EAAc;AAEnC,QAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,EAAA,EAAK,CAAC,CAAA,CAAE,CAAA;AAAA,MACtB;AAAA,IACF;AAAA,EACF,SAAS,GAAA,EAAK;AAEZ,IAAA,OAAA,CAAQ,KAAA,CAAM,4BAAA,EAA+B,GAAA,CAAc,OAAO,CAAA;AAClE,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAAA,EAChB;AACF,CAAC,CAAA;AAEH,OAAA,CAAQ,WAAW,OAAA,CAAQ,IAAI,CAAA,CAAE,KAAA,CAAM,CAAC,GAAA,KAAiB;AAEvD,EAAA,OAAA,CAAQ,MAAM,GAAG,CAAA;AACjB,EAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAChB,CAAC,CAAA","file":"cli.cjs","sourcesContent":["/**\n * Core scaffolder. Reads a template directory, renders each file through\n * Handlebars, and writes to the target path.\n *\n * Templates live under `packages/create-adapter/templates/<lang>/` and the\n * scaffolder resolves them relative to the compiled `dist/` via\n * `fileURLToPath(import.meta.url)`. Consumers using the programmatic API\n * in a non-standard layout can pass `templatesDir` directly.\n */\n\nimport { readdirSync, readFileSync, statSync, mkdirSync, writeFileSync, existsSync } from 'node:fs';\nimport { dirname, join, relative, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport Handlebars from 'handlebars';\n\nexport type SupportedLanguage = 'ts' | 'python';\n\nexport interface ScaffoldOptions {\n  /** Framework slug (kebab-case). Used in file paths + imports. */\n  framework: string;\n  /** Human-readable name (e.g. \"KyberBot\"). Used in README, error strings. */\n  displayName?: string;\n  /** Target language. */\n  language: SupportedLanguage;\n  /** Destination directory — will be created if missing. */\n  out: string;\n  /** Override the template root. Default: bundled templates. */\n  templatesDir?: string;\n  /** ARP spec version pinned in the generated package.json. */\n  arpVersion?: string;\n  /** When true, overwrite existing files. Default false. */\n  force?: boolean;\n}\n\nexport interface ScaffoldResult {\n  createdFiles: string[];\n  skippedFiles: string[];\n  summary: string;\n}\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nconst DEFAULT_TEMPLATES_DIR = resolve(__dirname, '..', 'templates');\n\nexport async function scaffoldAdapter(\n  options: ScaffoldOptions,\n): Promise<ScaffoldResult> {\n  const framework = options.framework.trim().toLowerCase();\n  if (!/^[a-z][a-z0-9-]*$/.test(framework)) {\n    throw new Error(\n      `framework slug \"${options.framework}\" must match /^[a-z][a-z0-9-]*$/`,\n    );\n  }\n  const displayName = options.displayName ?? toDisplayName(framework);\n  const arpVersion = options.arpVersion ?? '^0.1.0';\n\n  const templateRoot = options.templatesDir\n    ? resolve(options.templatesDir, options.language)\n    : join(DEFAULT_TEMPLATES_DIR, options.language);\n  if (!existsSync(templateRoot)) {\n    throw new Error(`template directory missing: ${templateRoot}`);\n  }\n\n  const context = {\n    framework,\n    frameworkPascal: toPascal(framework),\n    frameworkCamel: toCamel(framework),\n    frameworkSnake: framework.replace(/-/g, '_'),\n    frameworkUpper: framework.toUpperCase().replace(/-/g, '_'),\n    displayName,\n    arpVersion,\n    /** Best-effort Python-compatible version range — strip leading `^`. */\n    pythonArpVersion: arpVersion.startsWith('^')\n      ? `>=${arpVersion.slice(1)}`\n      : arpVersion,\n    generatedAt: new Date().toISOString(),\n  };\n\n  const created: string[] = [];\n  const skipped: string[] = [];\n\n  for (const rel of walk(templateRoot)) {\n    const src = join(templateRoot, rel);\n    const dst = join(options.out, renderFilename(rel, context));\n    if (existsSync(dst) && !options.force) {\n      skipped.push(dst);\n      continue;\n    }\n    const raw = readFileSync(src, 'utf8');\n    const rendered = rel.endsWith('.hbs')\n      ? Handlebars.compile(raw, { noEscape: true })(context)\n      : raw;\n    mkdirSync(dirname(dst), { recursive: true });\n    writeFileSync(dst, rendered);\n    created.push(dst);\n  }\n\n  const summary = [\n    `Scaffolded @kybernesis/arp-adapter-${framework} (${options.language}) at ${options.out}.`,\n    `Created ${created.length} file(s), skipped ${skipped.length}.`,\n    '',\n    'Next steps:',\n    `  1. cd ${relative(process.cwd(), options.out) || options.out}`,\n    options.language === 'ts'\n      ? '  2. pnpm install'\n      : '  2. uv sync  # or: python -m pip install -e .',\n    '  3. Implement src/* to map your framework\\'s public extension points to ArpAgent.',\n    '  4. Run the conformance test: pnpm test  (or: uv run pytest)',\n    '  5. See docs/ARP-adapter-authoring-guide.md for the full contract.',\n  ].join('\\n');\n\n  return { createdFiles: created, skippedFiles: skipped, summary };\n}\n\nfunction walk(dir: string): string[] {\n  const out: string[] = [];\n  function recurse(sub: string) {\n    const abs = join(dir, sub);\n    for (const entry of readdirSync(abs)) {\n      const fullRel = sub ? join(sub, entry) : entry;\n      const fullAbs = join(dir, fullRel);\n      const st = statSync(fullAbs);\n      if (st.isDirectory()) recurse(fullRel);\n      else out.push(fullRel);\n    }\n  }\n  recurse('');\n  return out;\n}\n\nfunction renderFilename(rel: string, ctx: Record<string, string>): string {\n  // Trim trailing `.hbs` and run Handlebars on the path (for filenames\n  // like `src/{{framework}}.ts.hbs`).\n  const withoutHbs = rel.endsWith('.hbs') ? rel.slice(0, -'.hbs'.length) : rel;\n  return Handlebars.compile(withoutHbs, { noEscape: true })(ctx);\n}\n\nfunction toPascal(slug: string): string {\n  return slug\n    .split('-')\n    .filter(Boolean)\n    .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n    .join('');\n}\n\nfunction toCamel(slug: string): string {\n  const pascal = toPascal(slug);\n  return pascal.charAt(0).toLowerCase() + pascal.slice(1);\n}\n\nfunction toDisplayName(slug: string): string {\n  return slug\n    .split('-')\n    .filter(Boolean)\n    .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n    .join(' ');\n}\n","#!/usr/bin/env node\n/**\n * `create-arp-adapter` CLI.\n *\n *   npx @kybernesis/arp-create-adapter \\\n *     --framework my-framework \\\n *     --language ts \\\n *     --out ./adapters/my-framework\n */\n\nimport { Command } from 'commander';\nimport { resolve } from 'node:path';\nimport { scaffoldAdapter, type SupportedLanguage } from './scaffold.js';\n\nconst program = new Command();\n\nprogram\n  .name('create-arp-adapter')\n  .description('Scaffold a conformance-passing ARP framework adapter.')\n  .requiredOption('-f, --framework <slug>', 'Framework slug (kebab-case), e.g. \"my-framework\"')\n  .option('-n, --name <name>', 'Display name (e.g. \"My Framework\"). Defaults to title-cased slug.')\n  .requiredOption('-l, --language <ts|python>', 'Target language', 'ts')\n  .option('-o, --out <path>', 'Destination directory (default ./adapters/<slug>)')\n  .option('--arp-version <range>', 'ARP spec/SDK version range', '^0.1.0')\n  .option('--force', 'Overwrite existing files', false)\n  .action(async (opts: {\n    framework: string;\n    name?: string;\n    language: string;\n    out?: string;\n    arpVersion: string;\n    force: boolean;\n  }) => {\n    if (opts.language !== 'ts' && opts.language !== 'python') {\n      // eslint-disable-next-line no-console\n      console.error(`--language must be \"ts\" or \"python\", got \"${opts.language}\"`);\n      process.exit(1);\n    }\n    const out = resolve(process.cwd(), opts.out ?? `./adapters/${opts.framework}`);\n    try {\n      const result = await scaffoldAdapter({\n        framework: opts.framework,\n        ...(opts.name ? { displayName: opts.name } : {}),\n        language: opts.language as SupportedLanguage,\n        out,\n        arpVersion: opts.arpVersion,\n        force: opts.force,\n      });\n      // eslint-disable-next-line no-console\n      console.log(result.summary);\n      if (result.skippedFiles.length > 0) {\n        // eslint-disable-next-line no-console\n        console.log('\\nSkipped (use --force to overwrite):');\n        for (const f of result.skippedFiles) {\n          // eslint-disable-next-line no-console\n          console.log(`  ${f}`);\n        }\n      }\n    } catch (err) {\n      // eslint-disable-next-line no-console\n      console.error('create-arp-adapter failed:', (err as Error).message);\n      process.exit(2);\n    }\n  });\n\nprogram.parseAsync(process.argv).catch((err: unknown) => {\n  // eslint-disable-next-line no-console\n  console.error(err);\n  process.exit(3);\n});\n"]}

package/dist/cli.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { dirname, resolve, join, relative } from 'path';
+import { existsSync, readFileSync, mkdirSync, writeFileSync, readdirSync, statSync } from 'fs';
+import { fileURLToPath } from 'url';
+import Handlebars from 'handlebars';
+
+var __filename$1 = fileURLToPath(import.meta.url);
+var __dirname$1 = dirname(__filename$1);
+var DEFAULT_TEMPLATES_DIR = resolve(__dirname$1, "..", "templates");
+async function scaffoldAdapter(options) {
+  const framework = options.framework.trim().toLowerCase();
+  if (!/^[a-z][a-z0-9-]*$/.test(framework)) {
+    throw new Error(
+      `framework slug "${options.framework}" must match /^[a-z][a-z0-9-]*$/`
+    );
+  }
+  const displayName = options.displayName ?? toDisplayName(framework);
+  const arpVersion = options.arpVersion ?? "^0.1.0";
+  const templateRoot = options.templatesDir ? resolve(options.templatesDir, options.language) : join(DEFAULT_TEMPLATES_DIR, options.language);
+  if (!existsSync(templateRoot)) {
+    throw new Error(`template directory missing: ${templateRoot}`);
+  }
+  const context = {
+    framework,
+    frameworkPascal: toPascal(framework),
+    frameworkCamel: toCamel(framework),
+    frameworkSnake: framework.replace(/-/g, "_"),
+    frameworkUpper: framework.toUpperCase().replace(/-/g, "_"),
+    displayName,
+    arpVersion,
+    /** Best-effort Python-compatible version range — strip leading `^`. */
+    pythonArpVersion: arpVersion.startsWith("^") ? `>=${arpVersion.slice(1)}` : arpVersion,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const created = [];
+  const skipped = [];
+  for (const rel of walk(templateRoot)) {
+    const src = join(templateRoot, rel);
+    const dst = join(options.out, renderFilename(rel, context));
+    if (existsSync(dst) && !options.force) {
+      skipped.push(dst);
+      continue;
+    }
+    const raw = readFileSync(src, "utf8");
+    const rendered = rel.endsWith(".hbs") ? Handlebars.compile(raw, { noEscape: true })(context) : raw;
+    mkdirSync(dirname(dst), { recursive: true });
+    writeFileSync(dst, rendered);
+    created.push(dst);
+  }
+  const summary = [
+    `Scaffolded @kybernesis/arp-adapter-${framework} (${options.language}) at ${options.out}.`,
+    `Created ${created.length} file(s), skipped ${skipped.length}.`,
+    "",
+    "Next steps:",
+    `  1. cd ${relative(process.cwd(), options.out) || options.out}`,
+    options.language === "ts" ? "  2. pnpm install" : "  2. uv sync  # or: python -m pip install -e .",
+    "  3. Implement src/* to map your framework's public extension points to ArpAgent.",
+    "  4. Run the conformance test: pnpm test  (or: uv run pytest)",
+    "  5. See docs/ARP-adapter-authoring-guide.md for the full contract."
+  ].join("\n");
+  return { createdFiles: created, skippedFiles: skipped, summary };
+}
+function walk(dir) {
+  const out = [];
+  function recurse(sub) {
+    const abs = join(dir, sub);
+    for (const entry of readdirSync(abs)) {
+      const fullRel = sub ? join(sub, entry) : entry;
+      const fullAbs = join(dir, fullRel);
+      const st = statSync(fullAbs);
+      if (st.isDirectory()) recurse(fullRel);
+      else out.push(fullRel);
+    }
+  }
+  recurse("");
+  return out;
+}
+function renderFilename(rel, ctx) {
+  const withoutHbs = rel.endsWith(".hbs") ? rel.slice(0, -".hbs".length) : rel;
+  return Handlebars.compile(withoutHbs, { noEscape: true })(ctx);
+}
+function toPascal(slug) {
+  return slug.split("-").filter(Boolean).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("");
+}
+function toCamel(slug) {
+  const pascal = toPascal(slug);
+  return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+function toDisplayName(slug) {
+  return slug.split("-").filter(Boolean).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join(" ");
+}
+
+// src/cli.ts
+var program = new Command();
+program.name("create-arp-adapter").description("Scaffold a conformance-passing ARP framework adapter.").requiredOption("-f, --framework <slug>", 'Framework slug (kebab-case), e.g. "my-framework"').option("-n, --name <name>", 'Display name (e.g. "My Framework"). Defaults to title-cased slug.').requiredOption("-l, --language <ts|python>", "Target language", "ts").option("-o, --out <path>", "Destination directory (default ./adapters/<slug>)").option("--arp-version <range>", "ARP spec/SDK version range", "^0.1.0").option("--force", "Overwrite existing files", false).action(async (opts) => {
+  if (opts.language !== "ts" && opts.language !== "python") {
+    console.error(`--language must be "ts" or "python", got "${opts.language}"`);
+    process.exit(1);
+  }
+  const out = resolve(process.cwd(), opts.out ?? `./adapters/${opts.framework}`);
+  try {
+    const result = await scaffoldAdapter({
+      framework: opts.framework,
+      ...opts.name ? { displayName: opts.name } : {},
+      language: opts.language,
+      out,
+      arpVersion: opts.arpVersion,
+      force: opts.force
+    });
+    console.log(result.summary);
+    if (result.skippedFiles.length > 0) {
+      console.log("\nSkipped (use --force to overwrite):");
+      for (const f of result.skippedFiles) {
+        console.log(`  ${f}`);
+      }
+    }
+  } catch (err) {
+    console.error("create-arp-adapter failed:", err.message);
+    process.exit(2);
+  }
+});
+program.parseAsync(process.argv).catch((err) => {
+  console.error(err);
+  process.exit(3);
+});
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scaffold.ts","../src/cli.ts"],"names":["__filename","__dirname","resolve"],"mappings":"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","file":"cli.js","sourcesContent":["/**\n * Core scaffolder. Reads a template directory, renders each file through\n * Handlebars, and writes to the target path.\n *\n * Templates live under `packages/create-adapter/templates/<lang>/` and the\n * scaffolder resolves them relative to the compiled `dist/` via\n * `fileURLToPath(import.meta.url)`. Consumers using the programmatic API\n * in a non-standard layout can pass `templatesDir` directly.\n */\n\nimport { readdirSync, readFileSync, statSync, mkdirSync, writeFileSync, existsSync } from 'node:fs';\nimport { dirname, join, relative, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport Handlebars from 'handlebars';\n\nexport type SupportedLanguage = 'ts' | 'python';\n\nexport interface ScaffoldOptions {\n  /** Framework slug (kebab-case). Used in file paths + imports. */\n  framework: string;\n  /** Human-readable name (e.g. \"KyberBot\"). Used in README, error strings. */\n  displayName?: string;\n  /** Target language. */\n  language: SupportedLanguage;\n  /** Destination directory — will be created if missing. */\n  out: string;\n  /** Override the template root. Default: bundled templates. */\n  templatesDir?: string;\n  /** ARP spec version pinned in the generated package.json. */\n  arpVersion?: string;\n  /** When true, overwrite existing files. Default false. */\n  force?: boolean;\n}\n\nexport interface ScaffoldResult {\n  createdFiles: string[];\n  skippedFiles: string[];\n  summary: string;\n}\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nconst DEFAULT_TEMPLATES_DIR = resolve(__dirname, '..', 'templates');\n\nexport async function scaffoldAdapter(\n  options: ScaffoldOptions,\n): Promise<ScaffoldResult> {\n  const framework = options.framework.trim().toLowerCase();\n  if (!/^[a-z][a-z0-9-]*$/.test(framework)) {\n    throw new Error(\n      `framework slug \"${options.framework}\" must match /^[a-z][a-z0-9-]*$/`,\n    );\n  }\n  const displayName = options.displayName ?? toDisplayName(framework);\n  const arpVersion = options.arpVersion ?? '^0.1.0';\n\n  const templateRoot = options.templatesDir\n    ? resolve(options.templatesDir, options.language)\n    : join(DEFAULT_TEMPLATES_DIR, options.language);\n  if (!existsSync(templateRoot)) {\n    throw new Error(`template directory missing: ${templateRoot}`);\n  }\n\n  const context = {\n    framework,\n    frameworkPascal: toPascal(framework),\n    frameworkCamel: toCamel(framework),\n    frameworkSnake: framework.replace(/-/g, '_'),\n    frameworkUpper: framework.toUpperCase().replace(/-/g, '_'),\n    displayName,\n    arpVersion,\n    /** Best-effort Python-compatible version range — strip leading `^`. */\n    pythonArpVersion: arpVersion.startsWith('^')\n      ? `>=${arpVersion.slice(1)}`\n      : arpVersion,\n    generatedAt: new Date().toISOString(),\n  };\n\n  const created: string[] = [];\n  const skipped: string[] = [];\n\n  for (const rel of walk(templateRoot)) {\n    const src = join(templateRoot, rel);\n    const dst = join(options.out, renderFilename(rel, context));\n    if (existsSync(dst) && !options.force) {\n      skipped.push(dst);\n      continue;\n    }\n    const raw = readFileSync(src, 'utf8');\n    const rendered = rel.endsWith('.hbs')\n      ? Handlebars.compile(raw, { noEscape: true })(context)\n      : raw;\n    mkdirSync(dirname(dst), { recursive: true });\n    writeFileSync(dst, rendered);\n    created.push(dst);\n  }\n\n  const summary = [\n    `Scaffolded @kybernesis/arp-adapter-${framework} (${options.language}) at ${options.out}.`,\n    `Created ${created.length} file(s), skipped ${skipped.length}.`,\n    '',\n    'Next steps:',\n    `  1. cd ${relative(process.cwd(), options.out) || options.out}`,\n    options.language === 'ts'\n      ? '  2. pnpm install'\n      : '  2. uv sync  # or: python -m pip install -e .',\n    '  3. Implement src/* to map your framework\\'s public extension points to ArpAgent.',\n    '  4. Run the conformance test: pnpm test  (or: uv run pytest)',\n    '  5. See docs/ARP-adapter-authoring-guide.md for the full contract.',\n  ].join('\\n');\n\n  return { createdFiles: created, skippedFiles: skipped, summary };\n}\n\nfunction walk(dir: string): string[] {\n  const out: string[] = [];\n  function recurse(sub: string) {\n    const abs = join(dir, sub);\n    for (const entry of readdirSync(abs)) {\n      const fullRel = sub ? join(sub, entry) : entry;\n      const fullAbs = join(dir, fullRel);\n      const st = statSync(fullAbs);\n      if (st.isDirectory()) recurse(fullRel);\n      else out.push(fullRel);\n    }\n  }\n  recurse('');\n  return out;\n}\n\nfunction renderFilename(rel: string, ctx: Record<string, string>): string {\n  // Trim trailing `.hbs` and run Handlebars on the path (for filenames\n  // like `src/{{framework}}.ts.hbs`).\n  const withoutHbs = rel.endsWith('.hbs') ? rel.slice(0, -'.hbs'.length) : rel;\n  return Handlebars.compile(withoutHbs, { noEscape: true })(ctx);\n}\n\nfunction toPascal(slug: string): string {\n  return slug\n    .split('-')\n    .filter(Boolean)\n    .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n    .join('');\n}\n\nfunction toCamel(slug: string): string {\n  const pascal = toPascal(slug);\n  return pascal.charAt(0).toLowerCase() + pascal.slice(1);\n}\n\nfunction toDisplayName(slug: string): string {\n  return slug\n    .split('-')\n    .filter(Boolean)\n    .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n    .join(' ');\n}\n","#!/usr/bin/env node\n/**\n * `create-arp-adapter` CLI.\n *\n *   npx @kybernesis/arp-create-adapter \\\n *     --framework my-framework \\\n *     --language ts \\\n *     --out ./adapters/my-framework\n */\n\nimport { Command } from 'commander';\nimport { resolve } from 'node:path';\nimport { scaffoldAdapter, type SupportedLanguage } from './scaffold.js';\n\nconst program = new Command();\n\nprogram\n  .name('create-arp-adapter')\n  .description('Scaffold a conformance-passing ARP framework adapter.')\n  .requiredOption('-f, --framework <slug>', 'Framework slug (kebab-case), e.g. \"my-framework\"')\n  .option('-n, --name <name>', 'Display name (e.g. \"My Framework\"). Defaults to title-cased slug.')\n  .requiredOption('-l, --language <ts|python>', 'Target language', 'ts')\n  .option('-o, --out <path>', 'Destination directory (default ./adapters/<slug>)')\n  .option('--arp-version <range>', 'ARP spec/SDK version range', '^0.1.0')\n  .option('--force', 'Overwrite existing files', false)\n  .action(async (opts: {\n    framework: string;\n    name?: string;\n    language: string;\n    out?: string;\n    arpVersion: string;\n    force: boolean;\n  }) => {\n    if (opts.language !== 'ts' && opts.language !== 'python') {\n      // eslint-disable-next-line no-console\n      console.error(`--language must be \"ts\" or \"python\", got \"${opts.language}\"`);\n      process.exit(1);\n    }\n    const out = resolve(process.cwd(), opts.out ?? `./adapters/${opts.framework}`);\n    try {\n      const result = await scaffoldAdapter({\n        framework: opts.framework,\n        ...(opts.name ? { displayName: opts.name } : {}),\n        language: opts.language as SupportedLanguage,\n        out,\n        arpVersion: opts.arpVersion,\n        force: opts.force,\n      });\n      // eslint-disable-next-line no-console\n      console.log(result.summary);\n      if (result.skippedFiles.length > 0) {\n        // eslint-disable-next-line no-console\n        console.log('\\nSkipped (use --force to overwrite):');\n        for (const f of result.skippedFiles) {\n          // eslint-disable-next-line no-console\n          console.log(`  ${f}`);\n        }\n      }\n    } catch (err) {\n      // eslint-disable-next-line no-console\n      console.error('create-arp-adapter failed:', (err as Error).message);\n      process.exit(2);\n    }\n  });\n\nprogram.parseAsync(process.argv).catch((err: unknown) => {\n  // eslint-disable-next-line no-console\n  console.error(err);\n  process.exit(3);\n});\n"]}

package/dist/index.cjs

@@ -0,0 +1,102 @@
+'use strict';
+
+var fs = require('fs');
+var path = require('path');
+var url = require('url');
+var Handlebars = require('handlebars');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var Handlebars__default = /*#__PURE__*/_interopDefault(Handlebars);
+
+// src/scaffold.ts
+var __filename$1 = url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
+var __dirname$1 = path.dirname(__filename$1);
+var DEFAULT_TEMPLATES_DIR = path.resolve(__dirname$1, "..", "templates");
+async function scaffoldAdapter(options) {
+  const framework = options.framework.trim().toLowerCase();
+  if (!/^[a-z][a-z0-9-]*$/.test(framework)) {
+    throw new Error(
+      `framework slug "${options.framework}" must match /^[a-z][a-z0-9-]*$/`
+    );
+  }
+  const displayName = options.displayName ?? toDisplayName(framework);
+  const arpVersion = options.arpVersion ?? "^0.1.0";
+  const templateRoot = options.templatesDir ? path.resolve(options.templatesDir, options.language) : path.join(DEFAULT_TEMPLATES_DIR, options.language);
+  if (!fs.existsSync(templateRoot)) {
+    throw new Error(`template directory missing: ${templateRoot}`);
+  }
+  const context = {
+    framework,
+    frameworkPascal: toPascal(framework),
+    frameworkCamel: toCamel(framework),
+    frameworkSnake: framework.replace(/-/g, "_"),
+    frameworkUpper: framework.toUpperCase().replace(/-/g, "_"),
+    displayName,
+    arpVersion,
+    /** Best-effort Python-compatible version range — strip leading `^`. */
+    pythonArpVersion: arpVersion.startsWith("^") ? `>=${arpVersion.slice(1)}` : arpVersion,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const created = [];
+  const skipped = [];
+  for (const rel of walk(templateRoot)) {
+    const src = path.join(templateRoot, rel);
+    const dst = path.join(options.out, renderFilename(rel, context));
+    if (fs.existsSync(dst) && !options.force) {
+      skipped.push(dst);
+      continue;
+    }
+    const raw = fs.readFileSync(src, "utf8");
+    const rendered = rel.endsWith(".hbs") ? Handlebars__default.default.compile(raw, { noEscape: true })(context) : raw;
+    fs.mkdirSync(path.dirname(dst), { recursive: true });
+    fs.writeFileSync(dst, rendered);
+    created.push(dst);
+  }
+  const summary = [
+    `Scaffolded @kybernesis/arp-adapter-${framework} (${options.language}) at ${options.out}.`,
+    `Created ${created.length} file(s), skipped ${skipped.length}.`,
+    "",
+    "Next steps:",
+    `  1. cd ${path.relative(process.cwd(), options.out) || options.out}`,
+    options.language === "ts" ? "  2. pnpm install" : "  2. uv sync  # or: python -m pip install -e .",
+    "  3. Implement src/* to map your framework's public extension points to ArpAgent.",
+    "  4. Run the conformance test: pnpm test  (or: uv run pytest)",
+    "  5. See docs/ARP-adapter-authoring-guide.md for the full contract."
+  ].join("\n");
+  return { createdFiles: created, skippedFiles: skipped, summary };
+}
+function walk(dir) {
+  const out = [];
+  function recurse(sub) {
+    const abs = path.join(dir, sub);
+    for (const entry of fs.readdirSync(abs)) {
+      const fullRel = sub ? path.join(sub, entry) : entry;
+      const fullAbs = path.join(dir, fullRel);
+      const st = fs.statSync(fullAbs);
+      if (st.isDirectory()) recurse(fullRel);
+      else out.push(fullRel);
+    }
+  }
+  recurse("");
+  return out;
+}
+function renderFilename(rel, ctx) {
+  const withoutHbs = rel.endsWith(".hbs") ? rel.slice(0, -".hbs".length) : rel;
+  return Handlebars__default.default.compile(withoutHbs, { noEscape: true })(ctx);
+}
+function toPascal(slug) {
+  return slug.split("-").filter(Boolean).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("");
+}
+function toCamel(slug) {
+  const pascal = toPascal(slug);
+  return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+function toDisplayName(slug) {
+  return slug.split("-").filter(Boolean).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join(" ");
+}
+
+exports.scaffoldAdapter = scaffoldAdapter;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scaffold.ts"],"names":["__filename","fileURLToPath","__dirname","dirname","resolve","join","existsSync","readFileSync","Handlebars","mkdirSync","writeFileSync","relative","readdirSync","statSync"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Core scaffolder. Reads a template directory, renders each file through\n * Handlebars, and writes to the target path.\n *\n * Templates live under `packages/create-adapter/templates/<lang>/` and the\n * scaffolder resolves them relative to the compiled `dist/` via\n * `fileURLToPath(import.meta.url)`. Consumers using the programmatic API\n * in a non-standard layout can pass `templatesDir` directly.\n */\n\nimport { readdirSync, readFileSync, statSync, mkdirSync, writeFileSync, existsSync } from 'node:fs';\nimport { dirname, join, relative, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport Handlebars from 'handlebars';\n\nexport type SupportedLanguage = 'ts' | 'python';\n\nexport interface ScaffoldOptions {\n  /** Framework slug (kebab-case). Used in file paths + imports. */\n  framework: string;\n  /** Human-readable name (e.g. \"KyberBot\"). Used in README, error strings. */\n  displayName?: string;\n  /** Target language. */\n  language: SupportedLanguage;\n  /** Destination directory — will be created if missing. */\n  out: string;\n  /** Override the template root. Default: bundled templates. */\n  templatesDir?: string;\n  /** ARP spec version pinned in the generated package.json. */\n  arpVersion?: string;\n  /** When true, overwrite existing files. Default false. */\n  force?: boolean;\n}\n\nexport interface ScaffoldResult {\n  createdFiles: string[];\n  skippedFiles: string[];\n  summary: string;\n}\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nconst DEFAULT_TEMPLATES_DIR = resolve(__dirname, '..', 'templates');\n\nexport async function scaffoldAdapter(\n  options: ScaffoldOptions,\n): Promise<ScaffoldResult> {\n  const framework = options.framework.trim().toLowerCase();\n  if (!/^[a-z][a-z0-9-]*$/.test(framework)) {\n    throw new Error(\n      `framework slug \"${options.framework}\" must match /^[a-z][a-z0-9-]*$/`,\n    );\n  }\n  const displayName = options.displayName ?? toDisplayName(framework);\n  const arpVersion = options.arpVersion ?? '^0.1.0';\n\n  const templateRoot = options.templatesDir\n    ? resolve(options.templatesDir, options.language)\n    : join(DEFAULT_TEMPLATES_DIR, options.language);\n  if (!existsSync(templateRoot)) {\n    throw new Error(`template directory missing: ${templateRoot}`);\n  }\n\n  const context = {\n    framework,\n    frameworkPascal: toPascal(framework),\n    frameworkCamel: toCamel(framework),\n    frameworkSnake: framework.replace(/-/g, '_'),\n    frameworkUpper: framework.toUpperCase().replace(/-/g, '_'),\n    displayName,\n    arpVersion,\n    /** Best-effort Python-compatible version range — strip leading `^`. */\n    pythonArpVersion: arpVersion.startsWith('^')\n      ? `>=${arpVersion.slice(1)}`\n      : arpVersion,\n    generatedAt: new Date().toISOString(),\n  };\n\n  const created: string[] = [];\n  const skipped: string[] = [];\n\n  for (const rel of walk(templateRoot)) {\n    const src = join(templateRoot, rel);\n    const dst = join(options.out, renderFilename(rel, context));\n    if (existsSync(dst) && !options.force) {\n      skipped.push(dst);\n      continue;\n    }\n    const raw = readFileSync(src, 'utf8');\n    const rendered = rel.endsWith('.hbs')\n      ? Handlebars.compile(raw, { noEscape: true })(context)\n      : raw;\n    mkdirSync(dirname(dst), { recursive: true });\n    writeFileSync(dst, rendered);\n    created.push(dst);\n  }\n\n  const summary = [\n    `Scaffolded @kybernesis/arp-adapter-${framework} (${options.language}) at ${options.out}.`,\n    `Created ${created.length} file(s), skipped ${skipped.length}.`,\n    '',\n    'Next steps:',\n    `  1. cd ${relative(process.cwd(), options.out) || options.out}`,\n    options.language === 'ts'\n      ? '  2. pnpm install'\n      : '  2. uv sync  # or: python -m pip install -e .',\n    '  3. Implement src/* to map your framework\\'s public extension points to ArpAgent.',\n    '  4. Run the conformance test: pnpm test  (or: uv run pytest)',\n    '  5. See docs/ARP-adapter-authoring-guide.md for the full contract.',\n  ].join('\\n');\n\n  return { createdFiles: created, skippedFiles: skipped, summary };\n}\n\nfunction walk(dir: string): string[] {\n  const out: string[] = [];\n  function recurse(sub: string) {\n    const abs = join(dir, sub);\n    for (const entry of readdirSync(abs)) {\n      const fullRel = sub ? join(sub, entry) : entry;\n      const fullAbs = join(dir, fullRel);\n      const st = statSync(fullAbs);\n      if (st.isDirectory()) recurse(fullRel);\n      else out.push(fullRel);\n    }\n  }\n  recurse('');\n  return out;\n}\n\nfunction renderFilename(rel: string, ctx: Record<string, string>): string {\n  // Trim trailing `.hbs` and run Handlebars on the path (for filenames\n  // like `src/{{framework}}.ts.hbs`).\n  const withoutHbs = rel.endsWith('.hbs') ? rel.slice(0, -'.hbs'.length) : rel;\n  return Handlebars.compile(withoutHbs, { noEscape: true })(ctx);\n}\n\nfunction toPascal(slug: string): string {\n  return slug\n    .split('-')\n    .filter(Boolean)\n    .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n    .join('');\n}\n\nfunction toCamel(slug: string): string {\n  const pascal = toPascal(slug);\n  return pascal.charAt(0).toLowerCase() + pascal.slice(1);\n}\n\nfunction toDisplayName(slug: string): string {\n  return slug\n    .split('-')\n    .filter(Boolean)\n    .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n    .join(' ');\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,34 @@
+/**
+ * Core scaffolder. Reads a template directory, renders each file through
+ * Handlebars, and writes to the target path.
+ *
+ * Templates live under `packages/create-adapter/templates/<lang>/` and the
+ * scaffolder resolves them relative to the compiled `dist/` via
+ * `fileURLToPath(import.meta.url)`. Consumers using the programmatic API
+ * in a non-standard layout can pass `templatesDir` directly.
+ */
+type SupportedLanguage = 'ts' | 'python';
+interface ScaffoldOptions {
+    /** Framework slug (kebab-case). Used in file paths + imports. */
+    framework: string;
+    /** Human-readable name (e.g. "KyberBot"). Used in README, error strings. */
+    displayName?: string;
+    /** Target language. */
+    language: SupportedLanguage;
+    /** Destination directory — will be created if missing. */
+    out: string;
+    /** Override the template root. Default: bundled templates. */
+    templatesDir?: string;
+    /** ARP spec version pinned in the generated package.json. */
+    arpVersion?: string;
+    /** When true, overwrite existing files. Default false. */
+    force?: boolean;
+}
+interface ScaffoldResult {
+    createdFiles: string[];
+    skippedFiles: string[];
+    summary: string;
+}
+declare function scaffoldAdapter(options: ScaffoldOptions): Promise<ScaffoldResult>;
+
+export { type ScaffoldOptions, type ScaffoldResult, type SupportedLanguage, scaffoldAdapter };

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Core scaffolder. Reads a template directory, renders each file through
+ * Handlebars, and writes to the target path.
+ *
+ * Templates live under `packages/create-adapter/templates/<lang>/` and the
+ * scaffolder resolves them relative to the compiled `dist/` via
+ * `fileURLToPath(import.meta.url)`. Consumers using the programmatic API
+ * in a non-standard layout can pass `templatesDir` directly.
+ */
+type SupportedLanguage = 'ts' | 'python';
+interface ScaffoldOptions {
+    /** Framework slug (kebab-case). Used in file paths + imports. */
+    framework: string;
+    /** Human-readable name (e.g. "KyberBot"). Used in README, error strings. */
+    displayName?: string;
+    /** Target language. */
+    language: SupportedLanguage;
+    /** Destination directory — will be created if missing. */
+    out: string;
+    /** Override the template root. Default: bundled templates. */
+    templatesDir?: string;
+    /** ARP spec version pinned in the generated package.json. */
+    arpVersion?: string;
+    /** When true, overwrite existing files. Default false. */
+    force?: boolean;
+}
+interface ScaffoldResult {
+    createdFiles: string[];
+    skippedFiles: string[];
+    summary: string;
+}
+declare function scaffoldAdapter(options: ScaffoldOptions): Promise<ScaffoldResult>;
+
+export { type ScaffoldOptions, type ScaffoldResult, type SupportedLanguage, scaffoldAdapter };