@cotrrackpro-dev/sdk 0.1.0

package/dist/community/events.d.ts

@@ -0,0 +1,30 @@
+/**
+ * XP events — the contributions the community recognizes, as a typed contract.
+ * This is a RECOGNITION layer: XP and badges celebrate contribution and inform a
+ * maintainer's tier decision; they do NOT automatically grant tiers or scopes
+ * (those stay human-provisioned + server-enforced, see tiers.ts). No backend
+ * ledger exists yet — `totalXp` lets tools score a known set of events offline.
+ *
+ * Referral note: `invite-accepted` recognizes a referral who actually joins. The web
+ * + CLI invite links carry a `ref` (see site/assets/invite.js, `cotrackpro community
+ * invite`), and the onboarding backend receives it at signup. When a server-side ledger
+ * exists, that backend should credit the REFERRER's `invite-accepted` automatically;
+ * until then `cotrackpro community log invite-accepted` is the manual self-report path.
+ */
+export type XpEventId = "first-setup" | "complete-quickstart" | "publish-package" | "ship-project" | "contribute-template" | "merge-pr" | "answer-help" | "submit-showcase" | "invite-accepted";
+export type XpCategory = "onboarding" | "build" | "contribute" | "community";
+export interface XpEvent {
+    id: XpEventId;
+    label: string;
+    xp: number;
+    category: XpCategory;
+    /** Can it be earned more than once (and count each time)? */
+    repeatable: boolean;
+}
+export declare const XP_EVENT_IDS: XpEventId[];
+export declare const XP_EVENTS: Record<XpEventId, XpEvent>;
+/**
+ * Score a known set of events. Non-repeatable events count at most once.
+ * Recognition only — never a scope/tier grant.
+ */
+export declare function totalXp(counts: Partial<Record<XpEventId, number>>): number;

package/dist/community/events.js

@@ -0,0 +1,31 @@
+export const XP_EVENT_IDS = [
+    "first-setup", "complete-quickstart", "publish-package", "ship-project",
+    "contribute-template", "merge-pr", "answer-help", "submit-showcase", "invite-accepted",
+];
+export const XP_EVENTS = {
+    "first-setup": { id: "first-setup", label: "Completed setup", xp: 10, category: "onboarding", repeatable: false },
+    "complete-quickstart": { id: "complete-quickstart", label: "Finished the quickstart", xp: 15, category: "onboarding", repeatable: false },
+    "publish-package": { id: "publish-package", label: "Published a package", xp: 50, category: "build", repeatable: true },
+    "ship-project": { id: "ship-project", label: "Shipped a project from a blueprint", xp: 40, category: "build", repeatable: true },
+    "contribute-template": { id: "contribute-template", label: "Contributed a parameter set or blueprint", xp: 30, category: "contribute", repeatable: true },
+    "merge-pr": { id: "merge-pr", label: "Had a pull request merged", xp: 25, category: "contribute", repeatable: true },
+    "answer-help": { id: "answer-help", label: "Answered a community question", xp: 10, category: "community", repeatable: true },
+    "submit-showcase": { id: "submit-showcase", label: "Added a tool to the Showcase", xp: 20, category: "community", repeatable: true },
+    "invite-accepted": { id: "invite-accepted", label: "Invited someone who joined the community", xp: 25, category: "community", repeatable: true },
+};
+/**
+ * Score a known set of events. Non-repeatable events count at most once.
+ * Recognition only — never a scope/tier grant.
+ */
+export function totalXp(counts) {
+    let xp = 0;
+    for (const id of XP_EVENT_IDS) {
+        const n = counts[id] ?? 0;
+        if (n <= 0)
+            continue;
+        const e = XP_EVENTS[id];
+        xp += e.xp * (e.repeatable ? n : 1);
+    }
+    return xp;
+}
+//# sourceMappingURL=events.js.map

