@starlein/paperclip-plugin-company-wizard 0.4.1 → 0.4.3

package/CHANGELOG.md

@@ -4,6 +4,29 @@ 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.3] - 2026-06-16
+
+### Fixed
+
+- **Worker agents are no longer provisioned with `high` thinking.** Non-CEO agents were built with `buildCeoAdapterConfig`, which defaulted `thinkingLevel`/`modelReasoningEffort` to the CEO default (`high`) for every role — expensive and unnecessary for routine work. A new `buildWorkerAdapterConfig` (with `DEFAULT_WORKER_THINKING_LEVEL = 'medium'`) builds worker adapter config: workers default to `medium`, do not inherit a user-configured CEO thinking level, and a role can still raise its level via its `role.meta.json` adapter override. The CEO is unchanged (`high`).
+- **Board Operations and Hiring Plan issues are no longer orphaned.** They are created before the CEO exists, so they could not be assigned at creation time. `start-provision` now assigns both governance issues to the CEO right after the CEO agent is available (best-effort), so they are actionable instead of unassigned.
+
+### Changed
+
+- **The Hiring Plan issue is now a review checkpoint, not a re-hiring task.** `buildHiringPlanBody` was rewritten to state explicitly that the initial team was already submitted as governed `/agent-hires` (pending approval where the board requires it, never auto-approved) and to give the CEO concrete tasks: review each provisioned agent against the `paperclip-create-agent` draft-review checklist, approve/reject the pending hires, and only hire for genuine remaining gaps. This makes the `disableBoardApprovalOnNewCompanies` setting meaningful: left `false`, the wizard's hires land as pending approvals the CEO works through this issue.
+
+### Added
+
+- `scripts/patch-active-company.mjs` — idempotent maintenance script that patches an already-provisioned company in place to the current defaults: sets worker agents to `medium` thinking and assigns the Board Operations / Hiring Plan issues to the CEO. Supports `--dry-run` and `--thinking=<level>`.
+
+---
+## [0.4.2] - 2026-06-15
+
+### Fixed
+
+- **Existing-company provisioning no longer fails while creating governance records.** Board Operations and Hiring Plan are now created as unassigned `todo` issues because Paperclip rejects unassigned `in_progress` issues.
+
 ---
 ## [0.4.1] - 2026-06-15
 

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.1.
+> **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.3.
 
 <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.1",
+  version: "0.4.3",
   displayName: "Company Wizard",
   description: "AI-powered wizard to bootstrap agent companies from composable templates",
   author: "Sascha Pietrowski <sp@speednetwork.de>",

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.1',\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"],
+  "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.3',\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;",
   "names": []
 }

package/dist/worker.js

@@ -9282,6 +9282,7 @@ import { join } from "node:path";
 var DEFAULT_CEO_ADAPTER_TYPE = "codex_local";
 var DEFAULT_CEO_MODEL = "gpt-5.5";
 var DEFAULT_CEO_THINKING_LEVEL = "high";
+var DEFAULT_WORKER_THINKING_LEVEL = "medium";
 var DEFAULT_CEO_MAX_CONCURRENT_RUNS = 1;
 var DEFAULT_CEO_HEARTBEAT_INTERVAL_SEC = 3600;
 var DEFAULT_CLAUDE_CEO_MODEL = "claude-opus-4-6";
