@kb-labs/shared 1.1.0

package/prettierrc.json

@@ -0,0 +1 @@
+{ "extends": "@kb-labs/devkit/prettier" }

package/scripts/devkit-sync.mjs

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import { resolve } from 'node:path';
+import { access } from 'node:fs/promises';
+import { spawn } from 'node:child_process';
+
+async function tryApi(args) {
+  try {
+    const mod = await import('@kb-labs/devkit/sync');
+    if (typeof mod.run === 'function') {
+      const code = await mod.run({ args });
+      if (typeof code === 'number' && code !== 0) process.exit(code);
+      return true;
+    }
+  } catch { }
+  return false;
+}
+
+async function tryBin(args) {
+  const isWin = process.platform === 'win32';
+  const binName = isWin ? 'kb-devkit-sync.cmd' : 'kb-devkit-sync';
+  const binPath = resolve(process.cwd(), 'node_modules', '.bin', binName);
+  try { await access(binPath); } catch { return false; }
+
+  await new Promise((res, rej) => {
+    const cp = spawn(binPath, args, { stdio: 'inherit', shell: false });
+    cp.on('close', (code) => (code === 0 ? res() : rej(Object.assign(new Error('sync failed'), { code }))));
+  });
+  return true;
+}
+
+(async () => {
+  const args = process.argv.slice(2);
+  if (await tryApi(args)) process.exit(0);
+  if (await tryBin(args)) process.exit(0);
+  console.error('[devkit-sync] DevKit is not installed. Add @kb-labs/devkit to devDependencies.');
+  process.exit(1);
+})();

package/scripts/hooks/post-push

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# Post-push hook — managed by kb-labs-devkit, do not edit manually.
+#
+# Note: DevLink undo was removed here — npm switch no longer runs
+# during push, so there is nothing to restore. npm mode is only
+# used during `npm publish` (managed by Release Manager).
+
+# No-op for now. Add project-specific post-push actions here if needed.
+exit 0

package/scripts/hooks/pre-commit

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# Pre-commit hook — managed by kb-labs-devkit, do not edit manually.
+#
+# Note: DevLink npm switch was removed — npm mode is only needed
+# for `npm publish`, not for git commits. Release Manager handles
+# the npm switch during the publish flow.
+
+# No-op for now. Add project-specific pre-commit checks here if needed.
+exit 0

package/scripts/hooks/pre-push

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# Pre-push hook — managed by kb-labs-devkit, do not edit manually.
+#
+# Note: DevLink npm switch was removed — git push only contains
+# submodule pointers or source code, not published package.json.
+# npm mode switch is only needed during `npm publish` (Release Manager).
+
+# No-op for now. Add project-specific pre-push checks here if needed.
+exit 0

package/tsconfig.base.json

@@ -0,0 +1,9 @@
+{
+  "extends": [
+    "@kb-labs/devkit/tsconfig/base.json",
+    "./tsconfig.paths.json"
+  ],
+  "compilerOptions": {
+    "baseUrl": "."
+  }
+}

package/tsconfig.build.json

@@ -0,0 +1,15 @@
+{
+  "extends": "tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "baseUrl": ".",
+    "paths": {}
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "dist",
+    "node_modules"
+  ]
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "@kb-labs/devkit/tsconfig/node.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}

package/tsconfig.paths.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@kb-labs/core-platform": [
+        "../kb-labs-core/packages/core-platform/src/index.ts"
+      ],
+      "@kb-labs/core-platform/*": [
+        "../kb-labs-core/packages/core-platform/src/*"
+      ],
+      "@kb-labs/core-resource-broker": [
+        "../kb-labs-core/packages/core-resource-broker/src/index.ts"
+      ],
+      "@kb-labs/core-resource-broker/*": [
+        "../kb-labs-core/packages/core-resource-broker/src/*"
+      ],
+      "@kb-labs/core-runtime": [
+        "../kb-labs-core/packages/core-runtime/src/index.ts"
+      ],
+      "@kb-labs/core-runtime/*": [
+        "../kb-labs-core/packages/core-runtime/src/*"
+      ],
+      "@kb-labs/plugin-contracts": [
+        "../../infra/kb-labs-plugin/packages/plugin-contracts/src/index.ts"
+      ],
+      "@kb-labs/plugin-contracts/*": [
+        "../../infra/kb-labs-plugin/packages/plugin-contracts/src/*"
+      ],
+      "@kb-labs/plugin-runtime": [
+        "../../infra/kb-labs-plugin/packages/plugin-runtime/src/index.ts"
+      ],
+      "@kb-labs/plugin-runtime/*": [
+        "../../infra/kb-labs-plugin/packages/plugin-runtime/src/*"
+      ],
+      "@kb-labs/shared-cli-ui": [
+        "packages/shared-cli-ui/src/index.ts"
+      ],
+      "@kb-labs/shared-cli-ui/*": [
+        "packages/shared-cli-ui/src/*"
+      ],
+      "@kb-labs/studio-contracts": [
+        "../kb-labs-studio/packages/studio-contracts/src/index.ts"
+      ],
+      "@kb-labs/studio-contracts/*": [
+        "../kb-labs-studio/packages/studio-contracts/src/*"
+      ]
+    }
+  }
+}