package/dist/community/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/community/events.ts"],"names":[],"mappings":"AAmCA,MAAM,CAAC,MAAM,YAAY,GAAgB;IACvC,aAAa,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,cAAc;IACvE,qBAAqB,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB;CACvF,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAA+B;IACnD,aAAa,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE;IACjH,qBAAqB,EAAE,EAAE,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,yBAAyB,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE;IACzI,iBAAiB,EAAE,EAAE,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE;IACvH,cAAc,EAAE,EAAE,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,oCAAoC,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE;IAChI,qBAAqB,EAAE,EAAE,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,0CAA0C,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE;IACzJ,UAAU,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,2BAA2B,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE;IACpH,aAAa,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,+BAA+B,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE;IAC7H,iBAAiB,EAAE,EAAE,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,8BAA8B,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE;IACpI,iBAAiB,EAAE,EAAE,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,0CAA0C,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE;CACjJ,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,MAA0C;IAChE,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QACrB,MAAM,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;QACxB,EAAE,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/community/identity.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The Clerk-sourced identity a consumer resolves for a developer-community member.
+ * This is the SHAPE only — Clerk is the source of truth and the backend enforces;
+ * the CLI/SDK/Slack/antigravity all read this same shape from a verified JWT so
+ * authorization is consistent across surfaces. Import-free (types only).
+ */
+import type { TierId } from "./types.js";
+export interface CommunityIdentity {
+    /** Clerk user id. */
+    userId: string;
+    /** Membership tier — Clerk `publicMetadata.tier` (Explorer → Maintainer). */
+    tier: TierId;
+    /** Clerk org role within the Developers org, e.g. "org:member" | "org:admin". */
+    orgRole?: string;
+    /** Cumulative org-permissions the JWT carries (`org:<feature>:<action>`). */
+    permissions?: string[];
+    /** Linked GitHub username — grants repo / proposer access (antigravity). */
+    githubUsername?: string;
+    /** Linked Slack user id — used to provision the tier's channels. */
+    slackUserId?: string;
+}
+/** The Clerk JWT claims every consumer authorizes against (template in the dashboard). */
+export interface CommunityJwtClaims {
+    org_id: string;
+    org_role: string;
+    org_permissions: string[];
+    tier: TierId;
+}

package/dist/community/identity.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=identity.js.map

package/dist/community/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/community/identity.ts"],"names":[],"mappings":""}

package/dist/community/index.d.ts

@@ -0,0 +1,7 @@
+/** Developer-community contract: the typed tier registry + cumulative helpers. */
+export * from "./types.js";
+export * from "./tiers.js";
+export * from "./events.js";
+export * from "./badges.js";
+export * from "./org.js";
+export * from "./identity.js";

package/dist/community/index.js

@@ -0,0 +1,8 @@
+/** Developer-community contract: the typed tier registry + cumulative helpers. */
+export * from "./types.js";
+export * from "./tiers.js";
+export * from "./events.js";
+export * from "./badges.js";
+export * from "./org.js";
+export * from "./identity.js";
+//# sourceMappingURL=index.js.map

package/dist/community/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/community/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/community/org.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The developer-community membership contract: the Clerk Organization it maps to,
+ * the roles a person can SELECT when joining, and the org-permission ↔ scope
+ * identity. Declarative only — Clerk + the backend enforce; this is the shared
+ * shape the CLI, the portal, the Slack app, and the antigravity GitHub component
+ * all read so nobody re-invents the mapping. Import-free (types only).
+ */
+import type { TierId } from "./types.js";
+/**
+ * The Clerk Organization that represents developer-community membership. Native
+ * Clerk org-permissions use the same `org:<feature>:<action>` shape as cotrackpro
+ * scopes, so the mapping is an IDENTITY — do not translate (see ORG_PERMISSIONS).
+ * New members join here at Explorer; their tier lives in `publicMetadata.tier`.
+ */
+export declare const DEVELOPERS_ORG: {
+    readonly slug: "cotrackpro-developers";
+    readonly label: "CoTrackPro Developers";
+    readonly defaultTier: TierId;
+};
+/** The org-permission strings that also ARE cotrackpro scopes (1:1, no translation). */
+export declare const ORG_PERMISSIONS: readonly ["org:packages:read", "org:packages:publish", "org:registry:admin", "org:keys:manage"];
+export type OrgPermission = (typeof ORG_PERMISSIONS)[number];
+/** A selectable "developer community" role — what a person picks when they join. */
+export interface CommunityRole {
+    id: string;
+    label: string;
+    blurb: string;
+    /** Everyone starts at Explorer; tier progression is human-reviewed (see tiers.ts). */
+    startTier: TierId;
+}
+export declare const COMMUNITY_ROLES: CommunityRole[];
+export declare const COMMUNITY_ROLE_IDS: string[];
+/** The three converging ways to select the developer-community role. */
+export declare const JOIN_ENTRY_POINTS: readonly [{
+    readonly id: "web";
+    readonly label: "Sign up on the web";
+    readonly detail: "developer.cotrackpro.com → sign in → choose “Developer community”. Self-serve; starts you at Explorer.";
+}, {
+    readonly id: "github";
+    readonly label: "Apply on GitHub";
+    readonly detail: "Open the developer-community application issue; a maintainer provisions your Clerk identity + tier.";
+}, {
+    readonly id: "cli";
+    readonly label: "From the CLI";
+    readonly detail: "`cotrackpro community join` explains the role, tiers, and the link steps.";
+}];

