tines 0.0.154 → 0.0.156

package/dist/index.js

@@ -3754,8 +3754,27 @@ function attachFlag(type, slot, contentType) {
     }
   }
 }
+function positionalSource(type, slot, contentType) {
+  switch (type) {
+    case "file":
+      return "<path>";
+    case "folder":
+      return "<dir>";
+    case "link":
+      return "<url>";
+    case "pr":
+      return "<owner/repo#N>";
+    case "text": {
+      const ext = contentType === "text/markdown" ? "md" : contentType === "text/plain" ? "txt" : null;
+      return ext ? `${slot}.${ext}` : "<path>";
+    }
+  }
+}
+function attachArg(r, type, contentType) {
+  return r.type === void 0 ? attachFlag(type, r.artifact, contentType) : positionalSource(type, r.artifact, contentType);
+}
 function requirementFix(r, ref) {
-  const attach = (type) => `tines issues artifacts attach ${ref} ${r.artifact} ${attachFlag(type, r.artifact, r.content_type)}`;
+  const attach = (type) => `tines issues artifacts attach ${ref} ${r.artifact} ${attachArg(r, type, r.content_type)}`;
   if (r.status === "missing" || r.current_type === null) {
     return { kind: "attach", command: attach(r.type ?? "file") };
   }
@@ -3765,7 +3784,8 @@ function requirementFix(r, ref) {
   if (r.status === "stale") {
     return {
       kind: "reattach_or_reaffirm",
-      command: `${attach(r.current_type)} \u2014 or, if the current content still stands: tines issues artifacts reaffirm ${ref} ${r.artifact}`
+      command: attach(r.current_type),
+      alternative: `tines issues artifacts reaffirm ${ref} ${r.artifact}`
     };
   }
   const reattachable = r.type === void 0 ? r.current_type === "file" || r.current_type === "text" : r.current_type === r.type;
@@ -4297,7 +4317,10 @@ function requirementLines(r) {
   const spec = [r.type, r.content_type].filter(Boolean).join(", ");
   return [
     `requires artifact "${r.artifact}"${spec ? ` (${spec})` : ""}: ${requirementStatus(r)}${r.description ? ` \u2014 ${r.description}` : ""}`,
-    ...r.fix ? [`  fix: ${r.fix}`] : []
+    ...r.fix ? [`  fix: ${r.fix}`] : [],
+    // A second line, never a second command on the first: each line is
+    // copy-pastable on its own (Tines/255).
+    ...r.fix_alternative ? [`  or: ${r.fix_alternative}`] : []
   ];
 }
 function scheduleRef(s) {
@@ -5229,28 +5252,34 @@ function planFlags(flags, probe) {
   return { type: "pr", source: { kind: "pr", pr: parsed }, ...modifiers };
 }
 function checkExistingSlot(plan, gates, ref, name2, flags, positional) {
-  const held = gates.find((g) => g.check.current_type !== null)?.check.current_type;
-  if (held === void 0 || held === null || held === plan.type) return;
+  const held = heldType(gates);
+  if (held === void 0 || held === plan.type) return;
   const rejecting = gates.find((g) => g.check.type !== void 0 && g.check.type !== held);
   const fix = rejecting ? fixCommand(rejecting, ref) : `tines issues artifacts delete ${ref} ${name2} && tines issues artifacts attach ${ref} ${name2} ${flagFor(plan.type)} <source>`;
   throw new CliError(
-    `"${name2}" already holds a ${held} artifact and the type is immutable; ${sourceLabel(flags, positional)} would attach ${plan.type}. Use: ${fix} \u2014 or attach it under a different name (--ignore-gates does not bypass this; the server rejects the type change too)`
+    `"${name2}" already holds a ${held} artifact and the type is immutable; ${sourceLabel(flags, positional)} would attach ${plan.type}.${" "}Use: ${fix}${IMMUTABLE_TAIL}`
   );
 }
+function heldType(gates) {
+  return gates.find((g) => g.check.current_type !== null)?.check.current_type ?? void 0;
+}
+var IMMUTABLE_TAIL = " \u2014 or attach it under a different name (--ignore-gates does not bypass this; the server rejects the type change too)";
 function checkAccepted(plan, gates, ref, name2, flags, positional, sniff) {
   const effective = effectiveContentType(plan.type, plan.source, plan.contentType, sniff);
   if (gates.some((g2) => requirementAccepts(g2.check, plan.type, effective))) return;
   const label = sourceLabel(flags, positional);
+  const held = heldType(gates);
+  const blockedByHeldType = held !== void 0 && held !== plan.type;
   const typeMatched = gates.filter((g2) => (g2.check.type ?? plan.type) === plan.type);
   if (typeMatched.length > 0) {
     const g2 = typeMatched[0];
     throw new CliError(
-      `"${name2}" is gated by ${joinTransitions(typeMatched.map((x) => x.transition))} as ${gateSpec(g2.check)}; ${label} would attach ${effective ?? plan.type}, which does not satisfy it. Use: ${fixCommand(g2, ref)} with --content-type <mime under ${g2.check.content_type}> (or --ignore-gates to attach it anyway)`
+      `"${name2}" is gated by ${joinTransitions(typeMatched.map((x) => x.transition))} as ${gateSpec(g2.check)}; ${label} would attach ${effective ?? plan.type}, which does not satisfy it. Use: ${fixCommand(g2, ref)} with --content-type <mime under ${g2.check.content_type}>${blockedByHeldType ? IMMUTABLE_TAIL : " (or --ignore-gates to attach it anyway)"}`
     );
   }
   const g = gates[0];
   throw new CliError(
-    `"${name2}" is gated by ${joinTransitions(gates.map((x) => x.transition))} as ${gateSpec(g.check)}; ${label} would create a ${plan.type} artifact that can never satisfy it. Use: ${fixCommand(g, ref)} (or --ignore-gates to attach a ${plan.type} anyway)`
+    `"${name2}" is gated by ${joinTransitions(gates.map((x) => x.transition))} as ${gateSpec(g.check)}; ${label} would create a ${plan.type} artifact that can never satisfy it. Use: ${fixCommand(g, ref)}${blockedByHeldType ? IMMUTABLE_TAIL : ` (or --ignore-gates to attach a ${plan.type} anyway)`}`
   );
 }
 function satisfiedBy(artifact, gates) {
@@ -5282,6 +5311,8 @@ function gateLabel(artifact, gates) {
 }
 var ATTACH_SOURCE_HELP = `
 Source:
+  Prefer the positional form: it is what a gated slot's own hint prints
+  ("fix:" on \`tines issues show\`, and the launch prompt's Requires: line).
   A positional <source> is typed by the slot's gate when this issue has one:
   a text gate reads the path as the document (the gate's content type wins over
   the extension), a file gate uploads its bytes, a folder gate walks it, and a
@@ -5977,7 +6008,7 @@ files (v${artifact.current_version.version}):`);
   });
   withCommon(
     artifactsCmd.command("attach <ref> <name> [source]").description(
-      "Attach content to a named artifact slot (creates it, or appends the next version)"
+      "Attach content to a named artifact slot \u2014 <source> is typed by the gate, flags override (creates it, or appends a version)"
     ).option("-f, --file <path>", "upload a file (MIME sniffed from the extension)").option(
       "--folder <dir>",
       "snapshot a directory tree as one version (collect locally, attach once; MIME per file sniffed)"

package/package.json

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