@nebutra/cofounder-match 0.1.1

package/README.md

@@ -0,0 +1,28 @@
+# @nebutra/cofounder-match
+
+Status: **WIP**
+
+Behavior-derived founder profiles, explainable cofounder matching, and
+mutual-consent introduction records.
+
+## Boundary
+
+This package does not own chat transport, identity providers, or social graph
+truth. It writes profile and match artifacts only after real activity and mutual
+consent checks.
+
+## Commands
+
+```bash
+pnpm cofounder-match:doctor
+pnpm cofounder-match:quickstart
+pnpm cofounder-match:debug
+```
+
+## Current Closure
+
+- 30-day activity gate.
+- Skill complementarity scoring.
+- Visible `why` explanations.
+- Mutual-interest-only chat handoff.
+- Local profile and intro artifacts.

package/dist/chunk-ZXTCDLEE.js

@@ -0,0 +1,179 @@
+// src/index.ts
+import { mkdir } from "fs/promises";
+import { join } from "path";
+import { appendCapabilityDebug, readCapabilityDebug } from "@nebutra/capability-kit/debug";
+import { ContentStore } from "@nebutra/content-store";
+import { CapabilityError } from "@nebutra/errors";
+import { EventLog } from "@nebutra/event-log";
+import { assetId } from "@nebutra/generation-context";
+function requireTenant(value) {
+  if (!value?.trim()) {
+    throw new CapabilityError("cofounder-match", "Cofounder Match requires tenant context", {
+      suggestion: "Pass tenantId so profile and consent artifacts stay tenant-scoped.",
+      statusCode: 400
+    });
+  }
+  return value;
+}
+function skillVector(input) {
+  return {
+    code: input.code ?? 0,
+    growth: input.growth ?? 0,
+    brand: input.brand ?? 0,
+    support: input.support ?? 0
+  };
+}
+function strongestSkill(vector) {
+  return Object.entries(vector).sort(
+    ([leftKey, left], [rightKey, right]) => right - left || leftKey.localeCompare(rightKey)
+  )[0]?.[0] ?? "code";
+}
+function weakestSkill(vector) {
+  return Object.entries(vector).sort(
+    ([leftKey, left], [rightKey, right]) => left - right || leftKey.localeCompare(rightKey)
+  )[0]?.[0] ?? "growth";
+}
+function sharedCount(left, right) {
+  const rightSet = new Set(right.map((item) => item.toLowerCase()));
+  return left.filter((item) => rightSet.has(item.toLowerCase())).length;
+}
+function consentKey(from, to) {
+  return `${from}->${to}`;
+}
+var CofounderMatch = class _CofounderMatch {
+  #tenantId;
+  #debugRoot;
+  #contentStore;
+  #eventLog;
+  #profiles = /* @__PURE__ */ new Map();
+  #interests = /* @__PURE__ */ new Set();
+  constructor(options) {
+    this.#tenantId = requireTenant(options.tenantId);
+    this.#debugRoot = options.debugRoot ?? process.cwd();
+    this.#contentStore = options.contentStore;
+    this.#eventLog = options.eventLog;
+  }
+  static async open(root = ".nebutra/cofounder-match", options = {}) {
+    const tenantId = options.tenantId ?? "local";
+    await mkdir(root, { recursive: true });
+    const contentStore = await ContentStore.open(join(root, "content"), { tenantId });
+    const eventLog = await EventLog.open(join(root, "event-log"), { tenantId });
+    return new _CofounderMatch({ ...options, tenantId, contentStore, eventLog });
+  }
+  async buildProfileFromActivity(input) {
+    const profile = {
+      founderId: input.founderId,
+      activeDays: input.activeDays,
+      activityVerified: input.activeDays >= 30,
+      ...input.activeDays < 30 ? { lockedReason: "Cofounder matching unlocks after 30 days of real activity." } : {},
+      skillVector: skillVector(input.playCounts),
+      domainTags: input.domainTags,
+      communicationStyle: input.communicationSamples
+    };
+    const path = `cofounder-match/profiles/${input.founderId}.json`;
+    const snapshot = `${JSON.stringify(profile, null, 2)}
+`;
+    await this.#contentStore.write(path, snapshot);
+    this.#profiles.set(input.founderId, profile);
+    await this.#debug({
+      type: "profile",
+      tenantId: this.#tenantId,
+      founderId: input.founderId,
+      activityVerified: profile.activityVerified
+    });
+    return profile;
+  }
+  scoreMatch(left, right) {
+    const leftWeak = weakestSkill(left.skillVector);
+    const rightStrong = strongestSkill(right.skillVector);
+    const rightWeak = weakestSkill(right.skillVector);
+    const leftStrong = strongestSkill(left.skillVector);
+    const growthFill = left.skillVector.growth <= 10 && right.skillVector.growth >= 30 ? 45 : 0;
+    const codeFill = right.skillVector.code <= 10 && left.skillVector.code >= 30 ? 25 : 0;
+    const supportFill = left.skillVector.support <= 5 && right.skillVector.support >= 15 ? 10 : 0;
+    const brandFill = right.skillVector.brand <= 5 && left.skillVector.brand >= 10 ? 10 : 0;
+    const complements = Math.min(100, 20 + growthFill + codeFill + supportFill + brandFill);
+    const domainAdjacency = Math.min(100, 55 + sharedCount(left.domainTags, right.domainTags) * 20);
+    const paceCompatibility = Math.max(40, 100 - Math.abs(left.activeDays - right.activeDays));
+    const overall = Math.round(
+      Math.min(100, complements * 0.55 + domainAdjacency * 0.25 + paceCompatibility * 0.2)
+    );
+    const why = [
+      `${right.founderId} is strong in ${rightStrong[0]?.toUpperCase()}${rightStrong.slice(
+        1
+      )}, which complements ${left.founderId}'s ${leftWeak} gap.`,
+      `${left.founderId} is strong in ${leftStrong}, which balances ${right.founderId}'s ${rightWeak} gap.`,
+      `Shared domains: ${sharedCount(left.domainTags, right.domainTags)}.`
+    ];
+    return {
+      leftFounderId: left.founderId,
+      rightFounderId: right.founderId,
+      overall,
+      skillComplementarity: Math.min(100, complements),
+      domainAdjacency,
+      paceCompatibility,
+      why
+    };
+  }
+  async expressInterest(fromFounderId, toFounderId) {
+    this.#interests.add(consentKey(fromFounderId, toFounderId));
+    await this.#debug({ type: "interest", tenantId: this.#tenantId, fromFounderId, toFounderId });
+  }
+  async startChat(leftFounderId, rightFounderId) {
+    if (!this.#interests.has(consentKey(leftFounderId, rightFounderId)) || !this.#interests.has(consentKey(rightFounderId, leftFounderId))) {
+      throw new CapabilityError("cofounder-match", "Mutual consent is required before chat", {
+        suggestion: "Wait for mutual interest before opening a cofounder intro thread.",
+        statusCode: 403
+      });
+    }
+    const thread = {
+      threadId: assetId("cofounder_chat", `${leftFounderId}_${rightFounderId}`),
+      threadKind: "mutual-consent-intro",
+      founders: [leftFounderId, rightFounderId],
+      icebreaker: `${leftFounderId}, start with the specific work you admired in ${rightFounderId}'s profile.`
+    };
+    const path = `cofounder-match/chats/${thread.threadId}.json`;
+    const snapshot = `${JSON.stringify(thread, null, 2)}
+`;
+    await this.#contentStore.write(path, snapshot);
+    await this.#eventLog.commit({
+      traceId: assetId("cofounder_match_chat", thread.threadId),
+      kind: "content_write",
+      affected: [path],
+      parent: null,
+      snapshot: { [path]: snapshot }
+    });
+    await this.#debug({
+      type: "start_chat",
+      tenantId: this.#tenantId,
+      founders: thread.founders
+    });
+    return thread;
+  }
+  async doctor() {
+    const report = {
+      capability: "cofounder-match",
+      ok: true,
+      checkedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      features: ["activity-verified-profile", "explainable-score", "mutual-consent-intro"],
+      suggestion: "Local matching contracts are ready; encrypted chat and identity providers remain adapter handoffs."
+    };
+    await this.#debug({ type: "doctor", tenantId: this.#tenantId, profiles: this.#profiles.size });
+    return report;
+  }
+  async close() {
+    await this.#contentStore.close();
+  }
+  async #debug(entry) {
+    await appendCapabilityDebug("cofounder-match", entry, { root: this.#debugRoot });
+  }
+};
+async function readCofounderMatchDebug(root = process.cwd(), limit = 20) {
+  return readCapabilityDebug("cofounder-match", { root, limit });
+}
+
+export {
+  CofounderMatch,
+  readCofounderMatchDebug
+};
+//# sourceMappingURL=chunk-ZXTCDLEE.js.map

package/dist/chunk-ZXTCDLEE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { mkdir } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { appendCapabilityDebug, readCapabilityDebug } from \"@nebutra/capability-kit/debug\";\nimport { ContentStore } from \"@nebutra/content-store\";\nimport { CapabilityError } from \"@nebutra/errors\";\nimport { EventLog } from \"@nebutra/event-log\";\nimport { assetId } from \"@nebutra/generation-context\";\n\nexport type SkillArea = \"code\" | \"growth\" | \"brand\" | \"support\";\n\nexport interface ActivityProfileInput {\n  readonly founderId: string;\n  readonly activeDays: number;\n  readonly playCounts: Partial<Record<SkillArea, number>>;\n  readonly domainTags: readonly string[];\n  readonly communicationSamples: readonly string[];\n}\n\nexport interface FounderProfile {\n  readonly founderId: string;\n  readonly activityVerified: boolean;\n  readonly lockedReason?: string;\n  readonly activeDays: number;\n  readonly skillVector: Record<SkillArea, number>;\n  readonly domainTags: readonly string[];\n  readonly communicationStyle: readonly string[];\n}\n\nexport interface MatchScore {\n  readonly leftFounderId: string;\n  readonly rightFounderId: string;\n  readonly overall: number;\n  readonly skillComplementarity: number;\n  readonly domainAdjacency: number;\n  readonly paceCompatibility: number;\n  readonly why: readonly string[];\n}\n\nexport interface ChatThread {\n  readonly threadId: string;\n  readonly threadKind: \"mutual-consent-intro\";\n  readonly founders: readonly [string, string];\n  readonly icebreaker: string;\n}\n\nexport interface CofounderMatchDoctorReport {\n  readonly capability: \"cofounder-match\";\n  readonly ok: boolean;\n  readonly checkedAt: string;\n  readonly features: readonly string[];\n  readonly suggestion?: string;\n}\n\nexport interface CofounderMatchOptions {\n  readonly tenantId?: string;\n  readonly debugRoot?: string;\n  readonly contentStore?: ContentStore;\n  readonly eventLog?: EventLog;\n}\n\nfunction requireTenant(value: string | undefined): string {\n  if (!value?.trim()) {\n    throw new CapabilityError(\"cofounder-match\", \"Cofounder Match requires tenant context\", {\n      suggestion: \"Pass tenantId so profile and consent artifacts stay tenant-scoped.\",\n      statusCode: 400,\n    });\n  }\n  return value;\n}\n\nfunction skillVector(input: Partial<Record<SkillArea, number>>): Record<SkillArea, number> {\n  return {\n    code: input.code ?? 0,\n    growth: input.growth ?? 0,\n    brand: input.brand ?? 0,\n    support: input.support ?? 0,\n  };\n}\n\nfunction strongestSkill(vector: Record<SkillArea, number>): SkillArea {\n  return (\n    (Object.entries(vector) as Array<[SkillArea, number]>).sort(\n      ([leftKey, left], [rightKey, right]) => right - left || leftKey.localeCompare(rightKey),\n    )[0]?.[0] ?? \"code\"\n  );\n}\n\nfunction weakestSkill(vector: Record<SkillArea, number>): SkillArea {\n  return (\n    (Object.entries(vector) as Array<[SkillArea, number]>).sort(\n      ([leftKey, left], [rightKey, right]) => left - right || leftKey.localeCompare(rightKey),\n    )[0]?.[0] ?? \"growth\"\n  );\n}\n\nfunction sharedCount(left: readonly string[], right: readonly string[]): number {\n  const rightSet = new Set(right.map((item) => item.toLowerCase()));\n  return left.filter((item) => rightSet.has(item.toLowerCase())).length;\n}\n\nfunction consentKey(from: string, to: string): string {\n  return `${from}->${to}`;\n}\n\nexport class CofounderMatch {\n  readonly #tenantId: string;\n  readonly #debugRoot: string;\n  readonly #contentStore: ContentStore;\n  readonly #eventLog: EventLog;\n  readonly #profiles = new Map<string, FounderProfile>();\n  readonly #interests = new Set<string>();\n\n  private constructor(\n    options: Required<Pick<CofounderMatchOptions, \"tenantId\" | \"contentStore\" | \"eventLog\">> &\n      Pick<CofounderMatchOptions, \"debugRoot\">,\n  ) {\n    this.#tenantId = requireTenant(options.tenantId);\n    this.#debugRoot = options.debugRoot ?? process.cwd();\n    this.#contentStore = options.contentStore;\n    this.#eventLog = options.eventLog;\n  }\n\n  static async open(\n    root = \".nebutra/cofounder-match\",\n    options: Omit<CofounderMatchOptions, \"contentStore\" | \"eventLog\"> = {},\n  ): Promise<CofounderMatch> {\n    const tenantId = options.tenantId ?? \"local\";\n    await mkdir(root, { recursive: true });\n    const contentStore = await ContentStore.open(join(root, \"content\"), { tenantId });\n    const eventLog = await EventLog.open(join(root, \"event-log\"), { tenantId });\n    return new CofounderMatch({ ...options, tenantId, contentStore, eventLog });\n  }\n\n  async buildProfileFromActivity(input: ActivityProfileInput): Promise<FounderProfile> {\n    const profile: FounderProfile = {\n      founderId: input.founderId,\n      activeDays: input.activeDays,\n      activityVerified: input.activeDays >= 30,\n      ...(input.activeDays < 30\n        ? { lockedReason: \"Cofounder matching unlocks after 30 days of real activity.\" }\n        : {}),\n      skillVector: skillVector(input.playCounts),\n      domainTags: input.domainTags,\n      communicationStyle: input.communicationSamples,\n    };\n    const path = `cofounder-match/profiles/${input.founderId}.json`;\n    const snapshot = `${JSON.stringify(profile, null, 2)}\\n`;\n    await this.#contentStore.write(path, snapshot);\n    this.#profiles.set(input.founderId, profile);\n    await this.#debug({\n      type: \"profile\",\n      tenantId: this.#tenantId,\n      founderId: input.founderId,\n      activityVerified: profile.activityVerified,\n    });\n    return profile;\n  }\n\n  scoreMatch(left: FounderProfile, right: FounderProfile): MatchScore {\n    const leftWeak = weakestSkill(left.skillVector);\n    const rightStrong = strongestSkill(right.skillVector);\n    const rightWeak = weakestSkill(right.skillVector);\n    const leftStrong = strongestSkill(left.skillVector);\n    const growthFill = left.skillVector.growth <= 10 && right.skillVector.growth >= 30 ? 45 : 0;\n    const codeFill = right.skillVector.code <= 10 && left.skillVector.code >= 30 ? 25 : 0;\n    const supportFill = left.skillVector.support <= 5 && right.skillVector.support >= 15 ? 10 : 0;\n    const brandFill = right.skillVector.brand <= 5 && left.skillVector.brand >= 10 ? 10 : 0;\n    const complements = Math.min(100, 20 + growthFill + codeFill + supportFill + brandFill);\n    const domainAdjacency = Math.min(100, 55 + sharedCount(left.domainTags, right.domainTags) * 20);\n    const paceCompatibility = Math.max(40, 100 - Math.abs(left.activeDays - right.activeDays));\n    const overall = Math.round(\n      Math.min(100, complements * 0.55 + domainAdjacency * 0.25 + paceCompatibility * 0.2),\n    );\n    const why = [\n      `${right.founderId} is strong in ${rightStrong[0]?.toUpperCase()}${rightStrong.slice(\n        1,\n      )}, which complements ${left.founderId}'s ${leftWeak} gap.`,\n      `${left.founderId} is strong in ${leftStrong}, which balances ${right.founderId}'s ${rightWeak} gap.`,\n      `Shared domains: ${sharedCount(left.domainTags, right.domainTags)}.`,\n    ];\n    return {\n      leftFounderId: left.founderId,\n      rightFounderId: right.founderId,\n      overall,\n      skillComplementarity: Math.min(100, complements),\n      domainAdjacency,\n      paceCompatibility,\n      why,\n    };\n  }\n\n  async expressInterest(fromFounderId: string, toFounderId: string): Promise<void> {\n    this.#interests.add(consentKey(fromFounderId, toFounderId));\n    await this.#debug({ type: \"interest\", tenantId: this.#tenantId, fromFounderId, toFounderId });\n  }\n\n  async startChat(leftFounderId: string, rightFounderId: string): Promise<ChatThread> {\n    if (\n      !this.#interests.has(consentKey(leftFounderId, rightFounderId)) ||\n      !this.#interests.has(consentKey(rightFounderId, leftFounderId))\n    ) {\n      throw new CapabilityError(\"cofounder-match\", \"Mutual consent is required before chat\", {\n        suggestion: \"Wait for mutual interest before opening a cofounder intro thread.\",\n        statusCode: 403,\n      });\n    }\n    const thread: ChatThread = {\n      threadId: assetId(\"cofounder_chat\", `${leftFounderId}_${rightFounderId}`),\n      threadKind: \"mutual-consent-intro\",\n      founders: [leftFounderId, rightFounderId],\n      icebreaker: `${leftFounderId}, start with the specific work you admired in ${rightFounderId}'s profile.`,\n    };\n    const path = `cofounder-match/chats/${thread.threadId}.json`;\n    const snapshot = `${JSON.stringify(thread, null, 2)}\\n`;\n    await this.#contentStore.write(path, snapshot);\n    await this.#eventLog.commit({\n      traceId: assetId(\"cofounder_match_chat\", thread.threadId),\n      kind: \"content_write\",\n      affected: [path],\n      parent: null,\n      snapshot: { [path]: snapshot },\n    });\n    await this.#debug({\n      type: \"start_chat\",\n      tenantId: this.#tenantId,\n      founders: thread.founders,\n    });\n    return thread;\n  }\n\n  async doctor(): Promise<CofounderMatchDoctorReport> {\n    const report: CofounderMatchDoctorReport = {\n      capability: \"cofounder-match\",\n      ok: true,\n      checkedAt: new Date().toISOString(),\n      features: [\"activity-verified-profile\", \"explainable-score\", \"mutual-consent-intro\"],\n      suggestion:\n        \"Local matching contracts are ready; encrypted chat and identity providers remain adapter handoffs.\",\n    };\n    await this.#debug({ type: \"doctor\", tenantId: this.#tenantId, profiles: this.#profiles.size });\n    return report;\n  }\n\n  async close(): Promise<void> {\n    await this.#contentStore.close();\n  }\n\n  async #debug(entry: Record<string, unknown>): Promise<void> {\n    await appendCapabilityDebug(\"cofounder-match\", entry, { root: this.#debugRoot });\n  }\n}\n\nexport async function readCofounderMatchDebug(\n  root = process.cwd(),\n  limit = 20,\n): Promise<unknown[]> {\n  return readCapabilityDebug(\"cofounder-match\", { root, limit });\n}\n"],"mappings":"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","names":[]}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/cli.js

