@ibgib/space-gib 0.0.33 → 0.0.34

package/src/client/ui/component/chat-view/IMPLEMENTATION.md

@@ -0,0 +1,48 @@
+# space-gib-chat-view Web Component Specification
+
+## 1. Overview & Architectural Role
+
+`space-gib-chat-view` is an `@ibgib` Web Component that provides a live discussion and companion note thread directly inside the Right Panel (`#right-panel`).
+
+### Inverted Soft Rel8ns & Living Discussions
+In standard VCS platforms (GitHub, GitLab), review comments and discussion threads live outside version control in centralized database tables. In `ibgib`:
+- Discussions, notes, and comments are first-class **metatext ibgibs** (`b2tfs_file` or comment nodes).
+- They link to target code entities (files, directories, commit tips) via **inverted soft rel8ns** (`data.targetAddr`).
+- Discussions travel with branches and merge accretively across spaces without polluting code ASTs.
+- This component renders those linked discussions in a natural, conversational chat interface.
+
+---
+
+## 2. Component Design & Capabilities
+
+- **Tag Name**: `<space-gib-chat-view>`
+- **Host Container**: `#code-chat-view-container` inside `#right-panel`
+- **Context Header**:
+  - Displays the active conversation context (e.g., `💬 Discussions: src/index.ts`).
+  - Active branch & tip indicator (`🌿 main @ 7f8a1b2`).
+  - Collapse / Close button (`◨`) to toggle the Right Panel.
+- **Message Stream**:
+  - Dynamic scrollable thread of discussion messages.
+  - Message metadata: author keystone badge (e.g., `Alice (Session Keystone)`), timestamp (`2m ago`), and target anchor badge (`🔗 L1-18`).
+  - Markdown-friendly body displaying architectural rationales, questions, and replies.
+- **Compose & Send Bar**:
+  - Auto-growing message input textarea.
+  - Attach / anchor button to pin comment to specific code lines.
+  - Send button (`Send 💬`) dispatching `space-gib-chat-message-sent`.
+
+---
+
+## 3. Custom Event Contracts
+
+- `space-gib-chat-message-sent`: Detail `{ text: string, targetAddr?: string, targetFile: string, author: string, timestamp: number }`
+- `space-gib-chat-anchor-clicked`: Detail `{ targetFile: string, lines?: string }`
+- `space-gib-chat-close-requested`: Detail `{}`
+
+---
+
+## 4. Lifecycle & Integration
+
+- Scaffolds `ChatViewComponentMeta` (extends `IbGibDynamicComponentMetaBase`)
+- Scaffolds `ChatViewComponentInstance` (extends `IbGibDynamicComponentInstanceBase<IbGib_V1, ChatViewElements>`)
+- Implements `initialize()`, `created()`, `renderUI()`, `disconnected(): Promise<void>`
+- Registered in `SpaceGibShellService` via `registerChatViewComponent()`.

package/src/client/ui/component/chat-view/chat-view.css

