@v1nvn/agentic-core 0.40.0 → 0.41.1

package/dist/index.js

@@ -3,11 +3,16 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 //#region src/cli.ts
 function parseQuietly(program, args, recover) {
-	try {
-		program.allowExcessArguments(false).exitOverride().configureOutput({
+	function quiet(command) {
+		command.allowExcessArguments(false).exitOverride().configureOutput({
 			writeOut: () => void 0,
 			writeErr: () => void 0
-		}).parse([...args], { from: "user" });
+		});
+		command.commands.forEach(quiet);
+	}
+	try {
+		quiet(program);
+		program.parse([...args], { from: "user" });
 		return program;
 	} catch (err) {
 		return recover?.(err);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/cli.ts","../src/dev.ts","../src/input.ts","../src/last-reply.ts","../src/logger.ts","../src/shutdown.ts"],"sourcesContent":["import type { Command } from 'commander';\n\nexport function parseQuietly<T = never>(\n  program: Command,\n  args: readonly string[],\n  recover?: (err: unknown) => T | undefined,\n): Command | T | undefined {\n  try {\n    program\n      .allowExcessArguments(false)\n      .exitOverride()\n      .configureOutput({ writeOut: () => undefined, writeErr: () => undefined })\n      .parse([...args], { from: 'user' });\n    return program;\n  } catch (err) {\n    return recover?.(err);\n  }\n}\n\nexport function printUsageAndExit(program: Command): never {\n  console.error(program.helpInformation());\n  // CLIs report failure through the exit code; the rule targets libraries.\n  // eslint-disable-next-line n/no-process-exit\n  process.exit(1);\n}\n\nexport async function runMain(main: () => Promise<void> | void): Promise<void> {\n  try {\n    await main();\n  } catch (e) {\n    console.error((e as Error).message);\n    // CLIs report failure through the exit code; the rule targets libraries.\n    // eslint-disable-next-line n/no-process-exit\n    process.exit(1);\n  }\n}\n","// Structural stand-ins for vite's dev server and module runner — the shared\n// hot-reload wiring below must not pull vite into core's runtime surface; the\n// MCP packages pass their real instances through.\nexport interface ReloadableRunner {\n  readonly evaluatedModules: { clear(): void };\n  import<T>(entry: string): Promise<T>;\n}\n\nexport interface WatchableDevServer {\n  close(): Promise<unknown>;\n  readonly watcher: {\n    on(event: 'change', cb: (file: string) => void): unknown;\n  };\n}\n\nconst RELOAD_DEBOUNCE_MS = 150;\n\nconst IGNORED_SEGMENTS = ['/node_modules/', '/dist/', '/.git/', '/coverage/'];\n\nfunction shouldReload(file: string): boolean {\n  return IGNORED_SEGMENTS.every(seg => !file.includes(seg));\n}\n\n/**\n * Debounced file-change reloads, serialized via a promise chain: concurrent\n * saves never overlap, and a mid-reload save still produces a follow-up.\n */\nexport function watchWithReload(\n  vite: WatchableDevServer,\n  reload: () => Promise<void>,\n): void {\n  let chain: Promise<void> = Promise.resolve();\n  let timer: NodeJS.Timeout | undefined;\n  vite.watcher.on('change', file => {\n    if (!shouldReload(file)) {\n      return;\n    }\n    if (timer) {\n      clearTimeout(timer);\n    }\n    timer = setTimeout(() => {\n      timer = undefined;\n      chain = chain.then(reload);\n    }, RELOAD_DEBOUNCE_MS);\n  });\n}\n","import { readFileSync, statSync } from 'node:fs';\n\nfunction readAll(stream: NodeJS.ReadableStream): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let data = '';\n    stream.setEncoding('utf8');\n    stream.on('data', (chunk: string) => {\n      data += chunk;\n    });\n    stream.on('end', () => {\n      resolve(data);\n    });\n    stream.on('error', reject);\n  });\n}\n\nexport function readStdin(\n  stream: NodeJS.ReadableStream = process.stdin,\n): Promise<string> {\n  return readAll(stream);\n}\n\n/** A markdown file's contents, with the CLI's no-such-file error. */\nexport function readMarkdownFile(path: string): string {\n  const stats = statSync(path, { throwIfNoEntry: false });\n  if (!stats?.isFile()) {\n    throw new Error(`no such file: ${path}`);\n  }\n  return readFileSync(path, 'utf8');\n}\n","import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\n\nfunction isFile(path: string): boolean {\n  try {\n    return statSync(path).isFile();\n  } catch {\n    return false;\n  }\n}\n\ninterface ContentBlock {\n  text?: string;\n  type: string;\n}\n\ninterface TranscriptEntry {\n  message?: { content?: unknown };\n  type?: string;\n}\n\nfunction textBlocks(entry: TranscriptEntry): ContentBlock[] | undefined {\n  const content = entry.message?.content;\n  if (entry.type !== 'assistant' || !Array.isArray(content)) {\n    return undefined;\n  }\n  const blocks = content.filter(\n    (b): b is ContentBlock =>\n      typeof b === 'object' &&\n      b !== null &&\n      (b as ContentBlock).type === 'text',\n  );\n  return blocks.length > 0 ? blocks : undefined;\n}\n\nexport function claudeProjectsDir(): string {\n  const claudeDir = process.env.CLAUDE_DIR ?? join(homedir(), '.claude');\n  return join(claudeDir, 'projects');\n}\n\n/**\n * The last assistant text reply from a Claude Code session, reproducing Claude\n * Code's `/copy` byte-for-byte: the last assistant entry that contains a\n * `text` block, only its `text` block(s) (tool_use / thinking dropped), blocks\n * joined with a blank line, and no trailing newline.\n *\n * @param arg a transcript file, a session UUID under the project dir, or\n *   nothing to use the newest session for the current project.\n */\nexport function lastReply(arg?: string): string {\n  // Claude Code keys transcripts under the project root with \"/\" → \"-\".\n  // Prefer $CLAUDE_PROJECT_DIR (exported to hook processes) over $PWD.\n  const proj = (process.env.CLAUDE_PROJECT_DIR ?? process.cwd()).replaceAll(\n    '/',\n    '-',\n  );\n  const projDir = join(claudeProjectsDir(), proj);\n\n  let file: string | undefined;\n  if (arg !== undefined) {\n    file = isFile(arg) ? arg : join(projDir, `${arg}.jsonl`);\n  } else if (existsSync(projDir)) {\n    const newest = readdirSync(projDir)\n      .filter(f => f.endsWith('.jsonl'))\n      .map(f => ({ f, mtimeMs: statSync(join(projDir, f)).mtimeMs }))\n      .sort((a, b) => b.mtimeMs - a.mtimeMs)\n      .at(0);\n    if (newest) {\n      file = join(projDir, newest.f);\n    }\n  }\n\n  if (file === undefined || !isFile(file)) {\n    throw new Error(`no session transcript found in ${projDir}`);\n  }\n\n  let last: ContentBlock[] | undefined;\n  for (const line of readFileSync(file, 'utf8').split('\\n')) {\n    if (!line.includes('\"assistant\"')) {\n      continue;\n    }\n    let entry: TranscriptEntry;\n    try {\n      entry = JSON.parse(line) as TranscriptEntry;\n    } catch {\n      continue;\n    }\n    const blocks = textBlocks(entry);\n    if (blocks) {\n      last = blocks;\n    }\n  }\n  return (last ?? []).map(b => b.text ?? '').join('\\n\\n');\n}\n","export type LogLevel = 'debug' | 'error' | 'info' | 'silent' | 'warn';\n\nconst LEVEL_RANK: Record<LogLevel, number> = {\n  debug: 10,\n  info: 20,\n  warn: 30,\n  error: 40,\n  silent: Number.MAX_SAFE_INTEGER,\n};\n\nexport function levelEnabled(\n  active: LogLevel,\n  wanted: Exclude<LogLevel, 'silent'>,\n): boolean {\n  return LEVEL_RANK[wanted] >= LEVEL_RANK[active];\n}\n\nconst LEVEL_LABEL: Record<Exclude<LogLevel, 'silent'>, string> = {\n  debug: 'DEBUG',\n  error: 'ERROR',\n  info: 'INFO',\n  warn: 'WARN',\n};\n\ntype Writer = (message: string) => void;\n\n// stdout carries the MCP transport; everything here goes to stderr.\nexport class Logger {\n  private readonly stderr: Writer;\n\n  constructor(\n    readonly activeLevel: LogLevel,\n    stderr: Writer = line => process.stderr.write(`${line}\\n`),\n  ) {\n    this.stderr = stderr;\n  }\n\n  debug(message: string): void {\n    this.log('debug', message);\n  }\n\n  error(message: string): void {\n    this.log('error', message);\n  }\n\n  info(message: string): void {\n    this.log('info', message);\n  }\n\n  warn(message: string): void {\n    this.log('warn', message);\n  }\n\n  private log(level: Exclude<LogLevel, 'silent'>, message: string): void {\n    if (levelEnabled(this.activeLevel, level)) {\n      this.stderr(`${LEVEL_LABEL[level]} ${message}`);\n    }\n  }\n}\n","/** Close each closable in order (best-effort), then force-exit. */\nexport function shutdownOnSignals(\n  closables: readonly { close(): Promise<unknown> }[],\n  signals: readonly NodeJS.Signals[] = ['SIGINT', 'SIGTERM'],\n): void {\n  function shutdown(): void {\n    void closables\n      .reduce(\n        (acc: Promise<void>, closable) =>\n          acc.then(async () => {\n            try {\n              await closable.close();\n            } catch {\n              // best-effort; exiting regardless\n            }\n            return;\n          }),\n        Promise.resolve(),\n      )\n      .finally(() => {\n        // Force-exit on signal; the n/no-process-exit rule targets libraries.\n        // eslint-disable-next-line n/no-process-exit\n        process.exit(0);\n      });\n  }\n  for (const signal of signals) {\n    process.on(signal, shutdown);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/cli.ts","../src/dev.ts","../src/input.ts","../src/last-reply.ts","../src/logger.ts","../src/shutdown.ts"],"sourcesContent":["import type { Command } from 'commander';\n\nexport function parseQuietly<T = never>(\n  program: Command,\n  args: readonly string[],\n  recover?: (err: unknown) => T | undefined,\n): Command | T | undefined {\n  function quiet(command: Command): void {\n    command\n      .allowExcessArguments(false)\n      .exitOverride()\n      .configureOutput({\n        writeOut: () => undefined,\n        writeErr: () => undefined,\n      });\n    command.commands.forEach(quiet);\n  }\n  try {\n    quiet(program);\n    program.parse([...args], { from: 'user' });\n    return program;\n  } catch (err) {\n    return recover?.(err);\n  }\n}\n\nexport function printUsageAndExit(program: Command): never {\n  console.error(program.helpInformation());\n  // CLIs report failure through the exit code; the rule targets libraries.\n  // eslint-disable-next-line n/no-process-exit\n  process.exit(1);\n}\n\nexport async function runMain(main: () => Promise<void> | void): Promise<void> {\n  try {\n    await main();\n  } catch (e) {\n    console.error((e as Error).message);\n    // CLIs report failure through the exit code; the rule targets libraries.\n    // eslint-disable-next-line n/no-process-exit\n    process.exit(1);\n  }\n}\n","// Structural stand-ins for vite's dev server and module runner — the shared\n// hot-reload wiring below must not pull vite into core's runtime surface; the\n// MCP packages pass their real instances through.\nexport interface ReloadableRunner {\n  readonly evaluatedModules: { clear(): void };\n  import<T>(entry: string): Promise<T>;\n}\n\nexport interface WatchableDevServer {\n  close(): Promise<unknown>;\n  readonly watcher: {\n    on(event: 'change', cb: (file: string) => void): unknown;\n  };\n}\n\nconst RELOAD_DEBOUNCE_MS = 150;\n\nconst IGNORED_SEGMENTS = ['/node_modules/', '/dist/', '/.git/', '/coverage/'];\n\nfunction shouldReload(file: string): boolean {\n  return IGNORED_SEGMENTS.every(seg => !file.includes(seg));\n}\n\n/**\n * Debounced file-change reloads, serialized via a promise chain: concurrent\n * saves never overlap, and a mid-reload save still produces a follow-up.\n */\nexport function watchWithReload(\n  vite: WatchableDevServer,\n  reload: () => Promise<void>,\n): void {\n  let chain: Promise<void> = Promise.resolve();\n  let timer: NodeJS.Timeout | undefined;\n  vite.watcher.on('change', file => {\n    if (!shouldReload(file)) {\n      return;\n    }\n    if (timer) {\n      clearTimeout(timer);\n    }\n    timer = setTimeout(() => {\n      timer = undefined;\n      chain = chain.then(reload);\n    }, RELOAD_DEBOUNCE_MS);\n  });\n}\n","import { readFileSync, statSync } from 'node:fs';\n\nfunction readAll(stream: NodeJS.ReadableStream): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let data = '';\n    stream.setEncoding('utf8');\n    stream.on('data', (chunk: string) => {\n      data += chunk;\n    });\n    stream.on('end', () => {\n      resolve(data);\n    });\n    stream.on('error', reject);\n  });\n}\n\nexport function readStdin(\n  stream: NodeJS.ReadableStream = process.stdin,\n): Promise<string> {\n  return readAll(stream);\n}\n\n/** A markdown file's contents, with the CLI's no-such-file error. */\nexport function readMarkdownFile(path: string): string {\n  const stats = statSync(path, { throwIfNoEntry: false });\n  if (!stats?.isFile()) {\n    throw new Error(`no such file: ${path}`);\n  }\n  return readFileSync(path, 'utf8');\n}\n","import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\n\nfunction isFile(path: string): boolean {\n  try {\n    return statSync(path).isFile();\n  } catch {\n    return false;\n  }\n}\n\ninterface ContentBlock {\n  text?: string;\n  type: string;\n}\n\ninterface TranscriptEntry {\n  message?: { content?: unknown };\n  type?: string;\n}\n\nfunction textBlocks(entry: TranscriptEntry): ContentBlock[] | undefined {\n  const content = entry.message?.content;\n  if (entry.type !== 'assistant' || !Array.isArray(content)) {\n    return undefined;\n  }\n  const blocks = content.filter(\n    (b): b is ContentBlock =>\n      typeof b === 'object' &&\n      b !== null &&\n      (b as ContentBlock).type === 'text',\n  );\n  return blocks.length > 0 ? blocks : undefined;\n}\n\nexport function claudeProjectsDir(): string {\n  const claudeDir = process.env.CLAUDE_DIR ?? join(homedir(), '.claude');\n  return join(claudeDir, 'projects');\n}\n\n/**\n * The last assistant text reply from a Claude Code session, reproducing Claude\n * Code's `/copy` byte-for-byte: the last assistant entry that contains a\n * `text` block, only its `text` block(s) (tool_use / thinking dropped), blocks\n * joined with a blank line, and no trailing newline.\n *\n * @param arg a transcript file, a session UUID under the project dir, or\n *   nothing to use the newest session for the current project.\n */\nexport function lastReply(arg?: string): string {\n  // Claude Code keys transcripts under the project root with \"/\" → \"-\".\n  // Prefer $CLAUDE_PROJECT_DIR (exported to hook processes) over $PWD.\n  const proj = (process.env.CLAUDE_PROJECT_DIR ?? process.cwd()).replaceAll(\n    '/',\n    '-',\n  );\n  const projDir = join(claudeProjectsDir(), proj);\n\n  let file: string | undefined;\n  if (arg !== undefined) {\n    file = isFile(arg) ? arg : join(projDir, `${arg}.jsonl`);\n  } else if (existsSync(projDir)) {\n    const newest = readdirSync(projDir)\n      .filter(f => f.endsWith('.jsonl'))\n      .map(f => ({ f, mtimeMs: statSync(join(projDir, f)).mtimeMs }))\n      .sort((a, b) => b.mtimeMs - a.mtimeMs)\n      .at(0);\n    if (newest) {\n      file = join(projDir, newest.f);\n    }\n  }\n\n  if (file === undefined || !isFile(file)) {\n    throw new Error(`no session transcript found in ${projDir}`);\n  }\n\n  let last: ContentBlock[] | undefined;\n  for (const line of readFileSync(file, 'utf8').split('\\n')) {\n    if (!line.includes('\"assistant\"')) {\n      continue;\n    }\n    let entry: TranscriptEntry;\n    try {\n      entry = JSON.parse(line) as TranscriptEntry;\n    } catch {\n      continue;\n    }\n    const blocks = textBlocks(entry);\n    if (blocks) {\n      last = blocks;\n    }\n  }\n  return (last ?? []).map(b => b.text ?? '').join('\\n\\n');\n}\n","export type LogLevel = 'debug' | 'error' | 'info' | 'silent' | 'warn';\n\nconst LEVEL_RANK: Record<LogLevel, number> = {\n  debug: 10,\n  info: 20,\n  warn: 30,\n  error: 40,\n  silent: Number.MAX_SAFE_INTEGER,\n};\n\nexport function levelEnabled(\n  active: LogLevel,\n  wanted: Exclude<LogLevel, 'silent'>,\n): boolean {\n  return LEVEL_RANK[wanted] >= LEVEL_RANK[active];\n}\n\nconst LEVEL_LABEL: Record<Exclude<LogLevel, 'silent'>, string> = {\n  debug: 'DEBUG',\n  error: 'ERROR',\n  info: 'INFO',\n  warn: 'WARN',\n};\n\ntype Writer = (message: string) => void;\n\n// stdout carries the MCP transport; everything here goes to stderr.\nexport class Logger {\n  private readonly stderr: Writer;\n\n  constructor(\n    readonly activeLevel: LogLevel,\n    stderr: Writer = line => process.stderr.write(`${line}\\n`),\n  ) {\n    this.stderr = stderr;\n  }\n\n  debug(message: string): void {\n    this.log('debug', message);\n  }\n\n  error(message: string): void {\n    this.log('error', message);\n  }\n\n  info(message: string): void {\n    this.log('info', message);\n  }\n\n  warn(message: string): void {\n    this.log('warn', message);\n  }\n\n  private log(level: Exclude<LogLevel, 'silent'>, message: string): void {\n    if (levelEnabled(this.activeLevel, level)) {\n      this.stderr(`${LEVEL_LABEL[level]} ${message}`);\n    }\n  }\n}\n","/** Close each closable in order (best-effort), then force-exit. */\nexport function shutdownOnSignals(\n  closables: readonly { close(): Promise<unknown> }[],\n  signals: readonly NodeJS.Signals[] = ['SIGINT', 'SIGTERM'],\n): void {\n  function shutdown(): void {\n    void closables\n      .reduce(\n        (acc: Promise<void>, closable) =>\n          acc.then(async () => {\n            try {\n              await closable.close();\n            } catch {\n              // best-effort; exiting regardless\n            }\n            return;\n          }),\n        Promise.resolve(),\n      )\n      .finally(() => {\n        // Force-exit on signal; the n/no-process-exit rule targets libraries.\n        // eslint-disable-next-line n/no-process-exit\n        process.exit(0);\n      });\n  }\n  for (const signal of signals) {\n    process.on(signal, shutdown);\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v1nvn/agentic-core",
-  "version": "0.40.0",
+  "version": "0.41.1",
   "description": "Shared runtime for the @v1nvn agent tools — last-reply transcript reader and fixed-width text formatting.",
   "type": "module",
   "main": "./dist/index.js",

package/src/cli.ts

@@ -5,12 +5,19 @@ export function parseQuietly<T = never>(
   args: readonly string[],
   recover?: (err: unknown) => T | undefined,
 ): Command | T | undefined {
-  try {
-    program
+  function quiet(command: Command): void {
+    command
       .allowExcessArguments(false)
       .exitOverride()
-      .configureOutput({ writeOut: () => undefined, writeErr: () => undefined })
-      .parse([...args], { from: 'user' });
+      .configureOutput({
+        writeOut: () => undefined,
+        writeErr: () => undefined,
+      });
+    command.commands.forEach(quiet);
+  }
+  try {
+    quiet(program);
+    program.parse([...args], { from: 'user' });
     return program;
   } catch (err) {
     return recover?.(err);