@mukulaggarwal/pacman 0.1.0

package/dist/dist-TWNHTXYH.js

@@ -0,0 +1,95 @@
+import "./chunk-7D4SUZUM.js";
+
+// ../integrations-gmail/dist/index.js
+var GmailConnector = class {
+  type = "gmail";
+  credentials;
+  async authenticate(config) {
+    this.credentials = config.credentials;
+    if (!this.credentials?.clientId || !this.credentials?.clientSecret || !this.credentials?.refreshToken) {
+      throw new Error("Gmail client ID, client secret, and refresh token are required");
+    }
+  }
+  async healthCheck() {
+    if (!this.credentials?.clientId || !this.credentials?.clientSecret || !this.credentials?.refreshToken) {
+      throw new Error("Gmail client ID, client secret, and refresh token are required");
+    }
+    const { google } = await import("googleapis");
+    const oauth2Client = new google.auth.OAuth2(
+      this.credentials.clientId,
+      this.credentials.clientSecret
+    );
+    oauth2Client.setCredentials({ refresh_token: this.credentials.refreshToken });
+    const gmail = google.gmail({ version: "v1", auth: oauth2Client });
+    const profile = await gmail.users.getProfile({ userId: "me" });
+    return { summary: `Connected as ${profile.data.emailAddress ?? "unknown"}` };
+  }
+  async fetchDelta(cursor) {
+    if (!this.credentials) throw new Error("Not authenticated");
+    const { google } = await import("googleapis");
+    const oauth2Client = new google.auth.OAuth2(
+      this.credentials.clientId,
+      this.credentials.clientSecret
+    );
+    oauth2Client.setCredentials({ refresh_token: this.credentials.refreshToken });
+    const gmail = google.gmail({ version: "v1", auth: oauth2Client });
+    const query = cursor ? `after:${cursor}` : "newer_than:1d";
+    const res = await gmail.users.messages.list({
+      userId: "me",
+      q: query,
+      maxResults: 50
+    });
+    const items = [];
+    for (const msg of res.data.messages ?? []) {
+      if (!msg.id) continue;
+      const detail = await gmail.users.messages.get({
+        userId: "me",
+        id: msg.id,
+        format: "metadata",
+        metadataHeaders: ["Subject", "From", "To", "Date"]
+      });
+      const headers = detail.data.payload?.headers ?? [];
+      const subject = headers.find((h) => h.name === "Subject")?.value ?? "";
+      const from = headers.find((h) => h.name === "From")?.value ?? "";
+      const snippet = detail.data.snippet ?? "";
+      items.push({
+        id: msg.id,
+        source: "gmail",
+        type: "email",
+        content: `Subject: ${subject}
+From: ${from}
+
+${snippet}`,
+        metadata: { subject, from, threadId: detail.data.threadId ?? "" },
+        timestamp: new Date(parseInt(detail.data.internalDate ?? "0")).toISOString()
+      });
+    }
+    return {
+      items,
+      newCursor: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+      hasMore: false
+    };
+  }
+  async normalize(rawItems) {
+    return rawItems.map((item) => ({
+      id: item.id,
+      source: "gmail",
+      title: `Email: ${item.metadata.subject}`,
+      body: item.content,
+      entities: extractEmailAddresses(item.content),
+      timestamp: item.timestamp
+    }));
+  }
+};
+function extractEmailAddresses(text) {
+  const emails = text.match(/[\w.-]+@[\w.-]+\.\w+/g) ?? [];
+  return [...new Set(emails)];
+}
+function createGmailConnector() {
+  return new GmailConnector();
+}
+export {
+  GmailConnector,
+  createGmailConnector
+};
+//# sourceMappingURL=dist-TWNHTXYH.js.map

