@xdsjs/dossierx-daemon 0.1.2 → 0.1.3

package/dist/index.js

@@ -3,7 +3,7 @@
 // src/cli.ts
 import { mkdir as mkdir6, stat as stat4 } from "fs/promises";
 import os3 from "os";
-import path8 from "path";
+import path9 from "path";
 import { Command } from "commander";
 import { DOSSIERX_DEFAULT_WORKSPACE_PATH } from "@xdsjs/dossierx-workspace";
 
@@ -30,8 +30,8 @@ var ApiClient = class {
     this.machineKey = options.machineKey;
     this.fetchImpl = options.fetchImpl ?? fetch;
   }
-  async post(path9, body, schema) {
-    const response = await this.fetchImpl(`${this.serverUrl}${path9}`, {
+  async post(path10, body, schema) {
+    const response = await this.fetchImpl(`${this.serverUrl}${path10}`, {
       method: "POST",
       headers: {
         authorization: `Bearer ${this.machineKey}`,
@@ -495,9 +495,103 @@ function createCodexRunnerFromOptions(options, env = process.env) {
   });
 }
 
+// src/git-mirror.ts
+import path2 from "path";
+import {
+  publishCompanySnapshot
+} from "@xdsjs/dossierx-git-mirror";
+
+// src/local-config.ts
+import { chmod, mkdir, readFile, writeFile } from "fs/promises";
+import os from "os";
+import path from "path";
+import { z } from "zod";
+import { DOSSIERX_CONFIG_DIR } from "@xdsjs/dossierx-workspace";
+var DaemonLocalConfigSchema = z.object({
+  machineId: z.string().uuid().optional(),
+  machineKey: z.string().startsWith("dx_machine_"),
+  serverUrl: z.string().min(1),
+  supabaseUrl: z.string().min(1),
+  supabaseAnonKey: z.string().min(1),
+  workspacePath: z.string().min(1),
+  investWikiMode: z.string().optional(),
+  investWikiLocalRepo: z.string().optional(),
+  investWikiCommand: z.string().optional(),
+  codexCommand: z.string().optional(),
+  codexModel: z.string().optional(),
+  codexSandbox: z.string().optional(),
+  gitMirrorRoot: z.string().optional(),
+  gitMirrorRemote: z.string().optional(),
+  gitMirrorBranch: z.string().optional(),
+  gitCommand: z.string().optional(),
+  localApiPort: z.number().int().positive().optional()
+});
+function expandHomePath(input) {
+  if (input === "~") {
+    return os.homedir();
+  }
+  if (input.startsWith("~/")) {
+    return path.join(os.homedir(), input.slice(2));
+  }
+  return input;
+}
+function getDaemonConfigDir(env = process.env) {
+  return path.resolve(
+    expandHomePath(env.DOSSIERX_CONFIG_DIR ?? DOSSIERX_CONFIG_DIR)
+  );
+}
+function daemonConfigPath(configDir = getDaemonConfigDir()) {
+  return path.join(configDir, "config.json");
+}
+async function readDaemonLocalConfig(configDir = getDaemonConfigDir()) {
+  try {
+    return DaemonLocalConfigSchema.parse(
+      JSON.parse(await readFile(daemonConfigPath(configDir), "utf8"))
+    );
+  } catch (error) {
+    if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+      return null;
+    }
+    throw error;
+  }
+}
+async function writeDaemonLocalConfig(config, configDir = getDaemonConfigDir()) {
+  const parsed = DaemonLocalConfigSchema.parse(config);
+  await mkdir(configDir, { recursive: true, mode: 448 });
+  const target = daemonConfigPath(configDir);
+  await writeFile(target, `${JSON.stringify(parsed, null, 2)}
+`, {
+    mode: 384
+  });
+  await chmod(target, 384);
+}
+
+// src/git-mirror.ts
+function createGitMirrorFromOptions(options) {
+  if (!options.gitMirrorRoot && !options.gitMirrorRemote) {
+    return null;
+  }
+  const mirrorRoot = path2.resolve(
+    expandHomePath(
+      options.gitMirrorRoot ?? path2.join(getDaemonConfigDir(), "git-mirror")
+    )
+  );
+  return {
+    publishCompanySnapshot(input) {
+      return publishCompanySnapshot({
+        ...input,
+        mirrorRoot,
+        remoteUrl: options.gitMirrorRemote,
+        branch: options.gitMirrorBranch,
+        gitCommand: options.gitCommand
+      });
+    }
+  };
+}
+
 // src/invest-wiki/runner.ts
 import { access } from "fs/promises";
-import path from "path";
+import path3 from "path";
 import { execa as execa2 } from "execa";
 
 // src/invest-wiki/config.ts
@@ -591,7 +685,7 @@ function createLocalRepoRunner(config) {
   return {
     kind: "local-repo",
     async run(args, options) {
-      const cliPath = path.join(config.localRepo, "dist", "cli.js");
+      const cliPath = path3.join(config.localRepo, "dist", "cli.js");
       await assertFileExists(cliPath);
       const result = await runInvestWikiCommand(
         process.execPath,
@@ -638,71 +732,10 @@ function createInvestWikiRunnerFromOptions(options, env = process.env) {
   return createInvestWikiRunner(resolveInvestWikiConfig(options, env));
 }
 
-// src/local-config.ts
-import { chmod, mkdir, readFile, writeFile } from "fs/promises";
-import os from "os";
-import path2 from "path";
-import { z } from "zod";
-import { DOSSIERX_CONFIG_DIR } from "@xdsjs/dossierx-workspace";
-var DaemonLocalConfigSchema = z.object({
-  machineId: z.string().uuid().optional(),
-  machineKey: z.string().startsWith("dx_machine_"),
-  serverUrl: z.string().min(1),
-  supabaseUrl: z.string().min(1),
-  supabaseAnonKey: z.string().min(1),
-  workspacePath: z.string().min(1),
-  investWikiMode: z.string().optional(),
-  investWikiLocalRepo: z.string().optional(),
-  investWikiCommand: z.string().optional(),
-  codexCommand: z.string().optional(),
-  codexModel: z.string().optional(),
-  codexSandbox: z.string().optional(),
-  localApiPort: z.number().int().positive().optional()
-});
-function expandHomePath(input) {
-  if (input === "~") {
-    return os.homedir();
-  }
-  if (input.startsWith("~/")) {
-    return path2.join(os.homedir(), input.slice(2));
-  }
-  return input;
-}
-function getDaemonConfigDir(env = process.env) {
-  return path2.resolve(
-    expandHomePath(env.DOSSIERX_CONFIG_DIR ?? DOSSIERX_CONFIG_DIR)
-  );
-}
-function daemonConfigPath(configDir = getDaemonConfigDir()) {
-  return path2.join(configDir, "config.json");
-}
-async function readDaemonLocalConfig(configDir = getDaemonConfigDir()) {
-  try {
-    return DaemonLocalConfigSchema.parse(
-      JSON.parse(await readFile(daemonConfigPath(configDir), "utf8"))
-    );
-  } catch (error) {
-    if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
-      return null;
-    }
-    throw error;
-  }
-}
-async function writeDaemonLocalConfig(config, configDir = getDaemonConfigDir()) {
-  const parsed = DaemonLocalConfigSchema.parse(config);
-  await mkdir(configDir, { recursive: true, mode: 448 });
-  const target = daemonConfigPath(configDir);
-  await writeFile(target, `${JSON.stringify(parsed, null, 2)}
-`, {
-    mode: 384
-  });
-  await chmod(target, 384);
-}
-
 // src/local-api/server.ts
 import { createServer } from "http";
 import { readFile as readFile3, realpath, stat } from "fs/promises";
-import path4 from "path";
+import path5 from "path";
 import { execa as execa3 } from "execa";
 import {
   resolveInsideWorkspace as resolveInsideWorkspace2,
@@ -712,7 +745,7 @@ import {
 // src/task-archive.ts
 import { randomUUID } from "crypto";
 import { appendFile, mkdir as mkdir2, readFile as readFile2 } from "fs/promises";
-import path3 from "path";
+import path4 from "path";
 import { resolveInsideWorkspace } from "@xdsjs/dossierx-workspace";
 var TASK_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 function assertTaskId(taskId) {
@@ -724,7 +757,7 @@ function taskDirectory(workspaceRoot, taskId) {
   assertTaskId(taskId);
   return resolveInsideWorkspace(
     workspaceRoot,
-    path3.posix.join(".dossierx", "tasks", taskId)
+    path4.posix.join(".dossierx", "tasks", taskId)
   );
 }
 async function ensureTaskDirectory(workspaceRoot, taskId) {
@@ -757,7 +790,7 @@ function createTaskArchive(options) {
         created_at: now().toISOString()
       };
       await appendFile(
-        path3.join(directory, "events.jsonl"),
+        path4.join(directory, "events.jsonl"),
         `${JSON.stringify(archivedEvent)}
 `,
         "utf8"
@@ -766,13 +799,13 @@ function createTaskArchive(options) {
     },
     async appendRawOutput(taskId, stream, chunk) {
       const directory = await ensureTaskDirectory(options.workspaceRoot, taskId);
-      await appendFile(path3.join(directory, `${stream}.log`), chunk, "utf8");
+      await appendFile(path4.join(directory, `${stream}.log`), chunk, "utf8");
     },
     async listEvents(taskId) {
       const directory = taskDirectory(options.workspaceRoot, taskId);
       let content = "";
       try {
-        content = await readFile2(path3.join(directory, "events.jsonl"), "utf8");
+        content = await readFile2(path4.join(directory, "events.jsonl"), "utf8");
       } catch (error) {
         if (error.code === "ENOENT") {
           return [];
@@ -813,7 +846,7 @@ function requestUrl(request) {
   return new URL(request.url ?? "/", "http://127.0.0.1");
 }
 async function readWorkspaceFile(options) {
-  const extension = path4.extname(options.relativePath).toLowerCase();
+  const extension = path5.extname(options.relativePath).toLowerCase();
   if (!ALLOWED_EXTENSIONS.has(extension)) {
     throw new Error("Only markdown, text, and json files can be previewed");
   }
@@ -865,7 +898,7 @@ function uniqueProbes(probes) {
 }
 async function resolveCommand(command) {
   const normalizedCommand = command.trim();
-  if (path4.isAbsolute(normalizedCommand)) {
+  if (path5.isAbsolute(normalizedCommand)) {
     return realpath(normalizedCommand).catch(() => normalizedCommand);
   }
   const result = await execa3("which", [normalizedCommand], {
@@ -1213,6 +1246,7 @@ import {
   TaskEventInputSchema,
   TaskSchema
 } from "@xdsjs/dossierx-shared";
+import { GitMirrorError } from "@xdsjs/dossierx-git-mirror";
 
 // src/errors.ts
 function failTaskError(error, code = "UNKNOWN", step) {
@@ -1433,7 +1467,7 @@ async function runCodexTask(task, context) {
 
 // src/executors/investWiki.ts
 import { access as access2, mkdir as mkdir3, readFile as readFile4, stat as stat3, writeFile as writeFile2 } from "fs/promises";
-import path5 from "path";
+import path6 from "path";
 import {
   buildCompanyManifest as buildCompanyManifest2,
   companyManifestPath as companyManifestPath2,
@@ -1611,7 +1645,7 @@ async function runInitCompanyVault(task, context) {
   const statusOutput = await runner.run(["dossier", "status"], { cwd: vaultRoot });
   await appendOutputEvent2(context, "Invest wiki dossier status completed", statusOutput);
   if (!await exists(markerPath)) {
-    await mkdir3(path5.dirname(markerPath), { recursive: true });
+    await mkdir3(path6.dirname(markerPath), { recursive: true });
     await writeFile2(markerPath, "# Created by dossierx-daemon\n");
   }
   const manifest = await buildCompanyManifest2({
@@ -1699,7 +1733,7 @@ async function runInvestWikiTask(task, context) {
 
 // src/executors/mockWriteCompanyReport.ts
 import { mkdir as mkdir4, writeFile as writeFile3 } from "fs/promises";
-import path6 from "path";
+import path7 from "path";
 import {
   buildCompanyManifest as buildCompanyManifest3,
   companyManifestPath as companyManifestPath3,
@@ -1739,7 +1773,7 @@ This is a placeholder right-price analysis for ${ticker}.
 `;
 async function writeWorkspaceFile(context, relativePath, content) {
   const absolutePath = resolveInsideWorkspace5(context.workspaceRoot, relativePath);
-  await mkdir4(path6.dirname(absolutePath), { recursive: true });
+  await mkdir4(path7.dirname(absolutePath), { recursive: true });
   if (!context.dryRun) {
     await writeFile3(absolutePath, content);
   }
@@ -1873,7 +1907,7 @@ async function runTask(ctx, task, agent) {
   }
   await appendEvent(ctx, task.id, "Task claimed");
   try {
-    const result = await executor(task, {
+    let result = await executor(task, {
       workspaceRoot: ctx.workspaceRoot,
       dryRun: ctx.dryRun,
       codex: codexRunnerForTask(ctx, agent),
@@ -1885,6 +1919,31 @@ async function runTask(ctx, task, agent) {
         await appendLocalRawOutput(ctx, task.id, stream, chunk);
       }
     });
+    if (ctx.gitMirror && result.manifest) {
+      const gitSnapshot = await ctx.gitMirror.publishCompanySnapshot({
+        workspaceRoot: ctx.workspaceRoot,
+        company: {
+          ticker: result.manifest.ticker,
+          market: result.manifest.market
+        },
+        taskId: task.id
+      });
+      await appendLocalEvent(ctx, task.id, {
+        level: "info",
+        message: gitSnapshot.status === "published" ? "Git mirror snapshot published" : "Git mirror snapshot unchanged",
+        data: {
+          commitSha: gitSnapshot.commitSha,
+          treeHash: gitSnapshot.treeHash,
+          branch: gitSnapshot.branch,
+          pushed: gitSnapshot.pushed
+        }
+      });
+      result = {
+        ...result,
+        commitSha: gitSnapshot.commitSha ?? result.commitSha,
+        gitSnapshot
+      };
+    }
     await appendEvent(ctx, task.id, "Task completed");
     await ctx.api.completeTask(task.id, { result });
   } catch (error) {
@@ -1920,6 +1979,22 @@ async function runTask(ctx, task, agent) {
       });
       return;
     }
+    if (error instanceof GitMirrorError) {
+      await appendLocalEvent(ctx, task.id, {
+        level: "error",
+        message: error.message,
+        data: { code: error.code, step: error.step }
+      });
+      await ctx.api.failTask(task.id, {
+        error: {
+          code: error.code,
+          message: error.message,
+          step: error.step,
+          recoverable: false
+        }
+      });
+      return;
+    }
     await appendLocalEvent(ctx, task.id, {
       level: "error",
       message: error instanceof Error ? error.message : "Task failed",
@@ -2103,7 +2178,7 @@ async function subscribeToTaskAvailable(options, onEvent, onInvalidEvent) {
 // src/service.ts
 import { mkdir as mkdir5, unlink, writeFile as writeFile4 } from "fs/promises";
 import os2 from "os";
-import path7 from "path";
+import path8 from "path";
 var LAUNCH_AGENT_LABEL = "com.xdsjs.dossierx-daemon";
 function xmlEscape(value) {
   return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
@@ -2112,10 +2187,10 @@ function shellQuote(value) {
   return `'${value.replaceAll("'", "'\\''")}'`;
 }
 function launchAgentsDir() {
-  return path7.join(os2.homedir(), "Library", "LaunchAgents");
+  return path8.join(os2.homedir(), "Library", "LaunchAgents");
 }
 function launchAgentPlistPath(label = LAUNCH_AGENT_LABEL, dir = launchAgentsDir()) {
-  return path7.join(dir, `${label}.plist`);
+  return path8.join(dir, `${label}.plist`);
 }
 function resolveDaemonProgramArguments(input) {
   if (input.daemonCommand?.trim()) {
@@ -2126,14 +2201,14 @@ function resolveDaemonProgramArguments(input) {
   if (!entry) {
     throw new Error("Unable to resolve daemon entrypoint for LaunchAgent");
   }
-  if (path7.extname(entry) === ".ts") {
+  if (path8.extname(entry) === ".ts") {
     throw new Error(
       "LaunchAgent cannot run a TypeScript daemon entrypoint directly; pass --daemon-command when installing from source"
     );
   }
   return [
     input.execPath ?? process.execPath,
-    path7.resolve(entry),
+    path8.resolve(entry),
     "--log-level",
     input.logLevel ?? "info"
   ];
@@ -2180,6 +2255,10 @@ function runtimeOptionsFrom(input) {
     codexCommand: input.codexCommand,
     codexModel: input.codexModel,
     codexSandbox: input.codexSandbox,
+    gitMirrorRoot: input.gitMirrorRoot,
+    gitMirrorRemote: input.gitMirrorRemote,
+    gitMirrorBranch: input.gitMirrorBranch,
+    gitCommand: input.gitCommand,
     localApiPort: input.localApiPort
   };
 }
@@ -2188,7 +2267,7 @@ async function installLaunchAgent(options = {}) {
     throw new Error("DossierX LaunchAgent service is only supported on macOS");
   }
   const label = options.label ?? LAUNCH_AGENT_LABEL;
-  const configDir = path7.resolve(
+  const configDir = path8.resolve(
     expandHomePath(options.configDir ?? getDaemonConfigDir())
   );
   const config = await readDaemonLocalConfig(configDir);
@@ -2208,8 +2287,8 @@ async function installLaunchAgent(options = {}) {
     );
   }
   const plistPath = launchAgentPlistPath(label, options.launchAgentsDir);
-  const stdoutPath = path7.join(configDir, "daemon.out.log");
-  const stderrPath = path7.join(configDir, "daemon.err.log");
+  const stdoutPath = path8.join(configDir, "daemon.out.log");
+  const stderrPath = path8.join(configDir, "daemon.err.log");
   const uid = typeof process.getuid === "function" ? process.getuid() : "<uid>";
   const programArguments = resolveDaemonProgramArguments({
     daemonCommand: options.daemonCommand,
@@ -2217,7 +2296,7 @@ async function installLaunchAgent(options = {}) {
     argv: options.argv,
     execPath: options.execPath
   });
-  await mkdir5(path7.dirname(plistPath), { recursive: true });
+  await mkdir5(path8.dirname(plistPath), { recursive: true });
   await mkdir5(configDir, { recursive: true, mode: 448 });
   await writeFile4(
     plistPath,
@@ -2309,11 +2388,11 @@ function buildProgram() {
   ).option("--codex-command <command>", "installed Codex CLI command").option("--codex-model <model>", "Codex model override for exec mode").option(
     "--codex-sandbox <mode>",
     "Codex sandbox mode: workspace-write or danger-full-access"
-  ).option("--local-api-port <port>", "local workspace preview API port").option("--no-local-api", "disable local workspace preview API").action(async (options) => {
+  ).option("--git-mirror-root <path>", "local Git mirror repository path").option("--git-mirror-remote <url>", "remote Git mirror repository URL").option("--git-mirror-branch <branch>", "Git mirror branch name").option("--git-command <command>", "installed Git command").option("--local-api-port <port>", "local workspace preview API port").option("--no-local-api", "disable local workspace preview API").action(async (options) => {
     await runDaemon(options);
   });
   const service = program.command("service").description("Manage the macOS LaunchAgent for dossierx-daemon");
-  service.command("install").description("Write a macOS LaunchAgent plist for persistent daemon runs").option("--label <label>", "LaunchAgent label").option("--daemon-command <command>", "custom command used by launchd").option("--log-level <level>", "daemon log level", "info").option("--invest-wiki-mode <mode>", "invest wiki runner mode").option("--invest-wiki-local-repo <path>", "local llm-wiki-invest repo path").option("--invest-wiki-command <command>", "installed llm-wiki-invest command").option("--codex-command <command>", "installed Codex CLI command").option("--codex-model <model>", "Codex model override for exec mode").option("--codex-sandbox <mode>", "Codex sandbox mode").option("--local-api-port <port>", "local workspace preview API port").action(async (options) => {
+  service.command("install").description("Write a macOS LaunchAgent plist for persistent daemon runs").option("--label <label>", "LaunchAgent label").option("--daemon-command <command>", "custom command used by launchd").option("--log-level <level>", "daemon log level", "info").option("--invest-wiki-mode <mode>", "invest wiki runner mode").option("--invest-wiki-local-repo <path>", "local llm-wiki-invest repo path").option("--invest-wiki-command <command>", "installed llm-wiki-invest command").option("--codex-command <command>", "installed Codex CLI command").option("--codex-model <model>", "Codex model override for exec mode").option("--codex-sandbox <mode>", "Codex sandbox mode").option("--git-mirror-root <path>", "local Git mirror repository path").option("--git-mirror-remote <url>", "remote Git mirror repository URL").option("--git-mirror-branch <branch>", "Git mirror branch name").option("--git-command <command>", "installed Git command").option("--local-api-port <port>", "local workspace preview API port").action(async (options) => {
     const result = await installLaunchAgent({
       ...options,
       localApiPort: parsePort(options.localApiPort)
@@ -2347,6 +2426,10 @@ async function runDaemon(options) {
     codexCommand: options.codexCommand ?? localConfig?.codexCommand,
     codexModel: options.codexModel ?? localConfig?.codexModel,
     codexSandbox: options.codexSandbox ?? localConfig?.codexSandbox,
+    gitMirrorRoot: options.gitMirrorRoot ?? localConfig?.gitMirrorRoot,
+    gitMirrorRemote: options.gitMirrorRemote ?? localConfig?.gitMirrorRemote,
+    gitMirrorBranch: options.gitMirrorBranch ?? localConfig?.gitMirrorBranch,
+    gitCommand: options.gitCommand ?? localConfig?.gitCommand,
     localApiPort: parsePort(options.localApiPort) ?? localConfig?.localApiPort ?? parsePort(process.env.DOSSIERX_LOCAL_API_PORT) ?? DOSSIERX_DEFAULT_LOCAL_API_PORT
   };
   if (!serverUrl || !supabaseUrl || !supabaseAnonKey || !machineKey) {
@@ -2354,11 +2437,12 @@ async function runDaemon(options) {
       "Missing daemon connection config. Run the generated daemon command from DossierX first."
     );
   }
-  const workspaceRoot = path8.resolve(expandHomePath(workspacePath3));
+  const workspaceRoot = path9.resolve(expandHomePath(workspacePath3));
   await ensureWorkspaceDirectory(workspaceRoot);
   const capabilities = await detectCapabilities();
   const investWiki = createInvestWikiRunnerFromOptions(runtimeOptions);
   const codex = createCodexRunnerFromOptions(runtimeOptions);
+  const gitMirror = createGitMirrorFromOptions(runtimeOptions);
   const taskArchive = createTaskArchive({ workspaceRoot });
   const api = new ApiClient({
     serverUrl,
@@ -2384,6 +2468,10 @@ async function runDaemon(options) {
     codexCommand: runtimeOptions.codexCommand,
     codexModel: runtimeOptions.codexModel,
     codexSandbox: runtimeOptions.codexSandbox,
+    gitMirrorRoot: runtimeOptions.gitMirrorRoot,
+    gitMirrorRemote: runtimeOptions.gitMirrorRemote,
+    gitMirrorBranch: runtimeOptions.gitMirrorBranch,
+    gitCommand: runtimeOptions.gitCommand,
     localApiPort: runtimeOptions.localApiPort
   });
   const state = { running: false, pending: false };
@@ -2397,6 +2485,7 @@ async function runDaemon(options) {
     codex,
     codexOptions: runtimeOptions,
     investWiki,
+    gitMirror,
     taskArchive
   };
   async function heartbeat(status) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdsjs/dossierx-daemon",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -28,8 +28,9 @@
     "execa": "^9.0.0",
     "pino": "^10.0.0",
     "zod": "^4.0.0",
+    "@xdsjs/dossierx-git-mirror": "^0.1.0",
     "@xdsjs/dossierx-workspace": "^0.1.0",
-    "@xdsjs/dossierx-shared": "^0.1.1"
+    "@xdsjs/dossierx-shared": "^0.1.2"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",