package/tsconfig.tools.json

@@ -0,0 +1,18 @@
+{
+  "extends": "@kb-labs/devkit/tsconfig/node.json",
+  "files": [],
+  "references": [
+    { "path": "packages/shared-boundaries" },
+    { "path": "packages/shared-diff" },
+    { "path": "packages/profiles" },
+    { "path": "packages/shared-textops" },
+    { "path": "apps/demo" }
+  ],
+  "compilerOptions": {
+    "composite": false,
+    "declaration": false,
+    "declarationMap": false,
+    "emitDeclarationOnly": false,
+    "noEmit": true
+  }
+}

package/tsup.config.bin.ts

@@ -0,0 +1,34 @@
+/**
+ * Standard tsup configuration template for CLI binaries
+ *
+ * This template is for packages that provide executable binaries.
+ * Examples: cli-bin, core-state-daemon, any standalone executables
+ *
+ * DO NOT modify this file locally - it is synced from @kb-labs/devkit
+ *
+ * Key differences from library template:
+ * - Uses binPreset instead of nodePreset
+ * - Bundles ALL dependencies into standalone executable
+ * - Outputs .cjs format (CommonJS)
+ * - No type generation (dts: false)
+ * - Adds shebang automatically
+ *
+ * @see https://github.com/kb-labs/devkit#binary-packages
+ */
+import { defineConfig } from 'tsup';
+import binPreset from '@kb-labs/devkit/tsup/bin.js';
+
+export default defineConfig({
+  ...binPreset,
+
+  // REQUIRED: Use build-specific tsconfig (convention)
+  tsconfig: 'tsconfig.build.json',
+
+  // REQUIRED: Entry point for binary
+  // Output will be dist/bin.cjs
+  entry: { bin: 'src/bin.ts' },
+
+  // binPreset already sets dts: false (binaries don't need types)
+  // binPreset already adds shebang banner
+  // binPreset already bundles everything
+});

package/tsup.config.cli.ts

@@ -0,0 +1,41 @@
+/**
+ * Standard tsup configuration template for CLI packages
+ *
+ * This template is for CLI packages that provide:
+ * - Multiple command handlers as separate entries
+ * - Importable from other packages (not bundled)
+ *
+ * Examples: cli-commands, mind-cli, workflow-cli
+ *
+ * DO NOT modify this file locally - it is synced from @kb-labs/devkit
+ *
+ * Key differences:
+ * - Multiple entry points for commands
+ * - NOT bundled (uses nodePreset)
+ * - Generates types (for other packages to import)
+ *
+ * @see https://github.com/kb-labs/devkit#cli-packages
+ */
+import { defineConfig } from 'tsup';
+import nodePreset from '@kb-labs/devkit/tsup/node.js';
+
+export default defineConfig({
+  ...nodePreset,
+
+  // REQUIRED: Use build-specific tsconfig (convention)
+  tsconfig: 'tsconfig.build.json',
+
+  // REQUIRED: Multiple entries for CLI commands
+  entry: [
+    'src/index.ts', // Main export
+    'src/commands/**/*.ts', // All command files
+    // Add more entries as needed
+  ],
+
+  // REQUIRED: Explicit type generation
+  dts: true,
+
+  // OPTIONAL: CLI packages often have manifest files
+  // If you have manifest.json or similar, you might need to copy it:
+  // onSuccess: 'cp src/manifest.json dist/'
+});

package/tsup.config.dual.ts

