@cleocode/core 2.0.0

package/dist/sessions/session-drift.js.map

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

package/dist/sessions/session-enforcement.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Session enforcement - require active sessions for write operations.
+ *
+ * Part of the Epic-Bound Session architecture. Enforces that write operations
+ * (add, update, complete) require an active session.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Enforcement modes. */
+export type EnforcementMode = 'strict' | 'warn' | 'none';
+/** Get the current enforcement mode. */
+export declare function getEnforcementMode(cwd?: string): EnforcementMode;
+/** Check if session enforcement is enabled. */
+export declare function isSessionEnforcementEnabled(cwd?: string): boolean;
+/** Session info for enforcement checks. */
+export interface ActiveSessionInfo {
+    id: string;
+    name: string;
+    scope: {
+        type: string;
+        epicId?: string;
+    };
+}
+/** Get active session info. Returns null if no active session. */
+export declare function getActiveSessionInfo(cwd?: string): Promise<ActiveSessionInfo | null>;
+/** Enforcement result. */
+export interface EnforcementResult {
+    allowed: boolean;
+    mode: EnforcementMode;
+    session: ActiveSessionInfo | null;
+    warning?: string;
+}
+/**
+ * Require an active session for write operations.
+ * In strict mode, throws if no session is active.
+ * In warn mode, returns a warning but allows the operation.
+ * In none mode, always allows.
+ */
+export declare function requireActiveSession(operation: string, cwd?: string): Promise<EnforcementResult>;
+/**
+ * Validate that a task is within the current session's scope.
+ * Only enforced when a session is active.
+ */
+export declare function validateTaskInScope(taskId: string, taskEpicId?: string, cwd?: string): Promise<{
+    inScope: boolean;
+    warning?: string;
+}>;
+//# sourceMappingURL=session-enforcement.d.ts.map

package/dist/sessions/session-enforcement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-enforcement.d.ts","sourceRoot":"","sources":["../../src/sessions/session-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2BH,yBAAyB;AACzB,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD,wCAAwC;AACxC,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,CAShE;AAED,+CAA+C;AAC/C,wBAAgB,2BAA2B,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAED,kEAAkE;AAClE,wBAAsB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAS1F;AAED,0BAA0B;AAC1B,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,CAsC5B;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwCjD"}

package/dist/sessions/session-enforcement.js

