@theihtisham/agent-shadow-brain 7.1.0 → 7.1.4

package/dist/activity-cli.js

@@ -0,0 +1,78 @@
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { Command } from 'commander';
+import { activityJournalFor } from './brain/activity-journal.js';
+import { reportAgentActivity } from './brain/activity-reporting.js';
+import { FEATURE_SETTINGS_FILENAME, FeatureSettingsStore } from './brain/feature-settings.js';
+function stores(opts) {
+    const dbPath = path.resolve(opts.db ?? path.join(os.homedir(), '.shadow-brain', 'global.json'));
+    const settings = new FeatureSettingsStore({
+        filePath: opts.settings ?? (opts.db ? path.join(path.dirname(dbPath), FEATURE_SETTINGS_FILENAME) : undefined),
+    });
+    return { brain: { dbPath }, settings };
+}
+function storeOptions(command) {
+    return command.option('--db <path>', 'Use the activity journal adjacent to this memory store')
+        .option('--settings <path>', 'Explicit feature-settings file');
+}
+function cursorNumber(input) {
+    if (input === undefined)
+        return undefined;
+    if (!/^\d+$/.test(input) || !Number.isSafeInteger(Number(input))) {
+        throw new TypeError('Activity cursor must be a nonnegative integer.');
+    }
+    return Number(input);
+}
+function durationNumber(input) {
+    if (input === undefined)
+        return undefined;
+    const value = Number(input);
+    if (!/^\d+(?:\.\d+)?$/.test(input) || !Number.isFinite(value) || value > Number.MAX_SAFE_INTEGER) {
+        throw new TypeError('Activity duration must be a nonnegative number of milliseconds.');
+    }
+    return value;
+}
+export function registerActivityCommands(program) {
+    const activity = new Command('activity').description('Report or read bounded local activity metadata');
+    storeOptions(activity.command('report').description('Record an explicitly reported session, phase, or tool event'))
+        .argument('<kind>', 'session-start, phase, tool-start, tool-end, or session-end')
+        .requiredOption('--project-id <id>', 'Project label')
+        .requiredOption('--session <id>', 'Host session label')
+        .requiredOption('--agent <id>', 'Agent label')
+        .option('--phase <phase>', 'understand, plan, work, or verify')
+        .option('--tool <name>', 'Tool label')
+        .option('--correlation <id>', 'Shared ID for the tool start and end')
+        .option('--outcome <outcome>', 'success, error, or cancelled')
+        .option('--duration-ms <number>', 'Host-reported tool duration in milliseconds')
+        .action(async (kind, opts) => {
+        const durationMs = durationNumber(opts.durationMs);
+        const { brain, settings } = stores(opts);
+        const result = await reportAgentActivity(brain, settings, {
+            kind, projectId: opts.projectId, sessionId: opts.session, agent: opts.agent,
+            phase: opts.phase, tool: opts.tool, correlationId: opts.correlation, outcome: opts.outcome, durationMs,
+        });
+        console.log(JSON.stringify(result, null, 2));
+    });
+    storeOptions(activity.command('tail').description('Read a page of recent activity or continue from a cursor'))
+        .option('--project-id <id>', 'Filter by recorded project label')
+        .option('--cursor <number>', 'Continue after this event sequence')
+        .option('--journal-id <id>', 'Journal ID paired with a previous cursor')
+        .action((opts) => {
+        const { brain, settings } = stores(opts);
+        const flags = settings.get().features;
+        const enabled = { liveEnabled: flags.liveActivity, recordingEnabled: flags.activityRecording };
+        if (!flags.liveActivity) {
+            console.log(JSON.stringify({
+                ...enabled, events: [], journalId: null, revision: 0, oldestSequence: null, latestSequence: 0,
+                nextAfterSequence: 0, cursor: 0, hasMore: false, gap: false, reset: false, retainedCount: 0, droppedCount: 0,
+            }, null, 2));
+            return;
+        }
+        const page = activityJournalFor(brain).read({
+            projectId: opts.projectId, afterSequence: cursorNumber(opts.cursor), journalId: opts.journalId, limit: 200,
+        });
+        console.log(JSON.stringify({ ...enabled, ...page, cursor: page.nextAfterSequence }, null, 2));
+    });
+    program.addCommand(activity);
+}
+//# sourceMappingURL=activity-cli.js.map

