@cspeach/cli 1.1.29 → 1.1.31

package/dist/register/xlsx.js

@@ -0,0 +1,127 @@
+/**
+ * A minimal .xlsx writer (spec §6.1): an .xlsx is a zip of a few XML parts.
+ *
+ * Text cells are inline strings (`t="inlineStr"`), which Excel never evaluates
+ * as formulas, so `=SUM(` in a reason stays text; a text cell that starts with
+ * = + - or @ also carries the quote-prefix style, so it stays text after an edit. Every cell goes through XML
+ * escaping, and characters XML 1.0 cannot hold are dropped. One bold header
+ * style, column widths, a frozen header row and an autofilter. Entry times are
+ * pinned, so the same sheets give the same bytes.
+ *
+ * Quote characters inside regex literals are written \x22 / \x27 so the
+ * terminal words guard (team-words.test.ts) keeps its place in this file.
+ */
+import AdmZip from 'adm-zip';
+import { writeWhole } from './write-whole.js';
+const PINNED = new Date(Date.UTC(2026, 0, 1, 0, 0, 0));
+const MAX_CELL = 32767;
+/** XML 1.0 forbids C0 controls other than tab, LF and CR, and U+FFFE / U+FFFF. */
+const NOT_XML = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\uFFFE\uFFFF]/g;
+const LONE_SURROGATE = /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g;
+const NS = 'http://schemas.openxmlformats.org/spreadsheetml/2006/main';
+const REL_NS = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships';
+const HEAD = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n';
+/** Cells Excel could read as a formula: =, +, - or @ first. */
+const FORMULA_LEAD = /^[=+\-@]/;
+/** The cell style with `quotePrefix` (the third xf in STYLES). */
+const QUOTED = 2;
+export function xmlText(v) {
+    // Strip lone surrogates again after the cut: the cut can split a pair.
+    return v.replace(NOT_XML, '').replace(LONE_SURROGATE, '').slice(0, MAX_CELL).replace(LONE_SURROGATE, '')
+        .replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/\x22/g, '&quot;');
+}
+export function colName(i) {
+    let s = '';
+    for (let n = i + 1; n > 0; n = Math.floor((n - 1) / 26))
+        s = String.fromCharCode(65 + ((n - 1) % 26)) + s;
+    return s;
+}
+function cellXml(v, ref, style) {
+    if (v === null || v === undefined || v === '')
+        return '';
+    const s = style ? ` s="${style}"` : '';
+    if (typeof v === 'number')
+        return Number.isFinite(v) ? `<c r="${ref}"${s}><v>${v}</v></c>` : '';
+    const text = String(v);
+    // Text that starts like a formula gets Excel's own quote-prefix style: shown as
+    // typed, and kept text even when someone edits the cell in Excel and presses Enter.
+    const t = !style && FORMULA_LEAD.test(text) ? ` s="${QUOTED}"` : s;
+    return `<c r="${ref}"${t} t="inlineStr"><is><t xml:space="preserve">${xmlText(text)}</t></is></c>`;
+}
+function sheetXml(sheet) {
+    const width = Math.max(1, sheet.header.length, ...sheet.rows.map((r) => r.length));
+    const row = (cells, r, style) => `<row r="${r}">${cells.map((v, c) => cellXml(v, `${colName(c)}${r}`, style)).join('')}</row>`;
+    const cols = (sheet.widths ?? []).map((w, i) => `<col min="${i + 1}" max="${i + 1}" width="${w}" customWidth="1"/>`).join('');
+    const filtered = sheet.filter !== false && sheet.rows.length > 0;
+    return `${HEAD}<worksheet xmlns="${NS}">`
+        + '<sheetViews><sheetView workbookViewId="0"><pane ySplit="1" topLeftCell="A2" activePane="bottomLeft" state="frozen"/></sheetView></sheetViews>'
+        + (cols ? `<cols>${cols}</cols>` : '')
+        + `<sheetData>${row(sheet.header, 1, 1)}${sheet.rows.map((r, i) => row(r, i + 2, 0)).join('')}</sheetData>`
+        + (filtered ? `<autoFilter ref="A1:${colName(width - 1)}${sheet.rows.length + 1}"/>` : '')
+        + '</worksheet>';
+}
+const STYLES = `${HEAD}<styleSheet xmlns="${NS}">`
+    + '<fonts count="2"><font><sz val="11"/><name val="Calibri"/></font><font><b/><sz val="11"/><name val="Calibri"/></font></fonts>'
+    + '<fills count="2"><fill><patternFill patternType="none"/></fill><fill><patternFill patternType="gray125"/></fill></fills>'
+    + '<borders count="1"><border><left/><right/><top/><bottom/><diagonal/></border></borders>'
+    + '<cellStyleXfs count="1"><xf numFmtId="0" fontId="0" fillId="0" borderId="0"/></cellStyleXfs>'
+    + '<cellXfs count="3"><xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0"/><xf numFmtId="0" fontId="1" fillId="0" borderId="0" xfId="0" applyFont="1"/>'
+    + '<xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0" quotePrefix="1"/></cellXfs>'
+    + '<cellStyles count="1"><cellStyle name="Normal" xfId="0" builtinId="0"/></cellStyles></styleSheet>';
+export function buildXlsx(sheets) {
+    const taken = new Set();
+    const named = sheets.map((s) => ({ ...s, name: safeSheetName(s.name, taken) }));
+    const zip = new AdmZip();
+    const add = (p, text) => zip.addFile(p, Buffer.from(text, 'utf-8'));
+    add('[Content_Types].xml', `${HEAD}<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">`
+        + '<Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>'
+        + '<Default Extension="xml" ContentType="application/xml"/>'
+        + '<Override PartName="/xl/workbook.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml"/>'
+        + '<Override PartName="/xl/styles.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml"/>'
+        + named.map((_, i) => `<Override PartName="/xl/worksheets/sheet${i + 1}.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml"/>`).join('')
+        + '</Types>');
+    add('_rels/.rels', `${HEAD}<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">`
+        + `<Relationship Id="rId1" Type="${REL_NS}/officeDocument" Target="xl/workbook.xml"/></Relationships>`);
+    const defined = named.map((s, i) => {
+        if (s.filter === false || !s.rows.length)
+            return '';
+        const width = Math.max(1, s.header.length, ...s.rows.map((r) => r.length));
+        return `<definedName name="_xlnm._FilterDatabase" localSheetId="${i}" hidden="1">'${xmlText(s.name.replace(/\x27/g, "''"))}'!$A$1:$${colName(width - 1)}$${s.rows.length + 1}</definedName>`;
+    }).join('');
+    add('xl/workbook.xml', `${HEAD}<workbook xmlns="${NS}" xmlns:r="${REL_NS}"><sheets>`
+        + named.map((s, i) => `<sheet name="${xmlText(s.name)}" sheetId="${i + 1}" r:id="rId${i + 1}"/>`).join('')
+        + `</sheets>${defined ? `<definedNames>${defined}</definedNames>` : ''}</workbook>`);
+    add('xl/_rels/workbook.xml.rels', `${HEAD}<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">`
+        + named.map((_, i) => `<Relationship Id="rId${i + 1}" Type="${REL_NS}/worksheet" Target="worksheets/sheet${i + 1}.xml"/>`).join('')
+        + `<Relationship Id="rId${named.length + 1}" Type="${REL_NS}/styles" Target="styles.xml"/></Relationships>`);
+    add('xl/styles.xml', STYLES);
+    named.forEach((s, i) => add(`xl/worksheets/sheet${i + 1}.xml`, sheetXml(s)));
+    for (const e of zip.getEntries())
+        e.header.time = PINNED;
+    return zip.toBuffer();
+}
+export function writeXlsxFile(file, sheets) {
+    writeWhole(file, buildXlsx(sheets));
+}
+/** Excel's rules: no []:*?/\ , no leading or trailing apostrophe, 1–31 characters, unique ignoring case. */
+export function safeSheetName(name, taken) {
+    const cleaned = String(name ?? '').replace(/[[\]:*?/\\]/g, ' ').replace(/\s+/g, ' ').trim().replace(/^\x27+|\x27+$/g, '').trim();
+    // Cut, then clean the ends again: a cut can leave an apostrophe (or a space) last.
+    const base = (cleaned || 'Sheet').slice(0, 31).replace(/^[\s\x27]+|[\s\x27]+$/g, '') || 'Sheet';
+    let candidate = base;
+    for (let n = 2; taken.has(candidate.toLowerCase()); n += 1) {
+        const tail = ` (${n})`;
+        candidate = `${base.slice(0, 31 - tail.length).trim()}${tail}`;
+    }
+    taken.add(candidate.toLowerCase());
+    return candidate;
+}
+const RESERVED = /^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i;
+/** A name Windows (and every sync tool) accepts as a file name stem. */
+export function safeFileStem(name) {
+    const cleaned = String(name ?? '').replace(/[<>:\x22/\\|?*\u0000-\u001F]/g, ' ').replace(/\s+/g, ' ').trim()
+        .replace(/[. ]+$/, '').slice(0, 80).trim();
+    if (!cleaned)
+        return 'team project';
+    return RESERVED.test(cleaned) ? `_${cleaned}` : cleaned;
+}