@@ -0,0 +1,381 @@
+:host {
+    display: flex;
+    flex-direction: column;
+    width: 100%;
+    height: 100%;
+    background: var(--clr-bg-surface, #0d1322);
+    color: var(--clr-text-primary, #f0f4fc);
+    font-family: var(--font-sans, system-ui, -apple-system, sans-serif);
+    font-size: 0.85rem;
+    overflow: hidden;
+    border-left: 1px solid var(--clr-border, rgba(255, 255, 255, 0.08));
+}
+
+.chat-root {
+    display: flex;
+    flex-direction: column;
+    width: 100%;
+    height: 100%;
+    overflow: hidden;
+}
+
+/* ── Header ── */
+.chat-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 0.75rem 1rem;
+    background: rgba(5, 8, 15, 0.6);
+    border-bottom: 1px solid var(--clr-border, rgba(255, 255, 255, 0.08));
+    flex-shrink: 0;
+}
+
+.chat-header-info {
+    display: flex;
+    align-items: center;
+    gap: 0.6rem;
+    min-width: 0;
+}
+
+.chat-header-icon {
+    font-size: 1.15rem;
+    line-height: 1;
+}
+
+.chat-title-group {
+    display: flex;
+    flex-direction: column;
+    min-width: 0;
+}
+
+.chat-title {
+    margin: 0;
+    font-size: 0.875rem;
+    font-weight: 600;
+    color: var(--clr-text-primary, #f0f4fc);
+    line-height: 1.2;
+}
+
+.chat-target-badge {
+    font-size: 0.725rem;
+    font-family: var(--font-mono, monospace);
+    color: var(--clr-accent, #78f87e);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+.chat-header-actions {
+    display: flex;
+    align-items: center;
+    gap: 0.35rem;
+}
+
+.chat-header-btn {
+    background: transparent;
+    border: 1px solid transparent;
+    color: var(--clr-text-muted, #7e8c9f);
+    padding: 0.3rem 0.45rem;
+    border-radius: var(--radius-sm, 4px);
+    cursor: pointer;
+    font-size: 0.9rem;
+    transition: all 120ms ease;
+}
+
+.chat-header-btn:hover {
+    background: rgba(255, 255, 255, 0.08);
+    color: var(--clr-text-primary, #f0f4fc);
+    border-color: var(--clr-border, rgba(255, 255, 255, 0.1));
+}
+
+/* ── Context Sub-Bar ── */
+.chat-sub-bar {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 0.35rem 1rem;
+    background: rgba(0, 0, 0, 0.25);
+    border-bottom: 1px solid var(--clr-border, rgba(255, 255, 255, 0.05));
+    font-size: 0.75rem;
+    color: var(--clr-text-secondary, #b4c0d3);
+    flex-shrink: 0;
+}
+
+.chat-context-item {
+    display: flex;
+    align-items: center;
+    gap: 0.35rem;
+    font-family: var(--font-mono, monospace);
+}
+
+.context-icon {
+    font-size: 0.8rem;
+}
+
+.filter-text {
+    color: var(--clr-text-muted, #7e8c9f);
+}
+
+/* ── Messages Stream ── */
+.chat-messages {
+    flex: 1;
+    overflow-y: auto;
+    padding: 0.85rem 1rem;
+    display: flex;
+    flex-direction: column;
+    gap: 0.85rem;
+    min-height: 0;
+}
+
+.chat-message {
+    background: rgba(18, 25, 42, 0.6);
+    border: 1px solid var(--clr-border, rgba(255, 255, 255, 0.07));
+    border-radius: var(--radius-sm, 6px);
+    padding: 0.75rem;
+    display: flex;
+    flex-direction: column;
+    gap: 0.5rem;
+    transition: border-color 150ms ease;
+}
+
+.chat-message:hover {
+    border-color: rgba(255, 255, 255, 0.15);
+}
+
+.chat-message.in-band-note {
+    border-left: 3px solid var(--clr-accent, #78f87e);
+    background: rgba(120, 248, 126, 0.03);
+}
+
+.msg-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+}
+
+.msg-author-group {
+    display: flex;
+    align-items: center;
+    gap: 0.4rem;
+}
+
+.msg-avatar {
+    font-size: 0.95rem;
+    line-height: 1;
+}
+
+.msg-author {
+    font-weight: 600;
+    font-size: 0.825rem;
+    color: var(--clr-text-primary, #f0f4fc);
+}
+
+.msg-badge {
+    font-size: 0.65rem;
+    padding: 0.1rem 0.35rem;
+    border-radius: 999px;
+    background: rgba(120, 248, 126, 0.12);
+    color: var(--clr-accent, #78f87e);
+    font-weight: 600;
+    text-transform: uppercase;
+}
+
+.peer-comment .msg-badge {
+    background: rgba(99, 102, 241, 0.15);
+    color: #a5b4fc;
+}
+
+.msg-time {
+    font-size: 0.7rem;
+    color: var(--clr-text-muted, #7e8c9f);
+}
+
+.msg-anchor {
+    display: flex;
+    align-items: center;
+    gap: 0.35rem;
+    font-size: 0.725rem;
+    font-family: var(--font-mono, monospace);
+    color: var(--clr-warn, #ffd166);
+    background: rgba(255, 209, 102, 0.08);
+    padding: 0.2rem 0.45rem;
+    border-radius: 4px;
+    width: fit-content;
+    cursor: pointer;
+}
+
+.msg-anchor:hover {
+    background: rgba(255, 209, 102, 0.16);
+}
+
+.anchor-tag {
+    font-size: 0.65rem;
+    color: var(--clr-text-muted, #7e8c9f);
+    margin-left: 0.35rem;
+    border-left: 1px solid rgba(255, 255, 255, 0.1);
+    padding-left: 0.35rem;
+}
+
+.msg-body {
+    font-size: 0.825rem;
+    line-height: 1.45;
+    color: var(--clr-text-secondary, #b4c0d3);
+}
+
+.msg-body p {
+    margin: 0 0 0.4rem 0;
+}
+
+.msg-body p:last-child {
+    margin-bottom: 0;
+}
+
+.msg-lead {
+    color: var(--clr-text-primary, #f0f4fc);
+}
+
+.msg-callout {
+    display: flex;
+    gap: 0.5rem;
+    padding: 0.55rem 0.65rem;
+    margin-top: 0.45rem;
+    border-radius: 4px;
+    background: rgba(120, 248, 126, 0.06);
+    border: 1px solid rgba(120, 248, 126, 0.15);
+    font-size: 0.775rem;
+    color: var(--clr-text-primary, #f0f4fc);
+}
+
+.callout-emoji {
+    font-size: 0.9rem;
+    line-height: 1;
+}
+
+.callout-text {
+    line-height: 1.35;
+}
+
+.msg-footer {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    margin-top: 0.2rem;
+}
+
+.msg-action-btn {
+    background: transparent;
+    border: none;
+    color: var(--clr-text-muted, #7e8c9f);
+    font-size: 0.725rem;
+    cursor: pointer;
+    padding: 0.15rem 0.4rem;
+    border-radius: 3px;
+    transition: all 120ms ease;
+}
+
+.msg-action-btn:hover {
+    background: rgba(255, 255, 255, 0.06);
+    color: var(--clr-text-primary, #f0f4fc);
+}
+
+/* ── Compose Footer ── */
+.chat-compose-footer {
+    padding: 0.75rem 1rem;
+    background: rgba(5, 8, 15, 0.75);
+    border-top: 1px solid var(--clr-border, rgba(255, 255, 255, 0.08));
+    flex-shrink: 0;
+}
+
+.compose-box {
+    display: flex;
+    flex-direction: column;
+    gap: 0.45rem;
+    background: rgba(18, 25, 42, 0.8);
+    border: 1px solid var(--clr-border, rgba(255, 255, 255, 0.12));
+    border-radius: var(--radius-sm, 6px);
+    padding: 0.5rem 0.65rem;
+    transition: border-color 150ms ease;
+}
+
+.compose-box:focus-within {
+    border-color: var(--clr-accent, #78f87e);
+    box-shadow: 0 0 0 1px rgba(120, 248, 126, 0.2);
+}
+
+.chat-textarea {
+    width: 100%;
+    background: transparent;
+    border: none;
+    outline: none;
+    color: var(--clr-text-primary, #f0f4fc);
+    font-family: inherit;
+    font-size: 0.825rem;
+    line-height: 1.4;
+    resize: none;
+    min-height: 48px;
+    box-sizing: border-box;
+}
+
+.chat-textarea::placeholder {
+    color: var(--clr-text-muted, #7e8c9f);
+}
+
+.compose-toolbar {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    border-top: 1px solid rgba(255, 255, 255, 0.05);
+    padding-top: 0.4rem;
+}
+
+.compose-tools-left {
+    display: flex;
+    align-items: center;
+    gap: 0.35rem;
+}
+
+.compose-tool-btn {
+    display: flex;
+    align-items: center;
+    gap: 0.3rem;
+    background: rgba(255, 255, 255, 0.04);
+    border: 1px solid rgba(255, 255, 255, 0.08);
+    color: var(--clr-text-secondary, #b4c0d3);
+    padding: 0.2rem 0.45rem;
+    border-radius: 4px;
+    font-size: 0.725rem;
+    font-family: var(--font-mono, monospace);
+    cursor: pointer;
+    transition: all 120ms ease;
+}
+
+.compose-tool-btn:hover {
+    border-color: var(--clr-accent, #78f87e);
+    color: var(--clr-text-primary, #f0f4fc);
+}
+
+.compose-tool-btn.active {
+    background: rgba(120, 248, 126, 0.1);
+    border-color: rgba(120, 248, 126, 0.3);
+    color: var(--clr-accent, #78f87e);
+}
+
+.compose-send-btn {
+    display: flex;
+    align-items: center;
+    gap: 0.35rem;
+    background: var(--clr-accent, #78f87e);
+    border: none;
+    color: #05080f;
+    font-weight: 600;
+    font-size: 0.775rem;
+    padding: 0.3rem 0.75rem;
+    border-radius: 4px;
+    cursor: pointer;
+    transition: all 120ms ease;
+}
+
+.compose-send-btn:hover {
+    background: #9fffa5;
+    box-shadow: 0 0 12px rgba(120, 248, 126, 0.4);
+}

package/src/client/ui/component/chat-view/chat-view.html

@@ -0,0 +1,104 @@
+<div class="chat-root" id="chat-root">
+  <!-- Header Bar -->
+  <header class="chat-header">
+    <div class="chat-header-info">
+      <span class="chat-header-icon">💬</span>
+      <div class="chat-title-group">
+        <h3 class="chat-title">Discussions</h3>
+        <span class="chat-target-badge" id="chat-target-file">src/index.ts</span>
+      </div>
+    </div>
+    <div class="chat-header-actions">
+      <button id="btn-chat-close" class="chat-header-btn" type="button" title="Collapse Panel">◨</button>
+    </div>
+  </header>
+
+  <!-- Context Sub-Bar -->
+  <div class="chat-sub-bar">
+    <div class="chat-context-item">
+      <span class="context-icon">🌿</span>
+      <span class="context-text" id="chat-branch-tip">main @ 7f8a1b2</span>
+    </div>
+    <div class="chat-filter-item">
+      <span class="filter-text">2 Notes</span>
+    </div>
+  </div>
+
+  <!-- Messages Stream -->
+  <div class="chat-messages" id="chat-messages">
+    <!-- Message 1: Architectural Note -->
+    <div class="chat-message in-band-note">
+      <div class="msg-header">
+        <div class="msg-author-group">
+          <span class="msg-avatar">👩‍💻</span>
+          <span class="msg-author">Alice</span>
+          <span class="msg-badge">Keystone</span>
+        </div>
+        <span class="msg-time">2m ago</span>
+      </div>
+      <div class="msg-anchor">
+        <span class="anchor-icon">🔗</span>
+        <span class="anchor-label">src/index.ts#L1-18</span>
+        <span class="anchor-tag">Inverted Rel8n</span>
+      </div>
+      <div class="msg-body">
+        <p class="msg-lead"><strong>Architectural Rationale</strong></p>
+        <p>This entrypoint initializes the virtual repository workspace within the browser’s local IndexedDB metaspace.
+        </p>
+        <div class="msg-callout">
+          <span class="callout-emoji">💡</span>
+          <div class="callout-text">
+            <strong>Why Living Comments?</strong> Unlike centralized SaaS review comments, this discussion node is an
+            in-band Merkle ibgib traveling directly with the branch DAG.
+          </div>
+        </div>
+      </div>
+      <div class="msg-footer">
+        <button class="msg-action-btn" type="button">Reply</button>
+        <button class="msg-action-btn" type="button">👍 1</button>
+      </div>
+    </div>
+
+    <!-- Message 2: Code Review Discussion -->
+    <div class="chat-message peer-comment">
+      <div class="msg-header">
+        <div class="msg-author-group">
+          <span class="msg-avatar">👨‍🚀</span>
+          <span class="msg-author">Bob</span>
+          <span class="msg-badge">Peer</span>
+        </div>
+        <span class="msg-time">1m ago</span>
+      </div>
+      <div class="msg-anchor">
+        <span class="anchor-icon">🔗</span>
+        <span class="anchor-label">src/index.ts#L36-42</span>
+      </div>
+      <div class="msg-body">
+        <p>Looks super clean! Should we add an async try/catch boundary around <code>boot()</code> as well?</p>
+      </div>
+      <div class="msg-footer">
+        <button class="msg-action-btn" type="button">Reply</button>
+        <button class="msg-action-btn" type="button">👍</button>
+      </div>
+    </div>
+  </div>
+
+  <!-- Compose Footer -->
+  <footer class="chat-compose-footer">
+    <div class="compose-box">
+      <textarea id="chat-input" class="chat-textarea" placeholder="Add a comment to this context." rows="2"></textarea>
+      <div class="compose-toolbar">
+        <div class="compose-tools-left">
+          <button id="btn-chat-pin" class="compose-tool-btn active" type="button" title="Pin to current line selection">
+            <span class="tool-icon">🔗</span>
+            <span class="tool-label">src/index.ts</span>
+          </button>
+        </div>
+        <button id="btn-chat-send" class="compose-send-btn" type="button">
+          <span>Send</span>
+          <span class="send-icon">💬</span>
+        </button>
+      </div>
+    </div>
+  </footer>
+</div>