package/dist/activity-cli.js.map

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

package/dist/adapters/index.d.ts

@@ -9,7 +9,8 @@ import { AiderAdapter } from './aider.js';
 import { CursorAdapter } from './cursor.js';
 import { WindsurfAdapter } from './windsurf.js';
 import { CopilotAdapter } from './copilot.js';
-export declare const ALL_ADAPTERS: Record<AgentTool, () => AgentAdapter>;
+/** File adapters are distinct from clients that connect through MCP and skills. */
+export declare const ALL_ADAPTERS: Record<Exclude<AgentTool, 'deepseek-harness' | 'user'>, () => AgentAdapter>;
 export declare function createAdapter(tool: AgentTool): AgentAdapter;
 export declare function detectRunningAgents(projectDir: string): Promise<AgentAdapter[]>;
 export { ClaudeCodeAdapter, KiloCodeAdapter, ClineAdapter, OpenCodeAdapter, CodexAdapter, RooCodeAdapter, AiderAdapter, CursorAdapter, WindsurfAdapter, CopilotAdapter, };

package/dist/adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,YAAY,CAW9D,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,CAI3D;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAcrF;AAED,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,GACf,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,mFAAmF;AACnF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,kBAAkB,GAAG,MAAM,CAAC,EAAE,MAAM,YAAY,CAWpG,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,CAI3D;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAcrF;AAED,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,GACf,CAAC"}

package/dist/adapters/index.js

@@ -9,6 +9,7 @@ import { AiderAdapter } from './aider.js';
 import { CursorAdapter } from './cursor.js';
 import { WindsurfAdapter } from './windsurf.js';
 import { CopilotAdapter } from './copilot.js';
