@tech-leads-club/harness-toolkit 0.10.6 → 0.11.0

package/dist/new-provider.mjs

@@ -0,0 +1,126 @@
+import{createRequire as Z}from"node:module";var W=Z(import.meta.url);import{existsSync as $,mkdirSync as q,writeFileSync as C}from"node:fs";import{dirname as X,join as H}from"node:path";import{fileURLToPath as L}from"node:url";var Y=H(X(L(import.meta.url)),".."),V=/[\s/\\]/,k=new Set(["index","provider"]);function x(B){if(B.length===0)return{ok:!1,reason:"provider name must not be empty"};if(V.test(B))return{ok:!1,reason:"provider name must not contain whitespace or a slash"};if(k.has(B.toLowerCase()))return{ok:!1,reason:`"${B}" is a reserved name`};return{ok:!0}}function K(B){return B.length===0?B:`${B[0]?.toUpperCase()}${B.slice(1)}`}function M(B){return`// why: always false until real detection logic replaces it, so the provider stays inert.
+export function detect${K(B)}(_raw: unknown): boolean {
+  return false;
+}
+`}function T(B){return`import type { HarnessEventKind, ProviderCapabilities } from "../../contracts/index.ts";
+
+export function ${B}Capabilities(): ProviderCapabilities {
+  return {
+    enforcesHooks: true,
+    askSupportedOn: [],
+    sessionEnv: false,
+    nativeLoopCounter: false,
+    dedicatedShellEvent: false,
+    toolInputRewrite: false,
+    // why: a placeholder, deliberately not a real HarnessEventKind — fails assertSatisfiesContract until replaced.
+    toolOutputRewriteOn: ["TODO-fill-in-real-capabilities" as unknown as HarnessEventKind],
+    contextAtToolBefore: false,
+    contextAtToolAfter: false,
+    contextAtStop: false,
+    sessionStartContextReliable: false,
+    toolOutputAtAfter: false,
+    usageInPayload: false,
+    effortSignal: false,
+    thoughtEvent: false,
+  };
+}
+`}function U(B){return`import type { ProviderPolicyDefaults } from "../../contracts/index.ts";
+
+export function ${B}PolicyDefaults(): ProviderPolicyDefaults {
+  return {
+    blockedPatterns: [],
+    minEffort: null,
+    untrustedTools: [],
+  };
+}
+`}function w(B){return`import type { HarnessEvent, HarnessEventKind } from "../../contracts/index.ts";
+
+// why: empty until this host's own hook names are mapped, so every payload falls through to null.
+export const EVENT_KIND_BY_HOOK: Record<string, HarnessEventKind> = {};
+
+/** Never throws on a malformed payload — returns null instead. */
+export function ${B}ToEvent(_raw: Record<string, unknown>): HarnessEvent | null {
+  return null;
+}
+`}function z(B){return`import type { ProviderWiring, RuntimePaths } from "../../contracts/index.ts";
+
+// why: a placeholder path, until the real file this provider's host reads hooks from is named.
+const WIRING_TARGET = "TODO: replace with the real wiring target path";
+
+export function ${B}WiringTargets(): string[] {
+  return [WIRING_TARGET];
+}
+
+// why: an empty entries list, until this adapter's real hook entries replace it (see claude.wiring.ts's ENTRY_SPECS shape).
+export function ${B}Wiring(_runtime: RuntimePaths): ProviderWiring {
+  return { target: WIRING_TARGET, strategy: "replace", entries: [] };
+}
+`}function A(B){return`import type { Decision, HarnessEvent, Rendered } from "../../contracts/index.ts";
+
+// why: an unconditional abstain, until this host's real hook response schema replaces it.
+export function ${B}Render(_decision: Decision, _event: HarnessEvent): Rendered {
+  return { stdout: null, exitCode: 0 };
+}
+`}function D(B){let G=K(B);return`import type { ProviderPort } from "../provider.port.ts";
+import { ${B}Capabilities } from "./${B}.capabilities.ts";
+import { detect${G} } from "./${B}.detect.ts";
+import { ${B}ToEvent } from "./${B}.inbound.ts";
+import { ${B}Render } from "./${B}.outbound.ts";
+import { ${B}PolicyDefaults } from "./${B}.policy-defaults.ts";
+import { ${B}Wiring, ${B}WiringTargets } from "./${B}.wiring.ts";
+
+// why: assembled here so \`tlc harness new-provider\` has one ProviderPort to import into provider.registry.ts.
+export const ${B}Provider: ProviderPort = {
+  name: "${B}",
+  detect: detect${G},
+  capabilities: ${B}Capabilities,
+  policyDefaults: ${B}PolicyDefaults,
+  toEvent: ${B}ToEvent,
+  render: ${B}Render,
+  wiring: ${B}Wiring,
+  wiringTargets: ${B}WiringTargets,
+};
+`}function F(B){let G=K(B),I=new Date().toISOString().slice(0,10);return`---
+type: Provider
+title: "${G} provider"
+description: "The ${G} adapter — capability descriptor, event mapping, and wiring target."
+tags: [provider, ${B}]
+timestamp: "${I}"
+---
+
+# ${G} provider
+
+Source: \`src/providers/${B}/\`.
+
+## Detection
+
+TODO: describe \`${B}.detect.ts\`'s real detection rule.
+
+## Capability descriptor
+
+\`${B}.capabilities.ts\`:
+
+<!-- generated:capabilities -->
+
+<!-- /generated -->
+
+## Policy defaults
+
+TODO: describe \`${B}.policy-defaults.ts\`'s defaults.
+
+## Event mapping
+
+\`${B}.inbound.ts\` maps ${G}'s own hook names to \`HarnessEventKind\`:
+
+<!-- generated:event-mapping -->
+
+<!-- /generated -->
+
+## Wiring target
+
+TODO: describe \`${B}.wiring.ts\`'s wiring target and strategy.
+
+## See also
+
+- [/providers/index.md](/providers/index.md)
+`}function N(B){let G=H("src","providers",B);return[{path:H(G,`${B}.detect.ts`),content:M(B)},{path:H(G,`${B}.capabilities.ts`),content:T(B)},{path:H(G,`${B}.policy-defaults.ts`),content:U(B)},{path:H(G,`${B}.inbound.ts`),content:w(B)},{path:H(G,`${B}.wiring.ts`),content:z(B)},{path:H(G,`${B}.outbound.ts`),content:A(B)},{path:H(G,"index.ts"),content:D(B)},{path:H("docs","providers",`${B}.md`),content:F(B)}]}function P(B,G=Y){let I=x(B);if(!I.ok)return I;let J=H(G,"src","providers",B);if($(J))return{ok:!1,reason:`${H("src","providers",B)} already exists`};for(let O of N(B)){let Q=H(G,O.path);q(X(Q),{recursive:!0}),C(Q,O.content,"utf8")}return{ok:!0}}function R(B,G=Y){let I=B[0];if(!I){console.error("usage: node tools/dev/new-provider.ts <name>"),process.exitCode=1;return}let J=P(I,G);if(!J.ok){console.error(`new-provider: refusing — ${J.reason}`),process.exitCode=1;return}console.log(`new-provider: scaffolded src/providers/${I}/ and docs/providers/${I}.md`)}if(W.main==W.module)R(process.argv.slice(2));export{x as validateProviderName,N as scaffoldFiles,P as scaffold,R as main};