package/dist/community/org.js

@@ -0,0 +1,32 @@
+/**
+ * The Clerk Organization that represents developer-community membership. Native
+ * Clerk org-permissions use the same `org:<feature>:<action>` shape as cotrackpro
+ * scopes, so the mapping is an IDENTITY — do not translate (see ORG_PERMISSIONS).
+ * New members join here at Explorer; their tier lives in `publicMetadata.tier`.
+ */
+export const DEVELOPERS_ORG = {
+    slug: "cotrackpro-developers",
+    label: "CoTrackPro Developers",
+    defaultTier: "explorer",
+};
+/** The org-permission strings that also ARE cotrackpro scopes (1:1, no translation). */
+export const ORG_PERMISSIONS = [
+    "org:packages:read",
+    "org:packages:publish",
+    "org:registry:admin",
+    "org:keys:manage",
+];
+export const COMMUNITY_ROLES = [
+    { id: "developer", label: "Developer", blurb: "Build tools and contribute code on the CLI and SDK.", startTier: "explorer" },
+    { id: "solution-builder", label: "Solution builder", blurb: "Assemble solutions for organizations or clients.", startTier: "explorer" },
+    { id: "researcher", label: "Researcher / faculty", blurb: "Study or teach with the catalog and the platform tools.", startTier: "explorer" },
+    { id: "student", label: "Student / intern", blurb: "Learn by building real, child-centered tools.", startTier: "explorer" },
+];
+export const COMMUNITY_ROLE_IDS = COMMUNITY_ROLES.map((r) => r.id);
+/** The three converging ways to select the developer-community role. */
+export const JOIN_ENTRY_POINTS = [
+    { id: "web", label: "Sign up on the web", detail: "developer.cotrackpro.com → sign in → choose “Developer community”. Self-serve; starts you at Explorer." },
+    { id: "github", label: "Apply on GitHub", detail: "Open the developer-community application issue; a maintainer provisions your Clerk identity + tier." },
+    { id: "cli", label: "From the CLI", detail: "`cotrackpro community join` explains the role, tiers, and the link steps." },
+];
+//# sourceMappingURL=org.js.map

package/dist/community/org.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"org.js","sourceRoot":"","sources":["../../src/community/org.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,uBAAuB;IAC7B,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EAAE,UAAoB;CACzB,CAAC;AAEX,wFAAwF;AACxF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,mBAAmB;IACnB,sBAAsB;IACtB,oBAAoB;IACpB,iBAAiB;CACT,CAAC;AAYX,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,qDAAqD,EAAE,SAAS,EAAE,UAAU,EAAE;IAC5H,EAAE,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,kDAAkD,EAAE,SAAS,EAAE,UAAU,EAAE;IACvI,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,yDAAyD,EAAE,SAAS,EAAE,UAAU,EAAE;IAC5I,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,+CAA+C,EAAE,SAAS,EAAE,UAAU,EAAE;CAC5H,CAAC;AACF,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEnE,wEAAwE;AACxE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,wGAAwG,EAAE;IAC5J,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,qGAAqG,EAAE;IACzJ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,2EAA2E,EAAE;CACjH,CAAC"}

package/dist/community/tiers.d.ts

