@agentwhy/cli 0.2.1 → 0.3.1

package/dist/report/render/report-page/files-view.js

@@ -24,8 +24,12 @@ import { fixId, storyId } from './to-do-view.js';
  * `protectKeys` names the files **Protect it** is offered for - private, not protected yet, and inside the project - and
  * the everyday ones inside it, offered **Make it private**.
  */
-export function filesView(rows, items, protectKeys, names) {
+export function filesView(rows, items, protectKeys, names, leftOut = 0) {
     const entries = rows.map((row, key) => ({ row, key }));
+    // Names past the most a page lists are said as a number, never dropped in silence (invariant 4).
+    const more = leftOut === 0 ? '' : '<p class="fl-note">' + inLanguages((t) => t('fl.namesLeftOut', { n: leftOut })) + '</p>';
+    // OW4 as amended 2026-10-05: an order is offered only where the files came up at more than one moment.
+    const orderable = momentsOf(rows) > 1;
     const opened = entries.filter(({ row }) => !onlyNamed(row));
     // One list, in the order a person deals with it (the maintainer, 2026-09-24): what the AI read, in coral; then the
     // private files it only saw the name of, in blue; then everything else. A name only seen is still never counted as
@@ -33,7 +37,8 @@ export function filesView(rows, items, protectKeys, names) {
     const listed = [...entries].sort((a, b) => tierOf(a.row) - tierOf(b.row));
     if (opened.length === 0) {
         return '<div class="fl"><div class="rp-alone">' + guideCard({ tone: 'mint', title: inLanguages((t) => t('fl.noneListed')), body: inLanguages((t) => t('fl.commands')) }) +
-            '</div>' + (listed.length === 0 ? '' : table(listed, items, protectKeys, false, names)) + '</div>';
+            '</div>' + (listed.length === 0 ? '' : (orderable ? '<div class="fl-filters js-only"><div class="fl-row">' + inLanguages(orderChoice) + '</div></div>' : '') +
+            table(listed, items, protectKeys, false, names, orderable)) + more + '</div>';
     }
     const privates = opened.filter(({ row }) => row.private).length;
     const action = privates === 0 ? inLanguages((t) => t('fl.noneRead'))
@@ -42,14 +47,27 @@ export function filesView(rows, items, protectKeys, names) {
     const lead = privates === 0 ? 'fl.leadNone' : privates === opened.length ? 'fl.leadAll' : 'fl.lead';
     return '<div class="fl' + (privates === 0 ? ' fl-clean' : '') + '">' +
         hero({ eyebrow: inLanguages((t) => t('fl.eyebrow')), fact: inLanguages((t) => t('fl.fact', { n: opened.length })), action, lead: inLanguages((t) => t(lead)) }) +
-        filters(listed.map(({ row }) => row)) + table(listed, items, protectKeys, true, names) +
+        filters(listed.map(({ row }) => row), orderable) + table(listed, items, protectKeys, true, names, orderable) +
         '<p class="fl-note">' + inLanguages((t) => t('fl.shown', { shown: '<span data-files-shown>' + listed.length + '</span>', n: listed.length })) + ' ' +
-        inLanguages((t) => t('fl.commands')) + '</p></div>';
+        inLanguages((t) => t('fl.commands')) + '</p>' + more + '</div>';
 }
-/** The table's three parts, in the order a person deals with them: read (coral), only its name seen (blue), the rest. */
-const TIERS = [{ key: 'fl.tier.read', tone: 'coral' }, { key: 'fl.tier.name', tone: 'blue' }, { key: 'fl.tier.rest', tone: 'grey' }];
+/**
+ * The table's parts, in the order a person deals with them (guidelines §9: the incident first, then what was stopped,
+ * then what is fine): read (coral), not known whether read (amber), stopped (mint), only its name seen (blue), the rest.
+ */
+const TIERS = [
+    { key: 'fl.tier.read', tone: 'coral' }, { key: 'fl.tier.unknown', tone: 'amber' }, { key: 'fl.tier.stopped', tone: 'mint' },
+    { key: 'fl.tier.name', tone: 'blue' }, { key: 'fl.tier.rest', tone: 'grey' },
+];
 function tierOf(row) {
-    return row.private && (row.access === 'read' || row.access === 'changed') ? 0 : onlyNamed(row) ? 1 : 2;
+    // Only a private file has a part of its own; an everyday file, whatever was done to it, is part of the rest (P32,
+    // 2026-10-05). A private file stopped or of no known end was listed with the rest until 2026-10-05, so a conversation
+    // the AI was stopped in drew one part, and no heading at all.
+    if (!row.private)
+        return 4;
+    if (row.access === 'read' || row.access === 'changed')
+        return 0;
+    return row.access === 'unknown' ? 1 : row.access === 'stopped' ? 2 : onlyNamed(row) ? 3 : 4;
 }
 /**
  * The window of every row not on the to-do list, written beside the page's other windows, outside the views. A private
@@ -61,8 +79,11 @@ export function fileWindows(rows, protectKeys, report, clock, names) {
     return rows.map((row, key) => {
         if (row.item !== undefined)
             return '';
-        const story = row.private ? fileStory(report, row.path) : undefined;
-        return story === undefined || story.entries.length === 0 ? fileWindow(row, key, protectKeys, names) : rowStoryWindow(row, key, story, report, protectKeys, clock, names);
+        // `the-same-window-for-every-file` EF7: the window follows what the model holds for the row, not whether the file is
+        // private. An everyday file the AI read, changed or was stopped from has its calls (EF2) and tells the same story; a
+        // name only seen has none kept (EFD1) and keeps the simple window, as a file the flows name nowhere always has.
+        const story = fileStory(report, row.path);
+        return story.entries.length === 0 ? fileWindow(row, key, protectKeys, names) : rowStoryWindow(row, key, story, report, protectKeys, clock, names);
     }).join('');
 }
 /** A private file with nothing to fix, in the story window: its row's words for what happened and what to do. */
@@ -71,7 +92,9 @@ function rowStoryWindow(row, key, story, report, protectKeys, clock, names) {
     const read = report.privateFiles.find((file) => file.path === row.path);
     const pattern = report.findings.find((finding) => finding.path === row.path)?.pattern;
     const reach = LOOKS[LOOK[row.access === 'changed' ? 'read' : row.access]];
-    const exposed = row.access === 'read' || row.access === 'changed';
+    // A copy reached the AI, so the diagram ends at the company. A write is not that: for a private file it has always
+    // followed a read, and for an everyday file (EF1) nothing says what was inside before it was written.
+    const exposed = row.access === 'read' || (row.private && row.access === 'changed');
     const protectKey = protectKeys.get(row.path);
     return storyPopup(story, {
         path: row.path,
@@ -79,11 +102,18 @@ function rowStoryWindow(row, key, story, report, protectKeys, clock, names) {
         title: label(row.kind),
         ...(pattern === undefined ? {} : { pattern }),
         exposed,
-        summary: label('fl.w.did.' + row.access),
+        ...(row.private ? {} : { everyday: true }),
+        summary: label(didKey(row)),
         ...(exposed ? {} : { look: { glyph: reach.glyph, tone: reach.tone } }),
     }, 'file-' + key, report.scope.sessionId, clock, { context: label(nextOf(row)), names }, protectKey === undefined ? '' : '<span data-protect-open="' + protectKey + '">' +
         pill({ label: label(protectLabel(row)), tone: 'light', size: 'md', href: '#protect-' + protectKey, attributes: opener('protect-' + protectKey) }) + '</span>');
 }
+/** What the AI did to a file, in its window's words: an everyday file's read and stop have words of their own. */
+function didKey(row) {
+    if (row.private)
+        return 'fl.w.did.' + row.access;
+    return row.access === 'changed' ? 'fl.w.did.changed' : row.access === 'stopped' ? 'fl.w.did.everydayStopped' : 'fl.w.did.everydayRead';
+}
 /** What to do about a file with nothing on the to-do list: the last answer of its window. */
 function nextOf(row) {
     return !row.private ? 'fl.w.next.none' : row.protection === 'yes' ? 'fl.w.next.safe' : row.protection === 'told' ? 'fl.w.next.told' : 'fl.w.next.maybe';
@@ -102,8 +132,54 @@ const PROTECTED = {
 function didOf(row) {
     return row.access === 'read' || row.access === 'name' || row.access === 'stopped' ? row.access : 'other';
 }
+/**
+ * OW4: the order of the rows - what needs the person first, as drawn, or the order the AI went - asked as a question,
+ * as the filters are, and a script's: without one the rows stay as drawn (OW6).
+ */
+function orderChoice(t) {
+    return labelledSelect(e(t('fl.order.q')), [
+        { value: 'need', label: e(t('fl.order.need')) },
+        { value: 'steps', label: e(t('fl.order.steps')) },
+    ], ' data-files-sort data-live-keep');
+}
+/** The moments the rows came up at: each AI's times it came across files, and one more for rows with none known. */
+function momentsOf(rows) {
+    return new Set(rows.map((row) => (row.step === undefined ? 'none' : row.step.rank + ':' + row.step.number))).size;
+}
+/**
+ * OW3 as amended 2026-10-05: a heading over the files of each moment, in words - "First", then "Then" - shown only in
+ * the order the AI went, where its rows are put under it. A helper's are named for it. Drawn hidden after the rows: the
+ * script moves each to its moment, before the moment's first file, and shows it.
+ */
+/**
+ * EF6: one moment in words - "First", "Then", a helper's - the same words the table heads its moments with (OW3), for
+ * the window of a row that is not ordered beside anything. An action number is Advanced's alone (guidelines §7).
+ */
+function momentWords(step) {
+    return inLanguages((t) => step === undefined ? t('fl.order.unknown')
+        : step.helper === undefined ? t(step.number === 1 ? 'fl.order.first' : 'fl.order.then')
+            : t(step.number === 1 ? 'fl.order.helperFirst' : 'fl.order.helperThen', { helper: t('st.helper', { ordinal: step.helper }) }));
+}
+function momentHeadings(rows) {
+    const moments = new Map();
+    for (const row of rows) {
+        const key = row.step === undefined ? 'none' : row.step.rank + ':' + row.step.number;
+        const known = moments.get(key);
+        if (known === undefined)
+            moments.set(key, { ...(row.step === undefined ? {} : { step: row.step }), count: 1 });
+        else
+            known.count += 1;
+    }
+    const at = (step) => [step?.rank ?? 9999, step?.number ?? 0];
+    return [...moments.values()].sort((a, b) => at(a.step)[0] - at(b.step)[0] || at(a.step)[1] - at(b.step)[1]).map(({ step, count }) => ({
+        group: momentWords(step),
+        tone: 'grey',
+        count,
+        attributes: ' data-files-step hidden data-order-agent="' + (step?.rank ?? 9999) + '" data-order-step="' + (step?.number ?? 0) + '" data-order-place="-1"',
+    }));
+}
 /** P34: the search, the three groups with their counts, and the two questions - a script's, so only with one. */
-function filters(rows) {
+function filters(rows, orderable) {
     const count = (test) => rows.filter(test).length;
     const groups = [['all', rows.length], ['fix', count((row) => row.group === 'fix')], ['fixed', count((row) => row.group === 'fixed')]]
         .map(([group, n]) => '<button type="button" class="fl-pill' + (group === 'all' ? ' fl-on' : '') + '" data-files-group="' + group + '" data-live-keep aria-pressed="' + String(group === 'all') + '">' +
@@ -120,13 +196,13 @@ function filters(rows) {
         '<input class="fl-search" type="search" data-files-search data-live-keep placeholder="' + e(translator('en')('fl.search')) + '"' +
         LANGS.map((lang) => ' data-placeholder-' + lang + '="' + e(translator(lang)('fl.search')) + '"').join('') + labelAttributes((t) => e(t('fl.search'))) + '>' +
         '<div class="fl-pills">' + groups + '</div></div>' +
-        '<div class="fl-row">' + inLanguages(did) + inLanguages(prot) + textButton(inLanguages((t) => t('fl.clear')), ' data-files-clear hidden', 'fl-clear') + '</div></div>';
+        '<div class="fl-row">' + (orderable ? inLanguages(orderChoice) : '') + inLanguages(did) + inLanguages(prot) + textButton(inLanguages((t) => t('fl.clear')), ' data-files-clear hidden', 'fl-clear') + '</div></div>';
 }
 /**
  * P35: `File · AI · Private file · When your AI reaches it · Action` (the mode its own column since 2026-09-25; X28 names
  * the AI it holds for since 2026-09-29), a row opening its story window or its simple one (P37).
  */
-function table(entries, items, protectKeys, filtered, names) {
+function table(entries, items, protectKeys, filtered, names, orderable) {
     const label = (key) => inLanguages((t) => t(key));
     return dataTable({
         head: [label('fl.col.file'), label('fl.col.ai'), label('fl.col.prot'), label('fl.col.mode'), label('fl.col.action')],
@@ -134,38 +210,40 @@ function table(entries, items, protectKeys, filtered, names) {
         columns: 'minmax(240px,2fr) 120px 140px minmax(250px,1.2fr) 110px',
         minWidth: 980,
         empty: label('fl.noMatch'),
-        // Only the table of opened files is the one the filters work on; the names under it are a list, not a filter's rows.
-        ...(filtered ? { attributes: ' data-files-table' } : {}),
-        rows: entries.flatMap(({ row, key }, at) => {
-            const tier = tierOf(row);
-            // A heading over each part, where the table has more than one: its first row is where the part begins.
-            const parts = new Set(entries.map((entry) => tierOf(entry.row))).size;
-            const heading = parts > 1 && (at === 0 || tierOf(entries[at - 1].row) !== tier)
-                ? [{
-                        group: label(TIERS[tier].key), tone: TIERS[tier].tone, count: entries.filter((entry) => tierOf(entry.row) === tier).length,
-                        attributes: ' data-files-tier="' + tier + '"',
-                    }]
-                : [];
-            const item = row.item === undefined ? undefined : items[row.item];
-            const target = row.item === undefined ? 'file-' + key : storyId(row.item);
-            const kind = item === undefined ? label(row.kind) : inLanguages((t, lang) => titleOf(item, t, lang));
-            return [...heading, {
-                    cells: [
-                        '<span class="fl-kind">' + kind + '</span><span class="fl-chip" title="' + e(row.path) + '">' + e(names(row.path)) + '</span>',
-                        row.private ? statusIcon(LOOK[row.access === 'changed' ? 'read' : row.access], label('fl.acc.' + row.access)) : '<span class="fl-plain">' + label('fl.acc.' + row.access) + '</span>',
-                        privateCell(row, protectKeys.get(row.path)),
-                        modeCell(row, protectKeys.get(row.path)),
-                        actionCell(row),
-                    ],
-                    href: '#' + target,
-                    linkAttributes: opener(target),
-                    label: e(row.path),
-                    // The status bar: protected now, read before, and not fixed - the one row whose rule came too late (guidelines §4).
-                    bar: row.private && row.protection === 'yes' && row.access === 'read' && row.group === 'fix',
-                    attributes: ' data-live-key="' + e(row.path) + '" data-file-key="' + key + '" data-tier="' + tier + '" data-group="' + row.group + '" data-did="' + didOf(row) + '" data-prot="' + row.protection + '"' +
-                        ' data-search="' + e(row.path.toLowerCase()) + '"' + (row.item === undefined ? '' : ' data-file-item="' + row.item + '"'),
-                }];
-        }),
+        // Only the table of opened files is the one the filters work on; either may be put in the order the AI went (OW4).
+        attributes: (filtered ? ' data-files-table' : '') + (orderable ? ' data-files-orderable' : ''),
+        rows: [...entries.flatMap(({ row, key }, at) => {
+                const tier = tierOf(row);
+                // A heading over each part, where the table has more than one: its first row is where the part begins.
+                const parts = new Set(entries.map((entry) => tierOf(entry.row))).size;
+                const heading = parts > 1 && (at === 0 || tierOf(entries[at - 1].row) !== tier)
+                    ? [{
+                            group: label(TIERS[tier].key), tone: TIERS[tier].tone, count: entries.filter((entry) => tierOf(entry.row) === tier).length,
+                            attributes: ' data-files-tier="' + tier + '"',
+                        }]
+                    : [];
+                const item = row.item === undefined ? undefined : items[row.item];
+                const target = row.item === undefined ? 'file-' + key : storyId(row.item);
+                const kind = item === undefined ? label(row.kind) : inLanguages((t, lang) => titleOf(item, t, lang));
+                return [...heading, {
+                        cells: [
+                            '<span class="fl-kind">' + kind + '</span><span class="fl-chip" title="' + e(row.path) + '">' + e(names(row.path)) + '</span>',
+                            row.private ? statusIcon(LOOK[row.access === 'changed' ? 'read' : row.access], label('fl.acc.' + row.access)) : '<span class="fl-plain">' + label('fl.acc.' + row.access) + '</span>',
+                            privateCell(row, protectKeys.get(row.path)),
+                            modeCell(row, protectKeys.get(row.path)),
+                            actionCell(row),
+                        ],
+                        href: '#' + target,
+                        linkAttributes: opener(target),
+                        label: e(row.path),
+                        // The status bar: protected now, read before, and not fixed - the one row whose rule came too late (guidelines §4).
+                        bar: row.private && row.protection === 'yes' && row.access === 'read' && row.group === 'fix',
+                        attributes: ' data-live-key="' + e(row.path) + '" data-file-key="' + key + '" data-tier="' + tier + '" data-group="' + row.group + '" data-did="' + didOf(row) + '" data-prot="' + row.protection + '"' +
+                            ' data-search="' + e(row.path.toLowerCase()) + '"' + (row.item === undefined ? '' : ' data-file-item="' + row.item + '"') +
+                            // OW5: by AI, then step, then the file's place in it; a row with no step last.
+                            ' data-order-agent="' + (row.step?.rank ?? 9999) + '" data-order-step="' + (row.step?.number ?? 0) + '" data-order-place="' + (row.step?.place ?? 0) + '"',
+                    }];
+            }), ...(orderable ? momentHeadings(entries.map(({ row }) => row)) : [])],
     });
 }
 /**
@@ -193,7 +271,12 @@ function privateCell(row, key) {
 function modeCell(row, key) {
     const label = (id) => inLanguages((t) => t(id));
     const blocked = glyphIcon(MODE_SVG.block, 'mint', label('fl.mode.yes'));
-    const made = key === undefined ? '' : '<span data-protected="' + key + '" hidden>' + blocked + '</span>';
+    const tracked = glyphIcon(MODE_SVG.tell, 'sand', label('fl.mode.told'));
+    // `block-or-track-from-the-report` BT7: the window writes one of two answers, so both are drawn beside the row's own
+    // and the script shows the one the person chose - it never writes markup of its own.
+    const made = key === undefined ? ''
+        : '<span data-made="block" data-made-key="' + key + '" hidden>' + blocked + '</span>' +
+            '<span data-made="tell" data-made-key="' + key + '" hidden>' + tracked + '</span>';
     if (row.protection === 'yes')
         return blocked;
     // F57: the person chose this. Nothing is wrong with it, so it is in Track's sand, and nothing offers to protect it.
@@ -230,9 +313,7 @@ function actionCell(row) {
 function fileWindow(row, key, protectKeys, names) {
     const id = 'file-' + key;
     const label = (k) => inLanguages((t) => t(k));
-    const did = row.private
-        ? 'fl.w.did.' + row.access
-        : row.access === 'changed' ? 'fl.w.did.changed' : row.access === 'stopped' ? 'fl.w.did.everydayStopped' : 'fl.w.did.everydayRead';
+    const did = didKey(row);
     const next = nextOf(row);
     const protectKey = protectKeys.get(row.path);
     // Each answer carries its colour's glyph, so the state is seen before it is read (guidelines §9.3): what the AI did
@@ -242,12 +323,15 @@ function fileWindow(row, key, protectKeys, names) {
         [reach.glyph, row.private ? reach.tone : 'grey'],
         PROTECTED[row.protection],
         [LOOKS.none.glyph, 'grey'],
+        ['·', 'grey'],
     ];
-    const fact = (at, question, answer) => {
+    const written = (at, question, answer) => {
         const [glyph, tone] = glyphs[at];
         return '<div class="fw-row"><span class="fw-glyph fw-' + tone + '" aria-hidden="true">' + glyph + '</span>' +
-            '<div><div class="fw-q">' + label(question) + '</div><div class="fw-a">' + label(answer) + '</div></div></div>';
+            '<div><div class="fw-q">' + label(question) + '</div><div class="fw-a">' + answer + '</div></div></div>';
     };
+    const fact = (at, question, answer) => written(at, question, label(answer));
+    const moment = (at, answer) => written(at, 'fl.w.when', answer);
     return popup({
         id,
         size: 'small',
@@ -255,7 +339,10 @@ function fileWindow(row, key, protectKeys, names) {
         body: '<div class="fw"><div class="fw-top"><div class="fw-id"><h2 class="fw-title" id="' + id + '-title">' + label(row.kind) + '</h2>' +
             '<span class="fl-chip" title="' + e(row.path) + '">' + e(names(row.path)) + '</span></div>' +
             closeButton(labelAttributes((t) => t('app.close')) + CLOSES, 'sm') + '</div>' +
-            '<div class="fw-facts">' + fact(0, 'fl.w.did', did) + fact(1, 'fl.w.prot', 'fl.w.prot.' + row.protection) + fact(2, 'fl.w.next', next) + '</div></div>' +
+            '<div class="fw-facts">' + fact(0, 'fl.w.did', did) + fact(1, 'fl.w.prot', 'fl.w.prot.' + row.protection) + fact(2, 'fl.w.next', next) +
+            // EF6: where the model says at which moment the file came up, this window says it too - the row beside it does.
+            // No step known draws no row: an absent answer is not the claim that nothing is known about the order (invariant 4).
+            (row.step === undefined ? '' : moment(3, momentWords(row.step))) + '</div></div>' +
             popupFoot('', pill({ label: label('app.close'), tone: 'outline', size: 'md', button: true, attributes: CLOSES }) +
                 (protectKey === undefined ? '' : '<span data-protect-open="' + protectKey + '">' +
                     pill({ label: label(protectLabel(row)), tone: row.protection === 'na' ? 'outline' : 'light', size: 'md', href: '#protect-' + protectKey, attributes: opener('protect-' + protectKey) }) + '</span>'), true),
@@ -269,6 +356,14 @@ function fileWindow(row, key, protectKeys, names) {
  */
 export const FILES_SCRIPT = String.raw `
 (() => {
+  // OW5 as amended 2026-10-05: in the order the AI went, each moment's heading stands over its files while one shows.
+  const moments = (table) => {
+    const by = table.classList.contains('fl-by-step');
+    const files = [...table.querySelectorAll('[data-file-key]')];
+    table.querySelectorAll('[data-files-step]').forEach((heading) => {
+      heading.hidden = !by || !files.some((row) => !row.hidden && row.dataset.orderAgent === heading.dataset.orderAgent && row.dataset.orderStep === heading.dataset.orderStep);
+    });
+  };
   const started = new WeakSet();
   const start = (table) => {
     if (started.has(table)) return;
@@ -288,6 +383,7 @@ export const FILES_SCRIPT = String.raw `
       table.querySelectorAll('[data-files-tier]').forEach((heading) => {
         heading.hidden = !rows.some((row) => !row.hidden && row.dataset.tier === heading.dataset.filesTier);
       });
+      moments(table);
       box.querySelectorAll('[data-files-shown]').forEach((element) => { element.textContent = String(shown); });
       const empty = table.querySelector('.dt-empty');
       if (empty) empty.hidden = shown !== 0;
@@ -321,7 +417,31 @@ export const FILES_SCRIPT = String.raw `
     document.addEventListener('files-changed', apply);
     apply();
   };
-  window.agentwhyFiles = (scope) => scope.querySelectorAll('[data-files-table]').forEach(start);
+  // OW5, OW6: the order the AI went moves the rows and their moments' headings, by AI, step and place, and hides the
+  // parts' headings by a class the filters do not touch; the default puts every element back where it was drawn, the
+  // moments' headings hidden. Filters and search are left as they are.
+  const ordered = new WeakSet();
+  const order = (table) => {
+    if (ordered.has(table)) return;
+    ordered.add(table);
+    const box = table.closest('.fl') || document;
+    const drawn = [...table.children];
+    const key = (row) => [Number(row.dataset.orderAgent), Number(row.dataset.orderStep), Number(row.dataset.orderPlace)];
+    box.addEventListener('change', (event) => {
+      if (!event.target.matches('[data-files-sort]')) return;
+      const bySteps = event.target.value === 'steps';
+      box.querySelectorAll('[data-files-sort]').forEach((select) => { select.value = event.target.value; });
+      table.classList.toggle('fl-by-step', bySteps);
+      const rows = drawn.filter((element) => element.hasAttribute('data-order-agent'));
+      const next = bySteps ? rows.slice().sort((a, b) => { const x = key(a); const y = key(b); return x[0] - y[0] || x[1] - y[1] || x[2] - y[2]; }) : drawn;
+      next.forEach((element) => table.appendChild(element));
+      moments(table);
+    });
+  };
+  window.agentwhyFiles = (scope) => {
+    scope.querySelectorAll('[data-files-table]').forEach(start);
+    scope.querySelectorAll('[data-files-orderable]').forEach(order);
+  };
   window.agentwhyFiles(document);
 })();
 `;
@@ -334,6 +454,7 @@ export const FILES_SCRIPT = String.raw `
  */
 export const FILES_VIEW_STYLE = String.raw `
 .fl{max-width:1100px;margin:0 auto;container:files/inline-size}
+.fl-by-step [data-files-tier]{display:none}
 .fl .dt-group{position:sticky;top:0;z-index:3;padding:13px 20px;font-size:16px;font-weight:650;letter-spacing:0;color:var(--text)}
 .fl .dt-group-cell{gap:10px}
 .fl .dt-group-dot{width:9px;height:9px}
@@ -359,7 +480,7 @@ export const FILES_VIEW_STYLE = String.raw `
 .fl-chip{display:inline-flex;margin-top:6px;font-family:var(--mono);font-size:13.5px;font-weight:500;color:var(--text);background:var(--white-07);border:1px solid var(--white-10);border-radius:6px;padding:2px 7px;white-space:nowrap;max-width:100%;overflow:hidden;text-overflow:ellipsis}
 .fl-plain{font-size:13.5px;font-weight:600;color:var(--text-2)}
 .fl-prot{display:flex;align-items:center;gap:10px;flex-wrap:nowrap}
-.fl-prot[hidden],[data-protected][hidden]{display:none}
+.fl-prot[hidden],[data-protected][hidden],[data-made-key][hidden]{display:none}
 .fw-glyph svg{width:13px;height:13px}
 [data-row-control]{position:relative;z-index:2}
 .fl-act{font-size:13.5px;font-weight:600;white-space:nowrap}.fl-act[hidden]{display:none}

package/dist/report/render/report-page/files.js

@@ -4,8 +4,40 @@ import { matchesGlob } from '../../../core/policy/glob.js';
 import { helperViews } from './helpers.js';
 import { nameOf, ruleKey } from './item-names.js';
 import { toDoItems } from './to-do.js';
+/** Each file's step, by its path, with each AI ranked as the Helpers tab orders them: Your AI, then helpers by number. */
+function stepsOf(report, accessOf) {
+    const helpers = [...report.graph.agents].sort((a, b) => (a.ordinal ?? Infinity) - (b.ordinal ?? Infinity) || a.index - b.index);
+    const agents = new Map([report.graph.main, ...helpers].map((agent, rank) => [agent.index, { rank, ordinal: agent === report.graph.main ? undefined : agent.ordinal }]));
+    // OW1 as amended 2026-10-05: a row stands at the first step that did to its file what the row says - the read after
+    // the listing that named it - else at the first that reached it. The steps come in the page's order of AIs.
+    const chosen = new Map();
+    for (const step of report.fileSteps ?? []) {
+        const access = accessOf.get(step.path);
+        const fits = (one) => access !== undefined && one.how === HOW[access];
+        const known = chosen.get(step.path);
+        if (known === undefined || (!fits(known) && fits(step)))
+            chosen.set(step.path, step);
+    }
+    // Each AI's moments, in its own order, numbered from 1: the action's own number stays in Advanced.
+    const times = new Map();
+    for (const step of chosen.values())
+        times.set(step.agentIndex, [...new Set([...(times.get(step.agentIndex) ?? []), step.step])].sort((a, b) => a - b));
+    return new Map([...chosen.values()].flatMap((step) => {
+        const agent = agents.get(step.agentIndex);
+        if (agent === undefined)
+            return [];
+        return [[step.path, {
+                    rank: agent.rank, ...(agent.ordinal === undefined ? {} : { helper: agent.ordinal }),
+                    number: (times.get(step.agentIndex) ?? []).indexOf(step.step) + 1, place: step.place,
+                }]];
+    }));
+}
 const REACH = { read: 'read', unknown: 'unknown', named: 'name', stopped: 'stopped' };
-const STRENGTH = ['read', 'unknown', 'name', 'stopped', 'changed'];
+/** What an action did to a file, in the model's words, for each thing a row says. */
+const HOW = { read: 'read', name: 'named', unknown: 'unknown', stopped: 'stopped', changed: 'changed' };
+// A stop outranks a name seen (changed 2026-10-05 by the maintainer): `rg --files` found it, `cat` of it was stopped -
+// the rule held, which the person is to hear, and the name alone is the step before it.
+const STRENGTH = ['read', 'unknown', 'stopped', 'name', 'changed'];
 export function fileRows(report, items, done, denied) {
     const patternOf = new Map(report.findings.map((finding) => [finding.path, finding.pattern]));
     const reached = new Map();
@@ -46,23 +78,34 @@ export function fileRows(report, items, done, denied) {
     const everydayRows = report.everydayFiles.filter((file) => !reached.has(file.path)).map((file) => ({
         path: file.path,
         private: false,
-        access: file.how === 'changed' ? 'changed' : file.how === 'stopped' ? 'stopped' : 'read',
+        access: file.how === 'changed' ? 'changed' : file.how === 'stopped' ? 'stopped' : file.how === 'named' ? 'name' : 'read',
         protection: 'na',
         group: 'none',
         kind: kindOfName(nameOf(file.path)),
     }));
-    return [...privateRows, ...everydayRows];
+    const rows = [...privateRows, ...everydayRows];
+    // A row's step is chosen by what the row says, so it is found once every row is.
+    const steps = stepsOf(report, new Map(rows.map((row) => [row.path, row.access])));
+    return rows.map((row) => {
+        const step = steps.get(row.path);
+        return step === undefined ? row : { ...row, step };
+    });
 }
-/** A private file the AI only saw the name of: nothing shows it opened it, or that it exists. */
+/**
+ * A file the AI only saw the name of, private or not: nothing shows it opened it, or that it exists, so it is never
+ * counted as opened (P32a) - a row of the table all the same.
+ */
 export function onlyNamed(row) {
-    return row.private && row.access === 'name';
+    return row.access === 'name';
 }
 /**
- * How many files the Files tab lists, as the report's sidebar counts them: every row but a name only seen. Marks and
- * rules change a row's group and protection, never whether it is a row, so none is needed to count them.
+ * How many rows the Files tab lists - what a conversation's "See all {n} files" leads to (F14). Every row, a name only
+ * seen among them (changed 2026-10-05: a session whose AI listed a folder had no link to the files it saw); the
+ * sidebar's count and the tab's heading keep to the files opened (P32a). Marks and rules change a row's group and
+ * protection, never whether it is a row, so none is needed to count them.
  */
 export function listedFiles(report) {
-    return fileRows(report, toDoItems(report), new Set(), undefined).filter((row) => !onlyNamed(row)).length;
+    return fileRows(report, toDoItems(report), new Set(), undefined).length;
 }
 const SOURCE = /\.(ts|tsx|js|jsx|mjs|cjs|py|go|rb|rs|java|kt|swift|c|h|cpp|hpp|cs|php|sh|vue|svelte|css|scss|html|sql)$/i;
 /** P33's fixed table: what an everyday file is, from its name alone. */

package/dist/report/render/report-page/fix-wizard-script.js

@@ -46,30 +46,40 @@ export const FIX_WIZARD_SCRIPT = String.raw `
   };
 
   // P38: the rule is sent, and the window closes only once it is written; otherwise it says why, or what to run.
+  // BT6: the window may ask which mode the file gets, and each of its two buttons says which it is. A block is the deny
+  // rule it has always been; Track takes no rule out - there is none holding the file - and puts the pattern on this
+  // person's own told list, where a block written from here already goes without asking (BTD2).
   const protect = (button) => {
     const dialog = button.closest('dialog');
-    const every = dialog.querySelector('[data-protect-every]');
+    const mode = button.getAttribute('data-protect-mode') || 'block';
+    const every = dialog.querySelector('[data-protect-every="' + mode + '"]');
     const pattern = every && every.checked ? button.getAttribute('data-pattern-every') : button.getAttribute('data-pattern');
     const reason = dialog.querySelector('[data-note-reason]');
-    const command = dialog.querySelector('[data-note-command]');
+    const command = dialog.querySelector('[data-note-command="' + mode + '"]');
     reason.hidden = true;
-    command.hidden = true;
+    if (command) command.hidden = true;
     const buttons = [...dialog.querySelectorAll('button')];
     buttons.forEach((each) => { each.disabled = true; });
-    send('api/settings', { change: 'protect', pattern }).then((answer) => {
+    const body = mode === 'tell'
+      ? { change: 'mode', to: 'tell', patterns: [pattern], rules: [], where: 'local' }
+      : { change: 'protect', pattern };
+    send('api/settings', body).then((answer) => {
       buttons.forEach((each) => { each.disabled = false; });
       if (answer.ok) {
         const at = button.getAttribute('data-protect');
         document.querySelectorAll('[data-protect-open="' + at + '"]').forEach((open) => { open.hidden = true; open.style.display = 'none'; });
         document.querySelectorAll('[data-protected="' + at + '"]').forEach((tag) => { tag.hidden = false; });
-        document.querySelectorAll('[data-file-key="' + at + '"]').forEach((row) => { row.dataset.prot = 'yes'; });
+        // BT7: the answer the person chose, out of the ones the row was drawn with.
+        document.querySelectorAll('[data-made-key="' + at + '"]').forEach((one) => { one.hidden = one.getAttribute('data-made') !== mode; });
+        document.querySelectorAll('[data-file-key="' + at + '"]').forEach((row) => { row.dataset.prot = mode === 'tell' ? 'told' : 'yes'; });
         document.dispatchEvent(new CustomEvent('files-changed'));
         dialog.close();
       } else if (answer.reached) {
         reason.textContent = answer.message;
         reason.hidden = false;
-      } else {
-        handOver(command, 'agentwhy init --protect ' + quoted(pattern));
+      } else if (command) {
+        // BT8: no flag writes a told list, so Track hands over the command that opens the page where it can be written.
+        handOver(command, mode === 'tell' ? 'agentwhy start' : 'agentwhy init --protect ' + quoted(pattern));
       }
     });
   };

package/dist/report/render/report-page/fix-wizard.js

@@ -165,7 +165,9 @@ function dataSteps(item, page, note) {
                 : key === undefined
                     ? '<p class="wz-p">' + label(page.shared ? 'wz.stop.shared' : 'wz.stop.outside') + '</p>'
                     : pill({ label: label('wz.protect'), tone: 'light', size: 'lg', href: '#protect-' + key, attributes: opener('protect-' + key) + ' data-protect-open="' + key + '"' }) +
-                        '<span class="wz-protected" data-protected="' + key + '" hidden>' + label('pr.done') + '</span>' +
+                        // BT7: the window writes one of two answers, so the step holds both and the script shows the one chosen.
+                        '<span class="wz-protected" data-made="block" data-made-key="' + key + '" hidden>' + label('pr.done') + '</span>' +
+                        '<span class="wz-protected wz-tracked" data-made="tell" data-made-key="' + key + '" hidden>' + label('md.done.tell') + '</span>' +
                         '<p class="wz-honest">' + label('wz.stop.honest') + '</p>';
     return '<section class="wz-step" data-step="1">' + stepHead('wz.stepOf', 1, 'wz.data.title') +
         '<div class="wz-ask">' + label('wz.data.ask') + '</div>' +
@@ -284,6 +286,7 @@ export const FIX_WIZARD_STYLE = String.raw `
 .wz-reason{margin:18px 0 0;padding:12px 14px;border-radius:12px;background:var(--coral-07);border:1px solid var(--coral-35);font-size:14px;line-height:1.5;white-space:pre-line}
 .wz-reason[hidden],.wz-handover[hidden],.wz-protected[hidden]{display:none}
 .wz-protected{display:inline-flex;align-items:center;padding:12px 20px;border-radius:999px;background:var(--mint-14);color:var(--mint);font-size:15px;font-weight:600}
+.wz-tracked{background:var(--sand-16);color:var(--sand)}
 .wz-foot{position:sticky;bottom:0;z-index:1;display:flex;align-items:center;justify-content:space-between;gap:12px;flex-wrap:wrap;padding:16px 24px;border-top:1px solid var(--white-07);background:var(--popup-foot)}
 .wz-foot-left,.wz-foot-right{display:flex;gap:14px;align-items:center}.wz-foot-right{gap:10px}
 .wz-back{background:transparent;border:1px solid var(--white-12);color:var(--text-soft);border-radius:999px;padding:10px 16px;font:inherit;font-size:14px;cursor:pointer}

package/dist/report/render/report-page/helpers.js

@@ -1,6 +1,7 @@
 import { isTemplate } from '../../check/session-actions.js';
 import { entryOf, storyAgents } from './file-story.js';
-const RANK = ['read', 'unknown', 'named', 'stopped'];
+// A stop outranks a name seen, as a file's access does (`files.ts`, 2026-10-05).
+const RANK = ['read', 'unknown', 'stopped', 'named'];
 export function helperViews(report) {
     const agentOf = storyAgents(report);
     const helpers = [...report.graph.agents].sort((a, b) => (a.ordinal ?? Infinity) - (b.ordinal ?? Infinity) || a.index - b.index);