tines 0.0.150 → 0.0.152

package/dist/index.js

@@ -3774,6 +3774,64 @@ function requirementFix(r, ref) {
     command: `tines issues artifacts delete ${ref} ${r.artifact} && ${attach(r.type ?? "file")}`
   };
 }
+function concreteContentType(ct) {
+  return ct !== void 0 && ct.includes("/") && !ct.endsWith("/") ? ct : void 0;
+}
+function requirementAccepts(r, type, contentType) {
+  if (r.type !== void 0 && r.type !== type) return false;
+  if (r.content_type === void 0) return true;
+  if (contentType === void 0) return true;
+  return contentType.startsWith(r.content_type);
+}
+function declaredContentType(reqs, type) {
+  if (type !== "text" && type !== "file") return void 0;
+  const declared = [
+    ...new Set(
+      reqs.filter((r) => r.type === type).map((r) => concreteContentType(r.content_type)).filter((ct) => ct !== void 0)
+    )
+  ];
+  return declared.length === 1 ? declared[0] : void 0;
+}
+
+// ../shared/src/artifact-site.ts
+var ARTIFACT_SITE_LINK_TTL_MS = 60 * 60 * 1e3;
+var ARTIFACT_SITE_INDEX = "index.html";
+function siteEntry(type, contentType, files = []) {
+  if (type === "file" || type === "text") {
+    return (contentType ?? "").toLowerCase().startsWith("text/html") ? "" : null;
+  }
+  if (type === "folder") {
+    return files.some((f) => f.path === ARTIFACT_SITE_INDEX) ? ARTIFACT_SITE_INDEX : null;
+  }
+  return null;
+}
+var VIEWPORT_META = /<meta[^>]+name\s*=\s*["']?viewport["']?[^>]*content\s*=\s*["'][^"']*width\s*=\s*device-width/i;
+var EXTERNAL_URL = /^(?:https?:)?\/\//i;
+function externalRefs(html) {
+  const found = [];
+  const push = (url) => {
+    if (url && EXTERNAL_URL.test(url.trim()) && !found.includes(url.trim())) found.push(url.trim());
+  };
+  for (const m of html.matchAll(/<script[^>]*\ssrc\s*=\s*["']([^"']+)["']/gi)) push(m[1]);
+  for (const m of html.matchAll(/<link[^>]*\shref\s*=\s*["']([^"']+)["']/gi)) push(m[1]);
+  for (const m of html.matchAll(/@import\s+(?:url\()?\s*["']([^"']+)["']/gi)) push(m[1]);
+  return found;
+}
+function lintHtmlArtifact(html) {
+  const warnings = [];
+  if (!VIEWPORT_META.test(html)) {
+    warnings.push(
+      'no viewport meta tag \u2014 add <meta name="viewport" content="width=device-width, initial-scale=1"> so it lays out for phones'
+    );
+  }
+  const external = externalRefs(html);
+  if (external.length > 0) {
+    warnings.push(
+      `external scripts/styles are blocked by the sandbox policy (${external.slice(0, 3).join(", ")}${external.length > 3 ? ", \u2026" : ""}) \u2014 inline or vendor them into the artifact`
+    );
+  }
+  return warnings;
+}
 
 // ../shared/src/client.ts
 var ApiError = class extends Error {
@@ -3957,6 +4015,11 @@ function createApiClient(options) {
     // Issue artifacts (name-addressed under the issue)
     listArtifacts: (issueId) => get(`/api/v1/issues/${issueId}/artifacts`),
     getArtifact: (issueId, name2) => get(artifactPath(issueId, name2)),
+    /**
+     * Mints a short-lived signed URL that renders an HTML artifact live
+     * (422 `not_a_site` when the artifact is not HTML / has no index.html).
+     */
+    createArtifactSiteLink: (issueId, name2, body = {}) => request("POST", artifactPath(issueId, name2, "/site-link"), body),
     /** JSON upsert for text/link/pr: creates the artifact or appends a version. */
     putArtifact: (issueId, name2, body) => request("PUT", artifactPath(issueId, name2), body),
     /** Raw-body upload for `file`: creates the artifact or appends a version. */
@@ -4970,9 +5033,6 @@ function normalizePositional(raw) {
   return { value: raw, stdin: false };
 }
 var isUrl = (v) => /^https?:\/\//.test(v);
-function concreteContentType(ct) {
-  return ct !== void 0 && ct.includes("/") && !ct.endsWith("/") ? ct : void 0;
-}
 function declaredTypes(gates) {
   return [
     ...new Set(gates.map((g) => g.check.type).filter((t) => t !== void 0))
@@ -5000,13 +5060,6 @@ function joinTransitions(names) {
 function fixCommand(gate, ref) {
   return gate.check.fix || requirementFix(gate.check, ref).command;
 }
-function accepts(gate, type, contentType) {
-  const check = gate.check;
-  if (check.type !== void 0 && check.type !== type) return false;
-  if (check.content_type === void 0) return true;
-  if (contentType === void 0) return true;
-  return contentType.startsWith(check.content_type);
-}
 function effectiveContentType(type, source, explicit, sniff) {
   if (explicit !== void 0) return explicit;
   if (type === "text") return "text/markdown";
@@ -5124,13 +5177,10 @@ function planPositional(name2, raw, gates, probe, flags) {
   }
 }
 function gateContentType(gates, type) {
-  if (type !== "text" && type !== "file") return void 0;
-  const declared = [
-    ...new Set(
-      gates.filter((g) => g.check.type === type).map((g) => concreteContentType(g.check.content_type)).filter((ct) => ct !== void 0)
-    )
-  ];
-  return declared.length === 1 ? declared[0] : void 0;
+  return declaredContentType(
+    gates.map((g) => g.check),
+    type
+  );
 }
 function planFlags(flags, probe) {
   const ct = flags.contentType;
@@ -5183,7 +5233,7 @@ function checkExistingSlot(plan, gates, ref, name2, flags, positional) {
 }
 function checkAccepted(plan, gates, ref, name2, flags, positional, sniff) {
   const effective = effectiveContentType(plan.type, plan.source, plan.contentType, sniff);
-  if (gates.some((g2) => accepts(g2, plan.type, effective))) return;
+  if (gates.some((g2) => requirementAccepts(g2.check, plan.type, effective))) return;
   const label = sourceLabel(flags, positional);
   const typeMatched = gates.filter((g2) => (g2.check.type ?? plan.type) === plan.type);
   if (typeMatched.length > 0) {
@@ -5202,7 +5252,11 @@ function satisfiedBy(artifact, gates) {
   const rejects = [];
   for (const gate of gates) {
     if (gate.check.artifact !== artifact.name) continue;
-    if (accepts(gate, artifact.artifact_type, artifact.current_version.content_type ?? void 0)) {
+    if (requirementAccepts(
+      gate.check,
+      artifact.artifact_type,
+      artifact.current_version.content_type ?? void 0
+    )) {
       satisfies.push(gate.transition);
     } else {
       rejects.push({ transition: gate.transition, wants: wantsLabel(gate, artifact) });
@@ -5887,6 +5941,16 @@ skills: ${context.skills.map((s) => s.name).join(", ")}`);
       `current: v${artifact.current_version.version} (${artifact.fresh ? "fresh" : "attached before the current state \u2014 reaffirm or attach a new version to satisfy gates"})`
     );
     console.log(`summary: ${artifactSummary(artifact)}`);
+    const entry = siteEntry(
+      artifact.artifact_type,
+      artifact.current_version.content_type,
+      artifact.current_version.files ?? []
+    );
+    if (entry !== null) {
+      console.log(
+        `site: renders live from /${entry} \u2014 "tines issues artifacts site-link ${issue.project_name}/${issue.number} ${artifact.name}" for a viewable URL`
+      );
+    }
     console.log("\nversions:");
     table(
       artifact.versions.map((v) => [
@@ -5936,10 +6000,13 @@ files (v${artifact.current_version.version}):`);
       );
       const withDescription = opts.description !== void 0 ? { description: opts.description } : {};
       let artifact;
+      let siteHtml = null;
       if (plan.type === "folder") {
         const dir = plan.source.dir;
         const files = walkFolder(dir);
         if (files.length === 0) die(`${dir} contains no files to snapshot`);
+        const index = files.find((f) => f.path === ARTIFACT_SITE_INDEX);
+        if (index) siteHtml = index.bytes.toString("utf8");
         artifact = await api.uploadArtifactFolder(issue.id, name2, files);
         if (opts.description !== void 0) {
           artifact = await api.putArtifact(issue.id, name2, { description: opts.description });
@@ -5957,15 +6024,18 @@ files (v${artifact.current_version.version}):`);
             die(`cannot read ${fromPath}: ${err instanceof Error ? err.message : String(err)}`);
           }
         }
+        const contentType = plan.contentType ?? (fromPath === null ? "application/octet-stream" : sniffContentType(fromPath));
+        if (siteEntry("file", contentType) !== null) siteHtml = bytes.toString("utf8");
         artifact = await api.uploadArtifactFile(issue.id, name2, bytes, {
           filename: plan.filename ?? (fromPath === null ? name2 : basename(fromPath)),
-          contentType: plan.contentType ?? (fromPath === null ? "application/octet-stream" : sniffContentType(fromPath))
+          contentType
         });
         if (opts.description !== void 0) {
           artifact = await api.putArtifact(issue.id, name2, { description: opts.description });
         }
       } else if (plan.type === "text") {
         const content = readTextSource(plan.source);
+        if (siteEntry("text", plan.contentType ?? null) !== null) siteHtml = content;
         artifact = await api.putArtifact(issue.id, name2, {
           type: "text",
           content,
@@ -5996,6 +6066,12 @@ files (v${artifact.current_version.version}):`);
       console.log(
         `attached "${artifact.name}" v${artifact.current_version.version} (${artifactTypeLabel(artifact)}) to ${issue.project_name}/${issue.number} \u2014 fresh${gateNote}`
       );
+      if (siteHtml !== null) {
+        console.log(
+          `site: renders live \u2014 "tines issues artifacts site-link ${issue.project_name}/${issue.number} ${artifact.name}" for a viewable URL`
+        );
+        for (const warning of lintHtmlArtifact(siteHtml)) console.log(`warning: ${warning}`);
+      }
     }
   );
   withCommon(
@@ -6011,6 +6087,32 @@ files (v${artifact.current_version.version}):`);
       `reaffirmed "${artifact.name}" on ${issue.project_name}/${issue.number}: v${artifact.current_version.version} reaffirms v${artifact.current_version.reaffirmed_from} \u2014 fresh as of now`
     );
   });
+  withCommon(
+    artifactsCmd.command("site-link <ref> <name>").description(
+      "Mint a short-lived URL that renders an HTML artifact live (scripts running) \u2014 for screenshotting your own prototype"
+    ).option(
+      "--version <n>",
+      "pin the link to a specific version (defaults to current)",
+      (v) => Number.parseInt(v, 10)
+    )
+  ).action(async (ref, name2, opts) => {
+    const api = client(opts);
+    const issue = await resolveIssue(api, ref);
+    const link = await api.createArtifactSiteLink(
+      issue.id,
+      name2,
+      opts.version === void 0 ? {} : { version: opts.version }
+    );
+    if (opts.json) return printJson(link);
+    console.log(link.url);
+    const minutes = Math.max(1, Math.round((link.expires_at - Date.now()) / 6e4));
+    console.log(`v${link.version}, expires in ~${minutes} minute${minutes === 1 ? "" : "s"}`);
+    if (link.mode === "same-origin") {
+      console.log(
+        "mode: same-origin sandbox (opaque origin) \u2014 localStorage and cookies throw inside the page"
+      );
+    }
+  });
   withCommon(
     artifactsCmd.command("get <ref> <name>").description("Fetch content (current version by default); a link/pr prints its URL").option(
       "--version <n>",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tines",
-  "version": "0.0.150",
+  "version": "0.0.152",
   "description": "CLI for Tines, an orchestration layer for AI agents",
   "repository": {
     "type": "git",