@augurworks/augur 0.15.1

package/agents/working-marks.md

@@ -0,0 +1,86 @@
+# Working marks — say what you are about to touch, read what everyone else is
+
+Nothing in a workspace used to say what was already being worked on. Two people's
+agents, on two machines, both told to improve "the checkout flow", would each open
+the same folder, each edit it, and find out at publish time — where the answer is a
+fork, a conflict file and an afternoon nobody planned.
+
+A **mark** is a note on a path saying *something is editing here right now*. It
+carries the path, a one-way id for who left it, when it started, and how long it is
+good for. That is all it is.
+
+Where the workspace serves drafts, a draft IS the mark: `augur open` tells you who else
+has the prototype open and shows you on their chips, with nothing to leave and nothing to
+expire — see [drafts.md](./drafts.md). Marks stay for workspaces without drafts.
+
+## ⚠️ It is not a lock, and you must not treat it as one
+
+A mark **grants nothing and refuses nothing**. A marked path can still be opened,
+edited, published and shipped by anybody, including you. Nothing in the engine asks
+a mark for permission — not the gate, not the publish handler, not the commit.
+`augur mark` exits 0 whatever it finds.
+
+So do not write a script that blocks on a mark, retries until one clears, or treats
+one as a failure. When coordination genuinely fails, the composed publish settles it
+on evidence after the fact (see [publishing.md](./publishing.md)) — that is the part
+that is allowed to refuse, and it is the only part.
+
+## The protocol, in one line
+
+**Read the marks before you start. Leave one when you do.**
+
+```
+augur mark                              what is being worked on right now
+augur mark <path> [--ttl <seconds>]     leave a mark on it, then start
+augur mark <path> --clear               take yours down early
+augur mark … --json                     the same answer, for a tool to read
+```
+
+A path is a URL path (`/checkout/flow/`). The repo folder is accepted and
+translated, so `checkout/prototypes/flow` — the folder you were just editing —
+marks the URL it publishes to. The line printed back is always the instance's own
+spelling; do not assume yours won.
+
+Marking a path that somebody else already marked **still works**, and prints their
+mark next to yours. That is the whole design: you now know, and you choose. Pick a
+different path, wait it out, or carry on knowing you will be merging.
+
+## It expires by itself
+
+A mark is good for ten minutes by default and an hour at the most. The instance
+stops reporting it the moment that passes, whether or not anything ever clears it.
+
+That is the point rather than a detail. The thing leaving marks is a process that
+can be killed — an interrupt, an out-of-memory, a closed laptop — and a claim that
+outlives the claimant is worse than no claim at all, because the next reader
+believes it. **`--clear` is a courtesy, never the guarantee.** There is no cleanup
+job to run and none to forget.
+
+If the work is genuinely still going when the mark lapses, mark it again. An agent
+that wants a four-hour mark is describing a lock, and the answer to a lock is a
+short mark re-written as the work continues.
+
+## Where marks show up without being asked for
+
+- `augur status` prints what is being worked on, under the live-vs-clone table.
+- `augur clone` and `augur pull` print the marks on the paths they are about to
+  write, before the first byte lands — and write anyway, with the same exit code
+  as always.
+- A gallery card carries a small badge (*"… is working on this"*) while a mark on
+  that exact URL is live, and drops it when the mark lapses.
+
+The badge is the **byproduct**, not the point. As an agent's edit shrinks toward
+seconds, a mark is felt almost never and read always — which is why the write side
+is the CLI and the browser side only ever reads.
+
+## What is stored
+
+`{path, personId, startedAt, ttl}` — and `personId` is the same one-way fingerprint
+a comment carries, so a mark holds **no address**. The display name beside it is
+resolved from the roster at read time, never stored, so a rename shows through and
+somebody who has left resolves to "Someone".
+
+Marks are workspace state, not published content: they are covered by
+`augur export --full`, and a restore deliberately drops them (see
+`src/state-inventory.mjs`) rather than reinstating a claim about a moment that has
+passed.

package/brand/augur-eye.svg