@@ -0,0 +1,137 @@
+/**
+ * Session enforcement - require active sessions for write operations.
+ *
+ * Part of the Epic-Bound Session architecture. Enforces that write operations
+ * (add, update, complete) require an active session.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+import { getCleoDir } from '../paths.js';
+import { sessionStatus } from './index.js';
+/** Synchronous config value reader. */
+function readConfigValueSync(path, defaultValue, cwd) {
+    try {
+        const configPath = join(getCleoDir(cwd), 'config.json');
+        if (!existsSync(configPath))
+            return defaultValue;
+        const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        const keys = path.split('.');
+        let value = config;
+        for (const key of keys) {
+            if (value == null || typeof value !== 'object')
+                return defaultValue;
+            value = value[key];
+        }
+        return value ?? defaultValue;
+    }
+    catch {
+        return defaultValue;
+    }
+}
+/** Get the current enforcement mode. */
+export function getEnforcementMode(cwd) {
+    try {
+        // Get enforcement mode from config
+        const mode = readConfigValueSync('session.enforcement', 'strict', cwd);
+        if (mode === 'strict' || mode === 'warn' || mode === 'none')
+            return mode;
+        return 'strict'; // Default
+    }
+    catch {
+        return 'none';
+    }
+}
+/** Check if session enforcement is enabled. */
+export function isSessionEnforcementEnabled(cwd) {
+    return getEnforcementMode(cwd) !== 'none';
+}
+/** Get active session info. Returns null if no active session. */
+export async function getActiveSessionInfo(cwd) {
+    const session = await sessionStatus(cwd);
+    if (!session)
+        return null;
+    return {
+        id: session.id,
+        name: session.name,
+        scope: session.scope,
+    };
+}
+/**
+ * Require an active session for write operations.
+ * In strict mode, throws if no session is active.
+ * In warn mode, returns a warning but allows the operation.
+ * In none mode, always allows.
+ */
+export async function requireActiveSession(operation, cwd) {
+    const mode = getEnforcementMode(cwd);
+    if (mode === 'none') {
+        return { allowed: true, mode, session: null };
+    }
+    const session = await getActiveSessionInfo(cwd);
+    if (session) {
+        return { allowed: true, mode, session };
+    }
+    // No active session
+    if (mode === 'strict') {
+        throw new CleoError(ExitCode.SESSION_REQUIRED, `Operation '${operation}' requires an active session`, {
+            fix: 'Start a session with \'cleo session start --scope epic:T### --auto-start --name "Work"\'',
+            alternatives: [
+                {
+                    action: 'Start session',
+                    command: 'cleo session start --scope epic:T001 --auto-start --name "Work"',
+                },
+                { action: 'List sessions', command: 'cleo session list' },
+            ],
+        });
+    }
+    // Warn mode
+    return {
+        allowed: true,
+        mode,
+        session: null,
+        warning: `No active session for operation '${operation}'. Consider starting one.`,
+    };
+}
+/**
+ * Validate that a task is within the current session's scope.
+ * Only enforced when a session is active.
+ */
+export async function validateTaskInScope(taskId, taskEpicId, cwd) {
+    const mode = getEnforcementMode(cwd);
+    if (mode === 'none')
+        return { inScope: true };
+    const session = await getActiveSessionInfo(cwd);
+    if (!session)
+        return { inScope: true }; // No session = no scope enforcement
+    // Global scope allows everything
+    if (session.scope.type === 'global')
+        return { inScope: true };
+    // Epic scope: task must be within the session's epic
+    if (session.scope.type === 'epic' && session.scope.epicId) {
+        const epicId = session.scope.epicId;
+        // Task is the epic itself or is a child
+        if (taskId === epicId || taskEpicId === epicId) {
+            return { inScope: true };
+        }
+        if (mode === 'strict') {
+            throw new CleoError(ExitCode.TASK_NOT_IN_SCOPE, `Task ${taskId} is not in scope of session ${session.id} (epic: ${epicId})`, {
+                fix: `Focus on tasks within epic ${epicId} or start a new session`,
+                alternatives: [
+                    { action: 'View session', command: `cleo session status` },
+                    { action: 'End session', command: `cleo session end` },
+                ],
+            });
+        }
+        return {
+            inScope: false,
+            warning: `Task ${taskId} is outside session scope (epic: ${epicId})`,
+        };
+    }
+    return { inScope: true };
+}
+//# sourceMappingURL=session-enforcement.js.map

