@calibrate-ds/cli 0.1.0

package/dist/commands/prune.js

@@ -0,0 +1,95 @@
+import { loadConfig, loadLatestSnapshot, loadManifest, saveManifest, getGenerator, resolveDSPaths, } from "@calibrate-ds/core";
+import { logger } from "../utils/logger.js";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+export async function pruneCommand() {
+    try {
+        logger.info("Loading ptb.config.json...");
+        const config = await loadConfig();
+        logger.info("Loading latest snapshot...");
+        const currentModel = await loadLatestSnapshot(config);
+        if (!currentModel) {
+            logger.warn("No current snapshot found. Please run 'ptb scan' first to establish a baseline.");
+            return;
+        }
+        logger.info("Reading manifest...");
+        const manifest = await loadManifest(config);
+        if (Object.keys(manifest.components).length === 0) {
+            logger.info("Manifest is empty. Nothing to prune.");
+            return;
+        }
+        // Identify stale components (present in manifest but missing from current Figma model)
+        const staleEntries = [];
+        for (const [id, data] of Object.entries(manifest.components)) {
+            const stillExists = currentModel.components.some(c => c.id === id);
+            if (!stillExists) {
+                staleEntries.push({ id, data });
+            }
+        }
+        if (staleEntries.length === 0) {
+            logger.info("No stale artifacts to prune.");
+            return;
+        }
+        console.log(`\nFound ${staleEntries.length} stale component${staleEntries.length > 1 ? "s" : ""}:`);
+        for (const entry of staleEntries) {
+            console.log(`  - ${entry.data.name}`);
+        }
+        console.log("");
+        const generator = getGenerator(config.framework.name || "react");
+        const result = await generator.pruneComponents(config, staleEntries);
+        if (result.deleted.length > 0) {
+            console.log(`\x1b[1mDeleted:\x1b[0m`);
+            for (const name of result.deleted) {
+                console.log(`  - ${name}`);
+            }
+            console.log("");
+            // Update manifest for deleted components
+            for (const entry of staleEntries) {
+                if (result.deleted.includes(entry.data.name)) {
+                    delete manifest.components[entry.id];
+                }
+            }
+            await saveManifest(config, manifest);
+            // Also remove stale entries from ptb.lock so they don't linger in status
+            const { workspaceRoot } = resolveDSPaths(config);
+            const lockPath = path.join(workspaceRoot, "ptb.lock");
+            try {
+                const lock = JSON.parse(await fs.readFile(lockPath, "utf-8"));
+                let lockChanged = false;
+                for (const entry of staleEntries) {
+                    if (!result.deleted.includes(entry.data.name))
+                        continue;
+                    const slug = entry.data.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+                    if (lock.components?.[slug]) {
+                        delete lock.components[slug];
+                        lockChanged = true;
+                    }
+                }
+                if (lockChanged) {
+                    await fs.writeFile(lockPath, JSON.stringify(lock, null, 2) + "\n", "utf-8");
+                    logger.dim("  ptb.lock updated — stale entries removed.");
+                }
+            }
+            catch { /* no ptb.lock yet — nothing to clean */ }
+        }
+        if (result.skipped.length > 0) {
+            console.log(`\x1b[1mSkipped:\x1b[0m`);
+            for (const info of result.skipped) {
+                console.log(`  - ${info}`);
+            }
+            console.log("");
+        }
+        if (result.errors.length > 0) {
+            logger.error("Pruning errors encountered:");
+            for (const err of result.errors) {
+                console.log(`  - ${err}`);
+            }
+        }
+        logger.success("Prune complete.");
+    }
+    catch (error) {
+        logger.error(error.message || String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=prune.js.map

package/dist/commands/prune.js.map

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

package/dist/commands/remove.d.ts

@@ -0,0 +1,2 @@
+export declare function removeCommand(): Promise<void>;
+//# sourceMappingURL=remove.d.ts.map

package/dist/commands/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../src/commands/remove.ts"],"names":[],"mappings":"AAuBA,wBAAsB,aAAa,kBA+DlC"}

package/dist/commands/remove.js

@@ -0,0 +1,76 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as readline from "node:readline";
+import { loadConfig, resolveDSPaths } from "@calibrate-ds/core";
+import { logger } from "../utils/logger.js";
+import { removePtbGitignoreEntries } from "../utils/gitignore.js";
+import { readRoster, getCurrentUserRole } from "../utils/team-roster.js";
+function ask(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise(resolve => rl.question(question, ans => { rl.close(); resolve(ans.trim()); }));
+}
+async function removeIfExists(filePath, label) {
+    try {
+        await fs.rm(filePath, { recursive: true, force: true });
+        logger.dim(`  Removed: ${label}`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function removeCommand() {
+    const cwd = process.cwd();
+    const configPath = path.join(cwd, "ptb.config.json");
+    const configExists = await fs.access(configPath).then(() => true).catch(() => false);
+    if (!configExists) {
+        logger.warn("No ptb.config.json found. PTB does not appear to be initialized here.");
+        return;
+    }
+    // Only leads can remove PTB from the project
+    const config = await loadConfig().catch(() => null);
+    if (config) {
+        const { workspaceRoot } = resolveDSPaths(config);
+        const roster = await readRoster(workspaceRoot);
+        const myRole = getCurrentUserRole(roster);
+        if (myRole !== "lead") {
+            logger.error("Only leads can remove PTB from a project.");
+            logger.dim("  Ask a lead to run: ptb remove");
+            process.exit(1);
+        }
+    }
+    console.log("\n  \x1b[33mThis will remove all PTB configuration and metadata from this project:\x1b[0m");
+    console.log("  \x1b[2m• ptb.config.json\x1b[0m");
+    console.log("  \x1b[2m• ptb.lock\x1b[0m");
+    console.log("  \x1b[2m• ptb-team.json\x1b[0m");
+    console.log("  \x1b[2m• .ptb/ folder\x1b[0m");
+    console.log("  \x1b[2m• .github/workflows/ptb.yml\x1b[0m");
+    console.log("  \x1b[2m• PTB entries in .gitignore\x1b[0m");
+    console.log("\n  \x1b[2mYour component files, tokens, and stories are NOT touched — those are yours.\x1b[0m");
+    console.log("  \x1b[2mTo set PTB up again, run: ptb init\x1b[0m\n");
+    if (!process.stdout.isTTY) {
+        logger.error("Non-interactive environment — aborting. Run this command in a terminal.");
+        process.exit(1);
+    }
+    const answer = await ask("  \x1b[1mRemove PTB from this project? (y/N)\x1b[0m ");
+    if (answer.toLowerCase() !== "y") {
+        logger.info("Cancelled.");
+        return;
+    }
+    console.log();
+    await removeIfExists(configPath, "ptb.config.json");
+    await removeIfExists(path.join(cwd, "ptb.lock"), "ptb.lock");
+    await removeIfExists(path.join(cwd, "ptb-team.json"), "ptb-team.json");
+    await removeIfExists(path.join(cwd, ".ptb"), ".ptb/");
+    const workflowPath = path.join(cwd, ".github", "workflows", "ptb.yml");
+    const workflowExists = await fs.access(workflowPath).then(() => true).catch(() => false);
+    if (workflowExists) {
+        await removeIfExists(workflowPath, ".github/workflows/ptb.yml");
+    }
+    await removePtbGitignoreEntries(cwd).catch(() => { });
+    console.log();
+    logger.success("PTB removed.");
+    logger.dim("  Run 'ptb init' to start over.");
+    console.log();
+}
+//# sourceMappingURL=remove.js.map

package/dist/commands/remove.js.map

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

package/dist/commands/scaffold.d.ts

@@ -0,0 +1,2 @@
+export declare function scaffoldCommand(): Promise<void>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/commands/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/commands/scaffold.ts"],"names":[],"mappings":"AAaA,wBAAsB,eAAe,kBAmDpC"}

package/dist/commands/scaffold.js

@@ -0,0 +1,47 @@
+import { loadConfig, scanFigmaFile, buildDesignSystemModel, buildComponentRegistry, buildFileMappings, buildScaffoldPlan, resolveTokenSource, getGenerator } from "@ptb/core";
+import { getFigmaFile } from "@ptb/figma-client";
+import { logger } from "../utils/logger.js";
+export async function scaffoldCommand() {
+    try {
+        logger.info("Loading config...");
+        const config = await loadConfig();
+        const token = process.env[config.designTool.accessTokenEnv];
+        if (!token) {
+            throw new Error(`Missing Figma access token. Please set ${config.designTool.accessTokenEnv}.`);
+        }
+        logger.info("Fetching and scanning Figma file...");
+        const figmaFile = await getFigmaFile({
+            fileKey: config.designTool.fileKey,
+            token
+        });
+        const rawScanResult = scanFigmaFile(config.designTool.fileKey, figmaFile);
+        logger.info("Resolving token source...");
+        const tokenResolution = await resolveTokenSource(config, token);
+        logger.info("Building Models and Registry...");
+        const model = buildDesignSystemModel(rawScanResult, tokenResolution.tokens);
+        const registry = buildComponentRegistry(model);
+        logger.info("Planning scaffold...");
+        const mappings = buildFileMappings(model, config);
+        const plan = buildScaffoldPlan(model, config, mappings);
+        logger.info("Writing output safely to disk...");
+        const generator = getGenerator(config.framework.name || "react");
+        const report = await generator.writeScaffold({
+            config,
+            model,
+            registry: registry,
+            graph: registry.graph,
+            mappings,
+            plan
+        });
+        logger.success("Scaffold generated successfully!");
+        logger.dim(`- Metadata written: ${report.writtenMetadataFiles.length} files`);
+        logger.dim(`- Directories created: ${report.createdDirectories.length}`);
+        logger.dim(`- Files created (new): ${report.createdFiles.length}`);
+        logger.dim(`- Files skipped (existing): ${report.skippedFiles.length}`);
+    }
+    catch (error) {
+        logger.error(error.message || String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/commands/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/commands/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,UAAU,EACV,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,eAAe;IACjC,IAAI,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;QAElC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,CAAC,UAAU,CAAC,cAAc,GAAG,CAAC,CAAC;QACnG,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC;YACjC,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO;YAClC,KAAK;SACR,CAAC,CAAC;QAEH,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAE1E,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACzC,MAAM,eAAe,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAEhE,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,sBAAsB,CAAC,aAAa,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;QAC5E,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAE/C,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAExD,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAEhD,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,aAAa,CAAC;YACzC,MAAM;YACN,KAAK;YACL,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,QAAQ;YACR,IAAI;SACP,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;QACnD,MAAM,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,oBAAoB,CAAC,MAAM,QAAQ,CAAC,CAAC;QAC9E,MAAM,CAAC,GAAG,CAAC,0BAA0B,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,GAAG,CAAC,0BAA0B,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,GAAG,CAAC,+BAA+B,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IAE5E,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC"}

package/dist/commands/scan.d.ts

@@ -0,0 +1,2 @@
+export declare function scanCommand(): Promise<void>;
+//# sourceMappingURL=scan.d.ts.map

package/dist/commands/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AAYA,wBAAsB,WAAW,kBA2FhC"}

package/dist/commands/scan.js

@@ -0,0 +1,91 @@
+import { loadConfig, resolveTokenSource, exportAllComponentContexts, loadManifest, resolveDSPaths, enrichIconsWithSvg, getDesignToolAdapter, saveSnapshot } from "@calibrate-ds/core";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as readline from "node:readline";
+import { logger } from "../utils/logger.js";
+function ask(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise(resolve => rl.question(question, ans => { rl.close(); resolve(ans.trim()); }));
+}
+export async function scanCommand() {
+    try {
+        logger.info("Loading ptb.config.json...");
+        const config = await loadConfig();
+        const { provider, fileKey, accessTokenEnv } = config.designTool;
+        // Warn if there are unimplemented/stale components — scanning will overwrite the diff
+        if (process.stdout.isTTY) {
+            const { workspaceRoot } = resolveDSPaths(config);
+            const lockPath = path.join(workspaceRoot, "ptb.lock");
+            try {
+                const lock = JSON.parse(await fs.readFile(lockPath, "utf-8"));
+                const pending = Object.values(lock.components).filter(e => !e.stampedHash || e.stampedHash !== e.designHash);
+                if (pending.length > 0) {
+                    logger.warn(`You have ${pending.length} component(s) with unimplemented design changes.`);
+                    logger.dim("  Scanning now will overwrite the current diff baseline.");
+                    const answer = await ask("  Continue scanning? (Y/n) ");
+                    if (answer.toLowerCase() === "n") {
+                        logger.info("Scan cancelled. Run 'ptb diff' to review pending changes.");
+                        return;
+                    }
+                }
+            }
+            catch { /* no ptb.lock yet — first scan, proceed */ }
+        }
+        const accessToken = process.env[accessTokenEnv];
+        if (!accessToken) {
+            throw new Error(`Missing design tool access token. Please set ${accessTokenEnv} in your environment.`);
+        }
+        if (fileKey === "YOUR_FIGMA_FILE_KEY" || !fileKey) {
+            throw new Error("Please update your ptb.config.json with a valid design tool fileKey.");
+        }
+        const adapter = getDesignToolAdapter(provider);
+        logger.info(`Fetching ${provider} file ${fileKey}...`);
+        logger.info("Scanning design document...");
+        const model = await adapter.scanDesignFile({ fileKey, accessToken });
+        logger.info("Resolving token source...");
+        const tokenResolution = await resolveTokenSource(config, accessToken);
+        switch (tokenResolution.source) {
+            case "rest":
+                logger.info("Using REST variables for tokens.");
+                break;
+            case "imported":
+                logger.info("Using imported token export from .ptb/imported-tokens.json.");
+                break;
+            case "none":
+                logger.warn("No token source available; continuing without tokens.");
+                break;
+        }
+        // Merge resolved tokens into the model
+        if (tokenResolution.tokens.length > 0) {
+            model.tokens = tokenResolution.tokens;
+        }
+        logger.info("Exporting icon SVGs...");
+        await enrichIconsWithSvg(model, fileKey, accessToken, adapter);
+        const iconCount = model.components.filter(c => c.iconKind).length;
+        if (iconCount > 0)
+            logger.dim(`- Icons enriched: ${iconCount}`);
+        logger.info("Saving snapshot history...");
+        await saveSnapshot(model, config);
+        logger.info("Exporting component context files...");
+        const manifest = await loadManifest(config).catch(() => undefined);
+        await exportAllComponentContexts(model, config, manifest);
+        logger.success("Scan complete.");
+        // Post-scan runtime validation
+        const { tokensDir } = resolveDSPaths(config);
+        const tokensCssPath = path.join(config.project.rootDir || process.cwd(), tokensDir, "tokens.css");
+        try {
+            await fs.access(tokensCssPath);
+        }
+        catch {
+            logger.warn("Token variables detected but no runtime CSS tokens found. Run `ptb generate-tokens`.");
+        }
+        logger.dim(`- Components found: ${model.components.length}`);
+        logger.dim(`- Token collections found: ${model.tokens.length}`);
+        logger.dim(`- Model saved to ${config.output.metadataDir}/latest.json`);
+    }
+    catch (error) {
+        logger.error(error.message || String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=scan.js.map

package/dist/commands/scan.js.map

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

package/dist/commands/stamp.d.ts

@@ -0,0 +1,11 @@
+import type { PTBConfig } from "@calibrate-ds/shared-types";
+/**
+ * Low-level: stamps a single component slug in ptb.lock without any logging.
+ * Returns true if the component was found and stamped, false otherwise.
+ */
+export declare function stampInLock(config: PTBConfig, nameOrSlug: string, message?: string): Promise<boolean>;
+/** Stamps one or more components in ptb.lock with the current designHash. */
+export declare function stampComponentCommand(name: string, options?: {
+    m?: string;
+}): Promise<void>;
+//# sourceMappingURL=stamp.d.ts.map

package/dist/commands/stamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.d.ts","sourceRoot":"","sources":["../../src/commands/stamp.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AA6C5D;;;GAGG;AACH,wBAAsB,WAAW,CAC7B,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CA6BlB;AAED,6EAA6E;AAC7E,wBAAsB,qBAAqB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,CAAC,CAAC,EAAE,MAAM,CAAA;CAAO,iBA8E/B"}

package/dist/commands/stamp.js

@@ -0,0 +1,147 @@
+import { loadConfig, resolveDSPaths } from "@calibrate-ds/core";
+import { logger } from "../utils/logger.js";
+import { readRoster, getCurrentUserRole, getGitUser, toHandle } from "../utils/team-roster.js";
+import { findComponentSlug } from "../utils/component-slug.js";
+import { canStampComponent } from "../utils/permissions.js";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { execSync } from "node:child_process";
+function getGitIdentity() {
+    try {
+        const name = execSync("git config user.name", { encoding: "utf-8" }).trim();
+        const email = execSync("git config user.email", { encoding: "utf-8" }).trim();
+        return name && email ? `${name} <${email}>` : (name || email || undefined);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Returns the filename of the most recent history snapshot, or undefined if none exists. */
+async function latestHistoryFile(config) {
+    const { metadataDir } = resolveDSPaths(config);
+    const historyDir = path.join(metadataDir, "history");
+    try {
+        const files = (await fs.readdir(historyDir)).filter(f => f.endsWith(".json")).sort();
+        return files.length > 0 ? files[files.length - 1] : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function readLock(lockPath) {
+    try {
+        return JSON.parse(await fs.readFile(lockPath, "utf-8"));
+    }
+    catch {
+        throw new Error("ptb.lock not found. Run 'ptb scan' or 'ptb export context' first.");
+    }
+}
+async function writeLock(lockPath, lock) {
+    const tmp = `${lockPath}.tmp.${process.pid}`;
+    await fs.writeFile(tmp, JSON.stringify(lock, null, 2) + "\n", "utf-8");
+    await fs.rename(tmp, lockPath); // atomic on POSIX — prevents partial-write corruption
+}
+/**
+ * Low-level: stamps a single component slug in ptb.lock without any logging.
+ * Returns true if the component was found and stamped, false otherwise.
+ */
+export async function stampInLock(config, nameOrSlug, message) {
+    const { workspaceRoot } = resolveDSPaths(config);
+    const lockPath = path.join(workspaceRoot, "ptb.lock");
+    let lock;
+    try {
+        lock = JSON.parse(await fs.readFile(lockPath, "utf-8"));
+    }
+    catch {
+        return false;
+    }
+    const slug = nameOrSlug.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+    const key = Object.keys(lock.components).find(k => k === slug || lock.components[k].displayName.toLowerCase() === nameOrSlug.toLowerCase());
+    if (!key)
+        return false;
+    const entry = lock.components[key];
+    const snapshotFile = await latestHistoryFile(config);
+    const stampedBy = getGitIdentity();
+    lock.components[key] = {
+        ...entry,
+        stampedHash: entry.designHash,
+        stampedAt: new Date().toISOString(),
+        ...(stampedBy ? { stampedBy } : {}),
+        ...(message ? { stampedMessage: message } : {}),
+        ...(snapshotFile ? { stampedSnapshotFile: snapshotFile } : {}),
+    };
+    await writeLock(lockPath, lock);
+    return true;
+}
+/** Stamps one or more components in ptb.lock with the current designHash. */
+export async function stampComponentCommand(name, options = {}) {
+    try {
+        const config = await loadConfig();
+        const { workspaceRoot } = resolveDSPaths(config);
+        const lockPath = path.join(workspaceRoot, "ptb.lock");
+        const lock = await readLock(lockPath);
+        const all = Object.keys(lock.components);
+        if (all.length === 0) {
+            logger.warn("ptb.lock has no components. Run 'ptb scan' first.");
+            return;
+        }
+        const isAll = name === "." || name === "*";
+        // Resolve targets
+        const targets = [];
+        if (isAll) {
+            targets.push(...all);
+        }
+        else {
+            const match = findComponentSlug(name, lock.components);
+            if (!match) {
+                logger.error(`Component '${name}' not found in ptb.lock.`);
+                logger.info("Available components:");
+                for (const k of all)
+                    logger.dim(`  - ${lock.components[k].displayName} (${k})`);
+                process.exit(1);
+            }
+            targets.push(match);
+        }
+        const now = new Date().toISOString();
+        const snapshotFile = await latestHistoryFile(config);
+        const stampedBy = getGitIdentity();
+        // Role check setup
+        const roster = await readRoster(workspaceRoot);
+        const myRole = getCurrentUserRole(roster);
+        const gitUser = getGitUser();
+        const me = gitUser ? roster.members[gitUser.email] : undefined;
+        const myHandle = me ? `@${me.handle}` : gitUser ? `@${toHandle(gitUser.name)}` : undefined;
+        let stamped = 0;
+        let skipped = 0;
+        for (const slug of targets) {
+            const entry = lock.components[slug];
+            // Only the assignee or a lead can stamp an assigned component
+            if (!canStampComponent(myRole, entry.assignedTo, myHandle)) {
+                logger.warn(`  ${entry.displayName} is assigned to ${entry.assignedTo} — only they or a lead can stamp it.`);
+                skipped++;
+                continue;
+            }
+            lock.components[slug] = {
+                ...entry,
+                stampedHash: entry.designHash,
+                stampedAt: now,
+                ...(stampedBy ? { stampedBy } : {}),
+                ...(options.m ? { stampedMessage: options.m } : {}),
+                ...(snapshotFile ? { stampedSnapshotFile: snapshotFile } : {}),
+            };
+            stamped++;
+            logger.success(`  Stamped: ${entry.displayName}`);
+        }
+        await writeLock(lockPath, lock);
+        const parts = [
+            stamped > 0 ? `${stamped} stamped` : "",
+            skipped > 0 ? `${skipped} skipped` : "",
+        ].filter(Boolean).join(", ");
+        logger.info(`\n${parts}. Run 'ptb status' to verify.`);
+    }
+    catch (error) {
+        logger.error(error.message || String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=stamp.js.map

package/dist/commands/stamp.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,7 @@
+export declare function statusCommand(options?: {
+    failOnStale?: boolean;
+    json?: boolean;
+    mine?: boolean;
+    team?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAkCA,wBAAsB,aAAa,CAAC,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,iBAqN1H"}