@yemi33/minions 0.1.2422 → 0.1.2423

package/docs/demo/memory-system.html

@@ -369,6 +369,109 @@
   .thesis p { margin: 0; color: var(--muted); }
   .thesis strong { color: var(--text); }
 
+  .evolution-timeline {
+    display: grid;
+    grid-template-columns: repeat(4, minmax(0, 1fr));
+    gap: 16px;
+    margin: 0;
+    padding: 0;
+    list-style: none;
+  }
+  .evolution-stage {
+    position: relative;
+    display: flex;
+    min-width: 0;
+  }
+  .evolution-stage:not(:last-child)::after {
+    content: "\2192";
+    position: absolute;
+    top: 25px;
+    right: -14px;
+    z-index: 2;
+    display: grid;
+    width: 12px;
+    height: 24px;
+    place-items: center;
+    background: var(--bg);
+    color: var(--muted);
+    font-size: 0.88rem;
+    font-weight: 900;
+  }
+  .evolution-card {
+    position: relative;
+    width: 100%;
+    min-width: 0;
+    padding: 23px;
+    overflow-wrap: anywhere;
+    border: 1px solid var(--border);
+    border-radius: var(--radius-lg);
+    background: var(--surface-strong);
+  }
+  .evolution-card::before {
+    content: "";
+    position: absolute;
+    inset: 0 0 auto;
+    height: 3px;
+    border-radius: var(--radius-lg) var(--radius-lg) 0 0;
+    background: var(--blue);
+  }
+  .evolution-stage:nth-child(2) .evolution-card::before { background: var(--green); }
+  .evolution-stage:nth-child(3) .evolution-card::before { background: var(--purple); }
+  .evolution-stage:nth-child(4) .evolution-card::before { background: var(--yellow); }
+  .evolution-stage:nth-child(4) .evolution-card {
+    border-color: rgba(210, 153, 34, 0.42);
+    background: linear-gradient(145deg, rgba(210, 153, 34, 0.08), var(--surface-strong));
+  }
+  .evolution-meta {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 10px;
+    margin-bottom: 20px;
+  }
+  .evolution-index {
+    display: grid;
+    width: 34px;
+    height: 34px;
+    flex: 0 0 auto;
+    place-items: center;
+    border-radius: var(--radius-md);
+    background: rgba(88, 166, 255, 0.12);
+    color: var(--blue);
+    font-size: 0.76rem;
+    font-weight: 950;
+  }
+  .evolution-date {
+    color: var(--muted);
+    font-size: 0.72rem;
+    font-weight: 850;
+    letter-spacing: 0.08em;
+    text-align: right;
+    text-transform: uppercase;
+  }
+  .evolution-card h3 { margin-bottom: 13px; font-size: 1.12rem; }
+  .evolution-card > p { color: var(--muted); font-size: 0.86rem; }
+  .evolution-problem {
+    padding-bottom: 14px;
+    border-bottom: 1px solid var(--border);
+  }
+  .evolution-card strong { color: var(--text); }
+  .evolution-current {
+    margin: 18px 0 0;
+    padding: 13px 14px;
+    border-radius: var(--radius-md);
+    background: rgba(88, 166, 255, 0.07);
+  }
+  .evolution-stage:nth-child(2) .evolution-current { background: rgba(63, 185, 80, 0.07); }
+  .evolution-stage:nth-child(3) .evolution-current { background: rgba(188, 140, 255, 0.08); }
+  .evolution-stage:nth-child(4) .evolution-current { background: rgba(210, 153, 34, 0.09); }
+  .evolution-source {
+    margin: 18px 0 0;
+    color: var(--muted);
+    font-size: 0.78rem;
+    text-align: right;
+  }
+
   .journey-shell {
     --journey-progress: 0%;
     position: relative;
@@ -854,6 +957,8 @@
     .journey-panel { grid-template-columns: 1fr; }
     .map-shell, .prompt-layout { grid-template-columns: 1fr; }
     .map-details { min-height: 0; }
+    .evolution-timeline { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+    .evolution-stage:not(:last-child)::after { display: none; }
     .controls-grid { grid-template-columns: 1fr; }
   }
 
@@ -894,6 +999,8 @@
     .map-arrow-4 { transform: rotate(90deg); }
     .map-down { display: none; }
     .map-down-2, .map-down-3 { transform: none; }
+    .evolution-timeline { grid-template-columns: 1fr; }
+    .evolution-card { padding: 21px; }
     .mode-grid, .security-card, .bounds-grid, .surface-strip, .trouble-grid { grid-template-columns: 1fr; }
     .mode-note, .limitation { grid-column: auto; }
     .control-card dl { grid-template-columns: 1fr; gap: 2px; }
@@ -920,6 +1027,7 @@
       <span>Minions Memory</span>
     </a>
     <div class="nav-links">
+      <a href="#memory-evolution">Evolution</a>
       <a href="#memory-journey">Journey</a>
       <a href="#architecture-map">System map</a>
       <a href="#prompt-assembly">Prompt</a>
@@ -987,6 +1095,69 @@
     </div>
   </section>
 
+  <section class="section" id="memory-evolution" aria-labelledby="evolution-heading">
+    <div class="section-heading">
+      <p class="eyebrow">Evolution, verified in repository history</p>
+      <h2 id="evolution-heading">How memory grew with the problems it had to solve.</h2>
+      <p>Each layer stayed useful after the next one arrived. The current system keeps readable files, adds focused retrieval, and falls back deliberately instead of treating older paths as obsolete.</p>
+    </div>
+
+    <ol class="evolution-timeline" aria-label="Memory system evolution">
+      <li class="evolution-stage" data-memory-era="shared">
+        <article class="evolution-card" aria-labelledby="evolution-shared-title">
+          <div class="evolution-meta">
+            <span class="evolution-index" aria-hidden="true">01</span>
+            <time class="evolution-date" datetime="2026-03">March 2026</time>
+          </div>
+          <h3 id="evolution-shared-title">Shared team memory</h3>
+          <p class="evolution-problem"><strong>Problem solved:</strong> useful findings were scattered across individual task outputs.</p>
+          <p>Inbox consolidation turned agent and human notes into a deduplicated, readable team digest in <span class="code-chip">notes.md</span>, while preserving source notes in the archive.</p>
+          <p class="evolution-current"><strong>Current role:</strong> consolidation still maintains the team-readable record; the digest is also the team half of the legacy prompt path.</p>
+        </article>
+      </li>
+
+      <li class="evolution-stage" data-memory-era="personal">
+        <article class="evolution-card" aria-labelledby="evolution-personal-title">
+          <div class="evolution-meta">
+            <span class="evolution-index" aria-hidden="true">02</span>
+            <time class="evolution-date" datetime="2026-05">May 2026</time>
+          </div>
+          <h3 id="evolution-personal-title">Personal routing</h3>
+          <p class="evolution-problem"><strong>Problem solved:</strong> one shared digest gave every specialist the same broad history.</p>
+          <p>Consolidation began routing configured, non-temporary authors' findings into <span class="code-chip">knowledge/agents/&lt;agent&gt;.md</span>, using YAML identity with a filename fallback.</p>
+          <p class="evolution-current"><strong>Current role:</strong> these notebooks remain readable and maintained, but broad prompt injection is now a fallback rather than the default recall strategy.</p>
+        </article>
+      </li>
+
+      <li class="evolution-stage" data-memory-era="retrieval">
+        <article class="evolution-card" aria-labelledby="evolution-retrieval-title">
+          <div class="evolution-meta">
+            <span class="evolution-index" aria-hidden="true">03</span>
+            <time class="evolution-date" datetime="2026-07">July 2026</time>
+          </div>
+          <h3 id="evolution-retrieval-title">Structured recall</h3>
+          <p class="evolution-problem"><strong>Problem solved:</strong> growing team and personal files spent prompt space on history unrelated to the task.</p>
+          <p>Migration 017 added scoped SQL records and FTS5 search. Retrieval now reranks task matches and builds a bounded <strong>Relevant Memory</strong> pack with provenance, then wraps it in an <span class="code-chip">UNTRUSTED-INPUT</span> fence.</p>
+          <p class="evolution-current"><strong>Current default:</strong> retrieval is enabled with shadow mode off and may select up to 8 records within 8,192 bytes; pinned context remains first.</p>
+        </article>
+      </li>
+
+      <li class="evolution-stage" data-memory-era="current">
+        <article class="evolution-card" aria-labelledby="evolution-current-title">
+          <div class="evolution-meta">
+            <span class="evolution-index" aria-hidden="true">04</span>
+            <time class="evolution-date" datetime="2026-07">July 2026 to now</time>
+          </div>
+          <h3 id="evolution-current-title">Outcome capture and fallback</h3>
+          <p class="evolution-problem"><strong>Problem solved:</strong> authored notes did not consistently preserve the normalized result of every task.</p>
+          <p><strong>Opt-in</strong> <span class="code-chip">memoryEpisodicCapture</span> stores compact success, partial, or failure outcomes in SQL instead of intentionally collecting transcripts or chain-of-thought. It remains off by default; without a structured summary, a redacted, truncated stdout fallback can include transcript-like text.</p>
+          <p class="evolution-current"><strong>Legacy fallback:</strong> when retrieval is off, shadowed, empty, or errors, prompt assembly uses bounded <span class="code-chip">notes.md</span> plus the assigned agent's notebook. Episode capture does not replace either file.</p>
+        </article>
+      </li>
+    </ol>
+    <p class="evolution-source">Milestone months follow the commits that introduced each capability; behavior labels describe the current implementation.</p>
+  </section>
+
   <section class="section" id="memory-journey" aria-labelledby="journey-heading">
     <div class="section-heading">
       <p class="eyebrow">End-to-end data flow</p>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.2422",
+  "version": "0.1.2423",
   "description": "Multi-agent AI dev team that runs from ~/.minions/ — five autonomous agents share a single engine, dashboard, and knowledge base",
   "bin": {
     "minions": "bin/minions.js"