package/dist/sessions/session-enforcement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-enforcement.js","sourceRoot":"","sources":["../../src/sessions/session-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,uCAAuC;AACvC,SAAS,mBAAmB,CAAC,IAAY,EAAE,YAAqB,EAAE,GAAY;IAC5E,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,CAAC;QACxD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,YAAY,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,GAAY,MAAM,CAAC;QAC5B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,YAAY,CAAC;YACpE,KAAK,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,KAAK,IAAI,YAAY,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,CAAC;IACtB,CAAC;AACH,CAAC;AAKD,wCAAwC;AACxC,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,IAAI,CAAC;QACH,mCAAmC;QACnC,MAAM,IAAI,GAAG,mBAAmB,CAAC,qBAAqB,EAAE,QAAQ,EAAE,GAAG,CAAW,CAAC;QACjF,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QACzE,OAAO,QAAQ,CAAC,CAAC,UAAU;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,2BAA2B,CAAC,GAAY;IACtD,OAAO,kBAAkB,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC;AAC5C,CAAC;AASD,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAY;IACrD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC;AACJ,CAAC;AAUD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAiB,EACjB,GAAY;IAEZ,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAErC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAEhD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC1C,CAAC;IAED,oBAAoB;IACpB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,gBAAgB,EACzB,cAAc,SAAS,8BAA8B,EACrD;YACE,GAAG,EAAE,0FAA0F;YAC/F,YAAY,EAAE;gBACZ;oBACE,MAAM,EAAE,eAAe;oBACvB,OAAO,EAAE,iEAAiE;iBAC3E;gBACD,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,EAAE;aAC1D;SACF,CACF,CAAC;IACJ,CAAC;IAED,YAAY;IACZ,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI;QACJ,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,oCAAoC,SAAS,2BAA2B;KAClF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,UAAmB,EACnB,GAAY;IAEZ,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAE9C,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,oCAAoC;IAE5E,iCAAiC;IACjC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAE9D,qDAAqD;IACrD,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;QAEpC,wCAAwC;QACxC,IAAI,MAAM,KAAK,MAAM,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YAC/C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,iBAAiB,EAC1B,QAAQ,MAAM,+BAA+B,OAAO,CAAC,EAAE,WAAW,MAAM,GAAG,EAC3E;gBACE,GAAG,EAAE,8BAA8B,MAAM,yBAAyB;gBAClE,YAAY,EAAE;oBACZ,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,EAAE;oBAC1D,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,EAAE;iBACvD;aACF,CACF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,QAAQ,MAAM,oCAAoC,MAAM,GAAG;SACrE,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/sessions/session-grade.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Session grading - rubric-based behavioral analysis of agent sessions.
+ *
+ * Reads audit log entries for a session and applies a 5-dimension rubric
+ * to score agent behavior:
+ *   - Session discipline (20pts)
+ *   - Discovery efficiency (20pts)
+ *   - Task hygiene (20pts)
+ *   - Error protocol (20pts)
+ *   - Progressive disclosure use (20pts)
+ *
+ * @task T4916
+ */
+export interface DimensionScore {
+    score: number;
+    max: number;
+    evidence: string[];
+}
+export interface GradeResult {
+    sessionId: string;
+    taskId?: string;
+    totalScore: number;
+    maxScore: number;
+    dimensions: {
+        sessionDiscipline: DimensionScore;
+        discoveryEfficiency: DimensionScore;
+        taskHygiene: DimensionScore;
+        errorProtocol: DimensionScore;
+        disclosureUse: DimensionScore;
+    };
+    flags: string[];
+    timestamp: string;
+    entryCount: number;
+}
+/**
+ * Grade a session by sessionId using the 5-dimension behavioral rubric.
+ */
+export declare function gradeSession(sessionId: string, cwd?: string): Promise<GradeResult>;
+/** Read past grade results from .cleo/metrics/GRADES.jsonl */
+export declare function readGrades(sessionId?: string, cwd?: string): Promise<GradeResult[]>;
+//# sourceMappingURL=session-grade.d.ts.map

package/dist/sessions/session-grade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-grade.d.ts","sourceRoot":"","sources":["../../src/sessions/session-grade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE;QACV,iBAAiB,EAAE,cAAc,CAAC;QAClC,mBAAmB,EAAE,cAAc,CAAC;QACpC,WAAW,EAAE,cAAc,CAAC;QAC5B,aAAa,EAAE,cAAc,CAAC;QAC9B,aAAa,EAAE,cAAc,CAAC;KAC/B,CAAC;IACF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwMxF;AAuED,8DAA8D;AAC9D,wBAAsB,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAczF"}

package/dist/sessions/session-grade.js