package/dist/register/xref.js

@@ -0,0 +1,117 @@
+/**
+ * The where-used index, turned into calling objects (spec §5.3).
+ *
+ * WBCROSSGT and CROSS name the INCLUDE that uses an object. A caller is the
+ * object that include belongs to: a class (its pool includes follow a fixed
+ * naming scheme), an interface pool, a function group (SAPL<fg>, or an L<fg>…
+ * include through its D010INC master), or a report (its master, or itself).
+ * Anything that resolves to nothing is counted as unmapped — never guessed.
+ *
+ * Namespaced names (`/ACME/CL_THING======CP`, `/ACME/SAPLZFG`) follow the
+ * same rules; the namespace stays part of the object name.
+ */
+/** Class-pool includes: name padded with '=' then CP/CU/CI/CO/CT/CS, CMnnn, CCDEF/CCIMP/CCMAC/CCAU. */
+const CLASS_INCLUDE = /^([^=]{1,30})=+(C[A-Z]{1,2}|CM[0-9A-Z]{3}|CCDEF|CCIMP|CCMAC|CCAU)$/;
+/** Interface-pool includes. */
+const INTF_INCLUDE = /^([^=]{1,30})=+I[PU]$/;
+/**
+ * The same pool includes read at fixed width: the object name is the first 30
+ * characters, padded with '='. A name of exactly 30 characters has no '=' at
+ * all, which the patterns above cannot see.
+ */
+const CLASS_SUFFIX = /^(C[A-Z]{1,2}|CM[0-9A-Z]{3}|CCDEF|CCIMP|CCMAC|CCAU)$/;
+const INTF_SUFFIX = /^I[PU]$/;
+/** Function-group main program, optionally namespaced: SAPLZFG, /ACME/SAPLZFG. */
+const FUGR_MAIN = /^(\/[A-Z0-9_]+\/)?SAPL(.+)$/;
+/** Pattern-only mapping: what an include or main program name says by itself. */
+function byPattern(include) {
+    let m = CLASS_INCLUDE.exec(include);
+    if (m)
+        return { type: 'CLAS', name: m[1] };
+    m = INTF_INCLUDE.exec(include);
+    if (m)
+        return { type: 'INTF', name: m[1] };
+    if (include.length > 30) {
+        const name = include.slice(0, 30).replace(/=+$/, '');
+        const suffix = include.slice(30);
+        if (name && !name.includes('=')) {
+            if (CLASS_SUFFIX.test(suffix))
+                return { type: 'CLAS', name };
+            if (INTF_SUFFIX.test(suffix))
+                return { type: 'INTF', name };
+        }
+    }
+    m = FUGR_MAIN.exec(include);
+    if (m)
+        return { type: 'FUGR', name: `${m[1] ?? ''}${m[2]}` };
+    return null;
+}
+/**
+ * The object an include belongs to. `masters` maps include → main program
+ * (from D010INC); a report known from TADIR is entered as mapping to itself.
+ */
+export function objectOfInclude(include, masters) {
+    const inc = (include ?? '').trim().toUpperCase();
+    if (!inc)
+        return null;
+    const direct = byPattern(inc);
+    if (direct)
+        return direct;
+    const master = masters.get(inc);
+    if (!master)
+        return null;
+    return byPattern(master) ?? { type: 'PROG', name: master };
+}
+/**
+ * Callers per referenced object name. Index names can carry a component
+ * (`ZCL_X\ME:RUN`); the part before the backslash is the object. `selfOf(name)`
+ * gives that object's own key (`TYPE|NAME`) so a self-reference is dropped.
+ * `includesUnmapped` counts distinct includes CSPeach could not map.
+ */
+export function callersFromIndex(rows, masters, selfOf) {
+    const out = new Map();
+    const unmapped = new Map();
+    for (const row of rows) {
+        const name = (row.name ?? '').trim().toUpperCase().split('\\')[0];
+        if (!name)
+            continue;
+        const include = (row.include ?? '').trim().toUpperCase();
+        let entry = out.get(name);
+        if (!entry) {
+            entry = { objects: new Set(), includesUnmapped: 0 };
+            out.set(name, entry);
+        }
+        const ref = objectOfInclude(include, masters);
+        if (!ref) {
+            let seen = unmapped.get(name);
+            if (!seen) {
+                seen = new Set();
+                unmapped.set(name, seen);
+            }
+            if (include)
+                seen.add(include);
+            entry.includesUnmapped = seen.size;
+            continue;
+        }
+        const key = `${ref.type}|${ref.name}`;
+        if (key === selfOf(name))
+            continue;
+        entry.objects.add(key);
+    }
+    return out;
+}
+/** The REPOSRC program name that carries an object's change date, or null for other types. */
+export function reposrcNameFor(type, name) {
+    const t = type.toUpperCase();
+    const n = name.toUpperCase();
+    switch (t) {
+        case 'PROG': return n;
+        case 'CLAS': return `${n.padEnd(30, '=')}CP`;
+        case 'INTF': return `${n.padEnd(30, '=')}IP`;
+        case 'FUGR': {
+            const m = /^(\/[A-Z0-9_]+\/)(.+)$/.exec(n);
+            return m ? `${m[1]}SAPL${m[2]}` : `SAPL${n}`;
+        }
+        default: return null;
+    }
+}