@@ -0,0 +1,3 @@
+<svg width="643" height="643" viewBox="0 0 643 643" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Augur">
+<path fill="#2C2150" fill-rule="evenodd" clip-rule="evenodd" d="M303.668 0.501099C480.9 -9.31876 632.543 126.378 642.396 303.609C652.249 480.839 516.579 632.508 339.35 642.392C162.076 652.279 10.36 516.567 0.504883 339.291C-9.34912 162.015 126.39 10.3241 303.668 0.501099ZM321.31 58.589C313.993 78.2949 309.682 91.0001 300.003 110.42C256.894 196.544 185.761 265.436 98.3008 305.765C84.5568 312.054 73.3451 316.365 59.0391 321.205C166.492 358.562 254.54 437.345 303.567 540.001C306.201 545.441 320.11 580.712 320.888 581.447C329.254 559.649 338.869 536.27 350.55 515.916C397.544 434.024 469.471 370.244 555.57 331.86C563.577 328.29 574.85 323.736 583.145 321.47C472.786 278.754 383.1 203.746 334.938 93.8761C332.878 89.1732 321.885 59.2127 321.31 58.589Z"/>
+</svg>

package/brand/augur-icon.svg

@@ -0,0 +1,41 @@
+<svg width="1024" height="1024" viewBox="0 0 1024 1024" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Augur">
+  <defs>
+    <linearGradient id="tile" x1="160" y1="80" x2="880" y2="980" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#241A3D"/>
+      <stop offset="0.55" stop-color="#2C1F49"/>
+      <stop offset="1" stop-color="#382350"/>
+    </linearGradient>
+    <radialGradient id="dawn" cx="512" cy="900" r="520" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#7A4E86" stop-opacity="0.55"/>
+      <stop offset="0.45" stop-color="#4A2D5A" stop-opacity="0.30"/>
+      <stop offset="1" stop-color="#382350" stop-opacity="0"/>
+    </radialGradient>
+    <linearGradient id="gold" x1="254" y1="296" x2="770" y2="686" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#FAD79A"/>
+      <stop offset="0.55" stop-color="#F1C078"/>
+      <stop offset="1" stop-color="#E2A14E"/>
+    </linearGradient>
+  </defs>
+
+  <!-- tile -->
+  <rect x="32" y="32" width="960" height="960" rx="224" fill="url(#tile)"/>
+  <rect x="32" y="32" width="960" height="960" rx="224" fill="url(#dawn)"/>
+  <rect x="33.5" y="33.5" width="957" height="957" rx="222.5" stroke="#FFFFFF" stroke-opacity="0.07" stroke-width="3"/>
+
+  <!-- soaring raptor, top-down -->
+  <path fill="url(#gold)" d="
+    M512 300
+    C 526 316 531 342 539 366
+    C 566 358 664 350 744 392
+    C 672 452 600 452 570 480
+    C 564 540 562 576 553 612
+    C 558 642 560 662 558 682
+    L 512 642
+    L 466 682
+    C 464 662 466 642 471 612
+    C 462 576 460 540 454 480
+    C 424 452 352 452 280 392
+    C 360 350 458 358 485 366
+    C 493 342 498 316 512 300
+    Z"/>
+</svg>

package/brand/augur-mark.svg

@@ -0,0 +1,5 @@
+<svg width="1024" height="1024" viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Augur">
+  <rect width="1024" height="1024" rx="224" fill="#F4EFE6"/>
+  <g transform="translate(153.5 153.5) scale(1.115)" fill="#2C2150" fill-rule="evenodd"><path d="M303.668 0.501099C480.9 -9.31876 632.543 126.378 642.396 303.609C652.249 480.839 516.579 632.508 339.35 642.392C162.076 652.279 10.36 516.567 0.504883 339.291C-9.34912 162.015 126.39 10.3241 303.668 0.501099ZM321.31 58.589C313.993 78.2949 309.682 91.0001 300.003 110.42C256.894 196.544 185.761 265.436 98.3008 305.765C84.5568 312.054 73.3451 316.365 59.0391 321.205C166.492 358.562 254.54 437.345 303.567 540.001C306.201 545.441 320.11 580.712 320.888 581.447C329.254 559.649 338.869 536.27 350.55 515.916C397.544 434.024 469.471 370.244 555.57 331.86C563.577 328.29 574.85 323.736 583.145 321.47C472.786 278.754 383.1 203.746 334.938 93.8761C332.878 89.1732 321.885 59.2127 321.31 58.589Z"/></g>
+  <rect x="2" y="2" width="1020" height="1020" rx="222" fill="none" stroke="#2C2150" stroke-opacity="0.14" stroke-width="4"/>
+</svg>