crewly 1.20.418 → 1.20.420

package/dist/backend/backend/src/services/memory/correction-ladder.service.js

@@ -0,0 +1,335 @@
+/**
+ * Correction ladder (#810, specs/2026-10-25-correction-ladder.md).
+ *
+ * When an agent is corrected, the correction lands in memory, an SOP or a
+ * prompt: prose that is read every turn and still lets the same mistake
+ * back in. This service keeps a per-project tally of corrections by
+ * **class** (a short slug the recorder chooses, e.g. `git-add-all`) and,
+ * the second time a class is recorded, hands the project's team lead one
+ * WorkItem: "can this be made impossible or checked in code?" with the
+ * ladder as options —
+ *
+ *   (a) structural / API change — the mistake can no longer be expressed
+ *   (b) lint / test / CI check — it is caught before merge
+ *   (c) state-triggered hook — it is caught when it happens
+ *   (d) keep as prose, with a stated reason
+ *
+ * The WorkItem is deduplicated: one open item per class. The lead records
+ * the rung with `decide`; until then a third occurrence does not raise a
+ * second item. A decision of (d) is not final: when the prose did not
+ * stick (two more occurrences after it), the class is raised again. No LLM;
+ * a plain JSON store under the project's `.crewly/`.
+ *
+ * @module services/memory/correction-ladder.service
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { LoggerService } from '../core/logger.service.js';
+import { CORRECTION_LADDER_CONSTANTS, ORCHESTRATOR_SESSION_NAME } from '../../constants.js';
+import { atomicWriteJson, safeReadJson } from '../../utils/file-io.utils.js';
+import { resolveProjectDataDir } from '../core/crewly-home.utils.js';
+import { createWorkItem } from '../../types/v2/work-item.types.js';
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Normalise a class to a slug: lower case, `a-z0-9-`, no leading/trailing
+ * or doubled dashes, at most `CLASS_MAX_CHARS`. Returns `null` when nothing
+ * usable is left.
+ *
+ * @param raw - What the recorder typed
+ * @returns The slug, or null
+ */
+export function normalizeCorrectionClass(raw) {
+    if (typeof raw !== 'string')
+        return null;
+    const slug = raw
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .replace(/-{2,}/g, '-')
+        .slice(0, CORRECTION_LADDER_CONSTANTS.CLASS_MAX_CHARS)
+        .replace(/-+$/g, '');
+    return slug.length >= CORRECTION_LADDER_CONSTANTS.CLASS_MIN_CHARS ? slug : null;
+}
+/**
+ * Whether a string names a rung of the ladder.
+ *
+ * @param rung - Candidate
+ * @returns True for one of `RUNGS`
+ */
+export function isCorrectionRung(rung) {
+    return typeof rung === 'string' && CORRECTION_LADDER_CONSTANTS.RUNGS.includes(rung);
+}
+/**
+ * Where a project's ladder store lives.
+ *
+ * @param projectPath - Project root
+ * @returns `<project data dir>/correction-ladder.json`
+ */
+export function correctionLadderPath(projectPath) {
+    return path.join(resolveProjectDataDir(projectPath), CORRECTION_LADDER_CONSTANTS.STORE_FILE);
+}
+/**
+ * Occurrences recorded after the current decision (or all, when undecided).
+ *
+ * @param record - Class record
+ * @returns Count
+ */
+export function occurrencesSinceDecision(record) {
+    if (!record.decision)
+        return record.count;
+    const since = record.decision.decidedAt;
+    return record.occurrences.filter((o) => o.at > since).length;
+}
+/**
+ * The lead's WorkItem for a class: the tally, the recorded texts, the four
+ * rungs, and how to record the choice.
+ *
+ * @param record - Class record (after the occurrence that raised it)
+ * @param projectPath - Project root
+ * @param target - Lead (or orchestrator) session
+ * @param again - Whether an earlier (d) did not hold
+ * @returns The WorkItem to add to the pool
+ */
+export function buildCorrectionWorkItem(record, projectPath, target, again) {
+    const c = record.class;
+    const recent = record.occurrences.slice(-CORRECTION_LADDER_CONSTANTS.OCCURRENCES_IN_BRIEF);
+    const lines = [
+        `# Correction ladder — \`${c}\`${again ? ' (again)' : ''}`,
+        '',
+        `Project: \`${projectPath}\``,
+        `Recorded ${record.count} time${record.count === 1 ? '' : 's'}; first ${record.firstAt.slice(0, 10)}, last ${record.lastAt.slice(0, 10)}.`,
+        '',
+    ];
+    if (again && record.previousDecisions.length) {
+        const prev = record.previousDecisions[record.previousDecisions.length - 1];
+        lines.push(`An earlier decision kept this as prose (${prev.decidedAt.slice(0, 10)}: "${prev.reason}") and the mistake came back ${occurrencesSinceDecision({ ...record, decision: prev })} more times. Prose did not hold; pick a higher rung or say why prose is still right.`, '');
+    }
+    lines.push('## What was recorded', '');
+    for (const o of recent)
+        lines.push(`- ${o.at.slice(0, 10)} · ${o.agentId} · ${o.source}${o.relatedTask ? ` · ${o.relatedTask}` : ''}: ${o.text}`);
+    lines.push('', '## The question', '', 'The same class of mistake has come back. Prose (memory, SOP, prompt) is read every turn and still let it through. Decide which rung makes it stop, highest feasible first:', '', '- **structural** — change the API, type or file layout so the mistake can no longer be expressed.', '- **check** — a lint rule, test or CI step that fails before merge.', '- **hook** — a state-triggered hook or skill guard that catches it the moment it happens.', '- **prose** — keep it as memory/SOP text, with the reason why nothing above is worth it.', '', 'Do the work for the rung you pick (or open the PR / ticket for it), then record the choice:', '', '```bash', `bash {{SKILLS_PATH}}/team-leader/decide-correction/execute.sh --project "${projectPath}" --class ${c} --rung <structural|check|hook|prose> --reason "<why this rung>" [--link <PR, file or rule>]`, '```', '', 'This WorkItem counts as done only when the choice is recorded. The owner is not involved; never post this in the owner\'s thread.');
+    return createWorkItem({
+        type: 'delegate',
+        owner: target === ORCHESTRATOR_SESSION_NAME ? 'orchestrator' : 'team_lead',
+        target,
+        title: `Correction ladder: "${c}" came back (${record.count}×)${again ? ' — prose did not hold' : ''}`,
+        description: `The correction class "${c}" was recorded ${record.count} times in ${projectPath}. Decide whether it can be made impossible (structural), caught by a check, caught by a hook, or must stay prose — and record the choice with decide-correction.`,
+        briefMarkdown: lines.join('\n'),
+        maxRetries: 1,
+        metadata: {
+            kind: CORRECTION_LADDER_CONSTANTS.WORKITEM_KIND,
+            correctionClass: c,
+            projectPath,
+            count: record.count,
+            again,
+            autoCreated: true,
+        },
+    });
+}
+// =============================================================================
+// Service
+// =============================================================================
+/**
+ * Per-project tally of correction classes with one ladder WorkItem per
+ * class for the team lead.
+ */
+export class CorrectionLadderService {
+    static instance = null;
+    logger;
+    pool;
+    resolveTarget;
+    isTargetAwake;
+    fallbackTarget;
+    now;
+    /** Serialises writes per store file */
+    locks = new Map();
+    /**
+     * @param options - Wiring (pool, lead resolver, wake check)
+     */
+    constructor(options = {}) {
+        this.logger = LoggerService.getInstance().createComponentLogger('CorrectionLadder');
+        this.pool = options.pool;
+        this.resolveTarget = options.resolveTarget;
+        this.isTargetAwake = options.isTargetAwake;
+        this.fallbackTarget = options.fallbackTarget ?? ORCHESTRATOR_SESSION_NAME;
+        this.now = options.now ?? (() => Date.now());
+    }
+    /** The wired instance (an unwired one records and never raises). */
+    static getInstance() {
+        if (!this.instance)
+            this.instance = new CorrectionLadderService();
+        return this.instance;
+    }
+    /** Install the wired instance (boot) or reset (tests). */
+    static setInstance(instance) {
+        this.instance = instance;
+    }
+    /**
+     * Record one correction of a class and, on the second occurrence (or the
+     * second after a (d) that did not hold), raise the lead's WorkItem.
+     *
+     * @param input - Class, who, what, where
+     * @returns The class record and whether a WorkItem was raised
+     * @throws Error when the class normalises to nothing or the text is empty
+     */
+    async record(input) {
+        const cls = normalizeCorrectionClass(input.correctionClass);
+        if (!cls)
+            throw new Error(`Correction class "${String(input.correctionClass)}" has no letters or digits to make a slug from`);
+        const text = (input.text ?? '').trim();
+        if (!text)
+            throw new Error('A correction needs the text that was recorded');
+        return this.withLock(input.projectPath, async () => {
+            const store = await this.read(input.projectPath);
+            const at = new Date(this.now()).toISOString();
+            const existing = store.classes[cls];
+            const occurrence = {
+                at,
+                agentId: input.agentId,
+                source: input.source,
+                text: text.slice(0, CORRECTION_LADDER_CONSTANTS.OCCURRENCE_TEXT_MAX_CHARS),
+                ...(input.relatedTask ? { relatedTask: input.relatedTask } : {}),
+            };
+            const record = existing
+                ? {
+                    ...existing,
+                    count: existing.count + 1,
+                    lastAt: at,
+                    occurrences: [...existing.occurrences, occurrence].slice(-CORRECTION_LADDER_CONSTANTS.MAX_OCCURRENCES_KEPT),
+                }
+                : { class: cls, count: 1, firstAt: at, lastAt: at, occurrences: [occurrence], workItemId: null, workItemAt: null, decision: null, previousDecisions: [] };
+            store.classes[cls] = record;
+            const raise = await this.maybeRaise(record, input.projectPath);
+            await this.write(input.projectPath, store);
+            if (raise.raised) {
+                this.logger.info('Correction class raised to the team lead', { projectPath: input.projectPath, class: cls, count: record.count, target: raise.target, workItemId: raise.workItemId });
+            }
+            return { record, ...raise };
+        });
+    }
+    /**
+     * Record the lead's choice for a class and close the ladder for it.
+     *
+     * @param input - Class, rung, reason, who
+     * @returns The updated record
+     * @throws Error for an unknown class, an unknown rung or an empty reason
+     */
+    async decide(input) {
+        const cls = normalizeCorrectionClass(input.correctionClass);
+        if (!cls)
+            throw new Error(`Correction class "${String(input.correctionClass)}" is not a slug`);
+        const rung = input.rung;
+        if (!isCorrectionRung(rung))
+            throw new Error(`Unknown rung "${String(rung)}" — one of ${CORRECTION_LADDER_CONSTANTS.RUNGS.join(', ')}`);
+        const reason = (input.reason ?? '').trim();
+        if (!reason)
+            throw new Error('A decision needs a reason, for every rung');
+        return this.withLock(input.projectPath, async () => {
+            const store = await this.read(input.projectPath);
+            const record = store.classes[cls];
+            if (!record)
+                throw new Error(`No correction class "${cls}" recorded in ${input.projectPath}`);
+            const decision = {
+                rung,
+                reason,
+                ...(input.link?.trim() ? { link: input.link.trim() } : {}),
+                decidedBy: input.decidedBy,
+                decidedAt: new Date(this.now()).toISOString(),
+            };
+            const updated = { ...record, decision, workItemId: null, workItemAt: null };
+            store.classes[cls] = updated;
+            await this.write(input.projectPath, store);
+            this.logger.info('Correction class decided', { projectPath: input.projectPath, class: cls, rung: decision.rung, decidedBy: input.decidedBy });
+            return updated;
+        });
+    }
+    /**
+     * Every class of a project, most recorded first.
+     *
+     * @param projectPath - Project root
+     * @returns Records
+     */
+    async list(projectPath) {
+        const store = await this.read(projectPath);
+        return Object.values(store.classes).sort((a, b) => b.count - a.count || a.class.localeCompare(b.class));
+    }
+    // ---------------------------------------------------------------------------
+    /**
+     * Raise the lead's WorkItem when the class has earned it: `THRESHOLD`
+     * occurrences with no decision and no open item, or `THRESHOLD`
+     * occurrences after a (d) decision. An open item older than
+     * `REOPEN_AFTER_MS` with no decision counts as abandoned and is replaced.
+     */
+    async maybeRaise(record, projectPath) {
+        const since = occurrencesSinceDecision(record);
+        const again = record.decision?.rung === 'prose';
+        if (record.decision && !again)
+            return { raised: false, skipped: 'decided' };
+        if (since < CORRECTION_LADDER_CONSTANTS.THRESHOLD)
+            return { raised: false, skipped: 'below_threshold' };
+        if (record.workItemId) {
+            const age = record.workItemAt ? this.now() - Date.parse(record.workItemAt) : 0;
+            if (age < CORRECTION_LADDER_CONSTANTS.REOPEN_AFTER_MS)
+                return { raised: false, skipped: 'already_raised', workItemId: record.workItemId };
+            this.logger.warn('Correction ladder WorkItem never decided; raising again', { projectPath, class: record.class, workItemId: record.workItemId });
+        }
+        if (!this.pool)
+            return { raised: false, skipped: 'no_pool' };
+        const target = (await this.targetFor(projectPath)) ?? this.fallbackTarget;
+        if (!(await this.targetAwake(target)))
+            return { raised: false, skipped: 'target_dormant', target };
+        if (again && record.decision) {
+            record.previousDecisions = [...record.previousDecisions, record.decision];
+            record.decision = null;
+        }
+        const wi = buildCorrectionWorkItem(record, projectPath, target, again);
+        await this.pool.addToPool(wi);
+        record.workItemId = wi.id;
+        record.workItemAt = new Date(this.now()).toISOString();
+        return { raised: true, workItemId: wi.id, target };
+    }
+    /** The lead for a project; errors count as "no lead". */
+    async targetFor(projectPath) {
+        if (!this.resolveTarget)
+            return null;
+        try {
+            return await this.resolveTarget(projectPath);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Errors count as dormant: a chore is never worth risking a wake. */
+    async targetAwake(target) {
+        if (!this.isTargetAwake)
+            return true;
+        try {
+            return await this.isTargetAwake(target);
+        }
+        catch {
+            return false;
+        }
+    }
+    async read(projectPath) {
+        const data = await safeReadJson(correctionLadderPath(projectPath), null);
+        const classes = data && typeof data.classes === 'object' && data.classes ? data.classes : {};
+        return { version: 1, classes: { ...classes } };
+    }
+    async write(projectPath, store) {
+        const file = correctionLadderPath(projectPath);
+        await fs.mkdir(path.dirname(file), { recursive: true });
+        await atomicWriteJson(file, store);
+    }
+    /** Run `fn` after every earlier operation on the same project's store. */
+    withLock(projectPath, fn) {
+        const key = path.resolve(projectPath);
+        const prev = this.locks.get(key) ?? Promise.resolve();
+        const next = prev.then(fn, fn);
+        this.locks.set(key, next.catch(() => undefined));
+        return next;
+    }
+}
+//# sourceMappingURL=correction-ladder.service.js.map

package/dist/backend/backend/src/services/memory/correction-ladder.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correction-ladder.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/memory/correction-ladder.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/build-info.json

@@ -1,4 +1,4 @@
 {
-  "commit": "278df5b80668cdbd7d461d2f606f0e9f2b0a414d",
-  "builtAt": "2026-10-25T22:08:25.252Z"
+  "commit": "9342820243f458c6a5b261826ba7288cc4042111",
+  "builtAt": "2026-10-25T23:19:13.787Z"
 }

package/dist/cli/backend/src/constants.d.ts

@@ -2181,6 +2181,31 @@ export declare const WIKI_GAPS_CONSTANTS: {
     /** Session that authors the page. */
     readonly CALLER_SESSION: "system:wiki-knowledge-gaps";
 };
+/**
+ * Correction ladder (#810): repeated corrections of one class become a
+ * team-lead WorkItem asking for a check in code instead of more prose.
+ */
+export declare const CORRECTION_LADDER_CONSTANTS: {
+    /** Per-project store, under the project data dir */
+    readonly STORE_FILE: "correction-ladder.json";
+    /** Occurrences of a class (or after a prose decision) that raise the lead's WorkItem */
+    readonly THRESHOLD: 2;
+    /** An undecided WorkItem older than this is treated as abandoned and raised again */
+    readonly REOPEN_AFTER_MS: number;
+    /** The rungs, highest first: make it impossible → catch before merge → catch when it happens → tell them again */
+    readonly RUNGS: readonly ["structural", "check", "hook", "prose"];
+    /** Class slug bounds */
+    readonly CLASS_MIN_CHARS: 2;
+    readonly CLASS_MAX_CHARS: 48;
+    /** Occurrences kept per class (newest) */
+    readonly MAX_OCCURRENCES_KEPT: 20;
+    /** Occurrences quoted in the lead's brief */
+    readonly OCCURRENCES_IN_BRIEF: 5;
+    /** Correction text kept per occurrence */
+    readonly OCCURRENCE_TEXT_MAX_CHARS: 400;
+    /** WorkItem `metadata.kind` */
+    readonly WORKITEM_KIND: "correction-ladder";
+};
 /**
  * Daily agent-memory refresh (#1345): what an agent recorded in the wiki
  * log is reflected into its `memory.json` and the project's memory.
@@ -9789,10 +9814,20 @@ export declare const ACTIVITY_LOG_CONSTANTS: {
  * importer knows what to reconnect.
  */
 export declare const TEAM_EXPORT_CONSTANTS: {
-    /** Format version written by this release */
-    readonly VERSION: "1.1";
+    /** Format version written by this release (1.2 added the optional wiki) */
+    readonly VERSION: "1.2";
     /** Versions `importTeam` accepts */
-    readonly SUPPORTED_VERSIONS: readonly ["1.0", "1.1"];
+    readonly SUPPORTED_VERSIONS: readonly ["1.0", "1.1", "1.2"];
+    /** Folder of a team's wiki vault inside its team directory */
+    readonly WIKI_DIR: "wiki";
+    /** Only these vault files travel: knowledge pages, never ledgers or compile state */
+    readonly WIKI_PAGE_EXTENSION: ".md";
+    /** A wiki page larger than this is listed as skipped, not packaged */
+    readonly WIKI_MAX_PAGE_BYTES: number;
+    /** Once packaged pages reach this many bytes, the rest are listed as skipped */
+    readonly WIKI_MAX_TOTAL_BYTES: number;
+    /** A packaged page path: vault-relative, `.md`, no dot segments, no traversal */
+    readonly WIKI_PAGE_PATH_PATTERN: RegExp;
     /** Member fields that describe this install's running agent, never the team */
     readonly RUNTIME_MEMBER_FIELDS: readonly ["agentId", "currentTickets", "readyAt", "loginRequired", "usageLimited", "runtimeOverride", "capabilities", "lastActivityCheck"];
     /** Connector id → words in prompts / skill ids / schedules that mean the team uses it */