coplan-engine 0.2.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3e4bc136761076f3c7f12bf4e025f5bfd0c89831c718f50cd88a4e650bb402e8
-  data.tar.gz: a7739fea373261118928c4c488043ca9d2547eac95d4ceeee91f004585e3b317
+  metadata.gz: 25dc4e49ba0c60553ed7d736f692711ed95908f904ced5ab0eab166a6afd5454
+  data.tar.gz: 9081eee65fbcadaef5bfb8af91a50bf67a1825382ff8763de0d3b1cb38a00ac4
 SHA512:
-  metadata.gz: 0d984b75c02ce889706c1cf1080f61106f5e355d0626d69c502b7f29ec28ef99300ad249d0c57cd1823f46d064f62e641a2c733b60a3df6cab266fc17fef453d
-  data.tar.gz: f70083d0f8ce612a2608e7863fe7606aecefa40e402c582596eccc68576f9cf60e546efd5f98d30c2a59a180d81a2c97e1b831ad9277ec21f54569df3ebf2325
+  metadata.gz: 3d75ee11d917e817192149b2a69a33b1089333312ebd8ac4f7b64142479d5108c5b70e801c6b4ae3b64f78e9190d123164f4e5b87f56ced1aad7df0d9b72cb93
+  data.tar.gz: c6b96bd3fe16455118551bd01ae3769914bcc2f41d0b2bd59bf159ee8eddd6e84a7fb24ebb74461d522d07802b242b08bc8f691acf9772dabcc0864ab4fdfaed

data/app/assets/stylesheets/coplan/application.css

@@ -21,6 +21,8 @@
   --color-status-developing: #3b82f6;
   --color-status-live: #10b981;
   --color-status-abandoned: #6b7280;
+--color-agent: #4338ca;
+--color-agent-bg: #e0e7ff;
 
   /* Spacing */
   --space-xs: 0.25rem;
@@ -119,6 +121,17 @@ img, svg {
   border-radius: 6px;
 }
 