@@ -0,0 +1,253 @@
+/**
+ * Session grading - rubric-based behavioral analysis of agent sessions.
+ *
+ * Reads audit log entries for a session and applies a 5-dimension rubric
+ * to score agent behavior:
+ *   - Session discipline (20pts)
+ *   - Discovery efficiency (20pts)
+ *   - Task hygiene (20pts)
+ *   - Error protocol (20pts)
+ *   - Progressive disclosure use (20pts)
+ *
+ * @task T4916
+ */
+import { existsSync } from 'node:fs';
+import { appendFile, mkdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { queryAudit } from '../audit.js';
+import { getCleoDirAbsolute } from '../paths.js';
+/**
+ * Grade a session by sessionId using the 5-dimension behavioral rubric.
+ */
+export async function gradeSession(sessionId, cwd) {
+    const sessionEntries = await queryAudit({ sessionId });
+    const result = {
+        sessionId,
+        totalScore: 0,
+        maxScore: 100,
+        dimensions: {
+            sessionDiscipline: { score: 0, max: 20, evidence: [] },
+            discoveryEfficiency: { score: 0, max: 20, evidence: [] },
+            taskHygiene: { score: 0, max: 20, evidence: [] },
+            errorProtocol: { score: 0, max: 20, evidence: [] },
+            disclosureUse: { score: 0, max: 20, evidence: [] },
+        },
+        flags: [],
+        timestamp: new Date().toISOString(),
+        entryCount: sessionEntries.length,
+    };
+    if (sessionEntries.length === 0) {
+        result.flags.push('No audit entries found for session (use --grade flag when starting session)');
+        await appendGradeResult(result, cwd);
+        return result;
+    }
+    // -- Dimension 1: Session Discipline (20pts) --
+    const sessionListCalls = sessionEntries.filter((e) => e.domain === 'session' && e.operation === 'list');
+    const sessionEndCalls = sessionEntries.filter((e) => e.domain === 'session' && e.operation === 'end');
+    const taskOps = sessionEntries.filter((e) => e.domain === 'tasks');
+    let disciplineScore = 0;
+    if (sessionListCalls.length > 0) {
+        const firstListTime = new Date(sessionListCalls[0].timestamp).getTime();
+        const firstTaskTime = taskOps.length > 0 ? new Date(taskOps[0].timestamp).getTime() : Infinity;
+        if (firstListTime <= firstTaskTime) {
+            disciplineScore += 10;
+            result.dimensions.sessionDiscipline.evidence.push('session.list called before first task op');
+        }
+        else {
+            result.flags.push('session.list called after task ops (should check sessions first)');
+        }
+    }
+    else {
+        result.flags.push('session.list never called (check existing sessions before starting)');
+    }
+    if (sessionEndCalls.length > 0) {
+        disciplineScore += 10;
+        result.dimensions.sessionDiscipline.evidence.push('session.end called');
+    }
+    else {
+        result.flags.push('session.end never called (always end sessions when done)');
+    }
+    result.dimensions.sessionDiscipline.score = disciplineScore;
+    // -- Dimension 2: Discovery Efficiency (20pts) --
+    const findCalls = sessionEntries.filter((e) => e.domain === 'tasks' && e.operation === 'find');
+    const listCalls = sessionEntries.filter((e) => e.domain === 'tasks' && e.operation === 'list');
+    const showCalls = sessionEntries.filter((e) => e.domain === 'tasks' && e.operation === 'show');
+    let discoveryScore = 0;
+    const totalDiscoveryCalls = findCalls.length + listCalls.length;
+    if (totalDiscoveryCalls > 0) {
+        const findRatio = findCalls.length / totalDiscoveryCalls;
+        if (findRatio >= 0.8) {
+            discoveryScore += 15;
+            result.dimensions.discoveryEfficiency.evidence.push(`find:list ratio ${(findRatio * 100).toFixed(0)}% >= 80%`);
+        }
+        else {
+            result.flags.push(`tasks.list used ${listCalls.length}x (prefer tasks.find for discovery)`);
+            discoveryScore += Math.round(15 * findRatio);
+        }
+    }
+    else {
+        discoveryScore += 10;
+        result.dimensions.discoveryEfficiency.evidence.push('No discovery calls needed');
+    }
+    if (showCalls.length > 0) {
+        discoveryScore = Math.min(20, discoveryScore + 5);
+        result.dimensions.discoveryEfficiency.evidence.push(`tasks.show used ${showCalls.length}x for detail`);
+    }
+    result.dimensions.discoveryEfficiency.score = Math.min(20, discoveryScore);
+    // -- Dimension 3: Task Hygiene (20pts) --
+    const addCalls = sessionEntries.filter((e) => e.domain === 'tasks' && e.operation === 'add' && e.result.success);
+    const existsCalls = sessionEntries.filter((e) => e.domain === 'tasks' && e.operation === 'exists');
+    let hygieneScore = 20;
+    for (const addCall of addCalls) {
+        const desc = addCall.params?.description;
+        if (!desc || desc.trim().length === 0) {
+            hygieneScore -= 5;
+            result.flags.push(`tasks.add without description (taskId: ${addCall.metadata?.taskId ?? 'unknown'})`);
+        }
+    }
+    const subtaskAdds = addCalls.filter((e) => e.params?.parent);
+    if (subtaskAdds.length > 0 && existsCalls.length > 0) {
+        result.dimensions.taskHygiene.evidence.push('Parent existence verified before subtask creation');
+    }
+    else if (subtaskAdds.length > 0) {
+        result.flags.push('Subtasks created without tasks.exists parent check');
+        hygieneScore -= 3;
+    }
+    if (addCalls.length > 0 && hygieneScore >= 20) {
+        result.dimensions.taskHygiene.evidence.push(`All ${addCalls.length} tasks.add calls had descriptions`);
+    }
+    result.dimensions.taskHygiene.score = Math.max(0, hygieneScore);
+    // -- Dimension 4: Error Protocol (20pts) --
+    const notFoundErrors = sessionEntries.filter((e) => !e.result.success && e.result.exitCode === 4);
+    let errorScore = 20;
+    for (const errEntry of notFoundErrors) {
+        const errIdx = sessionEntries.indexOf(errEntry);
+        const nextEntries = sessionEntries.slice(errIdx + 1, errIdx + 5);
+        const hasRecovery = nextEntries.some((e) => e.domain === 'tasks' && (e.operation === 'find' || e.operation === 'exists'));
+        if (!hasRecovery) {
+            errorScore -= 5;
+            result.flags.push(`E_NOT_FOUND (${errEntry.domain}.${errEntry.operation}) not followed by recovery lookup`);
+        }
+        else {
+            result.dimensions.errorProtocol.evidence.push('E_NOT_FOUND followed by recovery lookup');
+        }
+    }
+    const duplicateCreates = detectDuplicateCreates(sessionEntries);
+    if (duplicateCreates > 0) {
+        errorScore -= 5;
+        result.flags.push(`${duplicateCreates} potentially duplicate task create(s) detected`);
+    }
+    if (notFoundErrors.length === 0 && duplicateCreates === 0) {
+        result.dimensions.errorProtocol.evidence.push('No error protocol violations');
+    }
+    result.dimensions.errorProtocol.score = Math.max(0, errorScore);
+    // -- Dimension 5: Progressive Disclosure Use (20pts) --
+    const helpCalls = sessionEntries.filter((e) => (e.domain === 'admin' && e.operation === 'help') ||
+        (e.domain === 'tools' && (e.operation === 'skill.show' || e.operation === 'skill.list')) ||
+        (e.domain === 'skills' && (e.operation === 'list' || e.operation === 'show')));
+    // gateway is stored as 'query'/'mutate' in the audit log
+    const mcpQueryCalls = sessionEntries.filter((e) => e.metadata?.gateway === 'query');
+    let disclosureScore = 0;
+    if (helpCalls.length > 0) {
+        disclosureScore += 10;
+        result.dimensions.disclosureUse.evidence.push(`Progressive disclosure used (${helpCalls.length}x)`);
+    }
+    else {
+        result.flags.push('No admin.help or skill lookup calls (load ct-cleo for guidance)');
+    }
+    if (mcpQueryCalls.length > 0) {
+        disclosureScore += 10;
+        result.dimensions.disclosureUse.evidence.push(`query (MCP) used ${mcpQueryCalls.length}x`);
+    }
+    else {
+        result.flags.push('No MCP query calls (prefer query over CLI for programmatic access)');
+    }
+    result.dimensions.disclosureUse.score = disclosureScore;
+    // -- Total --
+    result.totalScore = Object.values(result.dimensions).reduce((sum, d) => sum + d.score, 0);
+    await feedGradeToBrain(result, cwd);
+    await appendGradeResult(result, cwd);
+    return result;
+}
+/** Detect potentially duplicate task creates (same title within session). */
+function detectDuplicateCreates(entries) {
+    const creates = entries.filter((e) => e.domain === 'tasks' && e.operation === 'add' && e.result.success);
+    const titles = creates
+        .map((e) => e.params?.title?.toLowerCase().trim())
+        .filter(Boolean);
+    const unique = new Set(titles);
+    return titles.length - unique.size;
+}
+/**
+ * Feed grade insights back into brain.db as learnings.
+ * Best-effort — errors are silently caught.
+ */
+async function feedGradeToBrain(result, projectRoot) {
+    if (!projectRoot)
+        return;
+    try {
+        const { storeLearning } = await import('../memory/learnings.js');
+        // Find dimensions scoring below 50% of max
+        const weakDimensions = [];
+        for (const [name, dim] of Object.entries(result.dimensions)) {
+            if (dim.score < dim.max * 0.5) {
+                weakDimensions.push(name);
+            }
+        }
+        if (weakDimensions.length > 0) {
+            await storeLearning(projectRoot, {
+                insight: `Session ${result.sessionId} scored ${result.totalScore}/${result.maxScore}. Weak dimensions: ${weakDimensions.join(', ')}`,
+                source: `grade:${result.sessionId}`,
+                confidence: 0.8,
+                actionable: true,
+                application: `Improve in next session: ${weakDimensions.join(', ')}`,
+            });
+        }
+        // Store protocol violations as separate learning
+        if (result.flags.length > 0) {
+            await storeLearning(projectRoot, {
+                insight: `Session ${result.sessionId} protocol violations: ${result.flags.join('; ')}`,
+                source: `grade:${result.sessionId}`,
+                confidence: 0.7,
+                actionable: true,
+                application: 'Address protocol violations in next session',
+            });
+        }
+    }
+    catch {
+        // Best-effort — grade feedback should never block
+    }
+}
+/** Append a grade result to .cleo/metrics/GRADES.jsonl */
+async function appendGradeResult(result, cwd) {
+    try {
+        const cleoDir = getCleoDirAbsolute(cwd);
+        const metricsDir = join(cleoDir, 'metrics');
+        await mkdir(metricsDir, { recursive: true });
+        const gradesPath = join(metricsDir, 'GRADES.jsonl');
+        const line = JSON.stringify({ ...result, evaluator: 'auto' }) + '\n';
+        await appendFile(gradesPath, line, 'utf8');
+    }
+    catch {
+        // Best-effort
+    }
+}
+/** Read past grade results from .cleo/metrics/GRADES.jsonl */
+export async function readGrades(sessionId, cwd) {
+    try {
+        const cleoDir = getCleoDirAbsolute(cwd);
+        const gradesPath = join(cleoDir, 'metrics', 'GRADES.jsonl');
+        if (!existsSync(gradesPath))
+            return [];
+        const content = await readFile(gradesPath, 'utf8');
+        const results = content
+            .split('\n')
+            .filter((l) => l.trim())
+            .map((l) => JSON.parse(l));
+        return sessionId ? results.filter((r) => r.sessionId === sessionId) : results;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=session-grade.js.map

package/dist/sessions/session-grade.js.map

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

package/dist/sessions/session-history.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Session history with focus changes and completed tasks.
+ *
+ * @task T4782
+ * @epic T4654
+ */
+export interface SessionHistoryEntry {
+    id: string;
+    name?: string;
+    status: string;
+    startedAt: string;
+    endedAt?: string | null;
+    tasksCompleted: number;
+    focusChanges: number;
+    focusHistory: Array<{
+        taskId: string;
+        timestamp: string;
+    }>;
+}
+export interface SessionHistoryParams {
+    sessionId?: string;
+    limit?: number;
+}
+/**
+ * List session history with focus changes and completed tasks.
+ * If sessionId is provided, returns history for that specific session.
+ * Otherwise, returns history across all sessions.
+ */
+export declare function getSessionHistory(projectRoot: string, params?: SessionHistoryParams): Promise<{
+    sessions: SessionHistoryEntry[];
+}>;
+//# sourceMappingURL=session-history.d.ts.map

package/dist/sessions/session-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-history.d.ts","sourceRoot":"","sources":["../../src/sessions/session-history.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC;IAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAAC,CAqC9C"}

package/dist/sessions/session-history.js

@@ -0,0 +1,42 @@
+/**
+ * Session history with focus changes and completed tasks.
+ *
+ * @task T4782
+ * @epic T4654
+ */
+import { getAccessor } from '../store/data-accessor.js';
+/**
+ * List session history with focus changes and completed tasks.
+ * If sessionId is provided, returns history for that specific session.
+ * Otherwise, returns history across all sessions.
+ */
+export async function getSessionHistory(projectRoot, params) {
+    const accessor = await getAccessor(projectRoot);
+    // Verify project is initialized by checking task count
+    await accessor.countTasks();
+    const allSessions = await accessor.loadSessions();
+    if (allSessions.length === 0) {
+        return { sessions: [] };
+    }
+    let filtered = allSessions;
+    if (params?.sessionId) {
+        filtered = filtered.filter((s) => s.id === params.sessionId);
+    }
+    // Sort by startedAt descending (most recent first)
+    filtered.sort((a, b) => new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime());
+    if (params?.limit && params.limit > 0) {
+        filtered = filtered.slice(0, params.limit);
+    }
+    const result = filtered.map((s) => ({
+        id: s.id,
+        name: s.name,
+        status: s.status,
+        startedAt: s.startedAt,
+        endedAt: s.endedAt,
+        tasksCompleted: s.stats?.tasksCompleted || 0,
+        focusChanges: s.stats?.focusChanges || 0,
+        focusHistory: [],
+    }));
+    return { sessions: result };
+}
+//# sourceMappingURL=session-history.js.map

package/dist/sessions/session-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-history.js","sourceRoot":"","sources":["../../src/sessions/session-history.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAmBxD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAmB,EACnB,MAA6B;IAE7B,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAEhD,uDAAuD;IACvD,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;IAE5B,MAAM,WAAW,GAAc,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC;IAE7D,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,QAAQ,GAAG,WAAW,CAAC;IAE3B,IAAI,MAAM,EAAE,SAAS,EAAE,CAAC;QACtB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;IAED,mDAAmD;IACnD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAE3F,IAAI,MAAM,EAAE,KAAK,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACtC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClC,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,cAAc,EAAE,CAAC,CAAC,KAAK,EAAE,cAAc,IAAI,CAAC;QAC5C,YAAY,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC;QACxC,YAAY,EAAE,EAAE;KACjB,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC"}

package/dist/sessions/session-id.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Canonical session ID generation and validation.
+ *
+ * Canonical format: ses_{YYYYMMDDHHmmss}_{6hex}
+ *   - Human-readable, sortable by timestamp
+ *   - 6 hex bytes of randomness avoids collisions
+ *
+ * Legacy formats remain valid for backward compat:
+ *   - session-{epoch}-{hex}         (v1: from core/sessions/index.ts)
+ *   - session_{YYYYMMDD}_{HHmmss}_{hex} (v2: from dispatch/engines/session-engine.ts)
+ *
+ * @epic T4959
+ */
+/**
+ * Generate a canonical session ID.
+ *
+ * Format: ses_{YYYYMMDDHHmmss}_{6hex}
+ * Example: ses_20260227171900_a1b2c3
+ */
+export declare function generateSessionId(): string;
+/**
+ * Check if a string is a valid session ID (any format).
+ */
+export declare function isValidSessionId(id: string): boolean;
+/**
+ * Check if a session ID uses the canonical format.
+ */
+export declare function isCanonicalSessionId(id: string): boolean;
+/**
+ * Extract an approximate timestamp from any valid session ID format.
+ * Returns null if the ID format is not recognized.
+ */
+export declare function extractSessionTimestamp(id: string): Date | null;
+//# sourceMappingURL=session-id.d.ts.map

package/dist/sessions/session-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-id.d.ts","sourceRoot":"","sources":["../../src/sessions/session-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAWD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAsB/D"}