@substrate-ai/core 0.20.111 → 0.20.112

package/dist/utils/stderr-logger.js

@@ -0,0 +1,65 @@
+/**
+ * Stderr-routed ILogger factory.
+ *
+ * Use this instead of `console` as the default fallback for any class that
+ * accepts an optional ILogger. Node's `console.debug` / `console.info` are
+ * aliases for `console.log`, which writes to STDOUT — that contaminates
+ * any stdout consumer that expects clean output (e.g. `substrate run --events`
+ * NDJSON consumers, `--output-format json` commands, downstream parsers).
+ *
+ * v0.20.110 fixed the adapter.ts leak. v0.20.111 fixed the
+ * git-worktree-manager-impl.ts leak. v0.20.112 centralized the discipline:
+ * one shared helper, applied at every `logger ?? console` site, so future
+ * callers can't reintroduce the bug.
+ *
+ * Usage:
+ *   import { createStderrLogger } from '@substrate-ai/core'
+ *   constructor(..., logger?: ILogger) {
+ *     this._logger = logger ?? createStderrLogger('my-module')
+ *   }
+ *
+ * The prefix is included in every line so stderr remains useful for
+ * diagnostic correlation across modules — without polluting stdout.
+ */
+/**
+ * Format args the same way `console.*` does — strings stay as-is, everything
+ * else serializes to JSON. Single-line output (newline appended by the
+ * stderr write).
+ */
+function formatArgs(args) {
+    return args
+        .map((a) => {
+        if (typeof a === 'string')
+            return a;
+        if (a instanceof Error)
+            return a.message;
+        try {
+            return JSON.stringify(a);
+        }
+        catch {
+            return String(a);
+        }
+    })
+        .join(' ');
+}
+/**
+ * Create an ILogger that routes every level to stderr via
+ * `process.stderr.write`. Each line is prefixed with `[<prefix>] [<level>]`
+ * so operators correlating cross-module diagnostics can tell where a line
+ * came from.
+ *
+ * @param prefix - Module identifier used in the stderr prefix
+ *                 (e.g., 'persistence:adapter', 'git-worktree-manager')
+ */
+export function createStderrLogger(prefix) {
+    function emit(level, args) {
+        process.stderr.write(`[${prefix}] [${level}] ${formatArgs(args)}\n`);
+    }
+    return {
+        info: (...args) => emit('info', args),
+        warn: (...args) => emit('warn', args),
+        error: (...args) => emit('error', args),
+        debug: (...args) => emit('debug', args),
+    };
+}
+//# sourceMappingURL=stderr-logger.js.map