@@ -0,0 +1,8 @@
+/** The developer-community tiers (authored contract — the source of truth). */
+import type { Tier, TierId } from "./types.js";
+export declare const TIER_IDS: TierId[];
+export declare const TIERS: Record<TierId, Tier>;
+/** All scopes available AT OR BELOW a tier (cumulative, deduped, declarative). */
+export declare function scopesForTier(id: TierId): string[];
+/** All Slack channels a member of this tier can see (cumulative). */
+export declare function channelsForTier(id: TierId): string[];

package/dist/community/tiers.js

@@ -0,0 +1,40 @@
+export const TIER_IDS = ["explorer", "builder", "scholar", "maintainer"];
+export const TIERS = {
+    explorer: {
+        id: "explorer", label: "Explorer", order: 1, applyable: true,
+        slackAdds: ["#general", "#help", "#announcements"],
+        scopes: [],
+        capability: "Browse the public catalog",
+    },
+    builder: {
+        id: "builder", label: "Builder", order: 2, applyable: true,
+        slackAdds: ["#builders", "#show-and-tell"],
+        scopes: ["org:packages:read"],
+        capability: "Build with the SDK against a sandbox org",
+    },
+    scholar: {
+        id: "scholar", label: "Scholar", order: 3, applyable: false,
+        slackAdds: ["#rfcs", "#scholars"],
+        scopes: [],
+        capability: "Propose changes via PRs; read sensitive summaries",
+    },
+    maintainer: {
+        id: "maintainer", label: "Maintainer", order: 4, applyable: false,
+        slackAdds: ["#triage", "private maintainer channels"],
+        scopes: ["org:packages:publish", "org:registry:admin"],
+        capability: "Publish packages, review & merge, scoped registry admin",
+    },
+};
+const upTo = (id) => {
+    const order = TIERS[id].order;
+    return TIER_IDS.map((t) => TIERS[t]).filter((t) => t.order <= order);
+};
+/** All scopes available AT OR BELOW a tier (cumulative, deduped, declarative). */
+export function scopesForTier(id) {
+    return [...new Set(upTo(id).flatMap((t) => t.scopes))];
+}
+/** All Slack channels a member of this tier can see (cumulative). */
+export function channelsForTier(id) {
+    return upTo(id).flatMap((t) => t.slackAdds);
+}
+//# sourceMappingURL=tiers.js.map

package/dist/community/tiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiers.js","sourceRoot":"","sources":["../../src/community/tiers.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,QAAQ,GAAa,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AAEnF,MAAM,CAAC,MAAM,KAAK,GAAyB;IACzC,QAAQ,EAAE;QACR,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI;QAC5D,SAAS,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,gBAAgB,CAAC;QAClD,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,2BAA2B;KACxC;IACD,OAAO,EAAE;QACP,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI;QAC1D,SAAS,EAAE,CAAC,WAAW,EAAE,gBAAgB,CAAC;QAC1C,MAAM,EAAE,CAAC,mBAAmB,CAAC;QAC7B,UAAU,EAAE,0CAA0C;KACvD;IACD,OAAO,EAAE;QACP,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK;QAC3D,SAAS,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;QACjC,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,mDAAmD;KAChE;IACD,UAAU,EAAE;QACV,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK;QACjE,SAAS,EAAE,CAAC,SAAS,EAAE,6BAA6B,CAAC;QACrD,MAAM,EAAE,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;QACtD,UAAU,EAAE,yDAAyD;KACtE;CACF,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,EAAU,EAAU,EAAE;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC;IAC9B,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;AACvE,CAAC,CAAC;AAEF,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAC9C,CAAC"}

package/dist/community/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Developer-community tier contract. The single typed source of truth for the
+ * membership tiers shown on the Join page, exposed by `cotrackpro community`,
+ * and provisioned against by the backend + the `cotrackpro-slack` app.
+ *
+ * IMPORTANT: tiers DECLARE which RBAC scopes and Slack channels they map to —
+ * they do not grant anything. Enforcement is server-side (Clerk identity + the
+ * gated-access broker); the CLI/SDK never grant scopes from a tier. Tiers also
+ * never unlock confidential family-case data — that is a separate professional
+ * role axis. Import-free so the portal and the Slack app can share it.
+ */
+export type TierId = "explorer" | "builder" | "scholar" | "maintainer";
+export interface Tier {
+    id: TierId;
+    label: string;
+    /** 1..4 — Explorer is lowest, Maintainer highest. */
+    order: number;
+    /** Can a new member apply directly at this tier? (Scholar/Maintainer are earned.) */
+    applyable: boolean;
+    /** Slack channels ADDED at this tier, on top of lower tiers. */
+    slackAdds: string[];
+    /** RBAC scopes this tier maps to — declarative, enforced server-side. */
+    scopes: string[];
+    /** One line: the building capability this tier unlocks. */
+    capability: string;
+}

package/dist/community/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/community/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/community/types.ts"],"names":[],"mappings":""}

package/dist/core/config.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Platform-agnostic config resolution.
+ *
+ * Mirrors the precedence in the CLI's `src/lib/config.ts`
+ * (flag → env → project → user → default) but takes its inputs as plain layers
+ * so it is not tied to `process.env` or the filesystem — a browser app, an edge
+ * function, or an Antigravity agent can supply layers however it likes.
+ */
+export declare const DEFAULT_BASE_URL = "https://api.cotrackpro.com";
+export interface ConfigLayer {
+    baseUrl?: string;
+    org?: string | null;
+}
+export interface ResolvedSdkConfig {
+    baseUrl: string;
+    org: string | null;
+}
+/**
+ * Resolve config from highest-priority layer first. Earlier layers win.
+ * Typical order: [flags, env, projectConfig, userConfig].
+ */
+export declare function resolveSdkConfig(...layers: Array<ConfigLayer | undefined>): ResolvedSdkConfig;

package/dist/core/config.js

@@ -0,0 +1,27 @@
+/**
+ * Platform-agnostic config resolution.
+ *
+ * Mirrors the precedence in the CLI's `src/lib/config.ts`
+ * (flag → env → project → user → default) but takes its inputs as plain layers
+ * so it is not tied to `process.env` or the filesystem — a browser app, an edge
+ * function, or an Antigravity agent can supply layers however it likes.
+ */
+export const DEFAULT_BASE_URL = "https://api.cotrackpro.com";
+/**
+ * Resolve config from highest-priority layer first. Earlier layers win.
+ * Typical order: [flags, env, projectConfig, userConfig].
+ */
+export function resolveSdkConfig(...layers) {
+    let baseUrl;
+    let org;
+    for (const layer of layers) {
+        if (!layer)
+            continue;
+        if (baseUrl === undefined && layer.baseUrl)
+            baseUrl = layer.baseUrl;
+        if (org === undefined && layer.org !== undefined)
+            org = layer.org;
+    }
+    return { baseUrl: baseUrl ?? DEFAULT_BASE_URL, org: org ?? null };
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AAY7D;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAG,MAAsC;IACxE,IAAI,OAA2B,CAAC;IAChC,IAAI,GAA8B,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,IAAI,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO;YAAE,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QACpE,IAAI,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;YAAE,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,GAAG,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;AACpE,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Framework-agnostic error type for every CoTrackPro API interaction.
+ *
+ * This is the shape the CLI's `CliError` wraps (see `src/lib/errors.ts`), but it
+ * carries no Node/CLI assumptions so it works unchanged in browsers, edge
+ * runtimes, and agent/IDE hosts (e.g. Antigravity).
+ */
+export interface CotrackproErrorInit {
+    /** Stable machine code, e.g. "unauthenticated", "forbidden", "network", "http_500". */
+    code: string;
+    message: string;
+    /** HTTP status when the error originated from a response. */
+    status?: number;
+    /** Server request id (x-request-id) for support/debugging. */
+    requestId?: string;
+    /** RBAC permission the caller was missing, when code is "forbidden". */
+    requiredPermission?: string;
+    /** Org slug the request was scoped to, when relevant. */
+    org?: string | null;
+}
+export declare class CotrackproError extends Error {
+    readonly code: string;
+    readonly status?: number;
+    readonly requestId?: string;
+    readonly requiredPermission?: string;
+    readonly org: string | null;
+    constructor(init: CotrackproErrorInit);
+}
+export declare function isCotrackproError(e: unknown): e is CotrackproError;

package/dist/core/errors.js

@@ -0,0 +1,20 @@
+export class CotrackproError extends Error {
+    code;
+    status;
+    requestId;
+    requiredPermission;
+    org;
+    constructor(init) {
+        super(init.message);
+        this.name = "CotrackproError";
+        this.code = init.code;
+        this.status = init.status;
+        this.requestId = init.requestId;
+        this.requiredPermission = init.requiredPermission;
+        this.org = init.org ?? null;
+    }
+}
+export function isCotrackproError(e) {
+    return e instanceof CotrackproError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IACb,MAAM,CAAU;IAChB,SAAS,CAAU;IACnB,kBAAkB,CAAU;IAC5B,GAAG,CAAgB;IAE5B,YAAY,IAAyB;QACnC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,CAAC;QAClD,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,CAAU;IAC1C,OAAO,CAAC,YAAY,eAAe,CAAC;AACtC,CAAC"}

package/dist/core/transport.d.ts

@@ -0,0 +1,45 @@
+/** A `fetch`-compatible function. Injectable so the SDK runs anywhere. */
+export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+export interface TransportConfig {
+    baseUrl: string;
+    /** API prefix appended after baseUrl. Defaults to the CLI API surface. */
+    basePath?: string;
+    /** Override the fetch implementation (defaults to global `fetch`). */
+    fetch?: FetchLike;
+    /** Max retries for idempotent requests on network errors / 5xx. Default 2. */
+    retries?: number;
+    /** Base backoff in ms (doubled each attempt). Default 200. */
+    retryBaseMs?: number;
+    /**
+     * Per-request timeout in ms. A hung connection would otherwise hang the CLI
+     * forever (Node's fetch has no default timeout). `0` disables it. Default 30000.
+     */
+    timeoutMs?: number;
+}
+export interface RequestParams {
+    path: string;
+    method?: string;
+    body?: unknown;
+    /** Org slug for the `x-cotrackpro-org` header. Falsy = header omitted. */
+    org?: string | null;
+    /** Bearer token. Falsy = no Authorization header. */
+    token?: string | null;
+    headers?: Record<string, string>;
+}
+/**
+ * Low-level HTTP transport. Generalizes the CLI's hand-rolled `api()`
+ * (`src/lib/http.ts`): `/cli/v1` base path, `x-cotrackpro-org` scoping,
+ * `x-request-id` capture, `{ data }` unwrapping, and a uniform error model —
+ * now with retry-with-backoff for idempotent requests.
+ */
+export declare class Transport {
+    private readonly baseUrl;
+    private readonly basePath;
+    private readonly fetchImpl;
+    private readonly retries;
+    private readonly retryBaseMs;
+    private readonly timeoutMs;
+    constructor(cfg: TransportConfig);
+    request<T>(p: RequestParams): Promise<T>;
+    private backoff;
+}

package/dist/core/transport.js

@@ -0,0 +1,109 @@
+import { CotrackproError } from "./errors.js";
+const DEFAULT_BASE_PATH = "/cli/v1";
+/**
+ * Low-level HTTP transport. Generalizes the CLI's hand-rolled `api()`
+ * (`src/lib/http.ts`): `/cli/v1` base path, `x-cotrackpro-org` scoping,
+ * `x-request-id` capture, `{ data }` unwrapping, and a uniform error model —
+ * now with retry-with-backoff for idempotent requests.
+ */
+export class Transport {
+    baseUrl;
+    basePath;
+    fetchImpl;
+    retries;
+    retryBaseMs;
+    timeoutMs;
+    constructor(cfg) {
+        this.baseUrl = cfg.baseUrl.replace(/\/+$/, "");
+        this.basePath = cfg.basePath ?? DEFAULT_BASE_PATH;
+        const f = cfg.fetch ?? globalThis.fetch;
+        if (!f) {
+            throw new CotrackproError({
+                code: "config_error",
+                message: "No fetch implementation available; pass `fetch` to createClient().",
+            });
+        }
+        this.fetchImpl = f;
+        this.retries = cfg.retries ?? 2;
+        this.retryBaseMs = cfg.retryBaseMs ?? 200;
+        this.timeoutMs = cfg.timeoutMs ?? 30000;
+    }
+    async request(p) {
+        const headers = { "content-type": "application/json", ...p.headers };
+        if (p.token)
+            headers.authorization = `Bearer ${p.token}`;
+        if (p.org)
+            headers["x-cotrackpro-org"] = p.org;
+        const url = `${this.baseUrl}${this.basePath}${p.path}`;
+        const method = p.method ?? "GET";
+        const bodyInit = p.body !== undefined ? JSON.stringify(p.body) : undefined;
+        // Only retry requests with no side effects to avoid duplicate writes.
+        const idempotent = method === "GET" || method === "HEAD";
+        let attempt = 0;
+        for (;;) {
+            // A fresh controller per attempt: an aborted signal can't be reused, and a
+            // retry needs its own timeout window.
+            const controller = new AbortController();
+            const timer = this.timeoutMs > 0 ? setTimeout(() => controller.abort(), this.timeoutMs) : undefined;
+            const canRetry = idempotent && attempt < this.retries;
+            let res;
+            let text;
+            try {
+                res = await this.fetchImpl(url, { method, headers, body: bodyInit, signal: controller.signal });
+                // Read the body inside the same timeout window — a stalled body stream is
+                // just as much a hang as a stalled connection.
+                text = await res.text();
+            }
+            catch (e) {
+                const timedOut = controller.signal.aborted;
+                if (timer)
+                    clearTimeout(timer);
+                if (canRetry) {
+                    await delay(this.backoff(attempt));
+                    attempt++;
+                    continue;
+                }
+                throw new CotrackproError({
+                    code: "network",
+                    message: timedOut ? `Request timed out after ${this.timeoutMs}ms` : `Network error: ${e.message}`,
+                });
+            }
+            if (timer)
+                clearTimeout(timer);
+            const requestId = res.headers.get("x-request-id") ?? undefined;
+            const json = text ? safeJson(text) : undefined;
+            if (!res.ok) {
+                if (idempotent && res.status >= 500 && attempt < this.retries) {
+                    await delay(this.backoff(attempt));
+                    attempt++;
+                    continue;
+                }
+                const err = json?.error ?? {};
+                throw new CotrackproError({
+                    code: err.code ?? `http_${res.status}`,
+                    message: err.message ?? `Request failed (${res.status})`,
+                    status: res.status,
+                    requestId,
+                    requiredPermission: err.requiredPermission,
+                    org: err.org ?? null,
+                });
+            }
+            return (json?.data ?? json);
+        }
+    }
+    backoff(attempt) {
+        return this.retryBaseMs * 2 ** attempt;
+    }
+}
+function safeJson(s) {
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return undefined;
+    }
+}
+function delay(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=transport.js.map

package/dist/core/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/core/transport.ts"],"names":[],"mappings":"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"}

package/dist/diagram/core.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Browser-safe barrel for the diagram engine. Import-free by construction so
+ * the compiled output loads directly in the portal builder — the CLI and the
+ * portal share the exact extract/render/validate logic. Keep it that way (an
+ * SDK test enforces no external imports).
+ */
+export * from "./types.js";
+export * from "./extract.js";
+export * from "./mermaid.js";
+export * from "./validate.js";
+export * from "./prompt.js";

package/dist/diagram/core.js

@@ -0,0 +1,12 @@
+/**
+ * Browser-safe barrel for the diagram engine. Import-free by construction so
+ * the compiled output loads directly in the portal builder — the CLI and the
+ * portal share the exact extract/render/validate logic. Keep it that way (an
+ * SDK test enforces no external imports).
+ */
+export * from "./types.js";
+export * from "./extract.js";
+export * from "./mermaid.js";
+export * from "./validate.js";
+export * from "./prompt.js";
+//# sourceMappingURL=core.js.map

package/dist/diagram/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/diagram/core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/diagram/extract.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Deterministic logic extraction: turn a document (or a parameter set) into a
+ * flowchart. No AI, no deps — heuristic but predictable, so the same input
+ * always yields the same diagram. Free-prose refinement is a manual edit in the
+ * builder (or an optional AI-assist pass documented separately).
+ */
+import type { Diagram, Direction } from "./types.js";
+import type { ParamSet } from "../params/types.js";
+/** Extract a flowchart from free-ish text (steps, if/then/else, and decision branches). */
+export declare function extractFromText(text: string, opts?: {
+    direction?: Direction;
+    title?: string;
+}): Diagram;
+/** Extract a data-collection flowchart from a parameter set (the builder logic). */
+export declare function extractFromParamSet(set: ParamSet, opts?: {
+    direction?: Direction;
+}): Diagram;