@indigoai-us/hq-cli 5.311.3 → 5.311.4

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## [Unreleased]
 
+## [5.311.4] — 2026-10-02
+- Preserve existing local company starter files during cloud provisioning by having the CLI request that hq-pro skip blank starter seeding; older servers are detected before company creation.
+
 ## [5.311.3] — 2026-10-01
 - Match company file access checks against the company-anchored paths printed by `hq files browse`.
 - Record a placement resolved to the current host as local so the lane starts without dispatching back through Outpost pickup.

package/dist/commands/cloud-provision.d.ts

@@ -135,6 +135,8 @@ export interface VaultClient {
     checkSlugInMyNamespace(slug: string): Promise<{
         available: boolean;
         conflictingCompanyUid?: string;
+        /** Older hq-pro servers omit this field; absence means unsupported. */
+        skipStarterSeedSupported?: boolean;
     }>;
     /** Fetch a company entity by uid. Used to materialize the entity
      * after `checkSlugInMyNamespace` reports a same-namespace collision. */
@@ -143,6 +145,7 @@ export interface VaultClient {
         slug: string;
         name: string;
         ownerUid?: string;
+        skipStarterSeed?: boolean;
     }): Promise<VaultEntity>;
     /**
      * Soft-tombstone a company (`DELETE /entity/{uid}`). Owner-only. Leaves the

package/dist/commands/cloud-provision.js

@@ -34,6 +34,25 @@ import * as yaml from "js-yaml";
 import { parseUserYaml } from "../utils/user-yaml-error.js";
 import { createSyncProgressRecorder, share, } from "@indigoai-us/hq-cloud";
 import { DEFAULT_HQ_ROOT, DEFAULT_VAULT_API_URL, ensureCognitoToken, buildVaultConfig, } from "../utils/cognito-session.js";
+const SHARED_COMPANY_STARTER_PATHS = [
+    "README.md",
+    "board.json",
+    "knowledge/README.md",
+    "knowledge/design-styles/packs/.gitkeep",
+    "people/.gitkeep",
+    "policies/.gitkeep",
+    "projects/.gitkeep",
+    "repos/.gitkeep",
+    "skills/.gitkeep",
+    "sources/meetings/source.yaml",
+    "workspace/.gitignore",
+    "workspace/index.jsonl",
+    "workspace/sessions/.gitkeep",
+];
+function hasLocalSharedStarterPath(hqRoot, slug) {
+    const companyDir = path.join(hqRoot, "companies", slug);
+    return SHARED_COMPANY_STARTER_PATHS.some((relativePath) => fs.existsSync(path.join(companyDir, relativePath)));
+}
 /** Custom error class so the CLI runner can map to exit codes. */
 export class ProvisionError extends Error {
     code;
@@ -333,7 +352,11 @@ export function createDefaultVaultClient(apiUrl, accessToken) {
                     const body = await safeBody(res);
                     throw new ProvisionError(1, `Vault GET /entity/check-slug/me failed: ${res.status} ${res.statusText} — ${body}`);
                 }
-                return (await res.json());
+                const data = (await res.json());
+                return {
+                    ...data,
+                    skipStarterSeedSupported: data.skipStarterSeedSupported === true,
+                };
             });
         },
         async getCompanyByUid(uid) {
@@ -359,6 +382,8 @@ export function createDefaultVaultClient(apiUrl, accessToken) {
             };
             if (input.ownerUid)
                 body.ownerUid = input.ownerUid;
+            if (input.skipStarterSeed)
+                body.skipStarterSeed = true;
             return withVaultRequest(url, {
                 method: "POST",
                 headers,
@@ -548,6 +573,7 @@ export async function provisionCompany(options) {
     // match the caller's own person UID(s) from `listMyPersonEntities`.
     const callerOwnedUids = new Set(persons.map((p) => p.uid));
     const callerIsOwner = !options.ownerUid || callerOwnedUids.has(options.ownerUid);
+    const hasLocalSharedStarterFiles = hasLocalSharedStarterPath(options.hqRoot, options.slug);
     let entity;
     let createdEntity = false;
     if (callerIsOwner) {
@@ -557,17 +583,24 @@ export async function provisionCompany(options) {
             entity = await vaultClient.getCompanyByUid(slugCheck.conflictingCompanyUid);
         }
         else {
+            if (hasLocalSharedStarterFiles && !slugCheck.skipStarterSeedSupported) {
+                throw new ProvisionError(1, "This hq-pro server does not support preserving local starter files during cloud provisioning; update hq-pro and retry");
+            }
             log(`slug available in caller's namespace — creating vault entity`);
             entity = await vaultClient.createCompanyEntity({
                 slug: options.slug,
                 name: options.name ?? options.slug,
                 ownerUid: options.ownerUid,
+                ...(hasLocalSharedStarterFiles ? { skipStarterSeed: true } : {}),
             });
             createdEntity = true;
             log(`created vault entity uid=${entity.uid}`);
         }
     }
     else {
+        if (hasLocalSharedStarterFiles) {
+            throw new ProvisionError(1, "Cannot preserve local starter files when provisioning for a different owner");
+        }
         log(`--owner ${options.ownerUid} differs from caller's person(s); skipping namespace pre-check (server authoritatively gates per-target-namespace)`);
         entity = await vaultClient.createCompanyEntity({
             slug: options.slug,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.311.3",
+  "version": "5.311.4",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {