@nebutra/idea-plaza 0.1.1

package/README.md

@@ -0,0 +1,27 @@
+# @nebutra/idea-plaza
+
+Status: **WIP**
+
+Opt-in idea publishing and fork lineage for Nebutra ecosystem artifacts.
+
+## Boundary
+
+Ideas are private by default. This package writes explicit public snapshots and
+fork metadata; it does not expose private founder data or own a global registry
+transport.
+
+## Commands
+
+```bash
+pnpm idea-plaza:doctor
+pnpm idea-plaza:quickstart
+pnpm idea-plaza:debug
+```
+
+## Current Closure
+
+- Sensitive-field scan before publish.
+- Surface/detail/cloneable publication levels.
+- Immutable local snapshot artifacts.
+- Fork attribution always enabled.
+- Cemetery warning metadata on cards.

package/dist/chunk-2WSISCFT.js

@@ -0,0 +1,147 @@
+// 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 { assertPublicDisclosureSafe } from "@nebutra/ecosystem-safety";
+import { CapabilityError } from "@nebutra/errors";
+import { EventLog } from "@nebutra/event-log";
+import { assetId } from "@nebutra/generation-context";
+import { scanForSensitiveFields } from "@nebutra/ecosystem-safety";
+function requireTenant(value) {
+  if (!value?.trim()) {
+    throw new CapabilityError("idea-plaza", "Idea Plaza requires tenant context", {
+      suggestion: "Pass tenantId so publish snapshots stay tenant-scoped.",
+      statusCode: 400
+    });
+  }
+  return value;
+}
+function bodyForScan(request) {
+  return [request.title, request.oneLine, request.body ?? "", request.tags.join(" ")].join("\n");
+}
+var IdeaPlaza = class _IdeaPlaza {
+  #tenantId;
+  #debugRoot;
+  #contentStore;
+  #eventLog;
+  #ideas = /* @__PURE__ */ new Map();
+  #forks = /* @__PURE__ */ new Map();
+  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/idea-plaza", 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 _IdeaPlaza({ ...options, tenantId, contentStore, eventLog });
+  }
+  async publish(request) {
+    assertPublicDisclosureSafe({
+      capability: "idea-plaza",
+      content: bodyForScan(request),
+      ...request.redactions !== void 0 ? { redactions: request.redactions } : {},
+      suggestion: "Review detected private values and pass redactions before publishing."
+    });
+    const ideaId = assetId("idea", `${request.title}_${request.oneLine}`);
+    const publicationPath = `plaza/ideas/${ideaId}.json`;
+    const publishedAt = (/* @__PURE__ */ new Date()).toISOString();
+    const idea = {
+      ideaId,
+      title: request.title,
+      oneLine: request.oneLine,
+      level: request.level,
+      tags: request.tags,
+      redactions: request.redactions ?? [],
+      cemeteryWarnings: request.cemeteryWarnings ?? [],
+      publicationPath,
+      publishedAt
+    };
+    const snapshot = `${JSON.stringify({ ...idea, body: request.body ?? "" }, null, 2)}
+`;
+    await this.#contentStore.write(publicationPath, snapshot);
+    const eventId = await this.#eventLog.commit({
+      traceId: assetId("idea_plaza_publish", ideaId),
+      kind: "content_write",
+      affected: [publicationPath],
+      parent: null,
+      snapshot: { [publicationPath]: snapshot }
+    });
+    const published = { ...idea, eventId };
+    this.#ideas.set(ideaId, published);
+    await this.#debug({ type: "publish", tenantId: this.#tenantId, ideaId, level: request.level });
+    return published;
+  }
+  async fork(ideaId, request) {
+    if (!this.#ideas.has(ideaId)) {
+      throw new CapabilityError("idea-plaza", "Idea fork source not found", {
+        suggestion: "Fork only from an explicit public or cloneable snapshot in the current feed.",
+        metadata: { ideaId },
+        statusCode: 404
+      });
+    }
+    const fork = {
+      forkId: assetId("idea_fork", `${ideaId}_${request.newFounderId}`),
+      sourceIdeaId: ideaId,
+      newFounderId: request.newFounderId,
+      inheritPlayPreferences: request.inheritPlayPreferences ?? false,
+      attribution: {
+        displayInNewCompany: true,
+        publicLineage: true
+      },
+      createdAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    const path = `plaza/forks/${fork.forkId}.json`;
+    const snapshot = `${JSON.stringify(fork, null, 2)}
+`;
+    await this.#contentStore.write(path, snapshot);
+    await this.#eventLog.commit({
+      traceId: assetId("idea_plaza_fork", fork.forkId),
+      kind: "content_write",
+      affected: [path],
+      parent: null,
+      snapshot: { [path]: snapshot }
+    });
+    this.#forks.set(fork.forkId, fork);
+    await this.#debug({ type: "fork", tenantId: this.#tenantId, ideaId, forkId: fork.forkId });
+    return fork;
+  }
+  async feed(request) {
+    const items = [...this.#ideas.values()].sort(
+      (left, right) => request.sort === "new" ? right.publishedAt.localeCompare(left.publishedAt) : right.cemeteryWarnings.length - left.cemeteryWarnings.length || right.publishedAt.localeCompare(left.publishedAt)
+    ).slice(0, request.limit);
+    await this.#debug({ type: "feed", tenantId: this.#tenantId, sort: request.sort });
+    return { items };
+  }
+  async doctor() {
+    const report = {
+      capability: "idea-plaza",
+      ok: true,
+      checkedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      features: ["publish", "redact", "fork-lineage", "feed", "cemetery-warning"],
+      suggestion: "Local snapshots are active; public registry transport and moderation queues remain adapter handoffs."
+    };
+    await this.#debug({ type: "doctor", tenantId: this.#tenantId, ideas: this.#ideas.size });
+    return report;
+  }
+  async close() {
+    await this.#contentStore.close();
+  }
+  async #debug(entry) {
+    await appendCapabilityDebug("idea-plaza", entry, { root: this.#debugRoot });
+  }
+};
+async function readIdeaPlazaDebug(root = process.cwd(), limit = 20) {
+  return readCapabilityDebug("idea-plaza", { root, limit });
+}
+
+export {
+  IdeaPlaza,
+  readIdeaPlazaDebug,
+  scanForSensitiveFields
+};
+//# sourceMappingURL=chunk-2WSISCFT.js.map

package/dist/chunk-2WSISCFT.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 { assertPublicDisclosureSafe } from \"@nebutra/ecosystem-safety\";\nimport { CapabilityError } from \"@nebutra/errors\";\nimport { EventLog } from \"@nebutra/event-log\";\nimport { assetId } from \"@nebutra/generation-context\";\n\nexport type IdeaPublishLevel = \"surface\" | \"detail\" | \"cloneable\";\nexport type FeedSort = \"hot\" | \"new\" | \"near_you\";\nexport type { SensitiveField } from \"@nebutra/ecosystem-safety\";\nexport { scanForSensitiveFields } from \"@nebutra/ecosystem-safety\";\n\nexport interface CemeteryWarning {\n  readonly title: string;\n  readonly cause: string;\n}\n\nexport interface PublishIdeaRequest {\n  readonly title: string;\n  readonly oneLine: string;\n  readonly level: IdeaPublishLevel;\n  readonly body?: string;\n  readonly tags: readonly string[];\n  readonly redactions?: readonly string[];\n  readonly cemeteryWarnings?: readonly CemeteryWarning[];\n}\n\nexport interface PublishedIdea {\n  readonly ideaId: string;\n  readonly title: string;\n  readonly oneLine: string;\n  readonly level: IdeaPublishLevel;\n  readonly tags: readonly string[];\n  readonly redactions: readonly string[];\n  readonly cemeteryWarnings: readonly CemeteryWarning[];\n  readonly publicationPath: string;\n  readonly eventId: string;\n  readonly publishedAt: string;\n}\n\nexport interface ForkRequest {\n  readonly newFounderId: string;\n  readonly inheritPlayPreferences?: boolean;\n}\n\nexport interface IdeaFork {\n  readonly forkId: string;\n  readonly sourceIdeaId: string;\n  readonly newFounderId: string;\n  readonly inheritPlayPreferences: boolean;\n  readonly attribution: {\n    readonly displayInNewCompany: true;\n    readonly publicLineage: true;\n  };\n  readonly createdAt: string;\n}\n\nexport interface FeedRequest {\n  readonly sort: FeedSort;\n  readonly limit: number;\n}\n\nexport interface IdeaFeed {\n  readonly items: readonly PublishedIdea[];\n}\n\nexport interface IdeaPlazaDoctorReport {\n  readonly capability: \"idea-plaza\";\n  readonly ok: boolean;\n  readonly checkedAt: string;\n  readonly features: readonly string[];\n  readonly suggestion?: string;\n}\n\nexport interface IdeaPlazaOptions {\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(\"idea-plaza\", \"Idea Plaza requires tenant context\", {\n      suggestion: \"Pass tenantId so publish snapshots stay tenant-scoped.\",\n      statusCode: 400,\n    });\n  }\n  return value;\n}\n\nfunction bodyForScan(request: PublishIdeaRequest): string {\n  return [request.title, request.oneLine, request.body ?? \"\", request.tags.join(\" \")].join(\"\\n\");\n}\n\nexport class IdeaPlaza {\n  readonly #tenantId: string;\n  readonly #debugRoot: string;\n  readonly #contentStore: ContentStore;\n  readonly #eventLog: EventLog;\n  readonly #ideas = new Map<string, PublishedIdea>();\n  readonly #forks = new Map<string, IdeaFork>();\n\n  private constructor(\n    options: Required<Pick<IdeaPlazaOptions, \"tenantId\" | \"contentStore\" | \"eventLog\">> &\n      Pick<IdeaPlazaOptions, \"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/idea-plaza\",\n    options: Omit<IdeaPlazaOptions, \"contentStore\" | \"eventLog\"> = {},\n  ): Promise<IdeaPlaza> {\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 IdeaPlaza({ ...options, tenantId, contentStore, eventLog });\n  }\n\n  async publish(request: PublishIdeaRequest): Promise<PublishedIdea> {\n    assertPublicDisclosureSafe({\n      capability: \"idea-plaza\",\n      content: bodyForScan(request),\n      ...(request.redactions !== undefined ? { redactions: request.redactions } : {}),\n      suggestion: \"Review detected private values and pass redactions before publishing.\",\n    });\n\n    const ideaId = assetId(\"idea\", `${request.title}_${request.oneLine}`);\n    const publicationPath = `plaza/ideas/${ideaId}.json`;\n    const publishedAt = new Date().toISOString();\n    const idea: Omit<PublishedIdea, \"eventId\"> = {\n      ideaId,\n      title: request.title,\n      oneLine: request.oneLine,\n      level: request.level,\n      tags: request.tags,\n      redactions: request.redactions ?? [],\n      cemeteryWarnings: request.cemeteryWarnings ?? [],\n      publicationPath,\n      publishedAt,\n    };\n    const snapshot = `${JSON.stringify({ ...idea, body: request.body ?? \"\" }, null, 2)}\\n`;\n    await this.#contentStore.write(publicationPath, snapshot);\n    const eventId = await this.#eventLog.commit({\n      traceId: assetId(\"idea_plaza_publish\", ideaId),\n      kind: \"content_write\",\n      affected: [publicationPath],\n      parent: null,\n      snapshot: { [publicationPath]: snapshot },\n    });\n    const published = { ...idea, eventId };\n    this.#ideas.set(ideaId, published);\n    await this.#debug({ type: \"publish\", tenantId: this.#tenantId, ideaId, level: request.level });\n    return published;\n  }\n\n  async fork(ideaId: string, request: ForkRequest): Promise<IdeaFork> {\n    if (!this.#ideas.has(ideaId)) {\n      throw new CapabilityError(\"idea-plaza\", \"Idea fork source not found\", {\n        suggestion: \"Fork only from an explicit public or cloneable snapshot in the current feed.\",\n        metadata: { ideaId },\n        statusCode: 404,\n      });\n    }\n    const fork: IdeaFork = {\n      forkId: assetId(\"idea_fork\", `${ideaId}_${request.newFounderId}`),\n      sourceIdeaId: ideaId,\n      newFounderId: request.newFounderId,\n      inheritPlayPreferences: request.inheritPlayPreferences ?? false,\n      attribution: {\n        displayInNewCompany: true,\n        publicLineage: true,\n      },\n      createdAt: new Date().toISOString(),\n    };\n    const path = `plaza/forks/${fork.forkId}.json`;\n    const snapshot = `${JSON.stringify(fork, null, 2)}\\n`;\n    await this.#contentStore.write(path, snapshot);\n    await this.#eventLog.commit({\n      traceId: assetId(\"idea_plaza_fork\", fork.forkId),\n      kind: \"content_write\",\n      affected: [path],\n      parent: null,\n      snapshot: { [path]: snapshot },\n    });\n    this.#forks.set(fork.forkId, fork);\n    await this.#debug({ type: \"fork\", tenantId: this.#tenantId, ideaId, forkId: fork.forkId });\n    return fork;\n  }\n\n  async feed(request: FeedRequest): Promise<IdeaFeed> {\n    const items = [...this.#ideas.values()]\n      .sort((left, right) =>\n        request.sort === \"new\"\n          ? right.publishedAt.localeCompare(left.publishedAt)\n          : right.cemeteryWarnings.length - left.cemeteryWarnings.length ||\n            right.publishedAt.localeCompare(left.publishedAt),\n      )\n      .slice(0, request.limit);\n    await this.#debug({ type: \"feed\", tenantId: this.#tenantId, sort: request.sort });\n    return { items };\n  }\n\n  async doctor(): Promise<IdeaPlazaDoctorReport> {\n    const report: IdeaPlazaDoctorReport = {\n      capability: \"idea-plaza\",\n      ok: true,\n      checkedAt: new Date().toISOString(),\n      features: [\"publish\", \"redact\", \"fork-lineage\", \"feed\", \"cemetery-warning\"],\n      suggestion:\n        \"Local snapshots are active; public registry transport and moderation queues remain adapter handoffs.\",\n    };\n    await this.#debug({ type: \"doctor\", tenantId: this.#tenantId, ideas: this.#ideas.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(\"idea-plaza\", entry, { root: this.#debugRoot });\n  }\n}\n\nexport async function readIdeaPlazaDebug(root = process.cwd(), limit = 20): Promise<unknown[]> {\n  return readCapabilityDebug(\"idea-plaza\", { 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,44 @@
+import {
+  IdeaPlaza,
+  readIdeaPlazaDebug
+} from "./chunk-2WSISCFT.js";
+
+// src/cli.ts
+var command = process.argv[2] ?? "doctor";
+var root = process.env.IDEA_PLAZA_ROOT ?? ".nebutra/idea-plaza";
+var tenantId = process.env.NEBUTRA_TENANT_ID ?? "local";
+if (command === "doctor") {
+  const plaza = await IdeaPlaza.open(root, { tenantId });
+  try {
+    process.stdout.write(`${JSON.stringify(await plaza.doctor(), null, 2)}
+`);
+  } finally {
+    await plaza.close();
+  }
+} else if (command === "quickstart") {
+  const plaza = await IdeaPlaza.open(root, { tenantId });
+  try {
+    const idea = await plaza.publish({
+      title: "Loop",
+      oneLine: "AI debugging for indie devs",
+      level: "surface",
+      tags: ["debugging", "developer-tools"]
+    });
+    process.stdout.write(
+      `${JSON.stringify({ idea, feed: await plaza.feed({ sort: "hot", limit: 5 }) }, null, 2)}
+`
+    );
+  } finally {
+    await plaza.close();
+  }
+} else if (command === "debug") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "idea-plaza", entries: await readIdeaPlazaDebug() }, null, 2)}
+`
+  );
+} else {
+  process.stderr.write(`Unknown idea-plaza 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 { IdeaPlaza, readIdeaPlazaDebug } from \"./index\";\n\nconst command = process.argv[2] ?? \"doctor\";\nconst root = process.env.IDEA_PLAZA_ROOT ?? \".nebutra/idea-plaza\";\nconst tenantId = process.env.NEBUTRA_TENANT_ID ?? \"local\";\n\nif (command === \"doctor\") {\n  const plaza = await IdeaPlaza.open(root, { tenantId });\n  try {\n    process.stdout.write(`${JSON.stringify(await plaza.doctor(), null, 2)}\\n`);\n  } finally {\n    await plaza.close();\n  }\n} else if (command === \"quickstart\") {\n  const plaza = await IdeaPlaza.open(root, { tenantId });\n  try {\n    const idea = await plaza.publish({\n      title: \"Loop\",\n      oneLine: \"AI debugging for indie devs\",\n      level: \"surface\",\n      tags: [\"debugging\", \"developer-tools\"],\n    });\n    process.stdout.write(\n      `${JSON.stringify({ idea, feed: await plaza.feed({ sort: \"hot\", limit: 5 }) }, null, 2)}\\n`,\n    );\n  } finally {\n    await plaza.close();\n  }\n} else if (command === \"debug\") {\n  process.stdout.write(\n    `${JSON.stringify({ capability: \"idea-plaza\", entries: await readIdeaPlazaDebug() }, null, 2)}\\n`,\n  );\n} else {\n  process.stderr.write(`Unknown idea-plaza command: ${command}\\n`);\n  process.exitCode = 1;\n}\n"],"mappings":";;;;;;AAEA,IAAM,UAAU,QAAQ,KAAK,CAAC,KAAK;AACnC,IAAM,OAAO,QAAQ,IAAI,mBAAmB;AAC5C,IAAM,WAAW,QAAQ,IAAI,qBAAqB;AAElD,IAAI,YAAY,UAAU;AACxB,QAAM,QAAQ,MAAM,UAAU,KAAK,MAAM,EAAE,SAAS,CAAC;AACrD,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,UAAU,KAAK,MAAM,EAAE,SAAS,CAAC;AACrD,MAAI;AACF,UAAM,OAAO,MAAM,MAAM,QAAQ;AAAA,MAC/B,OAAO;AAAA,MACP,SAAS;AAAA,MACT,OAAO;AAAA,MACP,MAAM,CAAC,aAAa,iBAAiB;AAAA,IACvC,CAAC;AACD,YAAQ,OAAO;AAAA,MACb,GAAG,KAAK,UAAU,EAAE,MAAM,MAAM,MAAM,MAAM,KAAK,EAAE,MAAM,OAAO,OAAO,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA;AAAA,IACzF;AAAA,EACF,UAAE;AACA,UAAM,MAAM,MAAM;AAAA,EACpB;AACF,WAAW,YAAY,SAAS;AAC9B,UAAQ,OAAO;AAAA,IACb,GAAG,KAAK,UAAU,EAAE,YAAY,cAAc,SAAS,MAAM,mBAAmB,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA;AAAA,EAC/F;AACF,OAAO;AACL,UAAQ,OAAO,MAAM,+BAA+B,OAAO;AAAA,CAAI;AAC/D,UAAQ,WAAW;AACrB;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,80 @@
+import { ContentStore } from '@nebutra/content-store';
+import { EventLog } from '@nebutra/event-log';
+export { SensitiveField, scanForSensitiveFields } from '@nebutra/ecosystem-safety';
+
+type IdeaPublishLevel = "surface" | "detail" | "cloneable";
+type FeedSort = "hot" | "new" | "near_you";
+
+interface CemeteryWarning {
+    readonly title: string;
+    readonly cause: string;
+}
+interface PublishIdeaRequest {
+    readonly title: string;
+    readonly oneLine: string;
+    readonly level: IdeaPublishLevel;
+    readonly body?: string;
+    readonly tags: readonly string[];
+    readonly redactions?: readonly string[];
+    readonly cemeteryWarnings?: readonly CemeteryWarning[];
+}
+interface PublishedIdea {
+    readonly ideaId: string;
+    readonly title: string;
+    readonly oneLine: string;
+    readonly level: IdeaPublishLevel;
+    readonly tags: readonly string[];
+    readonly redactions: readonly string[];
+    readonly cemeteryWarnings: readonly CemeteryWarning[];
+    readonly publicationPath: string;
+    readonly eventId: string;
+    readonly publishedAt: string;
+}
+interface ForkRequest {
+    readonly newFounderId: string;
+    readonly inheritPlayPreferences?: boolean;
+}
+interface IdeaFork {
+    readonly forkId: string;
+    readonly sourceIdeaId: string;
+    readonly newFounderId: string;
+    readonly inheritPlayPreferences: boolean;
+    readonly attribution: {
+        readonly displayInNewCompany: true;
+        readonly publicLineage: true;
+    };
+    readonly createdAt: string;
+}
+interface FeedRequest {
+    readonly sort: FeedSort;
+    readonly limit: number;
+}
+interface IdeaFeed {
+    readonly items: readonly PublishedIdea[];
+}
+interface IdeaPlazaDoctorReport {
+    readonly capability: "idea-plaza";
+    readonly ok: boolean;
+    readonly checkedAt: string;
+    readonly features: readonly string[];
+    readonly suggestion?: string;
+}
+interface IdeaPlazaOptions {
+    readonly tenantId?: string;
+    readonly debugRoot?: string;
+    readonly contentStore?: ContentStore;
+    readonly eventLog?: EventLog;
+}
+declare class IdeaPlaza {
+    #private;
+    private constructor();
+    static open(root?: string, options?: Omit<IdeaPlazaOptions, "contentStore" | "eventLog">): Promise<IdeaPlaza>;
+    publish(request: PublishIdeaRequest): Promise<PublishedIdea>;
+    fork(ideaId: string, request: ForkRequest): Promise<IdeaFork>;
+    feed(request: FeedRequest): Promise<IdeaFeed>;
+    doctor(): Promise<IdeaPlazaDoctorReport>;
+    close(): Promise<void>;
+}
+declare function readIdeaPlazaDebug(root?: string, limit?: number): Promise<unknown[]>;
+
+export { type CemeteryWarning, type FeedRequest, type FeedSort, type ForkRequest, type IdeaFeed, type IdeaFork, IdeaPlaza, type IdeaPlazaDoctorReport, type IdeaPlazaOptions, type IdeaPublishLevel, type PublishIdeaRequest, type PublishedIdea, readIdeaPlazaDebug };

package/dist/index.js

@@ -0,0 +1,11 @@
+import {
+  IdeaPlaza,
+  readIdeaPlazaDebug,
+  scanForSensitiveFields
+} from "./chunk-2WSISCFT.js";
+export {
+  IdeaPlaza,
+  readIdeaPlazaDebug,
+  scanForSensitiveFields
+};
+//# 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,9 @@
+import { IdeaPlaza } from "../src/index";
+
+const plaza = await IdeaPlaza.open(".nebutra/idea-plaza-example", { tenantId: "local" });
+
+try {
+  process.stdout.write(`${JSON.stringify(await plaza.doctor(), null, 2)}\n`);
+} finally {
+  await plaza.close();
+}

package/examples/fork.ts

@@ -0,0 +1,19 @@
+import { IdeaPlaza } from "../src/index";
+
+const plaza = await IdeaPlaza.open(".nebutra/idea-plaza-fork-example", { tenantId: "local" });
+
+try {
+  const idea = await plaza.publish({
+    title: "Loop",
+    oneLine: "AI debugging for indie devs",
+    level: "cloneable",
+    tags: ["debugging"],
+  });
+  const fork = await plaza.fork(idea.ideaId, {
+    newFounderId: "bob",
+    inheritPlayPreferences: true,
+  });
+  process.stdout.write(`${JSON.stringify(fork, null, 2)}\n`);
+} finally {
+  await plaza.close();
+}

package/examples/quickstart.ts

@@ -0,0 +1,16 @@
+import { IdeaPlaza } from "../src/index";
+
+const plaza = await IdeaPlaza.open(".nebutra/idea-plaza-example", { tenantId: "local" });
+
+try {
+  const idea = await plaza.publish({
+    title: "Loop",
+    oneLine: "AI debugging for indie devs",
+    level: "surface",
+    body: "A developer tool that explains stack traces as a conversation.",
+    tags: ["debugging", "developer-tools"],
+  });
+  process.stdout.write(`${JSON.stringify(idea, null, 2)}\n`);
+} finally {
+  await plaza.close();
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@nebutra/idea-plaza",
+  "version": "0.1.1",
+  "description": "Explicit opt-in idea publishing, lineage, and fork surface over Nebutra company artifacts",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "nebutra": {
+    "status": "wip",
+    "productionReady": false,
+    "surface": "ecosystem-product",
+    "requires": [
+      "@nebutra/content-store for public snapshots",
+      "@nebutra/event-log for publish and fork checkpoints",
+      "@nebutra/ecosystem-safety for public-disclosure PII and secret checks",
+      "@nebutra/capability-kit for debug and doctor surfaces"
+    ],
+    "gaps": [
+      "Public registry transport is represented as local immutable snapshots",
+      "Moderation is deterministic metadata until human review queues exist",
+      "Cemetery similarity warnings are provided by input contracts until global KB is online"
+    ],
+    "featureId": "idea-plaza",
+    "category": "ai",
+    "summary": "Opt-in public idea snapshot and fork lineage product surface"
+  },
+  "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/ecosystem-safety": "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/idea-plaza#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nebutra/Nebutra-Sailor.git",
+    "directory": "packages/ai/idea-plaza"
+  },
+  "bugs": {
+    "url": "https://github.com/Nebutra/Nebutra-Sailor/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/plays/publish_idea/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: publish_idea
+kind: play
+version: 1.0.0
+description: Publish an explicit, redacted idea snapshot for discovery and fork lineage
+required_skills:
+  - content_store.write
+  - event_log.commit
+sub_agents:
+  - role: privacy_reviewer
+    allowed_skills: [content_store.write]
+depends_on_plays: []
+---
+
+## What this play does
+
+Creates an opt-in public snapshot of an idea with lineage metadata.
+
+## Boundaries
+
+- Default state is private.
+- Any detected sensitive field must be redacted before publishing.
+- Fork attribution remains on so the lineage graph stays trustworthy.

package/src/cli.ts

@@ -0,0 +1,36 @@
+import { IdeaPlaza, readIdeaPlazaDebug } from "./index";
+
+const command = process.argv[2] ?? "doctor";
+const root = process.env.IDEA_PLAZA_ROOT ?? ".nebutra/idea-plaza";
+const tenantId = process.env.NEBUTRA_TENANT_ID ?? "local";
+
+if (command === "doctor") {
+  const plaza = await IdeaPlaza.open(root, { tenantId });
+  try {
+    process.stdout.write(`${JSON.stringify(await plaza.doctor(), null, 2)}\n`);
+  } finally {
+    await plaza.close();
+  }
+} else if (command === "quickstart") {
+  const plaza = await IdeaPlaza.open(root, { tenantId });
+  try {
+    const idea = await plaza.publish({
+      title: "Loop",
+      oneLine: "AI debugging for indie devs",
+      level: "surface",
+      tags: ["debugging", "developer-tools"],
+    });
+    process.stdout.write(
+      `${JSON.stringify({ idea, feed: await plaza.feed({ sort: "hot", limit: 5 }) }, null, 2)}\n`,
+    );
+  } finally {
+    await plaza.close();
+  }
+} else if (command === "debug") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "idea-plaza", entries: await readIdeaPlazaDebug() }, null, 2)}\n`,
+  );
+} else {
+  process.stderr.write(`Unknown idea-plaza command: ${command}\n`);
+  process.exitCode = 1;
+}

package/src/index.test.ts

@@ -0,0 +1,73 @@
+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 { IdeaPlaza, readIdeaPlazaDebug, scanForSensitiveFields } from "./index";
+
+let root: string | undefined;
+let plaza: IdeaPlaza | undefined;
+
+afterEach(async () => {
+  if (plaza) await plaza.close();
+  if (root) await rm(root, { recursive: true, force: true });
+  root = undefined;
+  plaza = undefined;
+});
+
+async function open(): Promise<IdeaPlaza> {
+  root = await mkdtemp(join(tmpdir(), "idea-plaza-"));
+  plaza = await IdeaPlaza.open(root, { tenantId: "tenant_a" });
+  return plaza;
+}
+
+describe("idea-plaza", () => {
+  it("blocks opt-in publish when sensitive data is not explicitly redacted", async () => {
+    const runtime = await open();
+
+    await expect(
+      runtime.publish({
+        title: "Loop",
+        oneLine: "AI debugging",
+        level: "detail",
+        body: "Contact alice@example.com with api key sk-test-1234567890",
+        tags: ["debugging"],
+      }),
+    ).rejects.toMatchObject({
+      capability: "idea-plaza",
+      suggestion: expect.stringContaining("redact"),
+    });
+  });
+
+  it("publishes explicit snapshots and preserves fork attribution", async () => {
+    const runtime = await open();
+    const published = await runtime.publish({
+      title: "Loop",
+      oneLine: "AI debugging",
+      level: "cloneable",
+      body: "Developer tool for stack trace conversations.",
+      tags: ["debugging", "developer-tools"],
+      redactions: ["customers", "finances"],
+      cemeteryWarnings: [{ title: "DebugMate", cause: "no PMF" }],
+    });
+
+    const fork = await runtime.fork(published.ideaId, {
+      newFounderId: "bob",
+      inheritPlayPreferences: true,
+    });
+    const feed = await runtime.feed({ sort: "hot", limit: 10 });
+
+    expect(published.publicationPath).toBe(`plaza/ideas/${published.ideaId}.json`);
+    expect(published.cemeteryWarnings).toHaveLength(1);
+    expect(fork.attribution.publicLineage).toBe(true);
+    expect(fork.sourceIdeaId).toBe(published.ideaId);
+    expect(feed.items.map((item) => item.ideaId)).toContain(published.ideaId);
+  });
+
+  it("keeps PII detection deterministic and auditable", async () => {
+    expect(scanForSensitiveFields("email me at a@example.com")).toEqual([
+      { kind: "email", value: "a@example.com" },
+    ]);
+    await open();
+    await expect(readIdeaPlazaDebug(root)).resolves.toEqual(expect.any(Array));
+  });
+});