@calibrate-ds/cli 0.1.0

package/dist/utils/gitignore.js

@@ -0,0 +1,67 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+// Standard entries every JS/TS project should ignore
+const STANDARD = [
+    "node_modules/",
+    "dist/",
+    "build/",
+    ".env",
+    ".env.local",
+    ".env.*.local",
+    "*.log",
+    ".DS_Store",
+    "coverage/",
+];
+// PTB-specific entries — only the heavy/ephemeral parts of .ptb/.
+// .ptb/context/ and .ptb/manifest.json are intentionally NOT ignored so teams
+// can commit them and use ptb without Figma access.
+const PTB_REQUIRED = [
+    ".ptb/latest.json",
+    ".ptb/history/",
+    ".ptb/imported-tokens.json",
+    "*.ptb-meta.json",
+];
+// Storybook build artifacts
+const STORYBOOK = [
+    "storybook-static/",
+    "*.storybook.log",
+];
+const ALL_REQUIRED = [...STANDARD, ...PTB_REQUIRED, ...STORYBOOK];
+/** Remove PTB-added entries from .gitignore (used by ptb remove). */
+export async function removePtbGitignoreEntries(cwd) {
+    const gitignorePath = path.join(cwd, ".gitignore");
+    let existing = "";
+    try {
+        existing = await fs.readFile(gitignorePath, "utf-8");
+    }
+    catch {
+        return;
+    }
+    const ptbEntries = new Set([...PTB_REQUIRED, ...STORYBOOK]);
+    const lines = existing.split("\n");
+    const filtered = lines.filter(l => !ptbEntries.has(l.trim()));
+    if (filtered.length === lines.length)
+        return;
+    await fs.writeFile(gitignorePath, filtered.join("\n"), "utf-8");
+}
+export async function ensureGitignore(cwd) {
+    const gitignorePath = path.join(cwd, ".gitignore");
+    let existing = "";
+    try {
+        existing = await fs.readFile(gitignorePath, "utf-8");
+    }
+    catch { /* ok */ }
+    // Migrate legacy blanket ignore if present
+    if (existing.split("\n").map(l => l.trim()).includes(".ptb/")) {
+        existing = existing.split("\n").filter(l => l.trim() !== ".ptb/").join("\n");
+        if (!existing.endsWith("\n"))
+            existing += "\n";
+    }
+    const currentLines = existing.split("\n").map(l => l.trim());
+    const toAdd = ALL_REQUIRED.filter(e => !currentLines.includes(e));
+    if (toAdd.length === 0)
+        return;
+    const prefix = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+    await fs.writeFile(gitignorePath, existing + prefix + toAdd.join("\n") + "\n", "utf-8");
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/utils/gitignore.js.map

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

package/dist/utils/lock-changes.d.ts

@@ -0,0 +1,14 @@
+import type { PTBLock } from "@calibrate-ds/core";
+export type LockChangeEvent = "component added" | "component removed" | "stamped" | "design changed";
+export type LockChange = {
+    event: LockChangeEvent;
+    displayName: string;
+    /** Populated for "stamped" events — who stamped it (from lock entry). */
+    stampedBy?: string;
+};
+/**
+ * Compare two ptb.lock snapshots and return what changed.
+ * Order: additions → stamp updates → design changes → removals.
+ */
+export declare function detectLockChanges(current: PTBLock, previous: PTBLock): LockChange[];
+//# sourceMappingURL=lock-changes.d.ts.map

package/dist/utils/lock-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-changes.d.ts","sourceRoot":"","sources":["../../src/utils/lock-changes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,SAAS,GAAG,gBAAgB,CAAC;AAErG,MAAM,MAAM,UAAU,GAAG;IACrB,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,UAAU,EAAE,CAqBnF"}

package/dist/utils/lock-changes.js

@@ -0,0 +1,26 @@
+/**
+ * Compare two ptb.lock snapshots and return what changed.
+ * Order: additions → stamp updates → design changes → removals.
+ */
+export function detectLockChanges(current, previous) {
+    const changes = [];
+    for (const [slug, entry] of Object.entries(current.components)) {
+        const prev = previous.components[slug];
+        if (!prev) {
+            changes.push({ event: "component added", displayName: entry.displayName });
+        }
+        else if (entry.stampedHash !== prev.stampedHash && entry.stampedHash) {
+            changes.push({ event: "stamped", displayName: entry.displayName, stampedBy: entry.stampedBy });
+        }
+        else if (entry.designHash !== prev.designHash) {
+            changes.push({ event: "design changed", displayName: entry.displayName });
+        }
+    }
+    for (const [slug, prev] of Object.entries(previous.components)) {
+        if (!current.components[slug]) {
+            changes.push({ event: "component removed", displayName: prev.displayName });
+        }
+    }
+    return changes;
+}
+//# sourceMappingURL=lock-changes.js.map

package/dist/utils/lock-changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-changes.js","sourceRoot":"","sources":["../../src/utils/lock-changes.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAgB,EAAE,QAAiB;IACjE,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/E,CAAC;aAAM,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACrE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QACnG,CAAC;aAAM,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9E,CAAC;IACL,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7D,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAChF,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,9 @@
+export declare function redact(msg: unknown): string;
+export declare const logger: {
+    info: (msg: unknown) => void;
+    success: (msg: unknown) => void;
+    warn: (msg: unknown) => void;
+    error: (msg: unknown) => void;
+    dim: (msg: unknown) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAuB3C;AAED,eAAO,MAAM,MAAM;gBACH,OAAO;mBACJ,OAAO;gBACV,OAAO;iBACN,OAAO;eACT,OAAO;CACrB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,32 @@
+const REDACTED = "[REDACTED]";
+export function redact(msg) {
+    let strMsg;
+    if (typeof msg === "string") {
+        strMsg = msg;
+    }
+    else if (msg instanceof Error) {
+        strMsg = msg.stack || msg.message;
+    }
+    else {
+        try {
+            strMsg = JSON.stringify(msg, null, 2);
+        }
+        catch {
+            strMsg = String(msg);
+        }
+    }
+    // Redact Figma tokens (e.g. figd_..., figa_...)
+    strMsg = strMsg.replace(/(?:figd|figa)_[a-zA-Z0-9\-_]+/g, REDACTED);
+    // Redact Authorization and X-Figma-Token headers if someone logs a header object explicitly
+    strMsg = strMsg.replace(/(["']?authorization["']?\s*:\s*["'][Bb]earer\s+)[^"'\s]+(["']?)/gi, `$1${REDACTED}$2`);
+    strMsg = strMsg.replace(/(["']?x-figma-token["']?\s*:\s*["'])[^"'\s]+(["']?)/gi, `$1${REDACTED}$2`);
+    return strMsg;
+}
+export const logger = {
+    info: (msg) => console.log(`\x1b[34mℹ\x1b[0m ${redact(msg)}`),
+    success: (msg) => console.log(`\x1b[32m✔\x1b[0m ${redact(msg)}`),
+    warn: (msg) => console.log(`\x1b[33m⚠\x1b[0m ${redact(msg)}`),
+    error: (msg) => console.error(`\x1b[31m✖\x1b[0m ${redact(msg)}`),
+    dim: (msg) => console.log(`\x1b[90m${redact(msg)}\x1b[0m`),
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,MAAM,UAAU,MAAM,CAAC,GAAY;IAC/B,IAAI,MAAc,CAAC;IAEnB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,CAAC;IACjB,CAAC;SAAM,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC;IACtC,CAAC;SAAM,CAAC;QACJ,IAAI,CAAC;YACD,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACL,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;IAED,gDAAgD;IAChD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,gCAAgC,EAAE,QAAQ,CAAC,CAAC;IAEpE,4FAA4F;IAC5F,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,mEAAmE,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC;IAChH,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,uDAAuD,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC;IAEpG,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB,IAAI,EAAE,CAAC,GAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACtE,OAAO,EAAE,CAAC,GAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACzE,IAAI,EAAE,CAAC,GAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACtE,KAAK,EAAE,CAAC,GAAY,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACzE,GAAG,EAAE,CAAC,GAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;CACtE,CAAC"}

package/dist/utils/permissions.d.ts

@@ -0,0 +1,17 @@
+import type { TeamRole } from "./team-roster.js";
+/** Returns true if the role can assign a component to someone other than themselves. */
+export declare function canAssignToOther(myRole: TeamRole): boolean;
+/** Returns true if targetHandle resolves to the same person as myHandle. */
+export declare function isSelfAssign(targetHandle: string, myHandle: string | undefined): boolean;
+/**
+ * Returns true if the current user can clear the given assignment.
+ * Leads can always clear. Members can only clear their own.
+ */
+export declare function canClearAssignment(myRole: TeamRole, assignedTo: string, myHandle: string | undefined): boolean;
+/**
+ * Returns true if the current user can stamp this component.
+ * Leads can always stamp. Members can stamp unassigned components
+ * or components assigned to themselves.
+ */
+export declare function canStampComponent(myRole: TeamRole, assignedTo: string | undefined, myHandle: string | undefined): boolean;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/utils/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/utils/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAE1D;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAMxF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,QAAQ,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAIT;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,QAAQ,EAChB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAKT"}

package/dist/utils/permissions.js

@@ -0,0 +1,37 @@
+/** Returns true if the role can assign a component to someone other than themselves. */
+export function canAssignToOther(myRole) {
+    return myRole === "lead";
+}
+/** Returns true if targetHandle resolves to the same person as myHandle. */
+export function isSelfAssign(targetHandle, myHandle) {
+    if (!myHandle)
+        return false;
+    return (targetHandle.replace(/^@/, "").toLowerCase() ===
+        myHandle.replace(/^@/, "").toLowerCase());
+}
+/**
+ * Returns true if the current user can clear the given assignment.
+ * Leads can always clear. Members can only clear their own.
+ */
+export function canClearAssignment(myRole, assignedTo, myHandle) {
+    if (myRole === "lead")
+        return true;
+    if (!myHandle)
+        return false;
+    return assignedTo === myHandle;
+}
+/**
+ * Returns true if the current user can stamp this component.
+ * Leads can always stamp. Members can stamp unassigned components
+ * or components assigned to themselves.
+ */
+export function canStampComponent(myRole, assignedTo, myHandle) {
+    if (myRole === "lead")
+        return true;
+    if (!assignedTo)
+        return true;
+    if (!myHandle)
+        return false;
+    return assignedTo === myHandle;
+}
+//# sourceMappingURL=permissions.js.map

package/dist/utils/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/utils/permissions.ts"],"names":[],"mappings":"AAEA,wFAAwF;AACxF,MAAM,UAAU,gBAAgB,CAAC,MAAgB;IAC7C,OAAO,MAAM,KAAK,MAAM,CAAC;AAC7B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAAC,YAAoB,EAAE,QAA4B;IAC3E,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,CACH,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE;QAC5C,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAC3C,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAC9B,MAAgB,EAChB,UAAkB,EAClB,QAA4B;IAE5B,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,UAAU,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC7B,MAAgB,EAChB,UAA8B,EAC9B,QAA4B;IAE5B,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,UAAU,KAAK,QAAQ,CAAC;AACnC,CAAC"}

package/dist/utils/status-logic.d.ts

@@ -0,0 +1,16 @@
+import type { PTBLock, PTBLockEntry } from "@calibrate-ds/core";
+export type ComponentStatusValue = "ready" | "stale" | "not-implemented";
+/** Derive the implementation status of a single lock entry. */
+export declare function computeComponentStatus(entry: PTBLockEntry): ComponentStatusValue;
+/** Aggregate ready/stale/notImplemented counts across an entire lock. */
+export declare function computeStatusSummary(lock: PTBLock): {
+    ready: number;
+    stale: number;
+    notImplemented: number;
+};
+/**
+ * Returns true if the given assignedTo string resolves to the given handle.
+ * Strips leading @ before comparing.
+ */
+export declare function isAssignedToHandle(assignedTo: string | undefined, handle: string): boolean;
+//# sourceMappingURL=status-logic.d.ts.map

package/dist/utils/status-logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-logic.d.ts","sourceRoot":"","sources":["../../src/utils/status-logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEhE,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,OAAO,GAAG,iBAAiB,CAAC;AAEzE,+DAA+D;AAC/D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,oBAAoB,CAIhF;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CAC1B,CASA;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAC9B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,MAAM,EAAE,MAAM,GACf,OAAO,CAGT"}

package/dist/utils/status-logic.js

@@ -0,0 +1,32 @@
+/** Derive the implementation status of a single lock entry. */
+export function computeComponentStatus(entry) {
+    if (!entry.stampedHash)
+        return "not-implemented";
+    if (entry.stampedHash === entry.designHash)
+        return "ready";
+    return "stale";
+}
+/** Aggregate ready/stale/notImplemented counts across an entire lock. */
+export function computeStatusSummary(lock) {
+    let ready = 0, stale = 0, notImplemented = 0;
+    for (const entry of Object.values(lock.components)) {
+        const s = computeComponentStatus(entry);
+        if (s === "ready")
+            ready++;
+        else if (s === "stale")
+            stale++;
+        else
+            notImplemented++;
+    }
+    return { ready, stale, notImplemented };
+}
+/**
+ * Returns true if the given assignedTo string resolves to the given handle.
+ * Strips leading @ before comparing.
+ */
+export function isAssignedToHandle(assignedTo, handle) {
+    if (!assignedTo)
+        return false;
+    return assignedTo.replace(/^@/, "").toLowerCase() === handle.toLowerCase();
+}
+//# sourceMappingURL=status-logic.js.map

package/dist/utils/status-logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-logic.js","sourceRoot":"","sources":["../../src/utils/status-logic.ts"],"names":[],"mappings":"AAIA,+DAA+D;AAC/D,MAAM,UAAU,sBAAsB,CAAC,KAAmB;IACtD,IAAI,CAAC,KAAK,CAAC,WAAW;QAAE,OAAO,iBAAiB,CAAC;IACjD,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,UAAU;QAAE,OAAO,OAAO,CAAC;IAC3D,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAK9C,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,cAAc,GAAG,CAAC,CAAC;IAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,OAAO;YAAE,KAAK,EAAE,CAAC;aACtB,IAAI,CAAC,KAAK,OAAO;YAAE,KAAK,EAAE,CAAC;;YAC3B,cAAc,EAAE,CAAC;IAC1B,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAC9B,UAA8B,EAC9B,MAAc;IAEd,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;AAC/E,CAAC"}

package/dist/utils/storybook-setup.d.ts

@@ -0,0 +1,5 @@
+import type { PTBConfig } from "@calibrate-ds/shared-types";
+export declare function ensureStorybookSetup(config: PTBConfig, options?: {
+    force?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=storybook-setup.d.ts.map

package/dist/utils/storybook-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storybook-setup.d.ts","sourceRoot":"","sources":["../../src/utils/storybook-setup.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAW5D,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+F1G"}

package/dist/utils/storybook-setup.js

@@ -0,0 +1,104 @@
+import { resolveDSPaths, setupStorybook, patchStorybookStories, detectPackageManager, checkStorybookReadiness, detectBundler } from "@calibrate-ds/core";
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { spawnSync } from "node:child_process";
+import * as path from "node:path";
+import * as fs from "node:fs/promises";
+import { logger } from "./logger.js";
+import { getFramework, storybookPackageFor } from "./framework-registry.js";
+const C = {
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    cyan: "\x1b[36m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    reset: "\x1b[0m",
+};
+export async function ensureStorybookSetup(config, options) {
+    const { packageRoot, workspaceRoot, componentsDir } = resolveDSPaths(config);
+    const force = options?.force ?? false;
+    // Skip entirely if the target package directory has no package.json yet
+    // (e.g. user ran ptb init before creating packages/ui)
+    const pkgJsonExists = await fs.access(path.join(packageRoot, "package.json")).then(() => true).catch(() => false);
+    if (!pkgJsonExists) {
+        logger.dim(`  Storybook setup skipped — ${path.relative(workspaceRoot, packageRoot) || "."} has no package.json yet. Run 'ptb document component <name>' after setting up the package.`);
+        return;
+    }
+    // Check prerequisites BEFORE touching .storybook/ — creating it before init causes
+    // Storybook 10 to ask "force initialization?" and picks the wrong framework.
+    const readiness = await checkStorybookReadiness(packageRoot);
+    if (readiness.nodeModulesExist && readiness.reactInstalled && readiness.storybookInstalled) {
+        // Storybook already installed — safe to write/update our config files now
+        const bundler = await detectBundler(packageRoot);
+        const fw = getFramework(config.framework.name);
+        const frameworkPkg = fw ? (storybookPackageFor(fw, bundler) ?? undefined) : undefined;
+        const sbResult = await setupStorybook(packageRoot, componentsDir, force, frameworkPkg);
+        if (sbResult.created.length > 0) {
+            logger.info(`\n  ${C.yellow}Storybook config updated.${C.reset}`);
+            for (const f of sbResult.created)
+                logger.success(`  Written: ${f}`);
+        }
+        else if (sbResult.skipped.length > 0) {
+            logger.dim(`  Storybook config preserved (${sbResult.skipped.join(", ")}). Use --force to overwrite.`);
+        }
+        logger.success(`  Storybook installed and configured.`);
+        return;
+    }
+    const pm = await detectPackageManager(packageRoot);
+    const relDir = path.relative(workspaceRoot, packageRoot) || ".";
+    const cdCmd = relDir !== "." ? `cd ${relDir}` : "";
+    const steps = [];
+    if (!readiness.nodeModulesExist || !readiness.reactInstalled) {
+        steps.push({ label: "Install package dependencies", cmd: `${pm} install` });
+    }
+    if (!readiness.storybookInstalled) {
+        // --no-dev: Storybook 10 launches a dev server after init; --no-dev prevents the hang
+        steps.push({ label: "Initialize Storybook", cmd: `npx storybook@latest init --no-dev`, isStorybookInit: true });
+    }
+    if (steps.length === 0)
+        return;
+    console.log(`\n  ${C.bold}Storybook setup needed${C.reset}${cdCmd ? `  ${C.dim}(inside ${relDir}/)${C.reset}` : ""}:\n`);
+    steps.forEach((step, i) => {
+        console.log(`  ${C.dim}${i + 1}.${C.reset}  ${step.label}`);
+        console.log(`      ${C.cyan}${cdCmd ? `${cdCmd} && ` : ""}${step.cmd}${C.reset}`);
+        if (step.isStorybookInit) {
+            console.log(`      ${C.dim}PTB will update the stories glob in .storybook/main.ts after init.${C.reset}`);
+        }
+        console.log();
+    });
+    if (!process.stdout.isTTY)
+        return;
+    const rl = createInterface({ input, output });
+    const answer = await rl.question(`  Run these steps now? (Y/n) `).finally(() => rl.close());
+    if (answer.trim().toLowerCase() === "n") {
+        logger.dim("  Skipped. You can run 'ptb document component <name>' later to trigger setup again.");
+        return;
+    }
+    for (const step of steps) {
+        console.log(`\n  ${C.dim}▶ ${step.cmd}${C.reset}\n`);
+        const result = spawnSync(step.cmd, {
+            cwd: packageRoot,
+            stdio: "inherit",
+            shell: true,
+        });
+        if (result.status !== 0) {
+            logger.warn(`  Step failed — fix the error above then re-run 'ptb document component <name>'.`);
+            return;
+        }
+        if (step.isStorybookInit) {
+            // Remove Storybook's example stories scaffold — PTB manages its own stories
+            const exampleDirs = ["src/stories", "stories"].map(d => path.join(packageRoot, d));
+            for (const dir of exampleDirs) {
+                await fs.rm(dir, { recursive: true, force: true }).catch(() => { });
+            }
+            // Patch only the stories glob — don't overwrite Storybook's auto-detected framework/builder
+            logger.dim("\n  Updating stories glob in .storybook/main.ts...");
+            const patched = await patchStorybookStories(packageRoot, componentsDir);
+            if (patched) {
+                logger.success("  .storybook/main.ts updated with correct stories glob.");
+            }
+        }
+    }
+    console.log(`\n  ${C.green}✔${C.reset}  Storybook is ready. Start it with: ${C.cyan}${cdCmd ? `${cdCmd} && ` : ""}npx storybook dev${C.reset}\n`);
+}
+//# sourceMappingURL=storybook-setup.js.map

package/dist/utils/storybook-setup.js.map

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

package/dist/utils/team-roster.d.ts

@@ -0,0 +1,35 @@
+export type TeamRole = "lead" | "member";
+export type TeamMember = {
+    name: string;
+    email: string;
+    handle: string;
+    joinedAt: string;
+    role: TeamRole;
+};
+export type TeamRoster = {
+    members: Record<string, TeamMember>;
+};
+export declare function toHandle(name: string): string;
+export declare function getGitUser(): {
+    name: string;
+    email: string;
+} | undefined;
+export declare function readRoster(workspaceRoot: string): Promise<TeamRoster>;
+export declare function writeRoster(workspaceRoot: string, roster: TeamRoster): Promise<void>;
+/** Find a member by exact handle, email, or name. */
+export declare function findMember(query: string, roster: TeamRoster): TeamMember | undefined;
+/**
+ * Find the closest matching member when exact match fails.
+ * Returns the member and distance only if within the threshold (default 2 edits).
+ */
+export declare function findClosestMember(query: string, roster: TeamRoster, maxDistance?: number): {
+    member: TeamMember;
+    distance: number;
+} | undefined;
+/** Get the role of the current git user in the roster.
+ *  Falls back to "lead" for empty/un-roled rosters (solo/bootstrap).
+ *  Falls back to "member" for users not in the roster — never returns undefined. */
+export declare function getCurrentUserRole(roster: TeamRoster): TeamRole;
+/** Returns true if a ptb.lock assignedTo string matches this member. */
+export declare function memberMatchesAssignee(member: TeamMember, assignedTo: string): boolean;
+//# sourceMappingURL=team-roster.d.ts.map

package/dist/utils/team-roster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-roster.d.ts","sourceRoot":"","sources":["../../src/utils/team-roster.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzC,MAAM,MAAM,UAAU,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;CAClB,CAAC;AAGF,MAAM,MAAM,UAAU,GAAG;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACvC,CAAC;AAEF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,UAAU,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CASxE;AAED,wBAAsB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAe3E;AAED,wBAAsB,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1F;AAeD,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAOpF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,UAAU,EAClB,WAAW,SAAI,GAChB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CActD;AAED;;oFAEoF;AACpF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAiB/D;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAKrF"}

package/dist/utils/team-roster.js

@@ -0,0 +1,99 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { execSync } from "node:child_process";
+export function toHandle(name) {
+    return name.toLowerCase().trim().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+}
+export function getGitUser() {
+    try {
+        const name = execSync("git config user.name", { encoding: "utf-8" }).trim();
+        const email = execSync("git config user.email", { encoding: "utf-8" }).trim();
+        if (!name || !email)
+            return undefined;
+        return { name, email };
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function readRoster(workspaceRoot) {
+    const rosterPath = path.join(workspaceRoot, "ptb-team.json");
+    try {
+        const raw = JSON.parse(await fs.readFile(rosterPath, "utf-8"));
+        // Migrate legacy array format → object keyed by email.
+        // Two people joining on separate branches now touch different keys → clean git merge.
+        if (Array.isArray(raw.members)) {
+            const obj = {};
+            for (const m of raw.members)
+                obj[m.email] = m;
+            return { members: obj };
+        }
+        return raw;
+    }
+    catch {
+        return { members: {} };
+    }
+}
+export async function writeRoster(workspaceRoot, roster) {
+    const rosterPath = path.join(workspaceRoot, "ptb-team.json");
+    await fs.writeFile(rosterPath, JSON.stringify(roster, null, 2) + "\n", "utf-8");
+}
+function levenshtein(a, b) {
+    const m = a.length, n = b.length;
+    const dp = Array.from({ length: m + 1 }, (_, i) => Array.from({ length: n + 1 }, (__, j) => (i === 0 ? j : j === 0 ? i : 0)));
+    for (let i = 1; i <= m; i++)
+        for (let j = 1; j <= n; j++)
+            dp[i][j] = a[i - 1] === b[j - 1]
+                ? dp[i - 1][j - 1]
+                : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+    return dp[m][n];
+}
+/** Find a member by exact handle, email, or name. */
+export function findMember(query, roster) {
+    const q = query.replace(/^@/, "").toLowerCase();
+    return Object.values(roster.members).find(m => m.handle === q ||
+        m.email.toLowerCase() === q ||
+        m.name.toLowerCase() === q);
+}
+/**
+ * Find the closest matching member when exact match fails.
+ * Returns the member and distance only if within the threshold (default 2 edits).
+ */
+export function findClosestMember(query, roster, maxDistance = 2) {
+    const q = query.replace(/^@/, "").toLowerCase();
+    let best;
+    for (const m of Object.values(roster.members)) {
+        const d = Math.min(levenshtein(q, m.handle), levenshtein(q, m.name.toLowerCase()), levenshtein(q, m.email.toLowerCase().split("@")[0]));
+        if (d <= maxDistance && (!best || d < best.distance)) {
+            best = { member: m, distance: d };
+        }
+    }
+    return best;
+}
+/** Get the role of the current git user in the roster.
+ *  Falls back to "lead" for empty/un-roled rosters (solo/bootstrap).
+ *  Falls back to "member" for users not in the roster — never returns undefined. */
+export function getCurrentUserRole(roster) {
+    const values = Object.values(roster.members);
+    // Empty roster or no roles set — treat as lead so solo devs are never locked out
+    const anyRoleSet = values.some(m => m.role);
+    if (!anyRoleSet || values.length === 0)
+        return "lead";
+    const user = getGitUser();
+    if (!user)
+        return "member";
+    const member = roster.members[user.email];
+    // Member exists but has no role (joined before roles were introduced) — treat as lead
+    if (member && !member.role)
+        return "lead";
+    // Not in the roster → safe default is member, not undefined
+    return member?.role ?? "member";
+}
+/** Returns true if a ptb.lock assignedTo string matches this member. */
+export function memberMatchesAssignee(member, assignedTo) {
+    const val = assignedTo.replace(/^@/, "").toLowerCase();
+    return member.handle === val ||
+        member.email.toLowerCase() === val ||
+        member.name.toLowerCase() === val;
+}
+//# sourceMappingURL=team-roster.js.map

package/dist/utils/team-roster.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@calibrate-ds/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "ptb": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "commander": "^14.0.3",
+    "openai": "^6.34.0",
+    "zod": "^4.3.6",
+    "@calibrate-ds/core": "0.1.0",
+    "@calibrate-ds/figma-client": "0.1.0",
+    "@calibrate-ds/shared-types": "0.1.0",
+    "@calibrate-ds/generator-react": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.5",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.3",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "clean": "rm -rf dist",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}