+/** File adapters are distinct from clients that connect through MCP and skills. */
 export const ALL_ADAPTERS = {
     'claude-code': () => new ClaudeCodeAdapter(),
     'kilo-code': () => new KiloCodeAdapter(),
@@ -22,9 +23,9 @@ export const ALL_ADAPTERS = {
     'copilot': () => new CopilotAdapter(),
 };
 export function createAdapter(tool) {
+    if (!Object.hasOwn(ALL_ADAPTERS, tool))
+        throw new Error(`No native file adapter for ${tool}. Use its MCP or project-skill integration.`);
     const factory = ALL_ADAPTERS[tool];
-    if (!factory)
-        throw new Error(`Unknown agent tool: ${tool}`);
     return factory();
 }
 export async function detectRunningAgents(projectDir) {

package/dist/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAGxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAC,MAAM,YAAY,GAA0C;IACjE,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,iBAAiB,EAAE;IAC5C,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,EAAE;IACxC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,EAAE;IACjC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,EAAE;IACvC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,EAAE;IACjC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,cAAc,EAAE;IACtC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,EAAE;IACjC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,aAAa,EAAE;IACnC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,EAAE;IACvC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,cAAc,EAAE;CACtC,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAe;IAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IAC7D,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAAkB;IAC1D,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;QACzB,OAAe,CAAC,UAAU,GAAG,UAAU,CAAC;QACzC,IAAI,CAAC;YACH,IAAI,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC3B,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,GACf,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAGxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,mFAAmF;AACnF,MAAM,CAAC,MAAM,YAAY,GAAgF;IACvG,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,iBAAiB,EAAE;IAC5C,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,EAAE;IACxC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,EAAE;IACjC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,EAAE;IACvC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,EAAE;IACjC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,cAAc,EAAE;IACtC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,EAAE;IACjC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,aAAa,EAAE;IACnC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,EAAE;IACvC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,cAAc,EAAE;CACtC,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAe;IAC3C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,6CAA6C,CAAC,CAAC;IACzI,MAAM,OAAO,GAAG,YAAY,CAAC,IAAiC,CAAC,CAAC;IAChE,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAAkB;IAC1D,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;QACzB,OAAe,CAAC,UAAU,GAAG,UAAU,CAAC;QACzC,IAAI,CAAC;YACH,IAAI,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC3B,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,GACf,CAAC"}

package/dist/brain/activity-journal.d.ts

@@ -0,0 +1,82 @@
+export declare const ACTIVITY_JOURNAL_FILENAME = "activity-journal.json";
+export declare const ACTIVITY_JOURNAL_LIMITS: Readonly<{
+    retained: 500;
+    page: 200;
+    bytes: number;
+}>;
+declare const KINDS: readonly ["session-start", "phase", "tool-start", "tool-end", "session-end"];
+declare const SOURCES: readonly ["measured", "reported"];
+declare const TRANSPORTS: readonly ["mcp", "cli", "host"];
+declare const PHASES: readonly ["understand", "plan", "work", "verify"];
+declare const OUTCOMES: readonly ["success", "error", "cancelled"];
+export interface ActivityEventInput {
+    kind: typeof KINDS[number];
+    source: typeof SOURCES[number];
+    transport: typeof TRANSPORTS[number];
+    projectId?: string;
+    sessionId?: string;
+    agent?: string;
+    phase?: typeof PHASES[number];
+    tool?: string;
+    correlationId?: string;
+    outcome?: typeof OUTCOMES[number];
+    durationMs?: number;
+}
+export interface ActivityJournalEvent extends ActivityEventInput {
+    id: string;
+    sequence: number;
+    timestamp: string;
+}
+export interface ActivityJournalSnapshot {
+    schemaVersion: 1;
+    journalId: string | null;
+    revision: number;
+    nextSequence: number;
+    events: ActivityJournalEvent[];
+}
+export interface ActivityJournalReadOptions {
+    afterSequence?: number;
+    journalId?: string;
+    limit?: number;
+    projectId?: string;
+}
+export interface ActivityJournalPage {
+    journalId: string | null;
+    revision: number;
+    oldestSequence: number | null;
+    latestSequence: number;
+    nextAfterSequence: number;
+    hasMore: boolean;
+    gap: boolean;
+    reset: boolean;
+    /** Retention counts describe the journal, including when the page filters by project. */
+    retainedCount: number;
+    droppedCount: number;
+    events: ActivityJournalEvent[];
+}
+export interface ActivityJournalOptions {
+    filePath?: string;
+    lockTimeoutMs?: number;
+}
+export declare class ActivityJournalError extends Error {
+    readonly code: 'ACTIVITY_JOURNAL_INVALID_EVENT' | 'ACTIVITY_JOURNAL_INVALID_CURSOR' | 'ACTIVITY_JOURNAL_INVALID_STORE' | 'ACTIVITY_JOURNAL_READ_FAILED' | 'ACTIVITY_JOURNAL_LOCK_TIMEOUT' | 'ACTIVITY_JOURNAL_LOCK_FAILED' | 'ACTIVITY_JOURNAL_WRITE_FAILED';
+    constructor(code: 'ACTIVITY_JOURNAL_INVALID_EVENT' | 'ACTIVITY_JOURNAL_INVALID_CURSOR' | 'ACTIVITY_JOURNAL_INVALID_STORE' | 'ACTIVITY_JOURNAL_READ_FAILED' | 'ACTIVITY_JOURNAL_LOCK_TIMEOUT' | 'ACTIVITY_JOURNAL_LOCK_FAILED' | 'ACTIVITY_JOURNAL_WRITE_FAILED', message: string);
+}
+/** Local metadata journal shared by cooperating service processes. */
+export declare class ActivityJournal {
+    readonly filePath: string;
+    private readonly lockTimeoutMs;
+    constructor(options?: ActivityJournalOptions);
+    get(): ActivityJournalSnapshot;
+    read(options?: ActivityJournalReadOptions): ActivityJournalPage;
+    append(raw: unknown): Promise<ActivityJournalEvent>;
+    private checkFile;
+    private acquireLock;
+    private releaseLock;
+    private replace;
+}
+export declare function activityJournalFor(brain: {
+    dbPath: string;
+}): ActivityJournal;
+export {};
+//# sourceMappingURL=activity-journal.d.ts.map

package/dist/brain/activity-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-journal.d.ts","sourceRoot":"","sources":["../../src/brain/activity-journal.ts"],"names":[],"mappings":"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"}

package/dist/brain/activity-journal.js

@@ -0,0 +1,315 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { setTimeout as delay } from 'node:timers/promises';
+import { matchesFileIdentity } from './file-identity.js';
+export const ACTIVITY_JOURNAL_FILENAME = 'activity-journal.json';
+export const ACTIVITY_JOURNAL_LIMITS = Object.freeze({ retained: 500, page: 200, bytes: 1024 * 1024 });
+const KINDS = ['session-start', 'phase', 'tool-start', 'tool-end', 'session-end'];
+const SOURCES = ['measured', 'reported'];
+const TRANSPORTS = ['mcp', 'cli', 'host'];
+const PHASES = ['understand', 'plan', 'work', 'verify'];
+const OUTCOMES = ['success', 'error', 'cancelled'];
+export class ActivityJournalError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'ActivityJournalError';
+    }
+}
+const INPUT_KEYS = new Set([
+    'kind', 'source', 'transport', 'projectId', 'sessionId', 'agent', 'phase', 'tool', 'correlationId', 'outcome', 'durationMs',
+]);
+const SNAPSHOT_KEYS = new Set(['schemaVersion', 'journalId', 'revision', 'nextSequence', 'events']);
+const LOCK_TIMEOUT_MS = 3000;
+const LOCK_POLL_MS = 20;
+// Windows can report a sharing error while the previous owner removes the
+// exclusive lock. A persistent permission error still fails at the deadline.
+const RETRYABLE_LOCK_OPEN = new Set(['EEXIST', 'EACCES', 'EPERM', 'EBUSY', 'ENOENT']);
+const DEFAULT_PAGE_SIZE = 100;
+const SAFE_LABEL = /^[A-Za-z0-9][A-Za-z0-9_.:-]*$/;
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+function errno(error) {
+    return error?.code;
+}
+function isRecord(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function member(values, value) {
+    return values.some(item => item === value);
+}
+function label(value, max = 128) {
+    return typeof value === 'string' && value.length <= max && SAFE_LABEL.test(value);
+}
+function instant(value) {
+    if (typeof value !== 'string')
+        return false;
+    const time = Date.parse(value);
+    return Number.isFinite(time) && new Date(time).toISOString() === value;
+}
+function eventInput(value) {
+    if (!isRecord(value))
+        return undefined;
+    const input = { ...value };
+    if (Reflect.ownKeys(input).some(key => typeof key !== 'string' || !INPUT_KEYS.has(key)) ||
+        !member(KINDS, input.kind) || !member(SOURCES, input.source) || !member(TRANSPORTS, input.transport) ||
+        (input.projectId !== undefined && !label(input.projectId)) ||
+        (input.sessionId !== undefined && !label(input.sessionId)) ||
+        (input.agent !== undefined && !label(input.agent, 64)) ||
+        (input.outcome !== undefined && !member(OUTCOMES, input.outcome)))
+        return undefined;
+    const { kind, source, transport, phase, tool, correlationId, outcome, durationMs } = input;
+    if ((source === 'reported') !== (transport === 'host'))
+        return undefined;
+    if (kind === 'tool-start' || kind === 'tool-end') {
+        if (phase !== undefined || !label(tool, 64) || !label(correlationId))
+            return undefined;
+        if (kind === 'tool-start' && (outcome !== undefined || durationMs !== undefined))
+            return undefined;
+        if (kind === 'tool-end' && (outcome === undefined || typeof durationMs !== 'number' ||
+            !Number.isFinite(durationMs) || durationMs < 0 || durationMs > Number.MAX_SAFE_INTEGER))
+            return undefined;
+    }
+    else {
+        if (tool !== undefined || correlationId !== undefined || durationMs !== undefined ||
+            (kind !== 'session-end' && outcome !== undefined))
+            return undefined;
+        if (kind === 'phase' ? source !== 'reported' || !member(PHASES, phase) : phase !== undefined)
+            return undefined;
+    }
+    return input;
+}
+function emptySnapshot() {
+    return { schemaVersion: 1, journalId: null, revision: 0, nextSequence: 1, events: [] };
+}
+function parseSnapshot(raw) {
+    try {
+        const data = JSON.parse(raw);
+        if (isRecord(data) && Object.keys(data).every(key => SNAPSHOT_KEYS.has(key)) && data.schemaVersion === 1 &&
+            typeof data.journalId === 'string' && UUID.test(data.journalId) && typeof data.revision === 'number' &&
+            Number.isSafeInteger(data.revision) && data.revision >= 1 && data.revision < Number.MAX_SAFE_INTEGER &&
+            data.nextSequence === data.revision + 1 && Array.isArray(data.events) &&
+            data.events.length === Math.min(data.revision, ACTIVITY_JOURNAL_LIMITS.retained)) {
+            const first = data.revision - data.events.length + 1;
+            const ids = new Set();
+            const events = [];
+            for (const value of data.events) {
+                if (!isRecord(value))
+                    break;
+                const { id, sequence, timestamp, ...input } = value;
+                const validated = eventInput(input);
+                if (typeof id !== 'string' || !UUID.test(id) || ids.has(id) || sequence !== first + events.length ||
+                    !instant(timestamp) || !validated)
+                    break;
+                ids.add(id);
+                events.push({ ...validated, id, sequence, timestamp });
+            }
+            if (events.length === data.events.length) {
+                return { schemaVersion: 1, journalId: data.journalId, revision: data.revision, nextSequence: data.nextSequence, events };
+            }
+        }
+    }
+    catch { /* Surface invalid storage without echoing its bytes. */ }
+    throw new ActivityJournalError('ACTIVITY_JOURNAL_INVALID_STORE', 'Activity journal is malformed or uses an unsupported schema.');
+}
+/** Local metadata journal shared by cooperating service processes. */
+export class ActivityJournal {
+    constructor(options = {}) {
+        this.filePath = path.resolve(options.filePath ?? path.join(os.homedir(), '.shadow-brain', ACTIVITY_JOURNAL_FILENAME));
+        this.lockTimeoutMs = typeof options.lockTimeoutMs === 'number' && Number.isFinite(options.lockTimeoutMs)
+            ? Math.max(0, Math.min(60000, options.lockTimeoutMs))
+            : LOCK_TIMEOUT_MS;
+    }
+    get() {
+        let raw;
+        try {
+            const stat = fs.lstatSync(this.filePath, { throwIfNoEntry: false });
+            if (!stat)
+                return emptySnapshot();
+            this.checkFile(stat);
+            const fd = fs.openSync(this.filePath, fs.constants.O_RDONLY | (fs.constants.O_NOFOLLOW ?? 0));
+            try {
+                this.checkFile(fs.fstatSync(fd));
+                raw = fs.readFileSync(fd, 'utf8');
+            }
+            finally {
+                fs.closeSync(fd);
+            }
+        }
+        catch (error) {
+            if (error instanceof ActivityJournalError)
+                throw error;
+            throw new ActivityJournalError('ACTIVITY_JOURNAL_READ_FAILED', 'Could not read the activity journal.');
+        }
+        return parseSnapshot(raw);
+    }
+    read(options = {}) {
+        const { afterSequence, journalId, limit = DEFAULT_PAGE_SIZE, projectId } = options;
+        if ((afterSequence !== undefined && (!Number.isSafeInteger(afterSequence) || afterSequence < 0)) ||
+            (journalId !== undefined && (typeof journalId !== 'string' || !UUID.test(journalId))) ||
+            !Number.isSafeInteger(limit) || limit < 1 || limit > ACTIVITY_JOURNAL_LIMITS.page ||
+            (projectId !== undefined && !label(projectId))) {
+            throw new ActivityJournalError('ACTIVITY_JOURNAL_INVALID_CURSOR', 'Invalid activity journal cursor, project, or page size.');
+        }
+        const snapshot = this.get();
+        const oldestSequence = snapshot.events[0]?.sequence ?? null;
+        const latestSequence = snapshot.nextSequence - 1;
+        const reset = (journalId !== undefined && journalId !== snapshot.journalId) ||
+            (afterSequence !== undefined && afterSequence > latestSequence);
+        const gap = !reset && afterSequence !== undefined && oldestSequence !== null && afterSequence < oldestSequence - 1;
+        const eligible = projectId === undefined ? snapshot.events : snapshot.events.filter(event => event.projectId === projectId);
+        const newer = reset || afterSequence === undefined ? null : eligible.filter(event => event.sequence > afterSequence);
+        const events = newer ? newer.slice(0, limit) : eligible.slice(-limit);
+        const hasMore = !!newer && newer.length > events.length;
+        return {
+            journalId: snapshot.journalId,
+            revision: snapshot.revision,
+            oldestSequence,
+            latestSequence,
+            nextAfterSequence: hasMore ? events[events.length - 1].sequence : latestSequence,
+            hasMore,
+            gap,
+            reset,
+            retainedCount: snapshot.events.length,
+            droppedCount: latestSequence - snapshot.events.length,
+            events,
+        };
+    }
+    async append(raw) {
+        const input = eventInput(raw);
+        if (!input) {
+            throw new ActivityJournalError('ACTIVITY_JOURNAL_INVALID_EVENT', 'Invalid activity event. Use only defined metadata fields.');
+        }
+        try {
+            fs.mkdirSync(path.dirname(this.filePath), { recursive: true });
+        }
+        catch {
+            throw new ActivityJournalError('ACTIVITY_JOURNAL_WRITE_FAILED', 'Could not open the activity journal directory.');
+        }
+        const release = await this.acquireLock();
+        try {
+            const latest = this.get();
+            if (latest.nextSequence >= Number.MAX_SAFE_INTEGER) {
+                throw new ActivityJournalError('ACTIVITY_JOURNAL_INVALID_STORE', 'Activity journal sequence has reached its limit.');
+            }
+            const event = {
+                ...input, id: randomUUID(), sequence: latest.nextSequence, timestamp: new Date().toISOString(),
+            };
+            this.replace({
+                schemaVersion: 1,
+                journalId: latest.journalId ?? randomUUID(),
+                revision: latest.revision + 1,
+                nextSequence: event.sequence + 1,
+                events: [...latest.events, event].slice(-ACTIVITY_JOURNAL_LIMITS.retained),
+            });
+            return event;
+        }
+        finally {
+            release();
+        }
+    }
+    checkFile(stat) {
+        if (!stat.isFile() || stat.isSymbolicLink() || stat.nlink !== 1 || stat.size > ACTIVITY_JOURNAL_LIMITS.bytes) {
+            throw new ActivityJournalError('ACTIVITY_JOURNAL_INVALID_STORE', 'Activity journal must be a regular local file within its size limit.');
+        }
+    }
+    async acquireLock() {
+        const lock = this.filePath + '.lock';
+        const deadline = performance.now() + this.lockTimeoutMs;
+        let lastCode;
+        for (;;) {
+            let fd;
+            try {
+                fd = fs.openSync(lock, 'wx', 0o600);
+            }
+            catch (error) {
+                lastCode = errno(error);
+                if (!lastCode || !RETRYABLE_LOCK_OPEN.has(lastCode)) {
+                    throw new ActivityJournalError('ACTIVITY_JOURNAL_LOCK_FAILED', 'Could not acquire the activity journal lock.');
+                }
+                const remaining = deadline - performance.now();
+                if (remaining <= 0)
+                    break;
+                await delay(Math.min(remaining, LOCK_POLL_MS));
+                if (performance.now() >= deadline)
+                    break;
+                continue;
+            }
+            let owner;
+            try {
+                owner = fs.fstatSync(fd, { bigint: true });
+                fs.writeFileSync(fd, JSON.stringify({ pid: process.pid, id: randomUUID(), acquiredAt: new Date().toISOString() }));
+                fs.closeSync(fd);
+            }
+            catch {
+                try {
+                    fs.closeSync(fd);
+                }
+                catch { /* Preserve the original lock error. */ }
+                try {
+                    if (owner)
+                        this.releaseLock(lock, owner);
+                }
+                catch { /* Preserve an unfamiliar lock. */ }
+                throw new ActivityJournalError('ACTIVITY_JOURNAL_LOCK_FAILED', 'Could not initialize the activity journal lock.');
+            }
+            const owned = owner;
+            return () => this.releaseLock(lock, owned);
+        }
+        if (lastCode && lastCode !== 'EEXIST') {
+            throw new ActivityJournalError('ACTIVITY_JOURNAL_LOCK_FAILED', 'Could not acquire the activity journal lock (' + lastCode + ').');
+        }
+        throw new ActivityJournalError('ACTIVITY_JOURNAL_LOCK_TIMEOUT', 'Timed out waiting for the activity journal lock.');
+    }
+    releaseLock(lock, owner) {
+        try {
+            const current = fs.lstatSync(lock, { bigint: true, throwIfNoEntry: false });
+            if (!matchesFileIdentity(lock, owner, current))
+                throw new Error('Lock ownership changed.');
+            fs.unlinkSync(lock);
+        }
+        catch {
+            throw new ActivityJournalError('ACTIVITY_JOURNAL_LOCK_FAILED', 'Could not release the activity journal lock.');
+        }
+    }
+    replace(snapshot) {
+        const payload = JSON.stringify(snapshot) + '\n';
+        if (Buffer.byteLength(payload) > ACTIVITY_JOURNAL_LIMITS.bytes) {
+            throw new ActivityJournalError('ACTIVITY_JOURNAL_WRITE_FAILED', 'Activity journal exceeds its size limit.');
+        }
+        const temporary = this.filePath + '.' + randomUUID() + '.tmp';
+        let ownsTemp = false;
+        try {
+            const fd = fs.openSync(temporary, 'wx', 0o600);
+            ownsTemp = true;
+            try {
+                fs.writeFileSync(fd, payload);
+                fs.fsyncSync(fd);
+            }
+            finally {
+                fs.closeSync(fd);
+            }
+            fs.renameSync(temporary, this.filePath);
+            ownsTemp = false;
+        }
+        catch {
+            throw new ActivityJournalError('ACTIVITY_JOURNAL_WRITE_FAILED', 'Could not save activity journal.');
+        }
+        finally {
+            if (ownsTemp) {
+                try {
+                    fs.unlinkSync(temporary);
+                }
+                catch { /* Preserve the original write error. */ }
+            }
+        }
+    }
+}
+export function activityJournalFor(brain) {
+    return new ActivityJournal({ filePath: path.join(path.dirname(brain.dbPath), ACTIVITY_JOURNAL_FILENAME) });
+}
+//# sourceMappingURL=activity-journal.js.map

package/dist/brain/activity-journal.js.map

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

package/dist/brain/activity-reporting.d.ts

@@ -0,0 +1,14 @@
+import type { GlobalBrain } from './global-brain.js';
+import type { FeatureSettingsStore } from './feature-settings.js';
+import { type ActivityJournal } from './activity-journal.js';
+/** Explicit host reports remain labelled reported; callers cannot forge measured events. */
+export declare function reportAgentActivity(brain: Pick<GlobalBrain, 'dbPath'>, settings: FeatureSettingsStore, input: unknown, journal?: ActivityJournal): Promise<{
+    recorded: boolean;
+    reason: string;
+    event?: undefined;
+} | {
+    recorded: boolean;
+    event: import("./activity-journal.js").ActivityJournalEvent;
+    reason?: undefined;
+}>;
+//# sourceMappingURL=activity-reporting.d.ts.map

package/dist/brain/activity-reporting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-reporting.d.ts","sourceRoot":"","sources":["../../src/brain/activity-reporting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEjF,4FAA4F;AAC5F,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe;;;;;;;;GAStJ"}

package/dist/brain/activity-reporting.js

@@ -0,0 +1,17 @@
+import { activityJournalFor } from './activity-journal.js';
+/** Explicit host reports remain labelled reported; callers cannot forge measured events. */
+export async function reportAgentActivity(brain, settings, input, journal) {
+    if (!input || typeof input !== 'object' || Array.isArray(input))
+        throw new TypeError('Send an activity object.');
+    const allowed = ['kind', 'projectId', 'sessionId', 'agent', 'phase', 'tool', 'correlationId', 'outcome', 'durationMs'];
+    if (Object.keys(input).some(key => !allowed.includes(key)))
+        throw new TypeError('Only activity labels, phases, and timing fields are accepted.');
+    const data = input;
+    if (['projectId', 'sessionId', 'agent'].some(key => typeof data[key] !== 'string' || !data[key]))
+        throw new TypeError('projectId, sessionId, and agent are required.');
+    if (!settings.get().features.activityRecording)
+        return { recorded: false, reason: 'Activity recording is disabled.' };
+    const event = await (journal ?? activityJournalFor(brain)).append({ ...data, source: 'reported', transport: 'host' });
+    return { recorded: true, event };
+}
+//# sourceMappingURL=activity-reporting.js.map

package/dist/brain/activity-reporting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-reporting.js","sourceRoot":"","sources":["../../src/brain/activity-reporting.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAwB,MAAM,uBAAuB,CAAC;AAEjF,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAkC,EAAE,QAA8B,EAAE,KAAc,EAAE,OAAyB;IACrJ,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC;IACjH,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IACvH,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACjJ,MAAM,IAAI,GAAG,KAAgC,CAAC;IAC9C,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;IACvK,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,iBAAiB;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAC;IACtH,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IACtH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC"}

package/dist/brain/auto-update.js

@@ -1,6 +1,6 @@
 // src/brain/auto-update.ts — Check for Shadow Brain updates
 import * as https from 'https';
-const CURRENT_VERSION = '7.1.0';
+const CURRENT_VERSION = '7.1.4';
 const PACKAGE_NAME = '@theihtisham/agent-shadow-brain';
 export async function checkForUpdate() {
     return new Promise((resolve) => {

package/dist/brain/brain-portability.js

@@ -35,7 +35,7 @@ export class BrainPortability {
         const fileName = `brain-${projectName}-${timestamp}.json`;
         const filePath = path.join(this.exportDir, fileName);
         const data = {
-            version: '7.1.0',
+            version: '7.1.4',
             exportedAt: new Date(),
             projectName,
             projectDir: this.projectDir,