package/dist/renderer/startup-lines.js

@@ -12,6 +12,7 @@ import { formatAttention } from './notice-shape.js';
 import { truncateToWidth, uiWidth, frameWidth } from './ui-width.js';
 import { sanitizeControlChars } from './sanitize.js';
 import { holdBrand } from './brand-settled.js';
+import { formatTimeAgo } from '../session/time-ago.js';
 export { brandSettled } from './brand-settled.js';
 /** Folder budget on the panels status line (controller ruling R2). */
 const STATUS_PATH_MAX = 20;
@@ -131,6 +132,16 @@ export function panelsResumeLine(last, priorTurns) {
     const fact = last ?? `${priorTurns} prior turn${priorTurns === 1 ? '' : 's'}`;
     return '   ' + paint('dim', truncateToWidth(sanitizeControlChars(`resumed · ${fact}`), Math.max(20, uiWidth() - 3)));
 }
+/** 2026-10-08 (sessions/folders) — the dim start line pointing at this folder's
+ *  latest session. Quotes the user's prompt, so control characters are neutralised. */
+export function lastSessionHereLine(s, now = new Date()) {
+    const when = formatTimeAgo(s.lastTurnAt, now);
+    const what = [
+        s.skill ? `/${s.skill}` : null,
+        s.promptSnippet ? `"${truncateToWidth(sanitizeControlChars(s.promptSnippet), 40)}"` : null,
+    ].filter(Boolean).join(', ');
+    return '   ' + paint('dim', `Last session here: ${when}${what ? ` (${what})` : ''} — cspeach --continue picks it up.`);
+}
 /** A "!" line for the start screen (no Next: line → exactly one line). */
 export function panelsInterruptedNote(n) {
     return formatAttention({ text: `${n} unfinished session${n === 1 ? '' : 's'}`, fact: 'cspeach --resume' }).trimEnd();

package/dist/renderer/tool-labels.js

@@ -160,6 +160,8 @@ const RULES = {
     sap_link: (a) => ({ verb: 'SAP link', object: str(a['action']) ?? '' }),
     cap_link_smoke: (a) => ({ verb: 'S/4 link check', object: str(a['s4']?.['entitySet']) ?? '' }),
     app_lane_resolve: (a) => ({ verb: 'Chose lane', object: shortLeft(str(a['specPath']) ?? '') }),
+    team_findings: (a) => ({ verb: 'Read team findings', object: str(a['lane']) ?? str(a['packages']) ?? 'all objects' }),
+    team_estate: (a) => ({ verb: 'Read estate inventory', object: str(a['packages']) ?? 'all packages' }),
     sap_badi_list: (a) => ({ verb: 'Searched BAdIs', object: shortRight(`"${str(a['query']) ?? ''}"`) }),
     sap_snapshot_list: (a) => ({ verb: 'Listed snapshots', object: shortRight(str(a['name']) ?? '') }),
     sap_snapshot_read: sapObject('Read snapshot'),
@@ -265,7 +267,7 @@ const PRESENT = {
     Preview: 'Preview', 'Searched samples': 'Searching samples', 'Read sample': 'Reading sample',
     'Audited metadata': 'Auditing metadata', 'Extended model': 'Extending model',
     'Checked capability': 'Checking capability',
-    'Read texts of': 'Reading texts of', 'Wrote texts': 'Writing texts',
+    'Read texts of': 'Reading texts of', 'Read team findings': 'Reading team findings', 'Read estate inventory': 'Reading estate inventory', 'Wrote texts': 'Writing texts',
 };
 export function toolActivityLabel(name, args) {
     const l = toolLabel(name, args);

package/dist/renderer/tool-widget.js

@@ -402,6 +402,18 @@ function approvalDeclined(content) {
         return undefined;
     }
 }
+/** 1.1.31 — true when request_approval approved by the user's auto_approve setting, not by a person. */
+function approvalAutoApproved(content) {
+    if (!content || !content.trim().startsWith('{'))
+        return false;
+    try {
+        const r = JSON.parse(content);
+        return r.approved === true && r.auto_approved === true;
+    }
+    catch {
+        return false;
+    }
+}
 function panelsRow(p) {
     const width = Math.max(20, getEffectiveBodyWidth());
     const label = toolLabel(p.name, p.args, p.isError ? undefined : p.resultContent);
@@ -410,7 +422,9 @@ function panelsRow(p) {
     const declined = !p.isError && p.name === 'request_approval' ? approvalDeclined(p.resultContent) : undefined;
     const icon = p.isError ? paint('bad', '✗') : declined ? paint('warn', '·') : paint('ok', '✓');
     const timing = p.durationMs >= 1000 ? formatDuration(p.durationMs) : '';
-    const tail = [declined ?? label.detail, timing].filter(Boolean).join(' · ');
+    // 1.1.31: a setting said yes, not a person — the row says so.
+    const auto = !p.isError && !declined && p.name === 'request_approval' && approvalAutoApproved(p.resultContent);
+    const tail = [declined ?? (auto ? 'auto-approved' : label.detail), timing].filter(Boolean).join(' · ');
     const verb = label.verb.padEnd(VERB_COL);
     // Budget: "✓ " + verb + " " + object + "  " + tail must fit the width.
     const budget = width - 2 - verb.length - 1 - (tail ? tail.length + 2 : 0);

package/dist/repl/at-completer.js

@@ -17,7 +17,7 @@
  * The cache TTL is short enough that newly-saved files appear within a
  * few seconds of their save without manual refresh.
  */
-import { ensureWorkspaceSync, listProjectFilesSync } from '../projects/workspace.js';
+import { ensureWorkspaceSync, listLegacyFilesSync, listProjectFilesSync } from '../projects/workspace.js';
 const CACHE_TTL_MS = 3000;
 let cache = null;
 function getCachedFiles() {
@@ -25,7 +25,11 @@ function getCachedFiles() {
     if (!cache || now - cache.at > CACHE_TTL_MS) {
         try {
             const ws = ensureWorkspaceSync();
-            cache = { files: listProjectFilesSync(ws), at: now };
+            const files = listProjectFilesSync(ws);
+            // Task 11 — old save locations stay readable for one release; their
+            // files follow the new folder's, same names skipped.
+            const legacy = listLegacyFilesSync(process.cwd(), files.map((f) => f.filename));
+            cache = { files: [...files, ...legacy], at: now };
         }
         catch {
             cache = { files: [], at: now };

package/dist/repl/at-picker.js

@@ -48,7 +48,7 @@ export function listWorkspaceFileChoices(opts) {
     const seen = new Set();
     // Workspace half (takes precedence on name collisions).
     try {
-        const ws = opts?.workspace ?? ensureWorkspaceSync();
+        const ws = opts?.workspace ?? ensureWorkspaceSync(opts?.cwd);
         for (const f of listProjectFilesSync(ws)) {
             if (seen.has(f.filename))
                 continue;

package/dist/repl/journey-entry.js

@@ -0,0 +1,25 @@
+import { enterJourney } from '../journey/chain.js';
+import { openStatusPage } from '../util/open-in-browser.js';
+export async function runJourneyEntry(trigger, a) {
+    const hooks = {
+        session: a.session,
+        cwd: a.cwd,
+        headless: a.headless,
+        emit: a.emit,
+        ...(a.queueNext && !a.headless ? { queueNext: a.queueNext } : {}),
+        ...(!a.standalone && a.adt ? { adt: a.adt } : {}),
+        sapAlias: a.sapAlias,
+        ...(a.standalone ? { noSap: true } : {}),
+        signal: a.signal,
+        // Task 6 — the status page opens in the browser after Yes on its card.
+        openFile: (file) => openStatusPage(file),
+    };
+    try {
+        await enterJourney(trigger, hooks);
+    }
+    catch (err) {
+        if (process.env['CSPEACH_DEBUG'] === '1')
+            throw err;
+        a.emit('The clean-core steps stopped here. Say carry on to continue.');
+    }
+}