package/dist/utils/stderr-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stderr-logger.js","sourceRoot":"","sources":["../../src/utils/stderr-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH;;;;GAIG;AACH,SAAS,UAAU,CAAC,IAAe;IACjC,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAA;QACnC,IAAI,CAAC,YAAY,KAAK;YAAE,OAAO,CAAC,CAAC,OAAO,CAAA;QACxC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC,CAAC,CAAC,CAAA;QAClB,CAAC;IACH,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,SAAS,IAAI,CAAC,KAAa,EAAE,IAAe;QAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,MAAM,KAAK,KAAK,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtE,CAAC;IACD,OAAO;QACL,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC;QAChD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC;QAChD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;QAClD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;KACnD,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@substrate-ai/core",
-  "version": "0.20.111",
+  "version": "0.20.112",
   "type": "module",
   "license": "MIT",
   "repository": {

package/dist/git/git-manager.d.ts

@@ -1,31 +0,0 @@
-/**
- * GitManager — interface and stub for git worktree management.
- *
- * The full implementation will be provided by a later story.
- * This stub subscribes to worktree events and satisfies the IBaseService
- * lifecycle contract.
- *
- * Event subscriptions (Architecture Section 19):
- *  - Listens to worktree:created, worktree:merged, worktree:conflict, worktree:removed events
- */
-import type { IBaseService } from '../types.js';
-import type { TypedEventBus } from '../events/index.js';
-import type { CoreEvents } from '../events/index.js';
-import type { ILogger } from '../dispatch/types.js';
-export interface GitManager extends IBaseService {
-}
-export declare class GitManagerImpl implements GitManager {
-    private readonly _eventBus;
-    private readonly _logger;
-    readonly repoRoot: string | undefined;
-    constructor(eventBus: TypedEventBus<CoreEvents>, repoRoot?: string, logger?: ILogger);
-    initialize(): Promise<void>;
-    shutdown(): Promise<void>;
-}
-export interface GitManagerOptions {
-    eventBus: TypedEventBus<CoreEvents>;
-    repoRoot?: string;
-    logger?: ILogger;
-}
-export declare function createGitManager(options: GitManagerOptions): GitManager;
-//# sourceMappingURL=git-manager.d.ts.map

package/dist/git/git-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"git-manager.d.ts","sourceRoot":"","sources":["../../src/git/git-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAMnD,MAAM,WAAW,UAAW,SAAQ,YAAY;CAE/C;AAMD,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;gBAEzB,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;IAM9E,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC;AAMD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAEvE"}

package/dist/git/git-manager.js

@@ -1,46 +0,0 @@
-/**
- * GitManager — interface and stub for git worktree management.
- *
- * The full implementation will be provided by a later story.
- * This stub subscribes to worktree events and satisfies the IBaseService
- * lifecycle contract.
- *
- * Event subscriptions (Architecture Section 19):
- *  - Listens to worktree:created, worktree:merged, worktree:conflict, worktree:removed events
- */
-// ---------------------------------------------------------------------------
-// GitManagerImpl (stub)
-// ---------------------------------------------------------------------------
-export class GitManagerImpl {
-    _eventBus;
-    _logger;
-    repoRoot;
-    constructor(eventBus, repoRoot, logger) {
-        this._eventBus = eventBus;
-        this.repoRoot = repoRoot;
-        this._logger = logger ?? console;
-    }
-    async initialize() {
-        this._logger.info({ repoRoot: this.repoRoot }, 'GitManager.initialize() — stub');
-        // Subscribe to worktree lifecycle events
-        this._eventBus.on('worktree:created', ({ taskId, worktreePath, branchName }) => {
-            this._logger.debug({ taskId, worktreePath, branchName }, 'worktree:created');
-        });
-        this._eventBus.on('worktree:merged', ({ taskId, branch }) => {
-            this._logger.debug({ taskId, branch }, 'worktree:merged');
-        });
-        this._eventBus.on('worktree:conflict', ({ taskId, conflictingFiles }) => {
-            this._logger.warn({ taskId, conflictingFiles }, 'worktree:conflict');
-        });
-        this._eventBus.on('worktree:removed', ({ taskId, branchName }) => {
-            this._logger.debug({ taskId, branchName }, 'worktree:removed');
-        });
-    }
-    async shutdown() {
-        this._logger.info('GitManager.shutdown() — stub');
-    }
-}
-export function createGitManager(options) {
-    return new GitManagerImpl(options.eventBus, options.repoRoot, options.logger);
-}
-//# sourceMappingURL=git-manager.js.map

package/dist/git/git-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"git-manager.js","sourceRoot":"","sources":["../../src/git/git-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,OAAO,cAAc;IACR,SAAS,CAA2B;IACpC,OAAO,CAAS;IACxB,QAAQ,CAAoB;IAErC,YAAY,QAAmC,EAAE,QAAiB,EAAE,MAAgB;QAClF,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,OAAO,CAAA;IAClC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,gCAAgC,CAAC,CAAA;QAEhF,yCAAyC;QACzC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,EAAE;YAC7E,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,kBAAkB,CAAC,CAAA;QAC9E,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;YAC1D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAA;QAC3D,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,EAAE;YACtE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,mBAAmB,CAAC,CAAA;QACtE,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE;YAC/D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,kBAAkB,CAAC,CAAA;QAChE,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAA;IACnD,CAAC;CACF;AAYD,MAAM,UAAU,gBAAgB,CAAC,OAA0B;IACzD,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;AAC/E,CAAC"}