@@ -0,0 +1,46 @@
+/**
+ * Standard tsup configuration template for packages with BOTH library AND binary
+ *
+ * This template is for packages that provide:
+ * 1. A library (importable by other packages)
+ * 2. A CLI binary (executable)
+ *
+ * Examples: cli packages with both API and bin
+ *
+ * DO NOT modify this file locally - it is synced from @kb-labs/devkit
+ *
+ * Important: This builds BOTH lib and bin in one config.
+ * For complex cases, use separate configs (tsup.lib.config.ts + tsup.bin.config.ts)
+ *
+ * @see https://github.com/kb-labs/devkit#dual-packages
+ */
+import { defineConfig } from 'tsup';
+import nodePreset from '@kb-labs/devkit/tsup/node.js';
+
+export default defineConfig([
+  // Library build (for imports)
+  {
+    ...nodePreset,
+    tsconfig: 'tsconfig.build.json',
+    entry: ['src/index.ts'], // Main library entry
+    dts: true,
+  },
+  // Binary build (for execution)
+  {
+    format: ['cjs'],
+    target: 'es2022',
+    platform: 'node',
+    sourcemap: true,
+    clean: false, // Already cleaned by first build
+    dts: false,
+    treeshake: true,
+    minify: false,
+    outDir: 'dist',
+    splitting: false,
+    noExternal: [/.*/], // Bundle everything
+    external: ['fsevents'], // Except native modules
+    banner: { js: '#!/usr/bin/env node' },
+    tsconfig: 'tsconfig.build.json',
+    entry: { bin: 'src/bin.ts' }, // Binary entry
+  },
+]);

package/tsup.config.ts

@@ -0,0 +1,36 @@
+/**
+ * Standard tsup configuration template
+ *
+ * This is the canonical template for all @kb-labs packages.
+ * DO NOT modify this file locally - it is synced from @kb-labs/devkit
+ *
+ * Customization guidelines:
+ * - For single entry point: use as-is
+ * - For multiple entry points: override `entry` array
+ * - For extra external deps: extend `external` array (only if needed!)
+ * - For special build needs: add minimal overrides, document why
+ *
+ * @see https://github.com/kb-labs/devkit#tsup-configuration
+ */
+import { defineConfig } from 'tsup';
+import nodePreset from '@kb-labs/devkit/tsup/node.js';
+
+export default defineConfig({
+  ...nodePreset,
+
+  // REQUIRED: Use build-specific tsconfig (convention)
+  tsconfig: 'tsconfig.build.json',
+
+  // REQUIRED: Entry point(s)
+  // Single entry (most common):
+  entry: ['src/index.ts'],
+  // Multiple entries (if needed):
+  // entry: ['src/index.ts', 'src/cli/index.ts', 'src/api/index.ts'],
+
+  // REQUIRED: Explicit type generation
+  dts: true,
+
+  // OPTIONAL: Only add if you need EXTRA externals beyond nodePreset
+  // nodePreset already includes all @kb-labs/* packages + dependencies from package.json
+  // external: ['special-package-not-in-preset'],
+});

package/tsup.external.json

