@starlein/paperclip-plugin-company-wizard 0.4.5-a → 0.4.6

package/CHANGELOG.md

@@ -4,6 +4,32 @@ All notable changes to the Company Wizard plugin are documented here.
 
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.4.6] - 2026-06-18
+
+### Changed
+
+- **Docker path auto-detection for companiesDir and templatesPath.** The plugin now detects Docker vs. NPX installations automatically: if `~/instances` exists (Docker, where HOME=/paperclip), paths default to `~/instances/default/companies` and `~/plugin-templates`; otherwise (NPX/local), paths default to `~/.paperclip/instances/default/companies` and `~/.paperclip/plugin-templates`. Both settings are now rarely needed — the plugin picks the right layout automatically. (`src/worker.ts`, `isDockerLayout()`, `resolveWritableCompaniesDir`, `ensureTemplatesDir`.)
+- **Removed `disableBoardApprovalOnNewCompanies` setting.** This setting was never used in practice — board approval governance is always preserved for new companies. The setting has been removed from the manifest and the worker no longer reads or applies it. (`src/manifest.ts`, `src/worker.ts`.)
+- **Direct assignment flow — backlog grooming assigns issues at creation, not via routine sweep.** The backlog-health skill now instructs the PM to assign each issue to its best-fit agent as it is created. The auto-assign routine is reframed as a low-frequency safety net (every 4 hours) that catches stragglers, not the primary dispatch path. (`backlog` module, `auto-assign` module.)
+- **Engineer hands off to Product Owner on completion (without pr-review).** When the PR-review module is not active and no `executionPolicy` is set, the engineer moves the issue to `in_review` and reassigns to the Product Owner in the same heartbeat. Never leaves finished work in `in_review` assigned to itself. (`engineer` AGENTS.md, HEARTBEAT.md.)
+- **Product Owner reviews `in_review` issues immediately.** When an issue is assigned to the PM in `in_review` and no formal executionPolicy participant is waiting, the PM reviews it against acceptance criteria and sets it `done` or sends it back to the engineer. (`product-owner` AGENTS.md, HEARTBEAT.md.)
+- **Engineer merges feature branches to base when no PR review is active.** The `github-repo` git-workflow skill now has an explicit direct-to-base-ref flow: push branch → checkout base → merge → push base → delete branch. (`github-repo` module.)
+- **Git identity uses real user profile instead of "Paperclip Bootstrap".** The initial empty commit in fresh repositories now uses the board user's name and email (resolved from the Paperclip session) instead of the hardcoded "Paperclip Bootstrap / bootstrap@paperclip.local". Falls back to "Paperclip Bootstrap" when no session is available (local_trusted mode). (`src/api/client.js`, `src/worker.ts`, `src/logic/assemble.js`.)
+- **Engineer claims unassigned engineering work as a fallback.** When no actionable work is assigned and unassigned `todo` issues clearly match engineering, the engineer claims the highest-priority ready issue. (`engineer` AGENTS.md.)
+- **Manifest setting descriptions updated.** `companiesDir` and `templatesPath` now document auto-detection behavior. `templatesRepoUrl` now notes that the default is correct for most setups. (`src/manifest.ts`.)
+
+### Fixed
+
+- **Branches no longer dangle unmerged without a PR review module.** The git-workflow skill previously instructed engineers to "push to the correct configured base branch" but did not explain how to merge a feature branch back to base. Without a PR review module, branches were pushed but never merged, leaving `main` stale and the team stuck. The skill now includes explicit merge-and-push steps for the no-review case.
+- **Auto-assign README and heartbeat-section schedule wording.** "Every few hours" was replaced with the actual cron schedule "every 4 hours" to match the `0 */4 * * *` routine. (`auto-assign` module.)
+- **github-repo README now matches the actual direct-to-base-ref skill.** The README previously said "commits directly on the default branch, no branches" but the skill uses a feature branch + merge-to-base flow. (`github-repo` README.)
+
+### Removed
+
+- `disableBoardApprovalOnNewCompanies` plugin setting. Board approval governance is always preserved for new companies — this toggle was never used in practice.
+
+---
+
 ## [0.4.5] - 2026-06-16
 
 ### Fixed

