pairit 0.2.0 → 0.3.0

package/README.md

@@ -43,8 +43,8 @@ pairit login                                       # Authenticate (required firs
 
 pairit config lint path/to/config.yaml
 pairit config compile path/to/config.yaml
-pairit config upload configs/simple-survey-basic.yaml --config-id simple-survey-basic
-pairit config upload configs/agent-study.yaml --config-id agent-study --openai-api-key sk-...
+pairit config upload configs/simple-survey-basic.yaml --name simple-survey-basic
+pairit config upload configs/agent-study.yaml --name agent-study --openai-api-key sk-...
 pairit config list
 pairit config delete 2f3c4d5e...
 
@@ -66,8 +66,8 @@ Add `--private` if you need to keep an object private. Use `--bucket <name>` onl
 # Point at local manager (published CLI defaults to production)
 export PAIRIT_API_URL=http://localhost:3002
 
-bun run apps/manager/cli/src/index.ts config upload configs/simple-survey-basic.yaml --config-id simple-survey-basic
-bun run apps/manager/cli/src/index.ts config upload configs/agent-study.yaml --config-id agent-study --openai-api-key sk-...
+bun run apps/manager/cli/src/index.ts config upload configs/simple-survey-basic.yaml --name simple-survey-basic
+bun run apps/manager/cli/src/index.ts config upload configs/agent-study.yaml --name agent-study --openai-api-key sk-...
 bun run apps/manager/cli/src/index.ts config list
 bun run apps/manager/cli/src/index.ts config delete 2f3c4d5e... --force
 
@@ -76,7 +76,7 @@ bun run apps/manager/cli/src/index.ts media list
 bun run apps/manager/cli/src/index.ts media delete onboarding/logo.png --force
 ```
 
-`config compile` writes `configs/simple-survey-basic.json` next to the source YAML. `config upload` defaults the config id to a 16-character base64url string derived from the SHA-256 hash of the compiled JSON (unless `--config-id` overrides it).
+`config compile` writes `configs/simple-survey-basic.json` next to the source YAML. `config upload` creates or updates a config by name (`--name`, else the YAML `name:` field, else the file name). The server assigns the config id (`<name>-<10 random chars>`) on the first upload, and later uploads under the same name add revisions. `--config-id` updates an existing config by id. See `config history` for past revisions.
 
 ## Manager allowlist (admin)
 
@@ -101,8 +101,8 @@ Notes:
 If your config uses AI agents, attach provider credentials when uploading:
 
 ```bash