@@ -9291,10 +9292,12 @@ function asTrimmedString(value) {
 function normalizeCeoAdapterType(userCeoAdapter = {}) {
   return asTrimmedString(userCeoAdapter.type) || DEFAULT_CEO_ADAPTER_TYPE;
 }
-function buildCeoAdapterConfig({
+function buildAdapterConfig({
   userCeoAdapter = {},
   companyDir,
-  roleAdapterOverrides = {}
+  roleAdapterOverrides = {},
+  defaultThinkingLevel = DEFAULT_CEO_THINKING_LEVEL,
+  inheritUserThinking = true
 } = {}) {
   const adapterType = normalizeCeoAdapterType(userCeoAdapter);
   const userCwd = asTrimmedString(userCeoAdapter.cwd);
@@ -9302,7 +9305,8 @@ function buildCeoAdapterConfig({
   const overrideModel = asTrimmedString(roleAdapterOverrides.model);
   const defaultModel = adapterType === "claude_local" ? DEFAULT_CLAUDE_CEO_MODEL : DEFAULT_CEO_MODEL;
   const model = userModel || overrideModel || defaultModel;
-  const thinkingLevel = asTrimmedString(userCeoAdapter.thinkingLevel) || asTrimmedString(userCeoAdapter.modelReasoningEffort) || asTrimmedString(userCeoAdapter.reasoningEffort) || asTrimmedString(roleAdapterOverrides.thinkingLevel) || asTrimmedString(roleAdapterOverrides.modelReasoningEffort) || asTrimmedString(roleAdapterOverrides.reasoningEffort) || DEFAULT_CEO_THINKING_LEVEL;
+  const userThinking = inheritUserThinking ? asTrimmedString(userCeoAdapter.thinkingLevel) || asTrimmedString(userCeoAdapter.modelReasoningEffort) || asTrimmedString(userCeoAdapter.reasoningEffort) : "";
+  const thinkingLevel = userThinking || asTrimmedString(roleAdapterOverrides.thinkingLevel) || asTrimmedString(roleAdapterOverrides.modelReasoningEffort) || asTrimmedString(roleAdapterOverrides.reasoningEffort) || defaultThinkingLevel;
   const adapterConfig = {
     ...roleAdapterOverrides,
     cwd: userCwd || companyDir,
@@ -9319,6 +9323,20 @@ function buildCeoAdapterConfig({
   }
   return adapterConfig;
 }
+function buildCeoAdapterConfig(opts = {}) {
+  return buildAdapterConfig({
+    ...opts,
+    defaultThinkingLevel: DEFAULT_CEO_THINKING_LEVEL,
+    inheritUserThinking: true
+  });
+}
+function buildWorkerAdapterConfig(opts = {}) {
+  return buildAdapterConfig({
+    ...opts,
+    defaultThinkingLevel: DEFAULT_WORKER_THINKING_LEVEL,
+    inheritUserThinking: false
+  });
+}
 function buildCeoAgentRuntimeConfig() {
   return {
     heartbeat: {
@@ -10939,7 +10957,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.1";
+var CURRENT_PLUGIN_VERSION = "0.4.2";
 var NPM_LATEST_URL = "https://registry.npmjs.org/@starlein%2Fpaperclip-plugin-company-wizard/latest";
 function copyDirSync(src, dest) {
   fs2.mkdirSync(dest, { recursive: true });
@@ -11266,23 +11284,36 @@ function buildHiringPlanBody({
 
 Generated by Company Wizard on ${today}.
 
-## Instruction Source
+## Status: initial team already provisioned
+
+Company Wizard has already submitted the initial team below as **governed hires**
+via \`/agent-hires\` (each with a full instruction bundle assembled from curated role
+templates). Where the board requires approval, those hires are pending your approval \u2014
+they were **not** auto-approved.
+
+**This issue is your review checkpoint \u2014 not a re-hiring task.** Do not create the
+roles below again.
+
+## Your tasks
 
-Company Wizard uses curated role templates from its template library. When proposing additional hires after bootstrap, follow the Paperclip \`paperclip-create-agent\` workflow: choose an exact, adjacent, or generic template; run the draft-review checklist; submit via \`/agent-hires\`; link this issue as \`sourceIssueId\`; and wait for board approval when required.
+1. **Review each provisioned agent against the draft-review checklist** (Paperclip
+   \`paperclip-create-agent\` \u2192 \`references/draft-review-checklist.md\`): instruction
+   quality, correct adapter/model/thinking level, escalation/reportsTo path, and
+   desiredSkills justification. Note any corrections in the decision log.
+2. **Approve or reject** the pending hires accordingly.
+3. **Only hire for genuine gaps.** If a capability is missing after the first
+   roadmap/backlog pass, follow the \`paperclip-create-agent\` workflow: pick an exact,
+   adjacent, or generic template, run the draft-review checklist, submit via
+   \`/agent-hires\` with a concrete AGENTS.md draft + adapter config + desiredSkills
+   justification, and set \`sourceIssueId\` to this issue.
 
-## Initial Roles
+## Initial Roles (already provisioned)
 
 ${roles.map((role) => `- ${formatRoleName(role)}`).join("\n")}
 
 ## Selected Modules
 
 ${moduleNames.length > 0 ? moduleNames.map((mod) => `- ${mod}`).join("\n") : "- none"}
-
-## Follow-up Review
-
-- Reassess capacity after the first roadmap/backlog pass.
-- Do not hire for capabilities already covered by existing roles.
-- If a gap remains, submit a governed hire request with a concrete AGENTS.md draft, adapter config, desiredSkills justification, and sourceIssueId pointing to this hiring plan issue.
 `;
 }
 var plugin = definePlugin({
@@ -11628,7 +11659,10 @@ var plugin = definePlugin({
           const createdBoardOperationsIssue = await client.createIssue(companyId, {
             title: "Board Operations",
             description: "Standing issue for board decision log and operations tracking.",
-            status: "in_progress",
+            // These governance records are created before the CEO is guaranteed to exist.
+            // Paperclip requires an assignee for in_progress issues, so keep them unassigned
+            // and actionable later rather than failing existing-company provisioning.
+            status: "todo",
             priority: "medium"
           });
           boardOperationsIssue = createdBoardOperationsIssue;
@@ -11651,7 +11685,7 @@ var plugin = definePlugin({
           const createdHiringPlanIssue = await client.createIssue(companyId, {
             title: "Hiring Plan",
             description: "Develop and execute the governed team hiring plan.",
-            status: "in_progress",
+            status: "todo",
             priority: "high"
           });
           hiringPlanIssue = createdHiringPlanIssue;
@@ -11771,6 +11805,20 @@ var plugin = definePlugin({
             fallbackEntryContent: ceoPromptTemplate,
             log
           });
+          for (const govIssue of [
+            { issue: boardOperationsIssue, label: "Board Operations" },
+            { issue: hiringPlanIssue, label: "Hiring Plan" }
+          ]) {
+            if (!govIssue.issue?.id) continue;
+            try {
+              await client.updateIssue(govIssue.issue.id, { assigneeAgentId: ceoAgentId });
+              log(`\u2713 Assigned ${govIssue.label} issue to CEO`);
+            } catch (assignErr) {
+              log(
+                `\u26A0 Could not assign ${govIssue.label} issue to CEO: ${assignErr instanceof Error ? assignErr.message : String(assignErr)}`
+              );
+            }
+          }
           const teamRoles = [...assembleResult.allRoles ?? []].filter(
             (r) => r && r !== "ceo"
           );
@@ -11796,7 +11844,7 @@ var plugin = definePlugin({
               ...roleDescription ? { description: roleDescription } : {}
             };
             const roleRuntimeConfig = buildWorkerAgentRuntimeConfig();
-            const roleAdapterConfig = buildCeoAdapterConfig({
+            const roleAdapterConfig = buildWorkerAdapterConfig({
               userCeoAdapter,
               companyDir,
               roleAdapterOverrides: assembleResult.roleAdapterOverrides?.get(roleName) ?? {}