pairit 0.2.0 → 0.3.1

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

@@ -9513,9 +9513,13 @@ function getEnvName() {
   return fromEnv ? parseEnvName(fromEnv) : "production";
 }
 function getApiUrl() {
+  if (selected)
+    return ENVIRONMENTS[selected].api;
   return process2.env.PAIRIT_API_URL || ENVIRONMENTS[getEnvName()].api;
 }
 function getLabUrl() {
+  if (selected)
+    return ENVIRONMENTS[selected].lab;
   return process2.env.PAIRIT_LAB_URL || ENVIRONMENTS[getEnvName()].lab;
 }
 function getCredentialKey() {
@@ -9805,7 +9809,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.1").option("--env <name>", "Target environment: staging or production", (value) => {
   try {
     return parseEnvName(value);
   } catch (error) {
@@ -9853,7 +9857,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 +9868,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 +9900,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 +10079,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");
   }
@@ -10044,6 +10093,12 @@ async function lintConfig(configPath) {
       if (!page.id) {
         errors.push(`pages[${index}] is missing id`);
       }
+      page.components?.forEach((component, componentIndex) => {
+        const column = component?.column;
+        if (column !== undefined && column !== "left" && column !== "right") {
+          errors.push(`pages[${index}].components[${componentIndex}].column must be "left" or "right"`);
+        }
+      });
     });
   }
   if (errors.length) {
@@ -10115,7 +10170,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 +10184,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,42 +1,42 @@
 {
-  "name": "pairit",
-  "version": "0.2.0",
-  "description": "CLI for the Pairit behavioral science experiment platform",
-  "type": "module",
-  "bin": {
-    "pairit": "dist/index.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "bun build src/index.ts --outdir dist --target node",
-    "lint": "tsc --noEmit",
-    "prepublishOnly": "bun run build"
-  },
-  "keywords": [
-    "experiment",
-    "behavioral-science",
-    "research",
-    "cli"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/pairium/pairit.git",
-    "directory": "apps/manager/cli"
-  },
-  "homepage": "https://docs.pairium.ai/pairit/",
-  "license": "MIT",
-  "optionalDependencies": {
-    "keytar": "^7.9.0"
-  },
-  "devDependencies": {
-    "@types/bun": "^1.1.13",
-    "@types/open": "^6.2.1",
-    "better-auth": "^1.4.7",
-    "commander": "^12.1.0",
-    "open": "^11.0.0",
-    "typescript": "^5.9.3",
-    "yaml": "^2.6.0"
-  }
+	"name": "pairit",
+	"version": "0.3.1",
+	"description": "CLI for the Pairit behavioral science experiment platform",
+	"type": "module",
+	"bin": {
+		"pairit": "dist/index.js"
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "bun build src/index.ts --outdir dist --target node",
+		"lint": "tsc --noEmit",
+		"prepublishOnly": "bun run build"
+	},
+	"keywords": [
+		"experiment",
+		"behavioral-science",
+		"research",
+		"cli"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/pairium/pairit.git",
+		"directory": "apps/manager/cli"
+	},
+	"homepage": "https://docs.pairium.ai/pairit/",
+	"license": "MIT",
+	"optionalDependencies": {
+		"keytar": "^7.9.0"
+	},
+	"devDependencies": {
+		"@types/bun": "^1.1.13",
+		"@types/open": "^6.2.1",
+		"better-auth": "^1.4.7",
+		"commander": "^12.1.0",
+		"open": "^11.0.0",
+		"typescript": "^5.9.3",
+		"yaml": "^2.6.0"
+	}
 }