@cstart/coldstart 2.2.14 → 2.2.15

package/dist/kb/session-worklist.js

@@ -1,92 +0,0 @@
-/**
- * Capture coverage — telling the writing agent how much of its worklist it noted.
- *
- * The gap this closes: the capture checklist hands the agent a worklist of every
- * file it worked on, but `kb write` only ever sees ONE spec, so nothing could
- * report "you wrote 8 notes for 30 worked files". The agent's own count is the
- * one thing it cannot check — it is mid-heredoc, and under-capture is silent by
- * construction. So the hook drops the worklist in tmpdir when it builds the
- * capture prompt, and every `kb write --session <sid>` prints the running ratio.
- *
- * CONTRACT TWIN: hooks/capture-payload.mjs (worklistManifestPath) writes this
- * file; keep the name and shape in step. Everything here is best-effort — a
- * missing, stale or malformed manifest prints nothing and never fails a write.
- *
- * Local only. The manifest lives in tmpdir, never in the repo: it is scratch
- * state for one session, not a record, and nothing about it is transmitted.
- */
-import { readFileSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-/** Manifests older than this are a resumed/unrelated session — ignore them. */
-const MAX_AGE_MS = 24 * 60 * 60 * 1000;
-/** Below this share of outstanding files, name the skips. */
-const LOW_COVERAGE = 0.5;
-const LIST_MAX = 6;
-function manifestPath(sid) {
-    return join(tmpdir(), `coldstart-kb-worklist-${sid}.json`);
-}
-function load(sid) {
-    try {
-        const m = JSON.parse(readFileSync(manifestPath(sid), 'utf8'));
-        if (!Array.isArray(m?.files) || !m.files.length)
-            return null;
-        if (typeof m.ts === 'number' && Date.now() - m.ts > MAX_AGE_MS)
-            return null;
-        m.wrote = Array.isArray(m.wrote) ? m.wrote : [];
-        return m;
-    }
-    catch {
-        return null;
-    }
-}
-/** Paths this spec puts a note on. Flow steps do NOT count: a flow verifies
- *  files, it does not give any of them the file note rule 5 asks for. */
-export function specPaths(spec) {
-    const s = spec;
-    if (!s || typeof s.path !== 'string')
-        return [];
-    return s.type === 'file-single' || s.type === 'file-hub' ? [s.path] : [];
-}
-/**
- * Record this write against the session worklist and return the coverage line
- * to print, or null when there is no manifest to compare against (no --session,
- * a manual `kb write` outside capture, a session that never armed).
- */
-export function noteCoverage(sid, spec) {
-    if (!sid)
-        return null;
-    const m = load(sid);
-    if (!m)
-        return null;
-    for (const p of specPaths(spec))
-        if (!m.wrote.includes(p))
-            m.wrote.push(p);
-    try {
-        writeFileSync(manifestPath(sid), JSON.stringify(m));
-    }
-    catch { /* best-effort */ }
-    const outstanding = m.files.filter((f) => f.needsNote);
-    if (!outstanding.length)
-        return null;
-    const wrote = new Set(m.wrote);
-    const done = outstanding.filter((f) => wrote.has(f.path));
-    const left = outstanding.filter((f) => !wrote.has(f.path));
-    const already = m.files.length - outstanding.length;
-    const lines = [
-        `capture coverage: ${done.length} of ${outstanding.length} worklist files noted` +
-            (already ? ` (${already} more already had a fresh note)` : ''),
-    ];
-    if (left.length) {
-        const shown = left.slice(0, LIST_MAX).map((f) => `${f.path} [${f.tier}]`).join(', ');
-        lines.push(`  not noted yet: ${shown}${left.length > LIST_MAX ? `, +${left.length - LIST_MAX} more` : ''}`);
-    }
-    // The nudge fires only on the low end, and asks for a REASON rather than more
-    // notes: a deliberate skip is a fine answer, an invisible one is not. Chained
-    // writes each print this, so the last line of the block carries the real tally.
-    if (left.length && done.length / outstanding.length < LOW_COVERAGE) {
-        lines.push('  if those need no note, say which and why in your reply — an unexplained skip reads as a forgotten one.');
-    }
-    return lines.join('\n');
-}
-//# sourceMappingURL=session-worklist.js.map

package/dist/kb/session-worklist.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-worklist.js","sourceRoot":"","sources":["../../src/kb/session-worklist.ts"],"names":[],"mappings":"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"}