@starlein/paperclip-plugin-company-wizard 0.4.5 → 0.4.7

package/dist/worker.js

@@ -9415,6 +9415,8 @@ async function assembleCompany({
   presetLabels = [],
   enableIsolatedWorktrees = false,
   enableEnrichedPersonas = true,
+  gitUserName,
+  gitUserEmail,
   outputDir,
   templatesDir,
   onProgress = () => {
@@ -9544,7 +9546,7 @@ async function assembleCompany({
     }
     return assignee;
   };
-  const resolveReviewGate = (reviewGate) => {
+  const resolveReviewGate = (reviewGate, assignTo) => {
     if (!reviewGate || typeof reviewGate !== "object") return null;
     const reviewersRaw = Array.isArray(reviewGate.reviewers) ? reviewGate.reviewers : [];
     const reviewers = [];
@@ -9558,22 +9560,12 @@ async function assembleCompany({
     }
     const approver = typeof reviewGate.approver === "string" && allRoles.has(reviewGate.approver) ? reviewGate.approver : void 0;
     let mergeGate = typeof reviewGate.mergeGate === "string" && allRoles.has(reviewGate.mergeGate) ? reviewGate.mergeGate : void 0;
-    if (!mergeGate) {
-      const mergeGateFallbacks = [
-        "code-reviewer",
-        "devops",
-        "ui-designer",
-        "ux-researcher",
-        "security-engineer",
-        "qa"
-      ];
-      mergeGate = mergeGateFallbacks.find((role) => allRoles.has(role) && role !== approver);
-    }
+    if (mergeGate === assignTo) mergeGate = void 0;
     if (approver) {
       const idx = reviewers.indexOf(approver);
       if (idx !== -1) reviewers.splice(idx, 1);
     }
-    if (reviewers.length === 0 && !approver && !mergeGate) return null;
+    if (!mergeGate) return null;
     return { reviewers, approver, mergeGate };
   };
   const hasCi = moduleNames.includes("ci-cd");
@@ -10080,7 +10072,9 @@ Read: \`docs/${doc}\`
       if (!workspace.cwd) workspace.cwd = localCwd;
       const trimmedSetup = typeof workspace.setupCommand === "string" ? workspace.setupCommand.trim() : "";
       if (!trimmedSetup || trimmedSetup === "git init -b main" || trimmedSetup === "git init") {
-        workspace.setupCommand = "git init -b main && git -c user.email=bootstrap@paperclip.local -c user.name='Paperclip Bootstrap' commit --allow-empty -m 'chore: initialize repository'";
+        const gitName = gitUserName || "Paperclip Bootstrap";
+        const gitEmail = gitUserEmail || "bootstrap@paperclip.local";
+        workspace.setupCommand = `git init -b main && git -c user.email=${gitEmail} -c user.name='${gitName.replace(/'/g, "'\\''")}' commit --allow-empty -m 'chore: initialize repository'`;
       }
     }
     return workspace;
@@ -10305,7 +10299,7 @@ Read: \`docs/${doc}\`
         ["goalId", goalRef ? `\u2192 "${goalRef}"` : void 0],
         ["labelIds", `\u2192 [${issueLabelNames.map((name) => `"${name}"`).join(", ")}]`]
       ]);
-      const issueReviewGate = resolveReviewGate(issue.reviewGate);
+      const issueReviewGate = resolveReviewGate(issue.reviewGate, issue.assignTo);
       if (issueReviewGate) {
         bootstrap += renderReviewGate(issueReviewGate);
       }
@@ -10330,7 +10324,7 @@ Read: \`docs/${doc}\`
 `;
     if (moduleNames.includes("pr-review")) {
       const ciClause = hasCi ? "CI (lint/test/build) must be green before the merge gate merges \u2014 this is the hard gate and cannot be skipped" : "no CI is configured, so the merge-gate agent must run the test suite/build and paste the real output into the merge-gate verdict before merging \u2014 this is the hard gate";
-      bootstrap += `- Required PR reviews use the issue's \`executionPolicy\`. The substantive gate is execution, not opinion: ${ciClause}. Stages, in order: a \`review\` stage for QA when present (test adequacy / running the tests), a \`review\` stage for the Security Engineer **only when the change is security-relevant** (auth, secrets, input boundaries, crypto, dependencies, infra exposure), an \`approval\` stage for the Product Owner (intent/scope), then a final \`approval\` merge-gate stage for the **Code Reviewer** (a non-author who satisfies the hard gate above, merges the PR, then records approval to close the issue). **Never list the issue's executor/author as a participant in any stage** \u2014 Paperclip excludes the original executor from review/approval, so a stage whose only participant is the author has no eligible participant and the issue stalls in \`in_review\` (422 No eligible approval participant); this is why the merge gate is the Code Reviewer (or another present non-author), not the engineer who wrote the code. The merge gate must be last so the Product Owner's approval does not auto-close the issue with the PR still open. Other domain reviewers may add advisory, non-blocking comments but do not gate the merge. Every verdict must cite executed verification. Resolve each role to its agentId. Model review stages in executionPolicy rather than child issues or @-mentions.
+      bootstrap += `- Required PR reviews use the issue's \`executionPolicy\`. The substantive gate is execution, not opinion: ${ciClause}. Stages, in order: a \`review\` stage for QA when present (test adequacy / running the tests), a \`review\` stage for the Security Engineer **only when the change is security-relevant** (auth, secrets, input boundaries, crypto, dependencies, infra exposure), an \`approval\` stage for the Product Owner when present (intent/scope), then a final \`approval\` merge-gate stage for the **Code Reviewer** (a non-author who satisfies the hard gate above, merges the PR, then records approval to close the issue). **Never list the issue's executor/author as a participant in any stage** \u2014 Paperclip excludes the original executor from review/approval, so a stage whose only participant is the author has no eligible participant and the issue stalls in \`in_review\` (422 No eligible approval participant); this is why the merge gate is the Code Reviewer (a non-author), not the engineer who wrote the code. The merge gate must be last so the Product Owner's approval does not auto-close the issue with the PR still open. When no Code Reviewer is on the team, do not set executionPolicy stages at all \u2014 use the PR-Self-Merge path (the engineer opens the PR and merges via \`gh pr merge <N> --merge\`); other review roles may leave advisory comments but do not block. Other domain reviewers may add advisory, non-blocking comments but do not gate the merge. Every verdict must cite executed verification. Resolve each role to its agentId. Model review stages in executionPolicy rather than child issues or @-mentions.
 `;
     }
     bootstrap += `
@@ -10449,6 +10443,8 @@ var PaperclipClient = class {
     this.credentials = credentials;
     this.sessionCookie = null;
     this.boardUserId = null;
+    this.boardUserName = null;
+    this.boardUserEmail = null;
   }
   async _fetch(path3, opts = {}) {
     const url = `${this.baseUrl}${path3}`;
@@ -10490,6 +10486,8 @@ var PaperclipClient = class {
     }
     if (res.ok) {
       this.boardUserId = "local-board";
+      this.boardUserName = null;
+      this.boardUserEmail = null;
       return;
     }
     if (res.status === 401 || res.status === 403) {
@@ -10504,6 +10502,8 @@ var PaperclipClient = class {
       try {
         const session = await this._fetch("/api/auth/get-session");
         this.boardUserId = session?.user?.id || null;
+        this.boardUserName = session?.user?.name || null;
+        this.boardUserEmail = session?.user?.email || null;
       } catch {
       }
       return;
@@ -10603,6 +10603,17 @@ var PaperclipClient = class {
       })
     });
   }
+  async getInstructionsBundle(agentId) {
+    return this._fetch(`/api/agents/${agentId}/instructions-bundle`, {
+      method: "GET"
+    });
+  }
+  async deleteInstructionsBundleFile(agentId, { path: path3 }) {
+    return this._fetch(`/api/agents/${agentId}/instructions-bundle/file`, {
+      method: "DELETE",
+      body: JSON.stringify({ path: path3 })
+    });
+  }
   async createAgent(companyId, agent) {
     const {
       name,
@@ -10772,6 +10783,23 @@ var PaperclipClient = class {
       })
     });
   }
+  async listRoutines(companyId, filters = {}) {
+    const params = new URLSearchParams();
+    if (filters.projectId) params.set("projectId", filters.projectId);
+    const query = params.toString();
+    return this._fetch(`/api/companies/${companyId}/routines${query ? `?${query}` : ""}`, {
+      method: "GET"
+    });
+  }
+  async getRoutine(routineId) {
+    return this._fetch(`/api/routines/${routineId}`, { method: "GET" });
+  }
+  async updateRoutine(routineId, updates = {}) {
+    return this._fetch(`/api/routines/${routineId}`, {
+      method: "PATCH",
+      body: JSON.stringify(updates || {})
+    });
+  }
   async createRoutineTrigger(routineId, { kind, cronExpression, timezone }) {
     return this._fetch(`/api/routines/${routineId}/triggers`, {
       method: "POST",
@@ -10782,6 +10810,12 @@ var PaperclipClient = class {
       })
     });
   }
+  async updateRoutineTrigger(triggerId, updates = {}) {
+    return this._fetch(`/api/routine-triggers/${triggerId}`, {
+      method: "PATCH",
+      body: JSON.stringify(updates || {})
+    });
+  }
   async triggerHeartbeat(agentId, { issueId } = {}) {
     return this._fetch(`/api/agents/${agentId}/wakeup`, {
       method: "POST",
@@ -10969,7 +11003,7 @@ var __dirname = path2.dirname(fileURLToPath2(import.meta.url));
 var DEFAULT_TEMPLATES_REPO_URL = "https://github.com/starlein/paperclip-plugin-company-wizard/tree/main/templates";
 var BUNDLED_TEMPLATES_DIR = path2.resolve(__dirname, "..", "templates");
 var PLUGIN_PACKAGE_NAME = "@starlein/paperclip-plugin-company-wizard";
-var CURRENT_PLUGIN_VERSION = "0.4.5";
+var CURRENT_PLUGIN_VERSION = "0.4.7";
 var NPM_LATEST_URL = "https://registry.npmjs.org/@starlein%2Fpaperclip-plugin-company-wizard/latest";
 function copyDirSync(src, dest) {
   fs2.mkdirSync(dest, { recursive: true });
@@ -11017,6 +11051,9 @@ function downloadTemplatesFromGithub(destDir, githubUrl) {
     }
   }
 }
+function isDockerLayout() {
+  return fs2.existsSync(path2.join(os.homedir(), "instances"));
+}
 async function ensureTemplatesDir(cfg) {
   const repoUrl = cfg.templatesRepoUrl || DEFAULT_TEMPLATES_REPO_URL;
   if (cfg.templatesPath) {
@@ -11024,6 +11061,15 @@ async function ensureTemplatesDir(cfg) {
     downloadTemplatesFromGithub(cfg.templatesPath, repoUrl);
     return cfg.templatesPath;
   }
+  if (isDockerLayout()) {
+    const dockerTemplatesDir = path2.join(os.homedir(), "plugin-templates");
+    if (fs2.existsSync(dockerTemplatesDir)) return dockerTemplatesDir;
+    try {
+      downloadTemplatesFromGithub(dockerTemplatesDir, repoUrl);
+      return dockerTemplatesDir;
+    } catch {
+    }
+  }
   const defaultDir = path2.join(os.homedir(), ".paperclip", "plugin-templates");
   if (fs2.existsSync(defaultDir)) return defaultDir;
   try {
@@ -11136,10 +11182,6 @@ function loadTemplates(templatesDir) {
     loadErrors: [...presetLoad.errors, ...moduleLoad.errors, ...roleLoad.errors]
   };
 }
-function cfgBool(cfg, key) {
-  const raw = cfg[key];
-  return raw === true || typeof raw === "string" && raw.toLowerCase() === "true";
-}
 async function resolveEnableIsolatedWorkspacesFromInstance(cfg, log) {
   const paperclipUrl = cfg.paperclipUrl || process.env.PAPERCLIP_PUBLIC_URL || "http://localhost:3100";
   const paperclipEmail = cfg.paperclipEmail || "";
@@ -11184,11 +11226,12 @@ function resolveWritableCompaniesDir(cfg, log) {
       );
     }
   }
-  const candidates = [
-    resolveCompaniesDir(cfg),
-    path2.join("/paperclip", "instances", "default", "companies"),
-    path2.join(os.tmpdir(), "paperclip-companies")
-  ];
+  const candidates = [];
+  if (isDockerLayout()) {
+    candidates.push(path2.join(os.homedir(), "instances", "default", "companies"));
+  }
+  candidates.push(resolveCompaniesDir(cfg));
+  candidates.push(path2.join(os.tmpdir(), "paperclip-companies"));
   const attempted = /* @__PURE__ */ new Set();
   let lastError = "";
   for (const candidate of candidates) {
@@ -11207,6 +11250,51 @@ function resolveWritableCompaniesDir(cfg, log) {
     `Unable to prepare a writable companies directory. Last attempt failed at ${lastError}`
   );
 }
+function isPathInside(parent, child) {
+  const relative = path2.relative(parent, child);
+  return relative === "" || !!relative && !relative.startsWith("..") && !path2.isAbsolute(relative);
+}
+function normalizeGitBranch(value) {
+  const branch = typeof value === "string" && value.trim() ? value.trim() : "main";
+  return /^[A-Za-z0-9._/-]+$/.test(branch) ? branch.replace(/^origin\//, "") : "main";
+}
+function prepareLocalProjectWorkspace(mainProject, companyDir, log, gitIdentity) {
+  const workspace = mainProject?.workspace;
+  if (!workspace || workspace.sourceType !== "local_path") return;
+  const cwd = typeof workspace.cwd === "string" ? workspace.cwd.trim() : "";
+  if (!cwd) return;
+  const resolvedCompanyDir = path2.resolve(companyDir);
+  const resolvedCwd = path2.resolve(cwd);
+  if (!isPathInside(resolvedCompanyDir, resolvedCwd)) {
+    log?.(`\u26A0 Skipped project workspace preparation outside company dir: ${resolvedCwd}`);
+    return;
+  }
+  fs2.mkdirSync(resolvedCwd, { recursive: true });
+  const gitDir = path2.join(resolvedCwd, ".git");
+  if (fs2.existsSync(gitDir)) {
+    log?.(`\u2713 Project workspace ready: ${resolvedCwd}`);
+    return;
+  }
+  const branch = normalizeGitBranch(workspace.defaultRef);
+  const gitUserName = gitIdentity?.name || "Paperclip Bootstrap";
+  const gitUserEmail = gitIdentity?.email || "bootstrap@paperclip.local";
+  execFileSync("git", ["init", "-b", branch], { cwd: resolvedCwd, stdio: "pipe" });
+  execFileSync(
+    "git",
+    [
+      "-c",
+      `user.email=${gitUserEmail}`,
+      "-c",
+      `user.name=${gitUserName}`,
+      "commit",
+      "--allow-empty",
+      "-m",
+      "chore: initialize repository"
+    ],
+    { cwd: resolvedCwd, stdio: "pipe" }
+  );
+  log?.(`\u2713 Project workspace initialized: ${resolvedCwd}`);
+}
 function formatRoleName(role) {
   return role.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
 }
@@ -11264,6 +11352,156 @@ async function syncAgentInstructionsIntoManagedBundle({
     );
   }
 }
+function preserveExistingSkillSync(existingAgent, nextAdapterConfig) {
+  const existingSync = existingAgent?.adapterConfig && typeof existingAgent.adapterConfig === "object" && "paperclipSkillSync" in existingAgent.adapterConfig ? existingAgent.adapterConfig.paperclipSkillSync : void 0;
+  if (!existingSync) {
+    return nextAdapterConfig;
+  }
+  return {
+    ...nextAdapterConfig,
+    paperclipSkillSync: existingSync
+  };
+}
+function routineTemplateTitle(routine) {
+  if (typeof routine?.title === "string" && routine.title.trim()) return routine.title.trim();
+  if (typeof routine?.name === "string" && routine.name.trim()) return routine.name.trim();
+  return "";
+}
+function buildWizardManifest(params) {
+  const routineTitles = params.initialRoutines.map((r) => routineTemplateTitle(r)).filter(Boolean);
+  const generatedFilePaths = {};
+  if (params.assembleResult?.allFiles && typeof params.assembleResult.allFiles === "object") {
+    for (const relativePath of Object.keys(params.assembleResult.allFiles)) {
+      const match = relativePath.match(/^agents\/([^/]+)\//);
+      if (match) {
+        const agentRole = match[1];
+        if (!generatedFilePaths[agentRole]) generatedFilePaths[agentRole] = [];
+        generatedFilePaths[agentRole].push(relativePath);
+      } else if (relativePath.startsWith("docs/")) {
+        if (!generatedFilePaths["docs"]) generatedFilePaths["docs"] = [];
+        generatedFilePaths["docs"].push(relativePath);
+      }
+    }
+  }
+  return {
+    pluginVersion: CURRENT_PLUGIN_VERSION,
+    preset: params.presetName,
+    modules: params.selectedModules,
+    roles: params.selectedRoleNames,
+    generatedFilePaths,
+    routineTitles,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+var WIZARD_PLUGIN_KEY = "starlein.paperclip-plugin-company-wizard";
+async function findPluginId(client) {
+  try {
+    const plugins = await client._fetch("/api/plugins");
+    const match = Array.isArray(plugins) ? plugins.find((p) => p.pluginKey === WIZARD_PLUGIN_KEY) : null;
+    return match?.id ?? null;
+  } catch {
+    return null;
+  }
+}
+async function syncRoutineTrigger({
+  client,
+  routineId,
+  schedule,
+  log
+}) {
+  if (!schedule) return;
+  try {
+    const detail = await client.getRoutine(routineId);
+    const triggers = Array.isArray(detail?.triggers) ? detail.triggers : [];
+    const scheduleTrigger = triggers.find((trigger) => trigger?.kind === "schedule");
+    if (scheduleTrigger?.id) {
+      await client.updateRoutineTrigger(scheduleTrigger.id, {
+        enabled: true,
+        cronExpression: schedule,
+        timezone: scheduleTrigger.timezone || "UTC"
+      });
+      return;
+    }
+    await client.createRoutineTrigger(routineId, {
+      kind: "schedule",
+      cronExpression: schedule,
+      timezone: "UTC"
+    });
+  } catch (err) {
+    log(
+      `\u26A0 Could not sync trigger for routine "${routineId}": ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
+async function syncExistingCompanyRoutines({
+  client,
+  companyId,
+  routines,
+  ceoAgentId,
+  teamAgentIds,
+  log
+}) {
+  if (!Array.isArray(routines) || routines.length === 0) return;
+  let existingRoutines = [];
+  try {
+    existingRoutines = await client.listRoutines(companyId);
+  } catch (err) {
+    log(
+      `\u26A0 Could not list existing routines for template sync: ${err instanceof Error ? err.message : String(err)}`
+    );
+    return;
+  }
+  const byTitle = /* @__PURE__ */ new Map();
+  for (const existing of existingRoutines) {
+    if (typeof existing?.title === "string" && existing.title.trim()) {
+      byTitle.set(existing.title.trim().toLowerCase(), existing);
+    }
+  }
+  for (const routine of routines) {
+    const title = routineTemplateTitle(routine);
+    if (!title) continue;
+    const role = routine.assignTo;
+    const assigneeAgentId = !role || role === "ceo" ? ceoAgentId : teamAgentIds[role] ?? ceoAgentId;
+    const payload = {
+      title,
+      description: routine.description || null,
+      assigneeAgentId,
+      priority: routine.priority || "medium",
+      status: routine.status || "active",
+      concurrencyPolicy: routine.concurrencyPolicy || "skip_if_active",
+      catchUpPolicy: routine.catchUpPolicy || "skip_missed"
+    };
+    const existing = byTitle.get(title.toLowerCase());
+    try {
+      if (existing?.id) {
+        await client.updateRoutine(existing.id, payload);
+        await syncRoutineTrigger({
+          client,
+          routineId: existing.id,
+          schedule: routine.schedule,
+          log
+        });
+        log(`\u2713 Synced existing routine "${title}"`);
+      } else {
+        const created = await client.createRoutine(companyId, payload);
+        if (routine.schedule && created?.id) {
+          await client.createRoutineTrigger(created.id, {
+            kind: "schedule",
+            cronExpression: routine.schedule,
+            timezone: "UTC"
+          });
+        }
+        log(
+          `\u2713 Created missing routine "${title}"${routine.schedule ? ` (${routine.schedule})` : ""}`
+        );
+      }
+    } catch (err) {
+      log(
+        `\u26A0 Could not sync routine "${title}": ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
+}
 function buildDecisionLogBody({
   companyName,
   companyDescription,
@@ -11465,6 +11703,204 @@ var plugin = definePlugin({
         }
       }
     });
+    ctx.actions.register("preview-company-update", async (params) => {
+      let tmpDir;
+      try {
+        let countFiles2 = function(dir) {
+          if (!fs2.existsSync(dir)) return;
+          for (const entry of fs2.readdirSync(dir, { withFileTypes: true })) {
+            const full = path2.join(dir, entry.name);
+            if (entry.isDirectory()) countFiles2(full);
+            else if (entry.isFile()) plannedFiles++;
+          }
+        };
+        var countFiles = countFiles2;
+        const existingCompanyId = typeof params.existingCompanyId === "string" && params.existingCompanyId.trim() ? params.existingCompanyId.trim() : "";
+        if (!existingCompanyId) {
+          return { error: "existingCompanyId is required for preview." };
+        }
+        const cfg = await ctx.config.get() ?? {};
+        const paperclipUrl = cfg.paperclipUrl || process.env.PAPERCLIP_PUBLIC_URL || "http://localhost:3100";
+        const paperclipEmail = cfg.paperclipEmail || "";
+        const paperclipPassword = cfg.paperclipPassword || "";
+        const companyName = typeof params.companyName === "string" && params.companyName.trim() ? params.companyName.trim() : "Preview";
+        const templatesDir = await ensureTemplatesDir(cfg);
+        tmpDir = path2.join(os.tmpdir(), `company-wizard-preview-update-${Date.now()}`);
+        const [presets, allModules, roleTemplates] = await Promise.all([
+          loadPresets(templatesDir),
+          loadModules(templatesDir),
+          loadRoles(templatesDir)
+        ]);
+        const roleTemplateByName = new Map(
+          (Array.isArray(roleTemplates) ? roleTemplates : []).filter((role) => role && typeof role.name === "string").map((role) => [role.name, role])
+        );
+        const selectedPreset = presets.find((p) => p.name === params.presetName) || null;
+        const effectiveModules = resolveEffectiveModules(
+          selectedPreset,
+          allModules,
+          params.selectedModules ?? []
+        );
+        const goals = collectGoals(selectedPreset, allModules, new Set(effectiveModules));
+        const presetBootstrapData = collectPresetBootstrapData(selectedPreset);
+        const previewGoals = Array.isArray(params.goals) ? params.goals : params.goal ? [params.goal] : [];
+        const previewProjects = Array.isArray(params.projects) ? params.projects : [];
+        const previewIssues = Array.isArray(params.issues) ? params.issues : [];
+        const assembleResult = await assembleCompany({
+          companyName,
+          userGoals: previewGoals,
+          userProjects: previewProjects,
+          moduleNames: effectiveModules,
+          extraRoleNames: params.selectedRoles ?? [],
+          inlineGoals: goals,
+          userIssues: previewIssues,
+          presetIssues: presetBootstrapData.issues,
+          presetRoutines: presetBootstrapData.routines,
+          presetLabels: presetBootstrapData.labels,
+          enableIsolatedWorktrees: await resolveEnableIsolatedWorkspacesFromInstance(cfg),
+          enableEnrichedPersonas: true,
+          outputDir: tmpDir,
+          templatesDir
+        });
+        const allRoles = Array.isArray(params.allRoles) ? params.allRoles : [...assembleResult.allRoles ?? []].filter(Boolean);
+        const teamRoles = allRoles.filter((r) => r && r !== "ceo");
+        let plannedFiles = 0;
+        countFiles2(assembleResult.companyDir);
+        const client = new PaperclipClient(paperclipUrl, {
+          email: paperclipEmail,
+          password: paperclipPassword
+        });
+        await client.connect();
+        const company = await client.getCompany(existingCompanyId);
+        const existingAgents = await client.listAgents(existingCompanyId);
+        const existingRoutines = await client.listRoutines(existingCompanyId);
+        let existingManifest = null;
+        try {
+          const pluginId = await findPluginId(client);
+          if (pluginId) {
+            const settings = await client._fetch(
+              `/api/plugins/${pluginId}/company-settings/${existingCompanyId}`
+            );
+            const manifestData = settings?.settingsJson?.wizardManifest ?? settings?.settings_json?.wizardManifest;
+            if (manifestData && typeof manifestData === "object") {
+              existingManifest = manifestData;
+            }
+          }
+        } catch {
+        }
+        const existingCeo = Array.isArray(existingAgents) ? existingAgents.find((a) => a?.role === "ceo" && a?.status !== "terminated") : null;
+        const existingByTemplateRole = /* @__PURE__ */ new Map();
+        if (Array.isArray(existingAgents)) {
+          for (const a of existingAgents) {
+            const tr = a?.metadata?.templateRole;
+            if (tr && a?.status !== "terminated" && a?.role !== "ceo") {
+              existingByTemplateRole.set(tr, a);
+            }
+          }
+        }
+        const agents = [];
+        const ceoTemplate = roleTemplateByName.get("ceo") || {};
+        const ceoTitle = typeof ceoTemplate.title === "string" && ceoTemplate.title.trim() ? ceoTemplate.title.trim() : "CEO";
+        agents.push({
+          role: "ceo",
+          title: existingCeo?.title || ceoTitle,
+          action: existingCeo ? "update" : "hire"
+        });
+        for (const roleName of teamRoles) {
+          const roleTemplate = roleTemplateByName.get(roleName) || {};
+          const roleTitle = typeof roleTemplate.title === "string" && roleTemplate.title.trim() ? roleTemplate.title.trim() : formatRoleName(roleName);
+          const existing = existingByTemplateRole.get(roleName);
+          agents.push({
+            role: roleName,
+            title: roleTitle,
+            action: existing ? "update" : "hire"
+          });
+        }
+        const selectedRoleSet = new Set(allRoles);
+        const manifestRoleSet = existingManifest?.roles ? new Set(existingManifest.roles) : null;
+        for (const [tr, agent] of existingByTemplateRole.entries()) {
+          if (!selectedRoleSet.has(tr)) {
+            if (manifestRoleSet && !manifestRoleSet.has(tr)) {
+              continue;
+            }
+            const roleTemplate = roleTemplateByName.get(tr) || {};
+            const roleTitle = typeof roleTemplate.title === "string" && roleTemplate.title.trim() ? roleTemplate.title.trim() : formatRoleName(tr);
+            agents.push({
+              role: tr,
+              title: agent?.title || roleTitle,
+              action: "retire"
+            });
+          }
+        }
+        const existingRoutineByTitle = /* @__PURE__ */ new Map();
+        if (Array.isArray(existingRoutines)) {
+          for (const r of existingRoutines) {
+            const title = routineTemplateTitle(r);
+            if (title) existingRoutineByTitle.set(title.toLowerCase(), r);
+          }
+        }
+        const plannedRoutines = [
+          ...assembleResult.initialRoutines ?? [],
+          ...presetBootstrapData.routines ?? []
+        ];
+        const seenRoutineTitles = /* @__PURE__ */ new Set();
+        const routines = [];
+        for (const routine of plannedRoutines) {
+          const title = routineTemplateTitle(routine);
+          if (!title) continue;
+          const key = title.toLowerCase();
+          if (seenRoutineTitles.has(key)) continue;
+          seenRoutineTitles.add(key);
+          const existing = existingRoutineByTitle.get(key);
+          routines.push({
+            title,
+            action: existing ? "update" : "create",
+            assignTo: routine.assignTo || void 0
+          });
+        }
+        const desiredSkillsPreserved = [];
+        if (Array.isArray(existingAgents)) {
+          for (const a of existingAgents) {
+            if (a?.adapterConfig && typeof a.adapterConfig === "object" && "paperclipSkillSync" in a.adapterConfig) {
+              const sync = a.adapterConfig.paperclipSkillSync;
+              if (sync && typeof sync === "object" && "desiredSkills" in sync) {
+                const skills = sync.desiredSkills;
+                if (Array.isArray(skills) && skills.length > 0) {
+                  desiredSkillsPreserved.push({
+                    agentId: a.id,
+                    agentName: a.title || a.name || a.id,
+                    skills
+                  });
+                }
+              }
+            }
+          }
+        }
+        try {
+          fs2.rmSync(tmpDir, { recursive: true, force: true });
+        } catch {
+        }
+        tmpDir = void 0;
+        return {
+          diff: {
+            companyId: existingCompanyId,
+            companyName: company?.name || companyName,
+            agents,
+            routines,
+            desiredSkillsPreserved,
+            plannedFiles,
+            existingManifest
+          }
+        };
+      } catch (err) {
+        if (tmpDir) {
+          try {
+            fs2.rmSync(tmpDir, { recursive: true, force: true });
+          } catch {
+          }
+        }
+        return { error: err instanceof Error ? err.message : String(err) };
+      }
+    });
     ctx.actions.register("check-auth", async () => {
       const cfg = await ctx.config.get() ?? {};
       const paperclipUrl = cfg.paperclipUrl || process.env.PAPERCLIP_PUBLIC_URL || "http://localhost:3100";
@@ -11547,10 +11983,6 @@ var plugin = definePlugin({
         const paperclipUrl = cfg.paperclipUrl || process.env.PAPERCLIP_PUBLIC_URL || "http://localhost:3100";
         const paperclipEmail = cfg.paperclipEmail || "";
         const paperclipPassword = cfg.paperclipPassword || "";
-        const disableBoardApprovalOnNewCompanies = cfgBool(
-          cfg,
-          "disableBoardApprovalOnNewCompanies"
-        );
         const enableIsolatedWorktrees = await resolveEnableIsolatedWorkspacesFromInstance(cfg, log);
         const enableEnrichedPersonas = true;
         const companyName = typeof params.companyName === "string" ? params.companyName.trim() : "";
@@ -11573,6 +12005,17 @@ var plugin = definePlugin({
         );
         const goals = collectGoals(selectedPreset, allModules, new Set(effectiveModules));
         const presetBootstrapData = collectPresetBootstrapData(selectedPreset);
+        log("Connecting to Paperclip API...");
+        const client = new PaperclipClient(paperclipUrl, {
+          email: paperclipEmail,
+          password: paperclipPassword
+        });
+        await client.connect();
+        log("Connected.");
+        const gitIdentity = {
+          name: client.boardUserName || null,
+          email: client.boardUserEmail || paperclipEmail || null
+        };
         const outputDir = resolveWritableCompaniesDir(cfg, log);
         log("Assembling company workspace...");
         const companyDescription = typeof params.companyDescription === "string" ? params.companyDescription.trim() : "";
@@ -11593,6 +12036,8 @@ var plugin = definePlugin({
           presetLabels: presetBootstrapData.labels,
           enableIsolatedWorktrees,
           enableEnrichedPersonas,
+          gitUserName: gitIdentity.name || void 0,
+          gitUserEmail: gitIdentity.email || void 0,
           outputDir,
           templatesDir,
           onProgress: log
@@ -11610,20 +12055,13 @@ var plugin = definePlugin({
             log(`\u270E Override: ${relPath}`);
           }
         }
+        prepareLocalProjectWorkspace(assembleResult.mainProject, companyDir, log, gitIdentity);
         const ceoInstructionsDir = path2.join(companyDir, "agents", "ceo");
         const ceoEntryFile = "AGENTS.md";
         const ceoEntryPath = path2.join(ceoInstructionsDir, ceoEntryFile);
         const ceoPromptTemplate = fs2.existsSync(ceoEntryPath) ? fs2.readFileSync(ceoEntryPath, "utf-8") : "";
         log("");
         log(`\u2713 Generated files: ${companyDir}`);
-        log("Connecting to Paperclip API...");
-        const client = new PaperclipClient(paperclipUrl, {
-          email: paperclipEmail,
-          password: paperclipPassword
-        });
-        await client.connect();
-        log("Connected.");
-        log("");
         let company;
         let companyId;
         let createdCompany = false;
@@ -11642,31 +12080,38 @@ var plugin = definePlugin({
           companyId = company.id;
           createdCompany = true;
           log(`\u2713 Company "${companyName}" created`);
-          if (disableBoardApprovalOnNewCompanies) {
-            try {
-              await client.updateCompany(companyId, { requireBoardApprovalForNewAgents: false });
-              log("\u2713 Disabled board-approval hiring policy for this new company");
-            } catch (err) {
-              log(
-                `\u26A0 Could not disable board-approval hiring for new agents: ${err instanceof Error ? err.message : String(err)}`
-              );
-              log("  Continuing \u2014 agent creation will use an approval-aware fallback if required.");
-            }
-          } else {
-            log("Keeping company hire policy as configured (board approvals may be required).");
-          }
+          log("Keeping company hire policy as configured (board approvals may be required).");
         }
         let ceoAgentId;
         const teamAgentIds = {};
         let boardOperationsIssue = null;
         let hiringPlanIssue = null;
         let bootstrapIssue;
+        let allRoleNames = [];
+        let existingManifest = null;
+        let existingByTemplateRole = /* @__PURE__ */ new Map();
+        let routines = [];
         try {
-          const allRoleNames = [...assembleResult.allRoles ?? []].filter(Boolean).sort();
+          allRoleNames = [...assembleResult.allRoles ?? []].filter(Boolean).sort();
+          if (existingCompanyId) {
+            try {
+              const pluginId = await findPluginId(client);
+              if (pluginId) {
+                const settings = await client._fetch(
+                  `/api/plugins/${pluginId}/company-settings/${companyId}`
+                );
+                const manifestData = settings?.settingsJson?.wizardManifest ?? settings?.settings_json?.wizardManifest;
+                if (manifestData && typeof manifestData === "object") {
+                  existingManifest = manifestData;
+                }
+              }
+            } catch {
+            }
+          }
           const repositoryMode = userProjects.some(
             (project) => project?.repoUrl || project?.workspace?.sourceType === "git_repo"
           ) ? "existing git repository" : "fresh local repository";
-          const approvalMode = disableBoardApprovalOnNewCompanies ? "board approval disabled for this new company by plugin setting" : "board approval preserved; /agent-hires may create pending approvals";
+          const approvalMode = "board approval preserved; /agent-hires may create pending approvals";
           log("Creating board operations and hiring plan records...");
           const createdBoardOperationsIssue = await client.createIssue(companyId, {
             title: "Board Operations",
@@ -11749,7 +12194,7 @@ var plugin = definePlugin({
               try {
                 const ceoPatch = {
                   adapterType,
-                  adapterConfig,
+                  adapterConfig: preserveExistingSkillSync(existingCeo, adapterConfig),
                   runtimeConfig: ceoRuntimeConfig,
                   ...ceoMetadata ? { metadata: { ...existingCeo.metadata ?? {}, ...ceoMetadata } } : {}
                 };
@@ -11834,7 +12279,7 @@ var plugin = definePlugin({
           const teamRoles = [...assembleResult.allRoles ?? []].filter(
             (r) => r && r !== "ceo"
           );
-          let existingByTemplateRole = /* @__PURE__ */ new Map();
+          existingByTemplateRole = /* @__PURE__ */ new Map();
           if (existingCompanyId && teamRoles.length > 0) {
             const agents = await client.listAgents(companyId);
             if (Array.isArray(agents)) {
@@ -11869,7 +12314,7 @@ var plugin = definePlugin({
               try {
                 await client.updateAgent(existingAgent.id, {
                   adapterType,
-                  adapterConfig: roleAdapterConfig,
+                  adapterConfig: preserveExistingSkillSync(existingAgent, roleAdapterConfig),
                   runtimeConfig: roleRuntimeConfig,
                   metadata: { ...existingAgent.metadata ?? {}, ...roleMetadata },
                   ...!existingAgent.title && roleTitle ? { title: roleTitle } : {},
@@ -11882,6 +12327,14 @@ var plugin = definePlugin({
                 );
               }
               teamAgentIds[roleName] = existingAgent.id;
+              await syncAgentInstructionsIntoManagedBundle({
+                client,
+                agentId: existingAgent.id,
+                sourceDir: roleInstructionsDir,
+                entryFile: "AGENTS.md",
+                log
+              });
+              log(`\u2713 Synced ${roleTitle} instructions from latest templates`);
               continue;
             }
             const roleAgent = await client.createAgent(companyId, {
@@ -11905,8 +12358,8 @@ var plugin = definePlugin({
               );
             }
           }
+          routines = Array.isArray(assembleResult.initialRoutines) ? assembleResult.initialRoutines : [];
           if (!existingCompanyId) {
-            const routines = Array.isArray(assembleResult.initialRoutines) ? assembleResult.initialRoutines : [];
             let mainProjectId;
             const mainProject = assembleResult.mainProject;
             if (routines.length > 0 && mainProject?.name) {
@@ -11939,7 +12392,8 @@ var plugin = definePlugin({
                   assigneeAgentId,
                   projectId: mainProjectId,
                   priority: routine.priority || "medium",
-                  concurrencyPolicy: routine.concurrencyPolicy || "skip_if_active"
+                  concurrencyPolicy: routine.concurrencyPolicy || "skip_if_active",
+                  catchUpPolicy: routine.catchUpPolicy || "skip_missed"
                 });
                 if (routine.schedule && createdRoutine?.id) {
                   await client.createRoutineTrigger(createdRoutine.id, {
@@ -11957,6 +12411,15 @@ var plugin = definePlugin({
                 );
               }
             }
+          } else {
+            await syncExistingCompanyRoutines({
+              client,
+              companyId,
+              routines,
+              ceoAgentId,
+              teamAgentIds,
+              log
+            });
           }
           const bootstrapDescription = fs2.readFileSync(
             path2.join(companyDir, "BOOTSTRAP.md"),
@@ -11997,6 +12460,73 @@ var plugin = definePlugin({
         const issueIds = [boardOperationsIssue?.id, hiringPlanIssue?.id, bootstrapIssue.id].filter(
           Boolean
         );
+        try {
+          const pluginId = await findPluginId(client);
+          if (pluginId) {
+            const wizardManifest = buildWizardManifest({
+              presetName: selectedPreset?.name ?? null,
+              selectedModules: effectiveModules,
+              selectedRoleNames: allRoleNames,
+              assembleResult,
+              initialRoutines: routines
+            });
+            await client._fetch(`/api/plugins/${pluginId}/company-settings/${companyId}`, {
+              method: "PUT",
+              body: JSON.stringify({ settingsJson: { wizardManifest } })
+            });
+            log("\u2713 Wizard manifest saved");
+          } else {
+            log("\u26A0 Could not find plugin ID \u2014 manifest not saved");
+          }
+        } catch (manifestErr) {
+          log(
+            `\u26A0 Could not save wizard manifest: ${manifestErr instanceof Error ? manifestErr.message : String(manifestErr)}`
+          );
+        }
+        if (existingCompanyId && existingManifest && Array.isArray(existingManifest.roles)) {
+          const newRoleSet = new Set(allRoleNames);
+          const retiredRoles = existingManifest.roles.filter(
+            (role) => !newRoleSet.has(role)
+          );
+          for (const role of retiredRoles) {
+            try {
+              const agentData = existingByTemplateRole.get(role);
+              const agentInfo = agentData ? `**Agent ID:** ${agentData.id}
+**Agent name:** ${agentData.title || agentData.name || agentData.id}` : "_No active agent found for this role._";
+              const issueTitle = `Review retired template role: ${role}`;
+              const issueDescription = [
+                `## Retired Role: \`${role}\``,
+                "",
+                "This template role was removed from the company configuration during an update.",
+                "The agent is still active but no longer managed by the wizard.",
+                "",
+                "### Cleanup Checklist",
+                "",
+                "- [ ] Review the agent's current work and open issues",
+                "- [ ] Reassign any in-progress issues to other team members",
+                "- [ ] Consider pausing the agent's heartbeat",
+                "- [ ] Remove module-specific skill files if applicable",
+                "- [ ] Consider terminating the agent if no longer needed",
+                "",
+                agentInfo
+              ].join("\n");
+              const createdIssue = await client.createIssue(companyId, {
+                title: issueTitle,
+                description: issueDescription,
+                priority: "low",
+                status: "todo",
+                ...boardOperationsIssue?.id ? { projectId: boardOperationsIssue.id, goalId: boardOperationsIssue.id } : {}
+              });
+              log(
+                `\u2713 Retired-role review issue created for "${role}": ${createdIssue.identifier || createdIssue.id}`
+              );
+            } catch (retiredRoleErr) {
+              log(
+                `\u26A0 Could not create retired-role review issue for "${role}": ${retiredRoleErr instanceof Error ? retiredRoleErr.message : String(retiredRoleErr)}`
+              );
+            }
+          }
+        }
         return {
           companyId,
           issuePrefix: company.issuePrefix,
@@ -12039,6 +12569,7 @@ var worker_default = plugin;
 runWorker(plugin, import.meta.url);
 export {
   worker_default as default,
+  prepareLocalProjectWorkspace,
   resolveWritableCompaniesDir
 };
 //# sourceMappingURL=worker.js.map