package/README.md

@@ -15,7 +15,7 @@
 
 ---
 
-> **Fork:** This is a community-maintained fork of [yesterday-AI/paperclip-plugin-company-wizard](https://github.com/yesterday-AI/paperclip-plugin-company-wizard), updated for the current Paperclip API (`>=2026.529.0`) with substantial bug fixes. End-to-end company setup is governed through current Paperclip workflows as of v0.4.5.
+> **Fork:** This is a community-maintained fork of [yesterday-AI/paperclip-plugin-company-wizard](https://github.com/yesterday-AI/paperclip-plugin-company-wizard), updated for the current Paperclip API (`>=2026.529.0`) with substantial bug fixes. End-to-end company setup is governed through current Paperclip workflows as of v0.4.6.
 
 <details>
 <summary><strong>What changed vs. upstream</strong></summary>

package/dist/manifest.js

@@ -2,7 +2,7 @@
 var manifest = {
   id: "starlein.paperclip-plugin-company-wizard",
   apiVersion: 1,
-  version: "0.4.5",
+  version: "0.4.6",
   displayName: "Company Wizard",
   description: "AI-powered wizard to bootstrap agent companies from composable templates",
   author: "Sascha Pietrowski <sp@speednetwork.de>",
@@ -28,16 +28,16 @@ var manifest = {
     properties: {
       companiesDir: {
         type: "string",
-        description: "Directory where assembled company workspaces are written. Defaults to ~/.paperclip/instances/default/companies. Override for Docker setups (e.g. /paperclip/instances/default/companies)."
+        description: "Directory where assembled company workspaces are written. Auto-detected: ~/instances/default/companies in Docker setups, ~/.paperclip/instances/default/companies otherwise. Rarely needs manual override."
       },
       templatesPath: {
         type: "string",
-        description: "Path to the templates directory. Defaults to ~/.paperclip/plugin-templates (auto-downloaded from templatesRepoUrl if missing). Override for Docker setups (e.g. /paperclip/plugin-templates)."
+        description: "Path to the templates directory. Auto-detected: ~/plugin-templates in Docker setups, ~/.paperclip/plugin-templates otherwise. Rarely needs manual override."
       },
       templatesRepoUrl: {
         type: "string",
         default: "https://github.com/starlein/paperclip-plugin-company-wizard/tree/main/templates",
-        description: "GitHub tree URL to pull templates from when the templates directory does not exist."
+        description: "GitHub tree URL for template downloads. The default is correct for most setups \u2014 only change this if using a custom fork."
       },
       anthropicApiKey: {
         type: "string",
@@ -54,11 +54,6 @@ var manifest = {
       paperclipPassword: {
         type: "string",
         description: "Board login password (for authenticated instances)."
-      },
-      disableBoardApprovalOnNewCompanies: {
-        type: "boolean",
-        default: false,
-        description: "Optional. If true, the wizard will PATCH new companies to set requireBoardApprovalForNewAgents=false during provisioning. Leave false to preserve approval-gated hiring policies."
       }
     }
   },

package/dist/manifest.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/manifest.ts"],
-  "sourcesContent": ["import type { PaperclipPluginManifestV1 } from '@paperclipai/plugin-sdk';\n\nconst manifest: PaperclipPluginManifestV1 = {\n  id: 'starlein.paperclip-plugin-company-wizard',\n  apiVersion: 1,\n  version: '0.4.5',\n  displayName: 'Company Wizard',\n  description: 'AI-powered wizard to bootstrap agent companies from composable templates',\n  author: 'Sascha Pietrowski <sp@speednetwork.de>',\n  categories: ['workspace', 'ui'],\n  capabilities: [\n    'companies.read',\n    'issues.create',\n    'issues.read',\n    'issues.update',\n    'goals.create',\n    'goals.read',\n    'agents.read',\n    'projects.read',\n    'plugin.state.read',\n    'plugin.state.write',\n    'secrets.read-ref',\n    'events.subscribe',\n    'ui.page.register',\n    'ui.sidebar.register',\n  ],\n  instanceConfigSchema: {\n    type: 'object',\n    properties: {\n      companiesDir: {\n        type: 'string',\n        description:\n          'Directory where assembled company workspaces are written. Defaults to ~/.paperclip/instances/default/companies. Override for Docker setups (e.g. /paperclip/instances/default/companies).',\n      },\n      templatesPath: {\n        type: 'string',\n        description:\n          'Path to the templates directory. Defaults to ~/.paperclip/plugin-templates (auto-downloaded from templatesRepoUrl if missing). Override for Docker setups (e.g. /paperclip/plugin-templates).',\n      },\n      templatesRepoUrl: {\n        type: 'string',\n        default: 'https://github.com/starlein/paperclip-plugin-company-wizard/tree/main/templates',\n        description:\n          'GitHub tree URL to pull templates from when the templates directory does not exist.',\n      },\n      anthropicApiKey: {\n        type: 'string',\n        description:\n          'Anthropic API key for the AI wizard (e.g. sk-ant-...). Required to use the AI-powered company setup path.',\n      },\n      paperclipUrl: {\n        type: 'string',\n        description:\n          'Paperclip instance URL. Defaults to http://localhost:3100 or the PAPERCLIP_PUBLIC_URL env var.',\n      },\n      paperclipEmail: {\n        type: 'string',\n        description: 'Board login email (for authenticated instances).',\n      },\n      paperclipPassword: {\n        type: 'string',\n        description: 'Board login password (for authenticated instances).',\n      },\n      disableBoardApprovalOnNewCompanies: {\n        type: 'boolean',\n        default: false,\n        description:\n          'Optional. If true, the wizard will PATCH new companies to set requireBoardApprovalForNewAgents=false during provisioning. Leave false to preserve approval-gated hiring policies.',\n      },\n    },\n  },\n  entrypoints: {\n    worker: './dist/worker.js',\n    ui: './dist/ui',\n  },\n  ui: {\n    slots: [\n      {\n        type: 'page',\n        id: 'company-wizard',\n        displayName: 'Company Wizard',\n        exportName: 'WizardPage',\n        routePath: 'company-creator',\n      },\n      {\n        type: 'sidebar',\n        id: 'company-wizard-link',\n        displayName: 'Create Company',\n        exportName: 'SidebarLink',\n      },\n    ],\n  },\n};\n\nexport default manifest;\n"],
-  "mappings": ";AAEA,IAAM,WAAsC;AAAA,EAC1C,IAAI;AAAA,EACJ,YAAY;AAAA,EACZ,SAAS;AAAA,EACT,aAAa;AAAA,EACb,aAAa;AAAA,EACb,QAAQ;AAAA,EACR,YAAY,CAAC,aAAa,IAAI;AAAA,EAC9B,cAAc;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,sBAAsB;AAAA,IACpB,MAAM;AAAA,IACN,YAAY;AAAA,MACV,cAAc;AAAA,QACZ,MAAM;AAAA,QACN,aACE;AAAA,MACJ;AAAA,MACA,eAAe;AAAA,QACb,MAAM;AAAA,QACN,aACE;AAAA,MACJ;AAAA,MACA,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,SAAS;AAAA,QACT,aACE;AAAA,MACJ;AAAA,MACA,iBAAiB;AAAA,QACf,MAAM;AAAA,QACN,aACE;AAAA,MACJ;AAAA,MACA,cAAc;AAAA,QACZ,MAAM;AAAA,QACN,aACE;AAAA,MACJ;AAAA,MACA,gBAAgB;AAAA,QACd,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA,mBAAmB;AAAA,QACjB,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA,oCAAoC;AAAA,QAClC,MAAM;AAAA,QACN,SAAS;AAAA,QACT,aACE;AAAA,MACJ;AAAA,IACF;AAAA,EACF;AAAA,EACA,aAAa;AAAA,IACX,QAAQ;AAAA,IACR,IAAI;AAAA,EACN;AAAA,EACA,IAAI;AAAA,IACF,OAAO;AAAA,MACL;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,YAAY;AAAA,QACZ,WAAW;AAAA,MACb;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,YAAY;AAAA,MACd;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,mBAAQ;",
+  "sourcesContent": ["import type { PaperclipPluginManifestV1 } from '@paperclipai/plugin-sdk';\n\nconst manifest: PaperclipPluginManifestV1 = {\n  id: 'starlein.paperclip-plugin-company-wizard',\n  apiVersion: 1,\n  version: '0.4.6',\n  displayName: 'Company Wizard',\n  description: 'AI-powered wizard to bootstrap agent companies from composable templates',\n  author: 'Sascha Pietrowski <sp@speednetwork.de>',\n  categories: ['workspace', 'ui'],\n  capabilities: [\n    'companies.read',\n    'issues.create',\n    'issues.read',\n    'issues.update',\n    'goals.create',\n    'goals.read',\n    'agents.read',\n    'projects.read',\n    'plugin.state.read',\n    'plugin.state.write',\n    'secrets.read-ref',\n    'events.subscribe',\n    'ui.page.register',\n    'ui.sidebar.register',\n  ],\n  instanceConfigSchema: {\n    type: 'object',\n    properties: {\n      companiesDir: {\n        type: 'string',\n        description:\n          'Directory where assembled company workspaces are written. Auto-detected: ~/instances/default/companies in Docker setups, ~/.paperclip/instances/default/companies otherwise. Rarely needs manual override.',\n      },\n      templatesPath: {\n        type: 'string',\n        description:\n          'Path to the templates directory. Auto-detected: ~/plugin-templates in Docker setups, ~/.paperclip/plugin-templates otherwise. Rarely needs manual override.',\n      },\n      templatesRepoUrl: {\n        type: 'string',\n        default: 'https://github.com/starlein/paperclip-plugin-company-wizard/tree/main/templates',\n        description:\n          'GitHub tree URL for template downloads. The default is correct for most setups \u2014 only change this if using a custom fork.',\n      },\n      anthropicApiKey: {\n        type: 'string',\n        description:\n          'Anthropic API key for the AI wizard (e.g. sk-ant-...). Required to use the AI-powered company setup path.',\n      },\n      paperclipUrl: {\n        type: 'string',\n        description:\n          'Paperclip instance URL. Defaults to http://localhost:3100 or the PAPERCLIP_PUBLIC_URL env var.',\n      },\n      paperclipEmail: {\n        type: 'string',\n        description: 'Board login email (for authenticated instances).',\n      },\n      paperclipPassword: {\n        type: 'string',\n        description: 'Board login password (for authenticated instances).',\n      },\n    },\n  },\n  entrypoints: {\n    worker: './dist/worker.js',\n    ui: './dist/ui',\n  },\n  ui: {\n    slots: [\n      {\n        type: 'page',\n        id: 'company-wizard',\n        displayName: 'Company Wizard',\n        exportName: 'WizardPage',\n        routePath: 'company-creator',\n      },\n      {\n        type: 'sidebar',\n        id: 'company-wizard-link',\n        displayName: 'Create Company',\n        exportName: 'SidebarLink',\n      },\n    ],\n  },\n};\n\nexport default manifest;\n"],
+  "mappings": ";AAEA,IAAM,WAAsC;AAAA,EAC1C,IAAI;AAAA,EACJ,YAAY;AAAA,EACZ,SAAS;AAAA,EACT,aAAa;AAAA,EACb,aAAa;AAAA,EACb,QAAQ;AAAA,EACR,YAAY,CAAC,aAAa,IAAI;AAAA,EAC9B,cAAc;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,sBAAsB;AAAA,IACpB,MAAM;AAAA,IACN,YAAY;AAAA,MACV,cAAc;AAAA,QACZ,MAAM;AAAA,QACN,aACE;AAAA,MACJ;AAAA,MACA,eAAe;AAAA,QACb,MAAM;AAAA,QACN,aACE;AAAA,MACJ;AAAA,MACA,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,SAAS;AAAA,QACT,aACE;AAAA,MACJ;AAAA,MACA,iBAAiB;AAAA,QACf,MAAM;AAAA,QACN,aACE;AAAA,MACJ;AAAA,MACA,cAAc;AAAA,QACZ,MAAM;AAAA,QACN,aACE;AAAA,MACJ;AAAA,MACA,gBAAgB;AAAA,QACd,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA,mBAAmB;AAAA,QACjB,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,IACF;AAAA,EACF;AAAA,EACA,aAAa;AAAA,IACX,QAAQ;AAAA,IACR,IAAI;AAAA,EACN;AAAA,EACA,IAAI;AAAA,IACF,OAAO;AAAA,MACL;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,YAAY;AAAA,QACZ,WAAW;AAAA,MACb;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,YAAY;AAAA,MACd;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,mBAAQ;",
   "names": []
 }

package/dist/worker.js

@@ -9415,6 +9415,8 @@ async function assembleCompany({
   presetLabels = [],
   enableIsolatedWorktrees = false,
   enableEnrichedPersonas = true,
+  gitUserName,
+  gitUserEmail,
   outputDir,
   templatesDir,
   onProgress = () => {
@@ -10080,7 +10082,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;
@@ -10449,6 +10453,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 +10496,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 +10512,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;
@@ -10772,6 +10782,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 +10809,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 +11002,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.6";
 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 +11050,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 +11060,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 +11181,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 +11225,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) {
@@ -11215,7 +11257,7 @@ 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) {
+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() : "";
@@ -11233,14 +11275,16 @@ function prepareLocalProjectWorkspace(mainProject, companyDir, log) {
     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=bootstrap@paperclip.local",
+      `user.email=${gitUserEmail}`,
       "-c",
-      "user.name=Paperclip Bootstrap",
+      `user.name=${gitUserName}`,
       "commit",
       "--allow-empty",
       "-m",
@@ -11307,6 +11351,110 @@ async function syncAgentInstructionsIntoManagedBundle({
     );
   }
 }
+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 "";
+}
+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,
@@ -11590,10 +11738,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() : "";
@@ -11616,6 +11760,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() : "";
@@ -11636,6 +11791,8 @@ var plugin = definePlugin({
           presetLabels: presetBootstrapData.labels,
           enableIsolatedWorktrees,
           enableEnrichedPersonas,
+          gitUserName: gitIdentity.name || void 0,
+          gitUserEmail: gitIdentity.email || void 0,
           outputDir,
           templatesDir,
           onProgress: log
@@ -11653,21 +11810,13 @@ var plugin = definePlugin({
             log(`\u270E Override: ${relPath}`);
           }
         }
-        prepareLocalProjectWorkspace(assembleResult.mainProject, companyDir, log);
+        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;
@@ -11686,19 +11835,7 @@ 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 = {};
@@ -11710,7 +11847,7 @@ var plugin = definePlugin({
           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",
@@ -11926,6 +12063,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, {
@@ -11949,8 +12094,8 @@ var plugin = definePlugin({
               );
             }
           }
+          const 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) {
@@ -11983,7 +12128,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, {
@@ -12001,6 +12147,15 @@ var plugin = definePlugin({
                 );
               }
             }
+          } else {
+            await syncExistingCompanyRoutines({
+              client,
+              companyId,
+              routines,
+              ceoAgentId,
+              teamAgentIds,
+              log
+            });
           }
           const bootstrapDescription = fs2.readFileSync(
             path2.join(companyDir, "BOOTSTRAP.md"),