package/dist/dist-TWNHTXYH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../integrations-gmail/dist/index.js"],"sourcesContent":["// src/index.ts\nvar GmailConnector = class {\n  type = \"gmail\";\n  credentials;\n  async authenticate(config) {\n    this.credentials = config.credentials;\n    if (!this.credentials?.clientId || !this.credentials?.clientSecret || !this.credentials?.refreshToken) {\n      throw new Error(\"Gmail client ID, client secret, and refresh token are required\");\n    }\n  }\n  async healthCheck() {\n    if (!this.credentials?.clientId || !this.credentials?.clientSecret || !this.credentials?.refreshToken) {\n      throw new Error(\"Gmail client ID, client secret, and refresh token are required\");\n    }\n    const { google } = await import(\"googleapis\");\n    const oauth2Client = new google.auth.OAuth2(\n      this.credentials.clientId,\n      this.credentials.clientSecret\n    );\n    oauth2Client.setCredentials({ refresh_token: this.credentials.refreshToken });\n    const gmail = google.gmail({ version: \"v1\", auth: oauth2Client });\n    const profile = await gmail.users.getProfile({ userId: \"me\" });\n    return { summary: `Connected as ${profile.data.emailAddress ?? \"unknown\"}` };\n  }\n  async fetchDelta(cursor) {\n    if (!this.credentials) throw new Error(\"Not authenticated\");\n    const { google } = await import(\"googleapis\");\n    const oauth2Client = new google.auth.OAuth2(\n      this.credentials.clientId,\n      this.credentials.clientSecret\n    );\n    oauth2Client.setCredentials({ refresh_token: this.credentials.refreshToken });\n    const gmail = google.gmail({ version: \"v1\", auth: oauth2Client });\n    const query = cursor ? `after:${cursor}` : \"newer_than:1d\";\n    const res = await gmail.users.messages.list({\n      userId: \"me\",\n      q: query,\n      maxResults: 50\n    });\n    const items = [];\n    for (const msg of res.data.messages ?? []) {\n      if (!msg.id) continue;\n      const detail = await gmail.users.messages.get({\n        userId: \"me\",\n        id: msg.id,\n        format: \"metadata\",\n        metadataHeaders: [\"Subject\", \"From\", \"To\", \"Date\"]\n      });\n      const headers = detail.data.payload?.headers ?? [];\n      const subject = headers.find((h) => h.name === \"Subject\")?.value ?? \"\";\n      const from = headers.find((h) => h.name === \"From\")?.value ?? \"\";\n      const snippet = detail.data.snippet ?? \"\";\n      items.push({\n        id: msg.id,\n        source: \"gmail\",\n        type: \"email\",\n        content: `Subject: ${subject}\nFrom: ${from}\n\n${snippet}`,\n        metadata: { subject, from, threadId: detail.data.threadId ?? \"\" },\n        timestamp: new Date(parseInt(detail.data.internalDate ?? \"0\")).toISOString()\n      });\n    }\n    return {\n      items,\n      newCursor: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),\n      hasMore: false\n    };\n  }\n  async normalize(rawItems) {\n    return rawItems.map((item) => ({\n      id: item.id,\n      source: \"gmail\",\n      title: `Email: ${item.metadata.subject}`,\n      body: item.content,\n      entities: extractEmailAddresses(item.content),\n      timestamp: item.timestamp\n    }));\n  }\n};\nfunction extractEmailAddresses(text) {\n  const emails = text.match(/[\\w.-]+@[\\w.-]+\\.\\w+/g) ?? [];\n  return [...new Set(emails)];\n}\nfunction createGmailConnector() {\n  return new GmailConnector();\n}\nexport {\n  GmailConnector,\n  createGmailConnector\n};\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,452 @@
+#!/usr/bin/env node
+import {
+  installClaudeMcp,
+  installCodexMcp,
+  resolvePacmanServerCommand,
+  startMcpServer
+} from "./chunk-AYFIQNZ5.js";
+import {
+  createIndexer
+} from "./chunk-3QNXXON5.js";
+import "./chunk-43PUZDIZ.js";
+import {
+  createContextManager
+} from "./chunk-UWT6AFJB.js";
+import {
+  createConfigManager,
+  createGDriveStorage,
+  createLocalStorage
+} from "./chunk-TRQIZP6Z.js";
+import "./chunk-7D4SUZUM.js";
+
+// src/index.ts
+import { Command } from "commander";
+import * as path3 from "path";
+import * as fs3 from "fs/promises";
+
+// ../claude-installer/dist/index.js
+import * as fs from "fs/promises";
+import * as path from "path";
+
+// ../client-guidance/dist/index.js
+var TOOL_GROUPS = [
+  "- Config: `config_get`, `config_get_storage_mode`, `config_get_active_project`, `config_set_active_project`",
+  "- Projects: `project_list`, `project_suggest`, `project_get_context`",
+  "- Read: `context_search`, `context_read_file`, `context_read_section`, `context_list_recent_updates`, `context_get_daily_summary`",
+  "- Update: `context_propose_update`, `context_apply_update`, `context_append_note`, `context_rebuild_indexes`",
+  "- Sync: `sync_run_now`, `sync_status`, `sync_list_integrations`",
+  "- Events: `events_ping`"
+];
+function getStorageDescription(config) {
+  return config.storage.mode === "local" ? `Local workspace at: ${config.storage.workspacePath}` : `Google Drive folder: ${config.storage.folderName} (ID: ${config.storage.folderId})`;
+}
+function buildSharedProjectSections(config) {
+  return `## Context source of truth
+
+All context is stored in:
+- ${getStorageDescription(config)}
+
+Do not assume any cloud database exists. Never store raw context outside user-controlled storage.
+
+## Context structure
+
+Read context in this order:
+1. context/canonical/ - long-lived, human-readable context (role, projects, stakeholders)
+2. context/derived/daily/ - machine-generated daily summaries
+3. context/derived/indexes/entities.json - extracted entities index
+4. context/raw/ - only when deeper detail is needed from integration data
+
+## Retrieval rule
+
+When the user asks about responsibilities, projects, stakeholders, status, history, routines, or prior decisions:
+- Call the Personal Assistant MCP tools first
+- Use \`context_search\` to find relevant files
+- Use \`context_read_file\` or \`context_read_section\` for specific content
+- Answer only from retrieved context files
+- State uncertainty if context is missing or insufficient
+
+## Update rule
+
+When the conversation creates stable new context (new ownership, priority changes, new contacts):
+- Call \`context_propose_update\` with the target file, section, proposed content, and reason
+- If the auto-apply policy allows, call \`context_apply_update\`
+- Never silently mutate canonical context without proposing first
+
+## Project rule
+
+- If an active project is set, prefer project-specific files from context/canonical/projects/
+- If no project is set, call \`project_suggest\` to infer likely project
+- If multiple candidates exist, ask the user to confirm
+- Use \`config_set_active_project\` to set the active project
+
+## MCP usage
+
+This project uses the Personal Assistant MCP server. All context operations go through MCP tools:
+${TOOL_GROUPS.join("\n")}
+
+## User profile
+
+- Name: ${config.user.name}
+- Assistant name: ${config.user.assistantName}
+- Profile: ${config.user.profileType}
+`;
+}
+function buildClaudeProjectMemory(config) {
+  return `# Personal Assistant Project Rules
+
+This project uses a local or Google Drive based context manager.
+
+${buildSharedProjectSections(config)}`;
+}
+function buildCodexProjectGuidance(config) {
+  return `# Personal Assistant Project Instructions
+
+This repository uses a local or Google Drive based context manager.
+
+${buildSharedProjectSections(config)}
+
+## Codex startup rule
+
+- If Personal Assistant MCP tools are unavailable, tell the user to run \`pacman mcp codex install\`
+- If the package is not installed globally, show the fallback command:
+  \`codex mcp add personal_assistant --env PA_WORKSPACE=$HOME/.personal-assistant -- npx -y pacman mcp serve\`
+- Tell the user to restart Codex after installing or updating the MCP registration
+`;
+}
+function buildClaudeSkillContent() {
+  return `---
+name: personal-assistant
+description: Start the personal assistant workflow for a project using local or Google Drive context through MCP.
+argument-hint: start [project_name]
+allowed-tools: mcp__personal_assistant__*
+---
+
+# Personal Assistant Skill
+
+When this skill is invoked with \`/personal-assistant start <project_name>\`:
+
+## Steps
+
+1. **Check MCP availability**:
+   - If Personal Assistant MCP tools are unavailable, stop and tell the user to install them with \`pacman mcp claude install\`
+   - If the package is not installed globally, show the fallback command:
+     \`claude mcp add -s user --env=PA_WORKSPACE=$HOME/.personal-assistant personal_assistant -- npx -y pacman mcp serve\`
+   - Tell the user to restart Claude Code after installing or updating the MCP registration
+
+2. **Check MCP health**:
+   - Call \`sync_status\` before doing project selection
+   - If the response shows an unhealthy storage backend, summarize the reason, fix steps, and restart steps, then stop
+   - If the response shows failing integrations, warn the user that sync inputs may be stale and continue unless they want to troubleshoot first
+
+3. **Parse arguments**: Extract the project name from the command arguments.
+
+4. **Set active project**: If a project name is provided:
+   - Call \`config_set_active_project\` with the project name
+   - Call \`project_get_context\` to retrieve project-scoped context
+
+5. **Suggest project**: If no project name is provided:
+   - Call \`project_suggest\` to get a suggested project
+   - If one strong candidate exists (confidence > 0.7), suggest it to the user
+   - If multiple candidates or low confidence, call \`project_list\` and ask the user to choose
+
+6. **Load context**: Once the project is set:
+   - Read the project's canonical file from context/canonical/projects/
+   - Read the latest daily summary from context/derived/daily/
+   - Read the entities index for relevant people and services
+   - Present a brief status summary to the user
+
+7. **Continue with MCP**: For all subsequent questions:
+   - Use MCP tools to search and retrieve context
+   - Answer only from retrieved context files
+   - Propose updates when stable new facts emerge
+   - State uncertainty when context is insufficient
+
+## Important rules
+
+- Never fabricate context that isn't in the retrieved files
+- Always use MCP tools for context operations
+- Propose updates rather than silently modifying canonical files
+- Respect the context hierarchy: canonical > derived > raw
+`;
+}
+function buildCodexSkillContent() {
+  return `---
+name: personal-assistant
+description: Use when the user asks to start, load, refresh, or inspect Personal Assistant project context stored through the Personal Assistant MCP workspace.
+---
+
+# Personal Assistant
+
+Use this skill when the user asks to load or refresh personal assistant context for a project.
+
+## Steps
+
+1. **Check MCP availability**:
+   - If Personal Assistant MCP tools are unavailable, stop and tell the user to install them with \`pacman mcp codex install\`
+   - If the package is not installed globally, show the fallback command:
+     \`codex mcp add personal_assistant --env PA_WORKSPACE=$HOME/.personal-assistant -- npx -y pacman mcp serve\`
+   - Tell the user to restart Codex after installing or updating the MCP registration
+
+2. **Check MCP health**:
+   - Call \`sync_status\` before doing project selection
+   - If the response shows an unhealthy storage backend, summarize the reason, fix steps, and restart steps, then stop
+   - If the response shows failing integrations, warn the user that sync inputs may be stale and continue unless they want to troubleshoot first
+
+3. **Parse the project name**:
+   - Extract the project name from the user's request if one is provided
+
+4. **Set or suggest the project**:
+   - If a project name is provided, call \`config_set_active_project\` and then \`project_get_context\`
+   - If no project name is provided, call \`project_suggest\`
+   - If one strong candidate exists (confidence > 0.7), suggest it to the user
+   - If multiple candidates or low confidence, call \`project_list\` and ask the user to choose
+
+5. **Load context**:
+   - Read the project's canonical file from context/canonical/projects/
+   - Read the latest daily summary from context/derived/daily/
+   - Read the entities index for relevant people and services
+   - Present a brief status summary to the user
+
+6. **Continue with MCP**:
+   - Use MCP tools to search and retrieve context
+   - Answer only from retrieved context files
+   - Propose updates when stable new facts emerge
+   - State uncertainty when context is insufficient
+
+## Important rules
+
+- Never fabricate context that isn't in the retrieved files
+- Always use MCP tools for context operations
+- Propose updates rather than silently modifying canonical files
+- Respect the context hierarchy: canonical > derived > raw
+`;
+}
+
+// ../claude-installer/dist/index.js
+async function installClaude(options) {
+  const { projectPath, config } = options;
+  await Promise.all([
+    generateClaudeMd(projectPath, config),
+    generateGlobalSkill()
+  ]);
+}
+async function generateClaudeMd(projectPath, config) {
+  await fs.mkdir(projectPath, { recursive: true });
+  await fs.writeFile(path.join(projectPath, "CLAUDE.md"), buildClaudeProjectMemory(config), "utf-8");
+}
+async function generateGlobalSkill() {
+  const globalSkillDir = path.join(
+    process.env.HOME ?? process.env.USERPROFILE ?? "~",
+    ".claude",
+    "skills",
+    "personal-assistant"
+  );
+  await fs.mkdir(globalSkillDir, { recursive: true });
+  await fs.writeFile(path.join(globalSkillDir, "SKILL.md"), buildClaudeSkillContent(), "utf-8");
+}
+
+// ../codex-installer/dist/index.js
+import * as fs2 from "fs/promises";
+import * as path2 from "path";
+async function installCodex(options) {
+  const { projectPath, config } = options;
+  await Promise.all([
+    generateAgentsMd(projectPath, config),
+    generateGlobalSkill2()
+  ]);
+}
+async function generateAgentsMd(projectPath, config) {
+  await fs2.mkdir(projectPath, { recursive: true });
+  await fs2.writeFile(
+    path2.join(projectPath, "AGENTS.md"),
+    buildCodexProjectGuidance(config),
+    "utf-8"
+  );
+}
+async function generateGlobalSkill2() {
+  const globalSkillDir = path2.join(
+    process.env.HOME ?? process.env.USERPROFILE ?? "~",
+    ".codex",
+    "skills",
+    "personal-assistant"
+  );
+  await fs2.mkdir(globalSkillDir, { recursive: true });
+  await fs2.writeFile(
+    path2.join(globalSkillDir, "SKILL.md"),
+    buildCodexSkillContent(),
+    "utf-8"
+  );
+}
+
+// src/index.ts
+async function resolveWorkspacePath(dirOpt) {
+  const rcPath = path3.join(
+    process.env.HOME ?? process.env.USERPROFILE ?? "~",
+    ".personal-assistant-rc.json"
+  );
+  try {
+    const rc = JSON.parse(await fs3.readFile(rcPath, "utf-8"));
+    if (rc.workspacePath) return rc.workspacePath;
+  } catch {
+  }
+  return path3.resolve(dirOpt);
+}
+var program = new Command();
+program.name("pacman").description("Claude Code and Codex compatible, file-backed personal context manager").version("0.1.0");
+program.command("init").description("Initialize the personal assistant and open onboarding UI").option("-p, --port <port>", "Port for onboarding server", "3847").option("-d, --dir <dir>", "Workspace directory", ".personal-assistant").action(async (opts) => {
+  const workspacePath = path3.resolve(opts.dir);
+  const port = parseInt(opts.port, 10);
+  console.log(`Initializing Personal Assistant workspace at ${workspacePath}...`);
+  await fs3.mkdir(workspacePath, { recursive: true });
+  const storage = createLocalStorage(workspacePath);
+  const contextManager = createContextManager(storage);
+  await contextManager.initWorkspace();
+  console.log("Workspace initialized. Starting onboarding server...");
+  const { startOnboardingServer } = await import("./onboarding-server.js");
+  await startOnboardingServer(port, workspacePath);
+});
+program.command("daemon").description("Start the sync daemon").option("-d, --dir <dir>", "Workspace directory", ".personal-assistant").action(async (opts) => {
+  const workspacePath = await resolveWorkspacePath(opts.dir);
+  console.log(`Starting daemon with workspace at ${workspacePath}...`);
+  const { startDaemon } = await import("./daemon.js");
+  await startDaemon(workspacePath);
+});
+program.command("slack").description("Slack runtime management").command("listen").description("Start the real-time Slack listener").option("-d, --dir <dir>", "Workspace directory", ".personal-assistant").action(async (opts) => {
+  const workspacePath = await resolveWorkspacePath(opts.dir);
+  console.log(`Starting Slack listener with workspace at ${workspacePath}...`);
+  const { startSlackListener } = await import("./slack-listener.js");
+  await startSlackListener(workspacePath);
+});
+program.command("claude").description("Claude integration management").command("install").description("Install Claude Code integration (CLAUDE.md, settings, skill)").option("-d, --dir <dir>", "Project directory", ".").option("-w, --workspace <workspace>", "Workspace directory", ".personal-assistant").action(async (opts) => {
+  const projectPath = path3.resolve(opts.dir);
+  const workspacePath = await resolveWorkspacePath(opts.workspace);
+  console.log("Installing Claude Code integration...");
+  const storage = createLocalStorage(workspacePath);
+  const configManager = createConfigManager(storage);
+  let config;
+  try {
+    config = await configManager.loadConfig();
+  } catch {
+    console.error(
+      "Error: No configuration found. Run `pacman init` first."
+    );
+    process.exit(1);
+  }
+  await installClaude({
+    projectPath,
+    workspacePath,
+    config
+  });
+  console.log("Claude Code integration installed:");
+  console.log(`  - ${projectPath}/CLAUDE.md`);
+  console.log(`  - ~/.claude/skills/personal-assistant/SKILL.md`);
+  console.log("");
+  console.log("Next, register the MCP server with:");
+  console.log("  pacman mcp claude install");
+  console.log("");
+  console.log("Restart Claude Code after the MCP install, then use:");
+  console.log("  /personal-assistant start <project_name>");
+});
+program.command("codex").description("Codex integration management").command("install").description("Install Codex integration (AGENTS.md, skill)").option("-d, --dir <dir>", "Project directory", ".").option("-w, --workspace <workspace>", "Workspace directory", ".personal-assistant").action(async (opts) => {
+  const projectPath = path3.resolve(opts.dir);
+  const workspacePath = await resolveWorkspacePath(opts.workspace);
+  console.log("Installing Codex integration...");
+  const storage = createLocalStorage(workspacePath);
+  const configManager = createConfigManager(storage);
+  let config;
+  try {
+    config = await configManager.loadConfig();
+  } catch {
+    console.error(
+      "Error: No configuration found. Run `pacman init` first."
+    );
+    process.exit(1);
+  }
+  await installCodex({
+    projectPath,
+    workspacePath,
+    config
+  });
+  console.log("Codex integration installed:");
+  console.log(`  - ${projectPath}/AGENTS.md`);
+  console.log(`  - ~/.codex/skills/personal-assistant/SKILL.md`);
+  console.log("");
+  console.log("Next, register the MCP server with:");
+  console.log("  pacman mcp codex install");
+  console.log("");
+  console.log("Restart Codex after the MCP install, then ask it to load or refresh");
+  console.log("your Personal Assistant context for a project.");
+});
+var mcpCommand = program.command("mcp").description("MCP server management");
+mcpCommand.command("serve").description("Start the Personal Assistant MCP server over stdio").option("-w, --workspace <workspace>", "Workspace directory", ".personal-assistant").action(async (opts) => {
+  const workspacePath = await resolveWorkspacePath(opts.workspace);
+  await startMcpServer(workspacePath);
+});
+mcpCommand.command("claude").description("Claude MCP integration management").command("install").description("Register the Personal Assistant MCP server with Claude Code").option("-w, --workspace <workspace>", "Workspace directory", ".personal-assistant").action(async (opts) => {
+  const workspacePath = await resolveWorkspacePath(opts.workspace);
+  await installClaudeMcp(workspacePath, resolvePacmanServerCommand);
+  console.log("Claude MCP registration installed:");
+  console.log("  - managed by Claude Code CLI");
+  console.log(`  - PA_WORKSPACE=${workspacePath}`);
+  console.log("");
+  console.log("Restart Claude Code to reload the Personal Assistant MCP server.");
+  console.log("Legacy alias still available: personal-assistant-mcp claude install");
+});
+mcpCommand.command("codex").description("Codex MCP integration management").command("install").description("Register the Personal Assistant MCP server with Codex").option("-w, --workspace <workspace>", "Workspace directory", ".personal-assistant").action(async (opts) => {
+  const workspacePath = await resolveWorkspacePath(opts.workspace);
+  await installCodexMcp(workspacePath, resolvePacmanServerCommand);
+  console.log("Codex MCP registration installed:");
+  console.log("  - managed by Codex CLI");
+  console.log(`  - PA_WORKSPACE=${workspacePath}`);
+  console.log("");
+  console.log("Restart Codex to reload the Personal Assistant MCP server.");
+  console.log("Legacy alias still available: personal-assistant-mcp codex install");
+});
+program.command("sync").description("Run a one-time sync").option("-d, --dir <dir>", "Workspace directory", ".personal-assistant").action(async (opts) => {
+  const workspacePath = await resolveWorkspacePath(opts.dir);
+  console.log("Running sync...");
+  const localStore = createLocalStorage(workspacePath);
+  const bootConfigManager = createConfigManager(localStore);
+  let resolvedStorage = localStore;
+  try {
+    const config = await bootConfigManager.loadConfig();
+    if (config.storage.mode === "gdrive") {
+      const gdriveConfig = config.storage;
+      const resolvedCachePath = path3.isAbsolute(gdriveConfig.cachePath) ? gdriveConfig.cachePath : path3.resolve(path3.dirname(workspacePath), gdriveConfig.cachePath);
+      const gdriveStorage = createGDriveStorage({
+        ...gdriveConfig,
+        cachePath: resolvedCachePath
+      });
+      await gdriveStorage.initialize();
+      resolvedStorage = gdriveStorage;
+      console.log("Using Google Drive storage backend");
+    }
+  } catch {
+  }
+  const indexer = createIndexer(resolvedStorage);
+  await indexer.buildIndexes();
+  console.log("Sync complete. Indexes rebuilt.");
+});
+program.command("status").description("Show current configuration and status").option("-d, --dir <dir>", "Workspace directory", ".personal-assistant").action(async (opts) => {
+  const workspacePath = await resolveWorkspacePath(opts.dir);
+  const storage = createLocalStorage(workspacePath);
+  const configManager = createConfigManager(storage);
+  try {
+    const config = await configManager.loadConfig();
+    console.log("Personal Assistant Status");
+    console.log("========================");
+    console.log(`Workspace: ${workspacePath}`);
+    console.log(`User: ${config.user.name}`);
+    console.log(`Assistant: ${config.user.assistantName}`);
+    console.log(`Profile: ${config.user.profileType}`);
+    console.log(`Storage: ${config.storage.mode}`);
+    console.log(`Active Project: ${config.activeProject ?? "none"}`);
+    console.log(`Integrations: ${config.integrations.filter((i) => i.enabled).map((i) => i.type).join(", ") || "none"}`);
+    console.log(`Sync Time: ${config.sync.dailySyncTime} ${config.sync.timezone}`);
+    console.log(`Slack Runtime: ${config.slackRuntime?.enabled ? `${config.slackRuntime.transport} (${config.slackRuntime.reviewMode})` : "disabled"}`);
+  } catch {
+    console.log("No configuration found. Run `pacman init` first.");
+  }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../../claude-installer/dist/index.js","../../client-guidance/dist/index.js","../../codex-installer/dist/index.js"],"sourcesContent":["#!/usr/bin/env node\n\nimport { Command } from 'commander';\nimport * as path from 'node:path';\nimport * as fs from 'node:fs/promises';\nimport { createLocalStorage } from '@personal-assistant/storage-local';\nimport { createGDriveStorage } from '@personal-assistant/storage-gdrive';\nimport { createConfigManager } from '@personal-assistant/config-manager';\nimport { createContextManager } from '@personal-assistant/context-manager';\nimport { createIndexer } from '@personal-assistant/indexer';\nimport { renderTemplate, getTemplate } from '@personal-assistant/template-engine';\nimport { installClaude } from '@personal-assistant/claude-installer';\nimport { installCodex } from '@personal-assistant/codex-installer';\nimport { createNoopEventClient } from '@personal-assistant/event-client';\nimport type { StorageBackend, GDriveStorageConfig } from '@personal-assistant/core-types';\nimport {\n  installClaudeMcp,\n  installCodexMcp,\n  resolvePacmanServerCommand,\n} from './mcp-installers.js';\nimport { startMcpServer } from './mcp-server.js';\n\n// Resolve workspace path: the pointer file written during `init` always wins\n// so all commands automatically find the configured workspace without --dir.\n// Pass an explicit absolute path via --dir to override (e.g. for multi-workspace setups).\nasync function resolveWorkspacePath(dirOpt: string): Promise<string> {\n  const rcPath = path.join(\n    process.env.HOME ?? process.env.USERPROFILE ?? '~',\n    '.personal-assistant-rc.json',\n  );\n  try {\n    const rc = JSON.parse(await fs.readFile(rcPath, 'utf-8')) as { workspacePath?: string };\n    if (rc.workspacePath) return rc.workspacePath;\n  } catch {\n    // no pointer yet — fall through to explicit path\n  }\n  return path.resolve(dirOpt);\n}\n\nconst program = new Command();\n\nprogram\n  .name('pacman')\n  .description('Claude Code and Codex compatible, file-backed personal context manager')\n  .version('0.1.0');\n\n// ---- init command ----\nprogram\n  .command('init')\n  .description('Initialize the personal assistant and open onboarding UI')\n  .option('-p, --port <port>', 'Port for onboarding server', '3847')\n  .option('-d, --dir <dir>', 'Workspace directory', '.personal-assistant')\n  .action(async (opts) => {\n    const workspacePath = path.resolve(opts.dir);\n    const port = parseInt(opts.port, 10);\n\n    console.log(`Initializing Personal Assistant workspace at ${workspacePath}...`);\n\n    // Create workspace directory\n    await fs.mkdir(workspacePath, { recursive: true });\n\n    // Initialize storage and context\n    const storage = createLocalStorage(workspacePath);\n    const contextManager = createContextManager(storage);\n    await contextManager.initWorkspace();\n\n    console.log('Workspace initialized. Starting onboarding server...');\n\n    // Start onboarding server\n    const { startOnboardingServer } = await import('./onboarding-server.js');\n    await startOnboardingServer(port, workspacePath);\n  });\n\n// ---- daemon command ----\nprogram\n  .command('daemon')\n  .description('Start the sync daemon')\n  .option('-d, --dir <dir>', 'Workspace directory', '.personal-assistant')\n  .action(async (opts) => {\n    const workspacePath = await resolveWorkspacePath(opts.dir);\n    console.log(`Starting daemon with workspace at ${workspacePath}...`);\n\n    const { startDaemon } = await import('./daemon.js');\n    await startDaemon(workspacePath);\n  });\n\n// ---- slack command ----\nprogram\n  .command('slack')\n  .description('Slack runtime management')\n  .command('listen')\n  .description('Start the real-time Slack listener')\n  .option('-d, --dir <dir>', 'Workspace directory', '.personal-assistant')\n  .action(async (opts) => {\n    const workspacePath = await resolveWorkspacePath(opts.dir);\n    console.log(`Starting Slack listener with workspace at ${workspacePath}...`);\n\n    const { startSlackListener } = await import('./slack-listener.js');\n    await startSlackListener(workspacePath);\n  });\n\n// ---- claude install command ----\nprogram\n  .command('claude')\n  .description('Claude integration management')\n  .command('install')\n  .description('Install Claude Code integration (CLAUDE.md, settings, skill)')\n  .option('-d, --dir <dir>', 'Project directory', '.')\n  .option('-w, --workspace <workspace>', 'Workspace directory', '.personal-assistant')\n  .action(async (opts) => {\n    const projectPath = path.resolve(opts.dir);\n    const workspacePath = await resolveWorkspacePath(opts.workspace);\n\n    console.log('Installing Claude Code integration...');\n\n    const storage = createLocalStorage(workspacePath);\n    const configManager = createConfigManager(storage);\n\n    let config;\n    try {\n      config = await configManager.loadConfig();\n    } catch {\n      console.error(\n        'Error: No configuration found. Run `pacman init` first.',\n      );\n      process.exit(1);\n    }\n\n    await installClaude({\n      projectPath,\n      workspacePath,\n      config,\n    });\n\n    console.log('Claude Code integration installed:');\n    console.log(`  - ${projectPath}/CLAUDE.md`);\n    console.log(`  - ~/.claude/skills/personal-assistant/SKILL.md`);\n    console.log('');\n    console.log('Next, register the MCP server with:');\n    console.log('  pacman mcp claude install');\n    console.log('');\n    console.log('Restart Claude Code after the MCP install, then use:');\n    console.log('  /personal-assistant start <project_name>');\n  });\n\n// ---- codex install command ----\nprogram\n  .command('codex')\n  .description('Codex integration management')\n  .command('install')\n  .description('Install Codex integration (AGENTS.md, skill)')\n  .option('-d, --dir <dir>', 'Project directory', '.')\n  .option('-w, --workspace <workspace>', 'Workspace directory', '.personal-assistant')\n  .action(async (opts) => {\n    const projectPath = path.resolve(opts.dir);\n    const workspacePath = await resolveWorkspacePath(opts.workspace);\n\n    console.log('Installing Codex integration...');\n\n    const storage = createLocalStorage(workspacePath);\n    const configManager = createConfigManager(storage);\n\n    let config;\n    try {\n      config = await configManager.loadConfig();\n    } catch {\n      console.error(\n        'Error: No configuration found. Run `pacman init` first.',\n      );\n      process.exit(1);\n    }\n\n    await installCodex({\n      projectPath,\n      workspacePath,\n      config,\n    });\n\n    console.log('Codex integration installed:');\n    console.log(`  - ${projectPath}/AGENTS.md`);\n    console.log(`  - ~/.codex/skills/personal-assistant/SKILL.md`);\n    console.log('');\n    console.log('Next, register the MCP server with:');\n    console.log('  pacman mcp codex install');\n    console.log('');\n    console.log('Restart Codex after the MCP install, then ask it to load or refresh');\n    console.log('your Personal Assistant context for a project.');\n  });\n\n// ---- mcp command ----\nconst mcpCommand = program\n  .command('mcp')\n  .description('MCP server management');\n\nmcpCommand\n  .command('serve')\n  .description('Start the Personal Assistant MCP server over stdio')\n  .option('-w, --workspace <workspace>', 'Workspace directory', '.personal-assistant')\n  .action(async (opts) => {\n    const workspacePath = await resolveWorkspacePath(opts.workspace);\n    await startMcpServer(workspacePath);\n  });\n\nmcpCommand\n  .command('claude')\n  .description('Claude MCP integration management')\n  .command('install')\n  .description('Register the Personal Assistant MCP server with Claude Code')\n  .option('-w, --workspace <workspace>', 'Workspace directory', '.personal-assistant')\n  .action(async (opts) => {\n    const workspacePath = await resolveWorkspacePath(opts.workspace);\n\n    await installClaudeMcp(workspacePath, resolvePacmanServerCommand);\n\n    console.log('Claude MCP registration installed:');\n    console.log('  - managed by Claude Code CLI');\n    console.log(`  - PA_WORKSPACE=${workspacePath}`);\n    console.log('');\n    console.log('Restart Claude Code to reload the Personal Assistant MCP server.');\n    console.log('Legacy alias still available: personal-assistant-mcp claude install');\n  });\n\nmcpCommand\n  .command('codex')\n  .description('Codex MCP integration management')\n  .command('install')\n  .description('Register the Personal Assistant MCP server with Codex')\n  .option('-w, --workspace <workspace>', 'Workspace directory', '.personal-assistant')\n  .action(async (opts) => {\n    const workspacePath = await resolveWorkspacePath(opts.workspace);\n\n    await installCodexMcp(workspacePath, resolvePacmanServerCommand);\n\n    console.log('Codex MCP registration installed:');\n    console.log('  - managed by Codex CLI');\n    console.log(`  - PA_WORKSPACE=${workspacePath}`);\n    console.log('');\n    console.log('Restart Codex to reload the Personal Assistant MCP server.');\n    console.log('Legacy alias still available: personal-assistant-mcp codex install');\n  });\n\n// ---- sync command ----\nprogram\n  .command('sync')\n  .description('Run a one-time sync')\n  .option('-d, --dir <dir>', 'Workspace directory', '.personal-assistant')\n  .action(async (opts) => {\n    const workspacePath = await resolveWorkspacePath(opts.dir);\n    console.log('Running sync...');\n\n    // Bootstrap: read config from local to determine storage backend\n    const localStore = createLocalStorage(workspacePath);\n    const bootConfigManager = createConfigManager(localStore);\n\n    // Resolve storage — all operations use the user's chosen backend\n    let resolvedStorage: StorageBackend = localStore;\n    try {\n      const config = await bootConfigManager.loadConfig();\n      if (config.storage.mode === 'gdrive') {\n        const gdriveConfig = config.storage as GDriveStorageConfig;\n        const resolvedCachePath = path.isAbsolute(gdriveConfig.cachePath)\n          ? gdriveConfig.cachePath\n          : path.resolve(path.dirname(workspacePath), gdriveConfig.cachePath);\n\n        const gdriveStorage = createGDriveStorage({\n          ...gdriveConfig,\n          cachePath: resolvedCachePath,\n        });\n        await gdriveStorage.initialize();\n        resolvedStorage = gdriveStorage;\n        console.log('Using Google Drive storage backend');\n      }\n    } catch {\n      // Config not readable — continue with local storage\n    }\n\n    const indexer = createIndexer(resolvedStorage);\n    await indexer.buildIndexes();\n\n    console.log('Sync complete. Indexes rebuilt.');\n  });\n\n// ---- status command ----\nprogram\n  .command('status')\n  .description('Show current configuration and status')\n  .option('-d, --dir <dir>', 'Workspace directory', '.personal-assistant')\n  .action(async (opts) => {\n    const workspacePath = await resolveWorkspacePath(opts.dir);\n\n    const storage = createLocalStorage(workspacePath);\n    const configManager = createConfigManager(storage);\n\n    try {\n      const config = await configManager.loadConfig();\n      console.log('Personal Assistant Status');\n      console.log('========================');\n      console.log(`Workspace: ${workspacePath}`);\n      console.log(`User: ${config.user.name}`);\n      console.log(`Assistant: ${config.user.assistantName}`);\n      console.log(`Profile: ${config.user.profileType}`);\n      console.log(`Storage: ${config.storage.mode}`);\n      console.log(`Active Project: ${config.activeProject ?? 'none'}`);\n      console.log(`Integrations: ${config.integrations.filter((i) => i.enabled).map((i) => i.type).join(', ') || 'none'}`);\n      console.log(`Sync Time: ${config.sync.dailySyncTime} ${config.sync.timezone}`);\n      console.log(`Slack Runtime: ${config.slackRuntime?.enabled ? `${config.slackRuntime.transport} (${config.slackRuntime.reviewMode})` : 'disabled'}`);\n    } catch {\n      console.log('No configuration found. Run `pacman init` first.');\n    }\n  });\n\nprogram.parse();\n","// src/index.ts\nimport * as fs from \"fs/promises\";\nimport * as path from \"path\";\nimport {\n  buildClaudeProjectMemory,\n  buildClaudeSkillContent\n} from \"@personal-assistant/client-guidance\";\nasync function installClaude(options) {\n  const { projectPath, config } = options;\n  await Promise.all([\n    generateClaudeMd(projectPath, config),\n    generateGlobalSkill()\n  ]);\n}\nasync function generateClaudeMd(projectPath, config) {\n  await fs.mkdir(projectPath, { recursive: true });\n  await fs.writeFile(path.join(projectPath, \"CLAUDE.md\"), buildClaudeProjectMemory(config), \"utf-8\");\n}\nasync function generateGlobalSkill() {\n  const globalSkillDir = path.join(\n    process.env.HOME ?? process.env.USERPROFILE ?? \"~\",\n    \".claude\",\n    \"skills\",\n    \"personal-assistant\"\n  );\n  await fs.mkdir(globalSkillDir, { recursive: true });\n  await fs.writeFile(path.join(globalSkillDir, \"SKILL.md\"), buildClaudeSkillContent(), \"utf-8\");\n}\nexport {\n  installClaude\n};\n","// src/index.ts\nvar TOOL_GROUPS = [\n  \"- Config: `config_get`, `config_get_storage_mode`, `config_get_active_project`, `config_set_active_project`\",\n  \"- Projects: `project_list`, `project_suggest`, `project_get_context`\",\n  \"- Read: `context_search`, `context_read_file`, `context_read_section`, `context_list_recent_updates`, `context_get_daily_summary`\",\n  \"- Update: `context_propose_update`, `context_apply_update`, `context_append_note`, `context_rebuild_indexes`\",\n  \"- Sync: `sync_run_now`, `sync_status`, `sync_list_integrations`\",\n  \"- Events: `events_ping`\"\n];\nfunction getStorageDescription(config) {\n  return config.storage.mode === \"local\" ? `Local workspace at: ${config.storage.workspacePath}` : `Google Drive folder: ${config.storage.folderName} (ID: ${config.storage.folderId})`;\n}\nfunction buildSharedProjectSections(config) {\n  return `## Context source of truth\n\nAll context is stored in:\n- ${getStorageDescription(config)}\n\nDo not assume any cloud database exists. Never store raw context outside user-controlled storage.\n\n## Context structure\n\nRead context in this order:\n1. context/canonical/ - long-lived, human-readable context (role, projects, stakeholders)\n2. context/derived/daily/ - machine-generated daily summaries\n3. context/derived/indexes/entities.json - extracted entities index\n4. context/raw/ - only when deeper detail is needed from integration data\n\n## Retrieval rule\n\nWhen the user asks about responsibilities, projects, stakeholders, status, history, routines, or prior decisions:\n- Call the Personal Assistant MCP tools first\n- Use \\`context_search\\` to find relevant files\n- Use \\`context_read_file\\` or \\`context_read_section\\` for specific content\n- Answer only from retrieved context files\n- State uncertainty if context is missing or insufficient\n\n## Update rule\n\nWhen the conversation creates stable new context (new ownership, priority changes, new contacts):\n- Call \\`context_propose_update\\` with the target file, section, proposed content, and reason\n- If the auto-apply policy allows, call \\`context_apply_update\\`\n- Never silently mutate canonical context without proposing first\n\n## Project rule\n\n- If an active project is set, prefer project-specific files from context/canonical/projects/\n- If no project is set, call \\`project_suggest\\` to infer likely project\n- If multiple candidates exist, ask the user to confirm\n- Use \\`config_set_active_project\\` to set the active project\n\n## MCP usage\n\nThis project uses the Personal Assistant MCP server. All context operations go through MCP tools:\n${TOOL_GROUPS.join(\"\\n\")}\n\n## User profile\n\n- Name: ${config.user.name}\n- Assistant name: ${config.user.assistantName}\n- Profile: ${config.user.profileType}\n`;\n}\nfunction buildClaudeProjectMemory(config) {\n  return `# Personal Assistant Project Rules\n\nThis project uses a local or Google Drive based context manager.\n\n${buildSharedProjectSections(config)}`;\n}\nfunction buildCodexProjectGuidance(config) {\n  return `# Personal Assistant Project Instructions\n\nThis repository uses a local or Google Drive based context manager.\n\n${buildSharedProjectSections(config)}\n\n## Codex startup rule\n\n- If Personal Assistant MCP tools are unavailable, tell the user to run \\`pacman mcp codex install\\`\n- If the package is not installed globally, show the fallback command:\n  \\`codex mcp add personal_assistant --env PA_WORKSPACE=$HOME/.personal-assistant -- npx -y pacman mcp serve\\`\n- Tell the user to restart Codex after installing or updating the MCP registration\n`;\n}\nfunction buildClaudeSkillContent() {\n  return `---\nname: personal-assistant\ndescription: Start the personal assistant workflow for a project using local or Google Drive context through MCP.\nargument-hint: start [project_name]\nallowed-tools: mcp__personal_assistant__*\n---\n\n# Personal Assistant Skill\n\nWhen this skill is invoked with \\`/personal-assistant start <project_name>\\`:\n\n## Steps\n\n1. **Check MCP availability**:\n   - If Personal Assistant MCP tools are unavailable, stop and tell the user to install them with \\`pacman mcp claude install\\`\n   - If the package is not installed globally, show the fallback command:\n     \\`claude mcp add -s user --env=PA_WORKSPACE=$HOME/.personal-assistant personal_assistant -- npx -y pacman mcp serve\\`\n   - Tell the user to restart Claude Code after installing or updating the MCP registration\n\n2. **Check MCP health**:\n   - Call \\`sync_status\\` before doing project selection\n   - If the response shows an unhealthy storage backend, summarize the reason, fix steps, and restart steps, then stop\n   - If the response shows failing integrations, warn the user that sync inputs may be stale and continue unless they want to troubleshoot first\n\n3. **Parse arguments**: Extract the project name from the command arguments.\n\n4. **Set active project**: If a project name is provided:\n   - Call \\`config_set_active_project\\` with the project name\n   - Call \\`project_get_context\\` to retrieve project-scoped context\n\n5. **Suggest project**: If no project name is provided:\n   - Call \\`project_suggest\\` to get a suggested project\n   - If one strong candidate exists (confidence > 0.7), suggest it to the user\n   - If multiple candidates or low confidence, call \\`project_list\\` and ask the user to choose\n\n6. **Load context**: Once the project is set:\n   - Read the project's canonical file from context/canonical/projects/\n   - Read the latest daily summary from context/derived/daily/\n   - Read the entities index for relevant people and services\n   - Present a brief status summary to the user\n\n7. **Continue with MCP**: For all subsequent questions:\n   - Use MCP tools to search and retrieve context\n   - Answer only from retrieved context files\n   - Propose updates when stable new facts emerge\n   - State uncertainty when context is insufficient\n\n## Important rules\n\n- Never fabricate context that isn't in the retrieved files\n- Always use MCP tools for context operations\n- Propose updates rather than silently modifying canonical files\n- Respect the context hierarchy: canonical > derived > raw\n`;\n}\nfunction buildCodexSkillContent() {\n  return `---\nname: personal-assistant\ndescription: Use when the user asks to start, load, refresh, or inspect Personal Assistant project context stored through the Personal Assistant MCP workspace.\n---\n\n# Personal Assistant\n\nUse this skill when the user asks to load or refresh personal assistant context for a project.\n\n## Steps\n\n1. **Check MCP availability**:\n   - If Personal Assistant MCP tools are unavailable, stop and tell the user to install them with \\`pacman mcp codex install\\`\n   - If the package is not installed globally, show the fallback command:\n     \\`codex mcp add personal_assistant --env PA_WORKSPACE=$HOME/.personal-assistant -- npx -y pacman mcp serve\\`\n   - Tell the user to restart Codex after installing or updating the MCP registration\n\n2. **Check MCP health**:\n   - Call \\`sync_status\\` before doing project selection\n   - If the response shows an unhealthy storage backend, summarize the reason, fix steps, and restart steps, then stop\n   - If the response shows failing integrations, warn the user that sync inputs may be stale and continue unless they want to troubleshoot first\n\n3. **Parse the project name**:\n   - Extract the project name from the user's request if one is provided\n\n4. **Set or suggest the project**:\n   - If a project name is provided, call \\`config_set_active_project\\` and then \\`project_get_context\\`\n   - If no project name is provided, call \\`project_suggest\\`\n   - If one strong candidate exists (confidence > 0.7), suggest it to the user\n   - If multiple candidates or low confidence, call \\`project_list\\` and ask the user to choose\n\n5. **Load context**:\n   - Read the project's canonical file from context/canonical/projects/\n   - Read the latest daily summary from context/derived/daily/\n   - Read the entities index for relevant people and services\n   - Present a brief status summary to the user\n\n6. **Continue with MCP**:\n   - Use MCP tools to search and retrieve context\n   - Answer only from retrieved context files\n   - Propose updates when stable new facts emerge\n   - State uncertainty when context is insufficient\n\n## Important rules\n\n- Never fabricate context that isn't in the retrieved files\n- Always use MCP tools for context operations\n- Propose updates rather than silently modifying canonical files\n- Respect the context hierarchy: canonical > derived > raw\n`;\n}\nexport {\n  buildClaudeProjectMemory,\n  buildClaudeSkillContent,\n  buildCodexProjectGuidance,\n  buildCodexSkillContent\n};\n","// src/index.ts\nimport * as fs from \"fs/promises\";\nimport * as path from \"path\";\nimport {\n  buildCodexProjectGuidance,\n  buildCodexSkillContent\n} from \"@personal-assistant/client-guidance\";\nasync function installCodex(options) {\n  const { projectPath, config } = options;\n  await Promise.all([\n    generateAgentsMd(projectPath, config),\n    generateGlobalSkill()\n  ]);\n}\nasync function generateAgentsMd(projectPath, config) {\n  await fs.mkdir(projectPath, { recursive: true });\n  await fs.writeFile(\n    path.join(projectPath, \"AGENTS.md\"),\n    buildCodexProjectGuidance(config),\n    \"utf-8\"\n  );\n}\nasync function generateGlobalSkill() {\n  const globalSkillDir = path.join(\n    process.env.HOME ?? process.env.USERPROFILE ?? \"~\",\n    \".codex\",\n    \"skills\",\n    \"personal-assistant\"\n  );\n  await fs.mkdir(globalSkillDir, { recursive: true });\n  await fs.writeFile(\n    path.join(globalSkillDir, \"SKILL.md\"),\n    buildCodexSkillContent(),\n    \"utf-8\"\n  );\n}\nexport {\n  installCodex\n};\n"],"mappings":"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","names":["path","fs","fs","path","generateGlobalSkill"]}

package/dist/mcp-compat.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node