+.env-badge {
+  font-size: 10px;
+  font-weight: 600;
+  color: #fff;
+  padding: 1px 6px;
+  border-radius: 4px;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  line-height: 1.4;
+}
+
 .site-nav__brand:hover {
   text-decoration: none;
   color: var(--color-primary);
@@ -173,6 +186,87 @@ img, svg {
   font-weight: 700;
 }
 
+/* Plan viewers / presence */
+.plan-viewers {
+  display: flex;
+  align-items: center;
+  gap: var(--space-sm);
+}
+
+.plan-viewers__avatars {
+  display: flex;
+  flex-direction: row-reverse;
+}
+
+.plan-viewers__avatar {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 2rem;
+  height: 2rem;
+  border-radius: 50%;
+  background: var(--color-primary);
+  color: #fff;
+  font-size: 0.7rem;
+  font-weight: 600;
+  border: 2px solid var(--color-surface);
+  margin-left: -0.5rem;
+  cursor: default;
+  position: relative;
+}
+
+.plan-viewers__avatar--you {
+  background: var(--color-success);
+}
+
+.plan-viewers__avatar::after {
+  content: attr(data-tooltip);
+  position: absolute;
+  bottom: calc(100% + 6px);
+  left: 50%;
+  transform: translateX(-50%);
+  background: var(--color-text);
+  color: var(--color-surface);
+  padding: 4px 8px;
+  border-radius: var(--radius);
+  font-size: 0.75rem;
+  font-weight: 500;
+  white-space: nowrap;
+  pointer-events: none;
+  opacity: 0;
+  transition: opacity 0.15s;
+  z-index: 10;
+}
+
+.plan-viewers__avatar:hover::after {
+  opacity: 1;
+}
+
+.plan-viewers__avatars > :last-child {
+  margin-left: 0;
+}
+
+.plan-viewers__overflow {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 2rem;
+  height: 2rem;
+  border-radius: 50%;
+  background: var(--color-border);
+  color: var(--color-text-muted);
+  font-size: 0.7rem;
+  font-weight: 600;
+  border: 2px solid var(--color-surface);
+  margin-left: -0.5rem;
+}
+
+.plan-viewers__label {
+  font-size: var(--text-sm);
+  color: var(--color-text-muted);
+  white-space: nowrap;
+}
+
 /* Flash messages */
 .flash {
   padding: var(--space-md) var(--space-lg);
@@ -268,6 +362,11 @@ img, svg {
 .badge--developing  { background: #dbeafe; color: var(--color-status-developing); }
 .badge--live        { background: #d1fae5; color: var(--color-status-live); }
 .badge--abandoned   { background: #f3f4f6; color: var(--color-status-abandoned); }
+.badge--pending     { background: #fef3c7; color: var(--color-status-considering); }
+.badge--todo        { background: #dbeafe; color: var(--color-status-developing); }
+.badge--discarded   { background: #f3f4f6; color: var(--color-status-abandoned); }
+.badge--resolved    { background: #d1fae5; color: var(--color-status-live); }
+.badge--agent       { background: var(--color-agent-bg); color: var(--color-agent); font-size: 0.65rem; padding: 1px 6px; vertical-align: middle; }
 
 /* Forms */
 .form-group {
@@ -619,6 +718,24 @@ img, svg {
   background: rgba(108, 140, 255, 0.22);
 }
 
+.anchor-highlight--pending {
+  background: rgba(245, 158, 11, 0.12);
+  border-bottom: 2px solid rgba(245, 158, 11, 0.6);
+}
+
+.anchor-highlight--pending:hover {
+  background: rgba(245, 158, 11, 0.22);
+}
+
+.anchor-highlight--todo {
+  background: rgba(59, 130, 246, 0.12);
+  border-bottom: 2px solid rgba(59, 130, 246, 0.6);
+}
+
+.anchor-highlight--todo:hover {
+  background: rgba(59, 130, 246, 0.22);
+}
+
 .anchor-highlight--resolved {
   background: none;
   border-bottom: none;
@@ -689,6 +806,18 @@ img, svg {
   min-width: 0;
 }
 
+#plan-threads {
+  position: absolute;
+  width: 0;
+  height: 0;
+  overflow: hidden;
+  pointer-events: none;
+}
+
+#plan-threads .thread-popover {
+  pointer-events: auto;
+}
+
 /* Comment form */
 .comment-form {
   position: absolute;
@@ -1004,24 +1133,47 @@ img, svg {
 /* Margin dots */
 .margin-dot {
   position: absolute;
-  width: 12px;
-  height: 12px;
+  width: 10px;
+  height: 10px;
   border-radius: 50%;
+  border: 2px solid transparent;
+  background-clip: padding-box;
   cursor: pointer;
   left: 14px;
-  transition: transform 0.15s, box-shadow 0.15s;
+  transition: transform 0.15s, box-shadow 0.15s, border-color 0.15s;
   display: flex;
   align-items: center;
   justify-content: center;
+  padding: 0;
+  outline: none;
+}
+
+.margin-dot::after {
+  content: "";
+  position: absolute;
+  inset: -8px;
+  border-radius: 50%;
 }
 
 .margin-dot:hover {
-  transform: scale(1.3);
+  transform: scale(1.4);
 }
 
-.margin-dot--open {
-  background: var(--color-primary);
-  box-shadow: 0 0 6px rgba(37, 99, 235, 0.3);
+.margin-dot:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: 2px;
+}
+
+.margin-dot--pending {
+  background: var(--color-status-considering);
+  border-color: rgba(245, 158, 11, 0.3);
+  box-shadow: 0 0 6px rgba(245, 158, 11, 0.25);
+}
+
+.margin-dot--todo {
+  background: var(--color-status-developing);
+  border-color: rgba(59, 130, 246, 0.3);
+  box-shadow: 0 0 6px rgba(59, 130, 246, 0.25);
 }
 
 .margin-dot--resolved {
@@ -1087,3 +1239,194 @@ body:has(.comment-toolbar) .main-content {
 .comment-toolbar__toggle input[type="checkbox"] {
   cursor: pointer;
 }
+
+/* Content navigation sidebar */
+.content-nav {
+  position: sticky;
+  top: calc(var(--nav-height) + var(--space-lg));
+  align-self: flex-start;
+  width: 220px;
+  flex-shrink: 0;
+  max-height: calc(100vh - var(--nav-height) - var(--space-xl) * 2);
+  transition: width 0.2s ease, opacity 0.2s ease;
+  margin-right: var(--space-lg);
+}
+
+.content-nav--hidden {
+  width: 0;
+  opacity: 0;
+  overflow: hidden;
+  margin-right: 0;
+}
+
+.content-nav__header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding-bottom: var(--space-sm);
+  margin-bottom: var(--space-sm);
+  border-bottom: 1px solid var(--color-border);
+}
+
+.content-nav__title {
+  font-size: var(--text-sm);
+  font-weight: 600;
+  color: var(--color-text-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.content-nav__toggle {
+  background: none;
+  border: none;
+  cursor: pointer;
+  color: var(--color-text-muted);
+  padding: 2px;
+  font-size: var(--text-sm);
+  line-height: 1;
+  border-radius: var(--radius);
+  transition: color 0.15s;
+}
+
+.content-nav__toggle:hover {
+  color: var(--color-text);
+}
+
+.content-nav__list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+  overflow-y: auto;
+  max-height: calc(100vh - var(--nav-height) - 8rem);
+  scrollbar-width: thin;
+  scrollbar-color: var(--color-border) transparent;
+}
+
+.content-nav__item {
+  margin: 0;
+}
+
+.content-nav__item--h1 {
+  /* top level — no indent */
+}
+
+.content-nav__item--h2 {
+  padding-left: var(--space-md);
+}
+
+.content-nav__item--h3 {
+  padding-left: var(--space-xl);
+}
+
+.content-nav__link {
+  display: flex;
+  align-items: center;
+  gap: var(--space-xs);
+  padding: 3px var(--space-sm);
+  font-size: 0.8rem;
+  line-height: 1.4;
+  color: var(--color-text-muted);
+  text-decoration: none;
+  border-radius: var(--radius);
+  border-left: 2px solid transparent;
+  transition: color 0.15s, border-color 0.15s, background 0.15s;
+  word-break: break-word;
+}
+
+.content-nav__link:hover {
+  color: var(--color-text);
+  background: var(--color-bg);
+  text-decoration: none;
+}
+
+.content-nav__link--active {
+  color: var(--color-primary);
+  border-left-color: var(--color-primary);
+  font-weight: 600;
+}
+
+.content-nav__link-text {
+  flex: 1;
+  min-width: 0;
+}
+
+.content-nav__badge {
+  flex-shrink: 0;
+  font-size: 0.65rem;
+  font-weight: 700;
+  min-width: 16px;
+  height: 16px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 8px;
+  color: white;
+  line-height: 1;
+}
+
+.content-nav__badge--pending {
+  background: var(--color-status-considering);
+}
+
+.content-nav__badge--todo {
+  background: var(--color-status-developing);
+}
+
+/* Toggle button when sidebar is hidden — shown outside the sidebar */
+.content-nav-show-btn {
+  position: sticky;
+  top: calc(var(--nav-height) + var(--space-lg));
+  align-self: flex-start;
+  flex-shrink: 0;
+  background: var(--color-surface);
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius);
+  padding: var(--space-xs) var(--space-sm);
+  cursor: pointer;
+  color: var(--color-text-muted);
+  font-size: var(--text-sm);
+  box-shadow: var(--shadow);
+  transition: color 0.15s, box-shadow 0.15s;
+  margin-right: var(--space-sm);
+  display: none;
+  white-space: nowrap;
+}
+
+.content-nav-show-btn:hover {
+  color: var(--color-text);
+  box-shadow: 0 2px 6px rgba(0, 0, 0, 0.1);
+}
+
+.content-nav-show-btn kbd {
+  font-family: var(--font-mono);
+  font-size: 0.7rem;
+  background: var(--color-bg);
+  border: 1px solid var(--color-border);
+  border-radius: 3px;
+  padding: 0 4px;
+  color: var(--color-text-muted);
+}
+
+.content-nav--hidden + .content-nav-show-btn {
+  display: block;
+}
+
+/* Add scroll-margin to headings so they clear the sticky nav */
+.markdown-rendered h1,
+.markdown-rendered h2,
+.markdown-rendered h3,
+.markdown-rendered h4,
+.markdown-rendered h5,
+.markdown-rendered h6 {
+  scroll-margin-top: calc(var(--nav-height) + var(--space-lg));
+}
+
+/* Hide sidebar on small screens */
+@media (max-width: 1024px) {
+  .content-nav {
+    display: none;
+  }
+  .content-nav-show-btn {
+    display: none !important;
+  }
+}

data/app/channels/coplan/plan_presence_channel.rb

@@ -0,0 +1,45 @@
+module CoPlan
+  class PlanPresenceChannel < ActionCable::Channel::Base
+    def subscribed
+      @plan = Plan.find_by(id: params[:plan_id])
+      policy = @plan && PlanPolicy.new(current_user, @plan)
+      unless @plan && policy.show?
+        reject
+        return
+      end
+
+      PlanViewer.track(plan: @plan, user: current_user)
+      broadcast_viewers
+    end
+
+    def unsubscribed
+      return unless @plan
+
+      PlanViewer.expire(plan: @plan, user: current_user)
+      broadcast_viewers
+    end
+
+    def ping
+      return unless @plan
+
+      PlanViewer.track(plan: @plan, user: current_user)
+      broadcast_viewers
+    end
+
+    private
+
+    def current_user
+      connection.current_user
+    end
+
+    def broadcast_viewers
+      viewers = PlanViewer.active_viewers_for(@plan)
+      Broadcaster.replace_to(
+        @plan,
+        target: "plan-viewers",
+        partial: "coplan/plans/viewers",
+        locals: { viewers: viewers }
+      )
+    end
+  end
+end

data/app/controllers/coplan/api/v1/comments_controller.rb

@@ -34,7 +34,7 @@ module CoPlan
           }, status: :created
 
         rescue ActiveRecord::RecordInvalid => e
-          render json: { error: e.message }, status: :unprocessable_entity
+          render json: { error: e.message }, status: :unprocessable_content
         end
 
         def resolve
@@ -98,7 +98,7 @@ module CoPlan
           }, status: :created
 
         rescue ActiveRecord::RecordInvalid => e
-          render json: { error: e.message }, status: :unprocessable_entity
+          render json: { error: e.message }, status: :unprocessable_content
         end
 
         private

data/app/controllers/coplan/api/v1/operations_controller.rb

@@ -10,12 +10,12 @@ module CoPlan
           base_revision = params[:base_revision]&.to_i
 
           unless base_revision.present?
-            render json: { error: "base_revision is required" }, status: :unprocessable_entity
+            render json: { error: "base_revision is required" }, status: :unprocessable_content
             return
           end
 
           unless operations.is_a?(Array) && operations.any?
-            render json: { error: "operations must be a non-empty array" }, status: :unprocessable_entity
+            render json: { error: "operations must be a non-empty array" }, status: :unprocessable_content
             return
           end
 
@@ -27,7 +27,7 @@ module CoPlan
             apply_direct(operations, base_revision)
           end
         rescue Plans::OperationError => e
-          render json: { error: e.message }, status: :unprocessable_entity
+          render json: { error: e.message }, status: :unprocessable_content
         end
 
         private
@@ -281,6 +281,44 @@ module CoPlan
                 return
               end
             end
+          when "replace_section"
+            return unless op["heading"]
+            include_heading = op.fetch("include_heading", true)
+            include_heading = include_heading != false && include_heading != "false"
+
+            transformed_ranges.each do |tr|
+              if include_heading
+                # Verify the heading is the first line of the section range
+                first_line_end = content.index("\n", tr[0]) || tr[1]
+                first_line = content[tr[0]...[first_line_end, tr[1]].min]
+                unless first_line&.rstrip == op["heading"]&.rstrip
+                  render json: {
+                    error: "Conflict: section at target position has changed",
+                    current_revision: @plan.current_revision,
+                    expected_heading: op["heading"],
+                    found: content[tr[0]...tr[1]]&.slice(0, 200)
+                  }, status: :conflict
+                  return
+                end
+              else
+                # Body-only: verify the heading appears on the line before tr[0].
+                # Walk backwards past any blank lines to find the heading text.
+                search_pos = tr[0]
+                search_pos -= 1 while search_pos > 0 && content[search_pos - 1] == "\n"
+                heading_line_end = search_pos
+                heading_line_start = search_pos > 0 ? (content.rindex("\n", search_pos - 1) || -1) + 1 : 0
+                heading_text = content[heading_line_start...heading_line_end]
+                unless heading_text == op["heading"]
+                  render json: {
+                    error: "Conflict: section heading before target position has changed",
+                    current_revision: @plan.current_revision,
+                    expected_heading: op["heading"],
+                    found: heading_text
+                  }, status: :conflict
+                  return
+                end
+              end
+            end
           end
         end
 

data/app/controllers/coplan/api/v1/plans_controller.rb

@@ -32,7 +32,7 @@ module CoPlan
             current_revision: plan.current_revision
           ), status: :created
         rescue ActiveRecord::RecordInvalid => e
-          render json: { error: e.message }, status: :unprocessable_entity
+          render json: { error: e.message }, status: :unprocessable_content
         end
 
         def update
@@ -61,7 +61,7 @@ module CoPlan
             current_revision: @plan.current_revision
           )
         rescue ActiveRecord::RecordInvalid => e
-          render json: { error: e.record.errors.full_messages.join(", ") }, status: :unprocessable_entity
+          render json: { error: e.record.errors.full_messages.join(", ") }, status: :unprocessable_content
         end
 
         def versions

data/app/controllers/coplan/api/v1/sessions_controller.rb

@@ -11,7 +11,7 @@ module CoPlan
         def create
           actor_type = params[:actor_type].presence || ApiToken::HOLDER_TYPE
           unless EditSession::ACTOR_TYPES.include?(actor_type)
-            render json: { error: "Invalid actor_type" }, status: :unprocessable_entity
+            render json: { error: "Invalid actor_type" }, status: :unprocessable_content
             return
           end
           ttl = actor_type == "cloud_persona" ? EditSession::CLOUD_PERSONA_TTL : EditSession::LOCAL_AGENT_TTL
@@ -56,7 +56,7 @@ module CoPlan
 
           render json: response
         rescue Plans::CommitSession::SessionNotOpenError => e
-          render json: { error: e.message }, status: :unprocessable_entity
+          render json: { error: e.message }, status: :unprocessable_content
         rescue Plans::CommitSession::StaleSessionError => e
           render json: { error: e.message }, status: :conflict
         rescue Plans::CommitSession::SessionConflictError => e

data/app/controllers/coplan/plans_controller.rb

@@ -11,6 +11,7 @@ module CoPlan
     def show
       authorize!(@plan, :show?)
       @threads = @plan.comment_threads.includes(:comments, :created_by_user).order(:created_at)
+      PlanViewer.track(plan: @plan, user: current_user)
     end
 
     def edit

data/app/controllers/coplan/settings/tokens_controller.rb

@@ -20,7 +20,7 @@ module CoPlan
       rescue ActiveRecord::RecordInvalid => e
         @api_tokens = current_user.api_tokens.order(created_at: :desc)
         flash.now[:alert] = e.message
-        render :index, status: :unprocessable_entity
+        render :index, status: :unprocessable_content
       end
 
       def destroy

data/app/helpers/coplan/application_helper.rb

@@ -1,4 +1,61 @@
 module CoPlan
   module ApplicationHelper
+    include MarkdownHelper
+    FAVICON_COLORS = {
+      "production"  => { start: "#3B82F6", stop: "#1E40AF" },
+      "staging"     => { start: "#F59E0B", stop: "#D97706" },
+      "development" => { start: "#10B981", stop: "#047857" },
+    }.freeze
+
+    def coplan_favicon_tag
+      colors = FAVICON_COLORS.fetch(Rails.env, FAVICON_COLORS["development"])
+      svg = <<~SVG
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">
+          <defs>
+            <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
+              <stop offset="0%" stop-color="#{colors[:start]}"/>
+              <stop offset="100%" stop-color="#{colors[:stop]}"/>
+            </linearGradient>
+          </defs>
+          <rect width="100" height="100" rx="22" fill="url(#g)"/>
+          <g opacity=".25" fill="none" stroke="#fff" stroke-width="2" stroke-linecap="round">
+            <line x1="16" y1="18" x2="84" y2="18"/>
+            <line x1="16" y1="28" x2="84" y2="28"/>
+            <line x1="16" y1="38" x2="84" y2="38"/>
+            <line x1="16" y1="48" x2="84" y2="48"/>
+            <line x1="16" y1="58" x2="84" y2="58"/>
+            <line x1="16" y1="68" x2="84" y2="68"/>
+            <line x1="16" y1="78" x2="84" y2="78"/>
+          </g>
+          <circle cx="40" cy="46" r="22" fill="#fff" opacity=".55"/>
+          <path d="M26,62 L18,78 L36,66 Z" fill="#fff" opacity=".55"/>
+          <circle cx="62" cy="54" r="22" fill="#fff" opacity=".55"/>
+          <path d="M76,70 L84,84 L68,72 Z" fill="#fff" opacity=".55"/>
+        </svg>
+      SVG
+
+      data_uri = "data:image/svg+xml,#{ERB::Util.url_encode(svg.strip)}"
+      tag.link(rel: "icon", type: "image/svg+xml", href: data_uri)
+    end
+
+    def plan_og_description(plan)
+      status = plan.status.capitalize
+      author = plan.created_by_user.name
+      prefix = "#{status} · by #{author}"
+      content = plan.current_content
+      return prefix if content.blank?
+
+      plain = markdown_to_plain_text(content)
+      truncated = truncate(plain, length: 200, omission: "…")
+      "#{prefix} — #{truncated}"
+    end
+
+    def coplan_environment_badge
+      return if Rails.env.production?
+
+      label = Rails.env.capitalize
+      colors = FAVICON_COLORS.fetch(Rails.env, FAVICON_COLORS["development"])
+      tag.span(label, class: "env-badge", style: "background: #{colors[:start]};")
+    end
   end
 end