@@ -0,0 +1,104 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "externals": [
+    "@kb-labs/ai-docs",
+    "@kb-labs/ai-docs-contracts",
+    "@kb-labs/ai-docs-plugin",
+    "@kb-labs/ai-review",
+    "@kb-labs/ai-review-contracts",
+    "@kb-labs/ai-review-core",
+    "@kb-labs/ai-review-plugin",
+    "@kb-labs/ai-review-providers",
+    "@kb-labs/ai-tests",
+    "@kb-labs/ai-tests-contracts",
+    "@kb-labs/ai-tests-plugin",
+    "@kb-labs/analytics-adapters",
+    "@kb-labs/analytics-cli",
+    "@kb-labs/analytics-core",
+    "@kb-labs/analytics-sdk-node",
+    "@kb-labs/rest-api-contracts",
+    "@kb-labs/audit",
+    "@kb-labs/audit-checks",
+    "@kb-labs/audit-cli",
+    "@kb-labs/audit-contracts",
+    "@kb-labs/audit-core",
+    "@kb-labs/release-manager-changelog",
+    "@kb-labs/cli",
+    "@kb-labs/cli-api",
+    "@kb-labs/cli-bin",
+    "@kb-labs/cli-commands",
+    "@kb-labs/cli-core",
+    "@kb-labs/cli-runtime",
+    "@kb-labs/core",
+    "@kb-labs/core-bundle",
+    "@kb-labs/core-cli",
+    "@kb-labs/core-cli-adapters",
+    "@kb-labs/core-config",
+    "@kb-labs/core-policy",
+    "@kb-labs/core-profiles",
+    "@kb-labs/core-sys",
+    "@kb-labs/core-types",
+    "@kb-labs/core-workspace",
+    "@kb-labs/data-client",
+    "@kb-labs/devkit",
+    "@kb-labs/devlink",
+    "@kb-labs/devlink-contracts",
+    "@kb-labs/devlink-core",
+    "@kb-labs/knowledge-contracts",
+    "@kb-labs/knowledge-core",
+    "@kb-labs/knowledge-fs",
+    "@kb-labs/mind",
+    "@kb-labs/mind-adapters",
+    "@kb-labs/mind-cli",
+    "@kb-labs/mind-contracts",
+    "@kb-labs/mind-core",
+    "@kb-labs/mind-embeddings",
+    "@kb-labs/mind-engine",
+    "@kb-labs/mind-gateway",
+    "@kb-labs/mind-indexer",
+    "@kb-labs/mind-llm",
+    "@kb-labs/mind-pack",
+    "@kb-labs/mind-query",
+    "@kb-labs/mind-tests",
+    "@kb-labs/mind-types",
+    "@kb-labs/mind-vector-store",
+    "@kb-labs/plugin",
+    "@kb-labs/plugin-adapter-cli",
+    "@kb-labs/plugin-adapter-rest",
+    "@kb-labs/plugin-adapter-studio",
+    "@kb-labs/plugin-contracts",
+    "@kb-labs/plugin-devtools",
+    "@kb-labs/plugin-manifest",
+    "@kb-labs/plugin-runtime",
+    "@kb-labs/plugin-template",
+    "@kb-labs/plugin-template-cli",
+    "@kb-labs/plugin-template-contracts",
+    "@kb-labs/product-template",
+    "@kb-labs/profile-toolkit",
+    "@kb-labs/release-manager-checks",
+    "@kb-labs/release-manager-cli",
+    "@kb-labs/release-manager-core",
+    "@kb-labs/release-manager",
+    "@kb-labs/rest-api-app",
+    "@kb-labs/rest-api-core",
+    "@kb-labs/sandbox",
+    "@kb-labs/setup-engine-core",
+    "@kb-labs/setup-engine-operations",
+    "@kb-labs/shared",
+    "@kb-labs/shared-boundaries",
+    "@kb-labs/shared-cli-ui",
+    "@kb-labs/shared-diff",
+    "@kb-labs/shared-repo",
+    "@kb-labs/shared-review-types",
+    "@kb-labs/shared-textops",
+    "@kb-labs/ui-core",
+    "@kb-labs/ui-react",
+    "@kb-labs/workflow",
+    "@kb-labs/workflow-artifacts",
+    "@kb-labs/workflow-constants",
+    "@kb-labs/workflow-contracts",
+    "@kb-labs/workflow-engine",
+    "@kb-labs/workflow-runtime",
+    "zod"
+  ]
+}

package/vitest.config.ts

@@ -0,0 +1,48 @@
+import { defineConfig } from 'vitest/config'
+import nodePreset from '@kb-labs/devkit/vitest/node.js'
+
+export default defineConfig({
+  ...nodePreset,
+  test: {
+    ...nodePreset.test,
+    include: [
+      'packages/**/src/**/*.spec.ts',
+      'packages/**/src/**/*.test.ts',
+      'packages/**/src/**/__tests__/**/*.spec.ts',
+      'packages/**/src/**/__tests__/**/*.test.ts',
+      'packages/**/tests/**/*.test.ts',
+      'apps/**/src/**/*.spec.ts',
+      'apps/**/src/**/*.test.ts',
+      'apps/**/src/**/__tests__/**/*.spec.ts',
+      'apps/**/src/**/__tests__/**/*.test.ts',
+    ],
+    coverage: {
+      ...nodePreset.test?.coverage,
+      enabled: true,
+      exclude: [
+        '**/dist/**',
+        '**/fixtures/**',
+        '**/__tests__/**',
+        '**/*.spec.*',
+        '**/*.test.*',
+        // non-source and config files
+        'eslint.config.js',
+        '**/vitest.config.ts',
+        '**/tsup.config.ts',
+        '**/tsconfig*.json',
+        'apps/**',
+        // coverage reports
+        '**/coverage/**',
+        // barrel files / types
+        '**/index.ts',
+        '**/types.ts',
+        '**/types/**',
+        // devkit scripts
+        'scripts/devkit-sync.mjs',
+        // test files and directories
+        '**/tests/**',
+        '**/test/**',
+      ],
+    },
+  },
+})