-pairit config upload path/to/config.yaml --config-id my-exp --openai-api-key sk-...
-pairit config upload path/to/config.yaml --config-id my-exp --anthropic-api-key sk-ant-...
+pairit config upload path/to/config.yaml --name my-exp --openai-api-key sk-...
+pairit config upload path/to/config.yaml --name my-exp --anthropic-api-key sk-ant-...
 ```
 
 Notes:

package/dist/index.js

@@ -9805,7 +9805,7 @@ async function attachHtmlToCompiledConfig(configPath, compiled) {
 
 // src/index.ts
 var program2 = new Command;
-program2.name("pairit").description("CLI for Pairit experiment configs").version("0.2.0").option("--env <name>", "Target environment: staging or production", (value) => {
+program2.name("pairit").description("CLI for Pairit experiment configs").version("0.3.0").option("--env <name>", "Target environment: staging or production", (value) => {
   try {
     return parseEnvName(value);
   } catch (error) {
@@ -9853,7 +9853,7 @@ configCommand.command("compile").argument("<config>", "Path to YAML config").des
     process11.exitCode = 1;
   }
 });
-configCommand.command("upload").argument("<config>", "Path to YAML config").option("--config-id <configId>", "Config id (defaults to hash)").option("--metadata <json>", "Optional metadata JSON string").option("--openai-api-key <key>", "OpenAI API key for this experiment").option("--anthropic-api-key <key>", "Anthropic API key for this experiment").description("Compile and upload config via Pairit Functions").action(async (configPath, options) => {
+configCommand.command("upload").argument("<config>", "Path to YAML config").option("--name <name>", "Config name (defaults to the YAML name field, then the file name)").option("--config-id <configId>", "Update an existing config by id (configs created before names)").option("--metadata <json>", "Optional metadata JSON string").option("--openai-api-key <key>", "OpenAI API key for this experiment").option("--anthropic-api-key <key>", "Anthropic API key for this experiment").description("Compile and upload config via Pairit Functions").action(async (configPath, options) => {
   try {
     const { payload, checksum, attachments } = await buildUploadPayload(configPath, options);
     const response = await callFunctions("/configs/upload", {
@@ -9864,10 +9864,23 @@ configCommand.command("upload").argument("<config>", "Path to YAML config").opti
     for (const file of attachments) {
       console.log(`✓ Attached ${path3.basename(file.src)} (${formatBytes(file.bytes)})`);
     }
-    console.log(`✓ Uploaded ${payload.configId} (${checksum})`);
+    const result = response;
+    const label = result.name ? `${result.name} (${result.configId})` : result.configId;
+    if (result.created) {
+      console.log(`✓ Created ${label}, revision ${result.revision}`);
+    } else if (result.previousRevision != null) {
+      console.log(`✓ Uploaded ${label}, revision ${result.previousRevision} → ${result.revision}`);
+    } else {
+      console.log(`✓ Uploaded ${label}, revision ${result.revision} (config unchanged)`);
+    }
+    console.log(`  checksum ${checksum}`);
+    if (result.previousRevision != null && result.previousRevisionSessionCount > 0) {
+      const n = result.previousRevisionSessionCount;
+      console.warn(`⚠ ${n} participant${n === 1 ? "" : "s"} ran revision ${result.previousRevision}. New participants will get revision ${result.revision}.`);
+      console.warn("  Exports record each session's configRevision. For a different study, upload under a new --name instead.");
+    }
     const labUrl = getLabUrl();
-    console.log(`Survey Link: ${labUrl}/${payload.configId}`);
-    console.log(JSON.stringify(response, null, 2));
+    console.log(`Survey Link: ${labUrl}/${result.configId}`);
   } catch (error) {
     reportCliError("Upload failed", error);
   }
@@ -9883,12 +9896,41 @@ configCommand.command("list").description("List configs from Pairit Functions").
     configs.forEach((config) => {
       const metadata = config.metadata;
       const filename = metadata?.originalFilename ? ` | file=${metadata.originalFilename}` : "";
-      console.log(`configId=${config.configId} | owner=${config.owner} | checksum=${config.checksum}${filename} | updated=${config.updatedAt ?? "n/a"}`);
+      const name = config.name ? `name=${config.name} | ` : "";
+      const revision = config.revision != null ? ` | revision=${config.revision}` : "";
+      console.log(`${name}configId=${config.configId}${revision} | owner=${config.owner} | checksum=${config.checksum}${filename} | updated=${config.updatedAt ?? "n/a"}`);
     });
   } catch (error) {
     reportCliError("List failed", error);
   }
 });
+configCommand.command("history").argument("<configId>", "Config id").option("--revision <n>", "Download one revision's compiled config").option("--out <file>", "With --revision, write the config to this file").description("List a config's revisions, or download one").action(async (configId, options) => {
+  try {
+    const base = `/configs/${encodeURIComponent(configId)}/revisions`;
+    if (options.revision) {
+      const revision = await callFunctions(`${base}/${encodeURIComponent(options.revision)}`, { method: "GET" });
+      const json = JSON.stringify(revision.config, null, 2);
+      if (options.out) {
+        await writeFile2(options.out, json, "utf8");
+        console.log(`✓ Wrote revision ${options.revision} to ${options.out}`);
+      } else {
+        console.log(json);
+      }
+      return;
+    }
+    const history = await callFunctions(base, { method: "GET" });
+    if (!history.revisions.length) {
+      console.log("No revisions recorded yet. They start with the next upload.");
+      return;
+    }
+    for (const r of history.revisions) {
+      const current = r.revision === history.currentRevision ? " (current)" : "";
+      console.log(`revision=${r.revision}${current} | sessions=${r.sessionCount} | uploaded=${r.createdAt ?? "n/a"} | checksum=${r.checksum ?? "n/a"}`);
+    }
+  } catch (error) {
+    reportCliError("History failed", error);
+  }
+});
 configCommand.command("delete").argument("<configId>", "Config id to delete").option("--force", "Skip confirmation").description("Delete config via Pairit Functions").action(async (configId, options) => {
   try {
     if (!options.force) {
@@ -10033,6 +10075,9 @@ async function lintConfig(configPath) {
   if (!config.schema_version) {
     errors.push("missing schema_version");
   }
+  if (config.name !== undefined && (typeof config.name !== "string" || !config.name.trim())) {
+    errors.push("name must be a non-empty string");
+  }
   if (!config.initialPageId) {
     errors.push("missing initialPageId");
   }
@@ -10115,7 +10160,8 @@ async function buildUploadPayload(configPath, options) {
   const attachments = await attachHtmlToCompiledConfig(configPath, parsed);
   const hashBuffer = createHash("sha256").update(JSON.stringify(parsed)).digest();
   const checksum = hashBuffer.toString("hex");
-  const configId = options.configId ?? toBase64Url(hashBuffer.subarray(0, 12));
+  const explicitName = options.name ?? sourceConfig.name;
+  const name = options.configId ? explicitName : explicitName ?? path3.basename(configPath, path3.extname(configPath));
   const metadata = options.metadata ? JSON.parse(options.metadata) : {};
   if (!metadata.originalFilename) {
     metadata.originalFilename = path3.basename(configPath);
@@ -10128,7 +10174,8 @@ async function buildUploadPayload(configPath, options) {
   };
   return {
     payload: {
-      configId,
+      ...name && { name },
+      ...options.configId && { configId: options.configId },
       checksum,
       metadata: metadata ?? null,
       config: parsed,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pairit",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "CLI for the Pairit behavioral science experiment platform",
   "type": "module",
   "bin": {