@@ -0,0 +1,43 @@
+import {
+  CofounderMatch,
+  readCofounderMatchDebug
+} from "./chunk-ZXTCDLEE.js";
+
+// src/cli.ts
+var command = process.argv[2] ?? "doctor";
+var root = process.env.COFOUNDER_MATCH_ROOT ?? ".nebutra/cofounder-match";
+var tenantId = process.env.NEBUTRA_TENANT_ID ?? "local";
+if (command === "doctor") {
+  const match = await CofounderMatch.open(root, { tenantId });
+  try {
+    process.stdout.write(`${JSON.stringify(await match.doctor(), null, 2)}
+`);
+  } finally {
+    await match.close();
+  }
+} else if (command === "quickstart") {
+  const match = await CofounderMatch.open(root, { tenantId });
+  try {
+    const profile = await match.buildProfileFromActivity({
+      founderId: "alice",
+      activeDays: 31,
+      playCounts: { code: 20, growth: 2, brand: 4, support: 1 },
+      domainTags: ["developer-tools"],
+      communicationSamples: ["direct technical updates"]
+    });
+    process.stdout.write(`${JSON.stringify(profile, null, 2)}
+`);
+  } finally {
+    await match.close();
+  }
+} else if (command === "debug") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "cofounder-match", entries: await readCofounderMatchDebug() }, null, 2)}
+`
+  );
+} else {
+  process.stderr.write(`Unknown cofounder-match command: ${command}
+`);
+  process.exitCode = 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import { CofounderMatch, readCofounderMatchDebug } from \"./index\";\n\nconst command = process.argv[2] ?? \"doctor\";\nconst root = process.env.COFOUNDER_MATCH_ROOT ?? \".nebutra/cofounder-match\";\nconst tenantId = process.env.NEBUTRA_TENANT_ID ?? \"local\";\n\nif (command === \"doctor\") {\n  const match = await CofounderMatch.open(root, { tenantId });\n  try {\n    process.stdout.write(`${JSON.stringify(await match.doctor(), null, 2)}\\n`);\n  } finally {\n    await match.close();\n  }\n} else if (command === \"quickstart\") {\n  const match = await CofounderMatch.open(root, { tenantId });\n  try {\n    const profile = await match.buildProfileFromActivity({\n      founderId: \"alice\",\n      activeDays: 31,\n      playCounts: { code: 20, growth: 2, brand: 4, support: 1 },\n      domainTags: [\"developer-tools\"],\n      communicationSamples: [\"direct technical updates\"],\n    });\n    process.stdout.write(`${JSON.stringify(profile, null, 2)}\\n`);\n  } finally {\n    await match.close();\n  }\n} else if (command === \"debug\") {\n  process.stdout.write(\n    `${JSON.stringify({ capability: \"cofounder-match\", entries: await readCofounderMatchDebug() }, null, 2)}\\n`,\n  );\n} else {\n  process.stderr.write(`Unknown cofounder-match command: ${command}\\n`);\n  process.exitCode = 1;\n}\n"],"mappings":";;;;;;AAEA,IAAM,UAAU,QAAQ,KAAK,CAAC,KAAK;AACnC,IAAM,OAAO,QAAQ,IAAI,wBAAwB;AACjD,IAAM,WAAW,QAAQ,IAAI,qBAAqB;AAElD,IAAI,YAAY,UAAU;AACxB,QAAM,QAAQ,MAAM,eAAe,KAAK,MAAM,EAAE,SAAS,CAAC;AAC1D,MAAI;AACF,YAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC;AAAA,CAAI;AAAA,EAC3E,UAAE;AACA,UAAM,MAAM,MAAM;AAAA,EACpB;AACF,WAAW,YAAY,cAAc;AACnC,QAAM,QAAQ,MAAM,eAAe,KAAK,MAAM,EAAE,SAAS,CAAC;AAC1D,MAAI;AACF,UAAM,UAAU,MAAM,MAAM,yBAAyB;AAAA,MACnD,WAAW;AAAA,MACX,YAAY;AAAA,MACZ,YAAY,EAAE,MAAM,IAAI,QAAQ,GAAG,OAAO,GAAG,SAAS,EAAE;AAAA,MACxD,YAAY,CAAC,iBAAiB;AAAA,MAC9B,sBAAsB,CAAC,0BAA0B;AAAA,IACnD,CAAC;AACD,YAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,SAAS,MAAM,CAAC,CAAC;AAAA,CAAI;AAAA,EAC9D,UAAE;AACA,UAAM,MAAM,MAAM;AAAA,EACpB;AACF,WAAW,YAAY,SAAS;AAC9B,UAAQ,OAAO;AAAA,IACb,GAAG,KAAK,UAAU,EAAE,YAAY,mBAAmB,SAAS,MAAM,wBAAwB,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA;AAAA,EACzG;AACF,OAAO;AACL,UAAQ,OAAO,MAAM,oCAAoC,OAAO;AAAA,CAAI;AACpE,UAAQ,WAAW;AACrB;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+import { ContentStore } from '@nebutra/content-store';
+import { EventLog } from '@nebutra/event-log';
+
+type SkillArea = "code" | "growth" | "brand" | "support";
+interface ActivityProfileInput {
+    readonly founderId: string;
+    readonly activeDays: number;
+    readonly playCounts: Partial<Record<SkillArea, number>>;
+    readonly domainTags: readonly string[];
+    readonly communicationSamples: readonly string[];
+}
+interface FounderProfile {
+    readonly founderId: string;
+    readonly activityVerified: boolean;
+    readonly lockedReason?: string;
+    readonly activeDays: number;
+    readonly skillVector: Record<SkillArea, number>;
+    readonly domainTags: readonly string[];
+    readonly communicationStyle: readonly string[];
+}
+interface MatchScore {
+    readonly leftFounderId: string;
+    readonly rightFounderId: string;
+    readonly overall: number;
+    readonly skillComplementarity: number;
+    readonly domainAdjacency: number;
+    readonly paceCompatibility: number;
+    readonly why: readonly string[];
+}
+interface ChatThread {
+    readonly threadId: string;
+    readonly threadKind: "mutual-consent-intro";
+    readonly founders: readonly [string, string];
+    readonly icebreaker: string;
+}
+interface CofounderMatchDoctorReport {
+    readonly capability: "cofounder-match";
+    readonly ok: boolean;
+    readonly checkedAt: string;
+    readonly features: readonly string[];
+    readonly suggestion?: string;
+}
+interface CofounderMatchOptions {
+    readonly tenantId?: string;
+    readonly debugRoot?: string;
+    readonly contentStore?: ContentStore;
+    readonly eventLog?: EventLog;
+}
+declare class CofounderMatch {
+    #private;
+    private constructor();
+    static open(root?: string, options?: Omit<CofounderMatchOptions, "contentStore" | "eventLog">): Promise<CofounderMatch>;
+    buildProfileFromActivity(input: ActivityProfileInput): Promise<FounderProfile>;
+    scoreMatch(left: FounderProfile, right: FounderProfile): MatchScore;
+    expressInterest(fromFounderId: string, toFounderId: string): Promise<void>;
+    startChat(leftFounderId: string, rightFounderId: string): Promise<ChatThread>;
+    doctor(): Promise<CofounderMatchDoctorReport>;
+    close(): Promise<void>;
+}
+declare function readCofounderMatchDebug(root?: string, limit?: number): Promise<unknown[]>;
+
+export { type ActivityProfileInput, type ChatThread, CofounderMatch, type CofounderMatchDoctorReport, type CofounderMatchOptions, type FounderProfile, type MatchScore, type SkillArea, readCofounderMatchDebug };

package/dist/index.js

@@ -0,0 +1,9 @@
+import {
+  CofounderMatch,
+  readCofounderMatchDebug
+} from "./chunk-ZXTCDLEE.js";
+export {
+  CofounderMatch,
+  readCofounderMatchDebug
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/examples/doctor.ts

@@ -0,0 +1,11 @@
+import { CofounderMatch } from "../src/index";
+
+const match = await CofounderMatch.open(".nebutra/cofounder-match-example", {
+  tenantId: "local",
+});
+
+try {
+  process.stdout.write(`${JSON.stringify(await match.doctor(), null, 2)}\n`);
+} finally {
+  await match.close();
+}

package/examples/mutual-consent.ts

@@ -0,0 +1,13 @@
+import { CofounderMatch } from "../src/index";
+
+const match = await CofounderMatch.open(".nebutra/cofounder-match-consent-example", {
+  tenantId: "local",
+});
+
+try {
+  await match.expressInterest("alice", "sarah");
+  await match.expressInterest("sarah", "alice");
+  process.stdout.write(`${JSON.stringify(await match.startChat("alice", "sarah"), null, 2)}\n`);
+} finally {
+  await match.close();
+}

package/examples/quickstart.ts

@@ -0,0 +1,18 @@
+import { CofounderMatch } from "../src/index";
+
+const match = await CofounderMatch.open(".nebutra/cofounder-match-example", {
+  tenantId: "local",
+});
+
+try {
+  const profile = await match.buildProfileFromActivity({
+    founderId: "alice",
+    activeDays: 31,
+    playCounts: { code: 40, growth: 3, brand: 8, support: 2 },
+    domainTags: ["developer-tools"],
+    communicationSamples: ["direct technical updates"],
+  });
+  process.stdout.write(`${JSON.stringify(profile, null, 2)}\n`);
+} finally {
+  await match.close();
+}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@nebutra/cofounder-match",
+  "version": "0.1.1",
+  "description": "Behavior-verified cofounder profile, matching, and mutual-consent introduction surface",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "nebutra": {
+    "status": "wip",
+    "productionReady": false,
+    "surface": "ecosystem-product",
+    "requires": [
+      "@nebutra/content-store for profile and match artifacts",
+      "@nebutra/event-log for match lifecycle checkpoints",
+      "@nebutra/capability-kit for debug and doctor surfaces"
+    ],
+    "gaps": [
+      "Encrypted chat transport is represented as a mutual-consent handoff",
+      "Identity verification is represented as profile metadata until live providers are wired",
+      "Reputation and abuse review remain deterministic local records"
+    ],
+    "featureId": "cofounder-match",
+    "category": "ai",
+    "summary": "Real-activity-based founder matching with explainable complementarity"
+  },
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "dependencies": {
+    "@nebutra/capability-kit": "0.2.0",
+    "@nebutra/content-store": "0.1.0",
+    "@nebutra/errors": "0.1.0",
+    "@nebutra/event-log": "0.1.0",
+    "@nebutra/generation-context": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.15",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.4"
+  },
+  "homepage": "https://github.com/Nebutra/Nebutra-Sailor/tree/main/packages/ai/cofounder-match#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nebutra/Nebutra-Sailor.git",
+    "directory": "packages/ai/cofounder-match"
+  },
+  "bugs": {
+    "url": "https://github.com/Nebutra/Nebutra-Sailor/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/plays/seek_cofounder/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: seek_cofounder
+kind: play
+version: 1.0.0
+description: Build an activity-verified profile and surface explainable cofounder matches
+required_skills:
+  - content_store.write
+  - event_log.commit
+sub_agents:
+  - role: match_explainer
+    allowed_skills: [content_store.write]
+depends_on_plays: []
+---
+
+## What this play does
+
+Builds a behavior-derived founder profile and explains complementary matches.
+
+## Boundaries
+
+- Matching is locked until the founder has at least 30 days of real activity.
+- Chat opens only after mutual consent.
+- Match explanations must be visible; hidden algorithmic matching is not allowed.

package/src/cli.ts

@@ -0,0 +1,35 @@
+import { CofounderMatch, readCofounderMatchDebug } from "./index";
+
+const command = process.argv[2] ?? "doctor";
+const root = process.env.COFOUNDER_MATCH_ROOT ?? ".nebutra/cofounder-match";
+const tenantId = process.env.NEBUTRA_TENANT_ID ?? "local";
+
+if (command === "doctor") {
+  const match = await CofounderMatch.open(root, { tenantId });
+  try {
+    process.stdout.write(`${JSON.stringify(await match.doctor(), null, 2)}\n`);
+  } finally {
+    await match.close();
+  }
+} else if (command === "quickstart") {
+  const match = await CofounderMatch.open(root, { tenantId });
+  try {
+    const profile = await match.buildProfileFromActivity({
+      founderId: "alice",
+      activeDays: 31,
+      playCounts: { code: 20, growth: 2, brand: 4, support: 1 },
+      domainTags: ["developer-tools"],
+      communicationSamples: ["direct technical updates"],
+    });
+    process.stdout.write(`${JSON.stringify(profile, null, 2)}\n`);
+  } finally {
+    await match.close();
+  }
+} else if (command === "debug") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "cofounder-match", entries: await readCofounderMatchDebug() }, null, 2)}\n`,
+  );
+} else {
+  process.stderr.write(`Unknown cofounder-match command: ${command}\n`);
+  process.exitCode = 1;
+}

package/src/index.test.ts

@@ -0,0 +1,78 @@
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { CofounderMatch, readCofounderMatchDebug } from "./index";
+
+let root: string | undefined;
+let matcher: CofounderMatch | undefined;
+
+afterEach(async () => {
+  if (matcher) await matcher.close();
+  if (root) await rm(root, { recursive: true, force: true });
+  root = undefined;
+  matcher = undefined;
+});
+
+async function open(): Promise<CofounderMatch> {
+  root = await mkdtemp(join(tmpdir(), "cofounder-match-"));
+  matcher = await CofounderMatch.open(root, { tenantId: "tenant_a" });
+  return matcher;
+}
+
+describe("cofounder-match", () => {
+  it("requires real activity before a founder can enter matching", async () => {
+    const runtime = await open();
+
+    const profile = await runtime.buildProfileFromActivity({
+      founderId: "alice",
+      activeDays: 12,
+      playCounts: { code: 12, growth: 0, brand: 3, support: 0 },
+      domainTags: ["developer-tools"],
+      communicationSamples: ["direct and technical"],
+    });
+
+    expect(profile.activityVerified).toBe(false);
+    expect(profile.lockedReason).toContain("30 days");
+  });
+
+  it("scores complementary founders with a transparent why explanation", async () => {
+    const runtime = await open();
+    const builder = await runtime.buildProfileFromActivity({
+      founderId: "alice",
+      activeDays: 45,
+      playCounts: { code: 120, growth: 4, brand: 12, support: 3 },
+      domainTags: ["developer-tools", "debugging"],
+      communicationSamples: ["short technical updates"],
+    });
+    const seller = await runtime.buildProfileFromActivity({
+      founderId: "sarah",
+      activeDays: 60,
+      playCounts: { code: 3, growth: 90, brand: 6, support: 18 },
+      domainTags: ["developer-tools", "sales"],
+      communicationSamples: ["warm customer notes"],
+    });
+
+    const score = runtime.scoreMatch(builder, seller);
+
+    expect(builder.activityVerified).toBe(true);
+    expect(score.overall).toBeGreaterThan(70);
+    expect(score.why.some((reason) => reason.includes("Growth"))).toBe(true);
+  });
+
+  it("opens chat only after mutual consent", async () => {
+    const runtime = await open();
+
+    await runtime.expressInterest("alice", "sarah");
+    await expect(runtime.startChat("alice", "sarah")).rejects.toMatchObject({
+      capability: "cofounder-match",
+      suggestion: expect.stringContaining("mutual"),
+    });
+    await runtime.expressInterest("sarah", "alice");
+    const chat = await runtime.startChat("alice", "sarah");
+
+    expect(chat.threadKind).toBe("mutual-consent-intro");
+    expect(chat.icebreaker).toContain("alice");
+    await expect(readCofounderMatchDebug(root)).resolves.toEqual(expect.any(Array));
+  });
+});