demo-this-pr 0.1.1 → 1.0.0

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/demo-this-pr@0.1.1/assets/demo-this-pr-logo.svg" alt="DEMO THIS PR animated wordmark" width="920">
+  <img src="https://cdn.jsdelivr.net/npm/demo-this-pr@1.0.0/assets/demo-this-pr-logo.svg" alt="DEMO THIS PR animated wordmark" width="920">
 </p>
 
 # demo-this-pr
@@ -70,7 +70,7 @@ For CI or agent runners, prefer a pinned package version and a deterministic
 artifact directory:
 
 ```bash
-npx demo-this-pr@0.1.1 ci
+npx demo-this-pr@1.0.0 ci
 ```
 
 The command exits non-zero when Git context or a reachable local app is missing.
@@ -207,13 +207,19 @@ Generate in CI without a visible browser or report viewer:
 demo-this-pr ci
 ```
 
+Delete all generated run artifacts for the current repository:
+
+```bash
+demo-this-pr runs --delete
+```
+
 Jenkins example:
 
 ```groovy
 stage('PR demo') {
   steps {
     sh 'npm ci'
-    sh 'npx demo-this-pr@0.1.1 ci'
+    sh 'npx demo-this-pr@1.0.0 ci'
   }
   post {
     always {

package/dist/cli.js

@@ -1,17 +1,19 @@
 #!/usr/bin/env node
 import { Command } from "commander";
+import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import pc from "picocolors";
 import { resolveAutoDemo } from "./auto.js";
 import { createPrKit } from "./prKit.js";
 import { parseDemoStep } from "./demoPlan.js";
-import { defaultRunOutputDir } from "./runs.js";
+import { defaultRunOutputDir, deleteRuns } from "./runs.js";
 import { openReportViewer } from "./viewer.js";
 const program = new Command();
+const packageVersion = readPackageVersion();
 program
     .name("demo-this-pr")
     .description("Generate reviewable PR demos from current unpushed changes.")
-    .version("0.1.0")
+    .version(packageVersion)
     .argument("[repo]", "repository path; defaults to the current working directory")
     .option("--cwd <path>", "repository path; useful when running from outside the target repo")
     .option("--headless", "run Chromium without a visible window", false)
@@ -20,7 +22,7 @@ program
     .action(async (repo, options) => {
     let cleanup;
     try {
-        const targetCwd = resolve(options.cwd ?? repo ?? process.cwd());
+        const targetCwd = resolveTargetCwd(repo, options.cwd);
         const autoDemo = await resolveAutoDemo(targetCwd, {
             headless: options.headless ?? false,
             output: options.output,
@@ -48,7 +50,7 @@ program
     .action(async (repo, options) => {
     let cleanup;
     try {
-        const targetCwd = resolve(options.cwd ?? repo ?? process.cwd());
+        const targetCwd = resolveTargetCwd(repo, options.cwd);
         const autoDemo = await resolveAutoDemo(targetCwd, {
             headless: !(options.headed ?? false),
             output: options.output,
@@ -66,6 +68,31 @@ program
         await cleanup?.();
     }
 });
+program
+    .command("runs")
+    .description("Manage generated demo-this-pr run artifacts")
+    .argument("[repo]", "repository path; defaults to the current working directory")
+    .option("--cwd <path>", "repository path; useful when running from outside the target repo")
+    .option("--delete", "delete all run directories under .demo-this-pr/runs", false)
+    .action(async (repo, options) => {
+    if (!options.delete) {
+        process.stderr.write(`${pc.red("demo-this-pr:")} runs needs --delete\n`);
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        const targetCwd = resolveTargetCwd(repo, options.cwd);
+        const result = await deleteRuns(targetCwd);
+        process.stdout.write(`${pc.green("Runs deleted")}\n`);
+        process.stdout.write(`Directory: ${result.runsDir}\n`);
+        process.stdout.write(`Deleted:   ${result.deletedCount}\n`);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`${pc.red("demo-this-pr:")} ${message}\n`);
+        process.exitCode = 1;
+    }
+});
 program
     .command("demo")
     .description("Launch a local Chromium demo for the current changes and write the PR kit")
@@ -199,3 +226,11 @@ function printResult(result, label, notes) {
 function collect(value, previous) {
     return [...previous, value];
 }
+function resolveTargetCwd(repo, commandCwd) {
+    const rootOptions = program.opts();
+    return resolve(commandCwd ?? rootOptions.cwd ?? repo ?? process.cwd());
+}
+function readPackageVersion() {
+    const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+    return packageJson.version ?? "0.0.0";
+}

package/dist/runs.d.ts

@@ -1 +1,6 @@
+export interface DeleteRunsResult {
+    runsDir: string;
+    deletedCount: number;
+}
 export declare function defaultRunOutputDir(label: string | undefined): string;
+export declare function deleteRuns(cwd: string): Promise<DeleteRunsResult>;

package/dist/runs.js

@@ -1,6 +1,35 @@
+import { lstat, readdir, rm } from "node:fs/promises";
+import { join, resolve } from "node:path";
 export function defaultRunOutputDir(label) {
     return `.demo-this-pr/runs/${timestamp()}-${slug(normalizeLabel(label))}`;
 }
+export async function deleteRuns(cwd) {
+    const runsDir = resolve(cwd, ".demo-this-pr", "runs");
+    try {
+        const stats = await lstat(runsDir);
+        if (stats.isSymbolicLink()) {
+            throw new Error(`Refusing to delete symlinked runs directory: ${runsDir}`);
+        }
+        if (!stats.isDirectory()) {
+            throw new Error(`Runs path exists but is not a directory: ${runsDir}`);
+        }
+    }
+    catch (error) {
+        if (isNotFoundError(error)) {
+            return { runsDir, deletedCount: 0 };
+        }
+        throw error;
+    }
+    const entries = await readdir(runsDir);
+    await Promise.all(entries.map((entry) => rm(join(runsDir, entry), { recursive: true, force: true })));
+    return {
+        runsDir,
+        deletedCount: entries.length
+    };
+}
+function isNotFoundError(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
 function timestamp() {
     const now = new Date();
     const pad = (value, size = 2) => String(value).padStart(size, "0");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "demo-this-pr",
-  "version": "0.1.1",
+  "version": "1.0.0",
   "description": "Record local PR demos with isolated Playwright Chromium, MP4 evidence, test output, and review-ready reports.",
   "type": "module",
   "main": "./dist/index.js",