@lumpcode/cli-types 0.0.6 → 0.0.9

package/README.md

@@ -1,8 +1,8 @@
 # @lumpcode/cli-types
 
-TypeScript types and small `defineX` identity helpers for authoring **Lumpcode** lump configuration (`config.js`) and command modules (`.lumpcode/commands/<name>.js`). Runtime is just identity functions; the value is purely the type hints.
+TypeScript types and small `defineX` identity helpers for authoring **Lumpcode** lump configuration (`config.ts` / `config.js`) and command modules (`.lumpcode/commands/<name>.ts` or `.js`). Runtime is just identity functions; the value is purely the type hints.
 
-> Use **alongside the Lumpcode CLI** for typed `config.js` and command modules. Install the CLI with `npm install -g @lumpcode/cli` (Node 22+).
+> Use **alongside [@lumpcode/cli](https://www.npmjs.com/package/@lumpcode/cli)** for typed lump config and command modules. Install the CLI with `npm install -g @lumpcode/cli` (Node 22+).
 
 ## Install
 
@@ -12,9 +12,9 @@ npm install --save-dev @lumpcode/cli-types
 
 ## Usage
 
-`config.js`:
+`config.ts` (or `config.js`):
 
-```js
+```ts
 import { defineConfig } from '@lumpcode/cli-types';
 
 export default defineConfig({
@@ -24,9 +24,9 @@ export default defineConfig({
 });
 ```
 
-Command module (`.lumpcode/commands/my-agent.js`):
+Command module (`.lumpcode/commands/my-agent.ts` or `.js`):
 
-```js
+```ts
 import { defineCommand, defineCommandSetup } from '@lumpcode/cli-types';
 
 export const command = defineCommand(({ prompt }) => ({
@@ -37,14 +37,24 @@ export const command = defineCommand(({ prompt }) => ({
 export const setup = defineCommandSetup(async () => ({}));
 ```
 
+Lumpcode transpiles project **`.ts`** config, hooks, and command modules at load time. Shipped presets under `~/.lumpcode/commands/presets/` remain **`.js` only**.
+
 ## What's exported
 
-- **Config helpers** — `defineConfig`, `defineStep`, hook `define*` helpers for lump `config.js`.
+- **Config helpers** — `defineConfig`, `defineStep`, hook `define*` helpers for lump `config.ts` / `config.js`.
 - **Command-module helpers** — `defineCommandModule`, `defineCommand`, `defineCommandSetup`, `defineCommandTeardown`.
-- **Types** — lump config and command-module shapes, plus engine types re-exported from `@lumpcode/core`.
+- **Types** — lump config and command-module shapes, plus engine types re-exported from [@lumpcode/core](https://www.npmjs.com/package/@lumpcode/core).
 
-Full list: [types.md](../DOCS/types.md).
+Full list: [types.md](https://github.com/lumpcode/lumpcode/blob/main/packages/apps/cli/DOCS/types.md).
 
 ## Docs
 
-Field reference and hook signatures live in the CLI docs — see [lump-config.md](../DOCS/lump-config.md) and [commands.md](../DOCS/commands.md).
+Field reference and hook signatures live in the CLI docs — see [lump-config.md](https://github.com/lumpcode/lumpcode/blob/main/packages/apps/cli/DOCS/lump-config.md) and [commands.md](https://github.com/lumpcode/lumpcode/blob/main/packages/apps/cli/DOCS/commands.md).
+
+## Related packages
+
+| Package | npm | Role |
+| ------- | --- | ---- |
+| `@lumpcode/cli` | [npm](https://www.npmjs.com/package/@lumpcode/cli) | CLI: project setup, run, daemon, status |
+| `@lumpcode/core` | [npm](https://www.npmjs.com/package/@lumpcode/core) | Engine API (`runLump`) |
+| `lumpcode` | [npm](https://www.npmjs.com/package/lumpcode) | Unscoped npm alias for `@lumpcode/cli` |

package/dist/index.d.ts

@@ -51,6 +51,8 @@ type LumpJsConfig<V extends LumpVariables = LumpVariables> = MergeObjs<Omit<{
     [K in keyof RunLumpInput<V>]?: NonNullable<RunLumpInput<V>[K]> extends Function ? (RunLumpInput<V>[K] | FilePath) : RunLumpInput<V>[K];
 }, 'gitCommitMessageFn' | 'projectRoot' | 'branchFn' | 'baseBranch' | 'setupWorkspaceFn' | 'teardownWorkspaceFn' | 'gitAddCommandFn' | 'gitCommitCommandFn' | 'gitPushCommandFn'>, {
     baseBranch?: RunLumpInput<V>['baseBranch'];
+    /** Which integration line this lump is discovered and scheduled on (defaults to primary branch from local.json). */
+    discoveryBranch?: string;
     command?: LumpJsConfigStep['command'];
     contextListJson?: FilePath | Record<string, string>;
     contextMatchFn?: FilePath | ContextMatchFn;
@@ -129,7 +131,15 @@ type WorkspaceStrategy = 'checkout' | 'worktree';
  */
 interface LocalConfig {
     mode: Mode;
-    projectBaseBranch: string;
+    /** Required when `primaryBranches` is omitted or empty. Primary integration branch for this install. */
+    primaryBranch?: string;
+    /**
+     * @deprecated Use `primaryBranch` instead.
+     * Legacy alias kept for existing `.lumpcode/local.json` files.
+     */
+    projectBaseBranch?: string;
+    /** When non-empty, wins over singular `primaryBranch` for the effective primary-branch list. Dedicated daemon scans these lines. */
+    primaryBranches?: string[];
     workspaceStrategy?: WorkspaceStrategy;
     /** When `true`, the background daemon skips every lump on this machine (`lumpcode start`). */
     disabled?: boolean;

package/package.json

@@ -1,9 +1,23 @@
 {
   "name": "@lumpcode/cli-types",
-  "version": "0.0.6",
+  "version": "0.0.9",
   "description": "Types and defineX helpers for Lumpcode CLI lump config and command modules",
+  "keywords": [
+    "lumpcode",
+    "typescript",
+    "types",
+    "cli",
+    "agent-loop",
+    "coding-agent",
+    "lump-config"
+  ],
   "license": "Apache-2.0",
   "author": "",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lumpcode/lumpcode.git",
+    "directory": "packages/apps/cli/cli-types"
+  },
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -22,7 +36,7 @@
     "build": "rollup -c"
   },
   "dependencies": {
-    "@lumpcode/core": "^0.0.6"
+    "@lumpcode/core": "^0.0.9"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^28.0.1",