@hartvig/developer-control-center 0.8.2

package/.developer-control-center/metrics.json

@@ -0,0 +1 @@
+{"projectRunning":true,"activeTasks":1,"packageVersion":"0.8.2","latestTest":{"label":"Test all packages","status":"success","time":1780431890869},"latestBuild":{"status":"success","time":1780431872826}}

package/.developer-control-center/status.json

@@ -0,0 +1 @@
+[["deploy-publish",{"id":"deploy-publish","label":"Publish package","status":"running","output":"","startTime":1780432163378,"watchMode":false}]]

package/.developer-control-center/timings.jsonl

@@ -0,0 +1,3 @@
+{"id":"build","label":"Build all packages","duration":2460,"exitCode":0,"status":"success","timestamp":"2026-06-02T20:24:32.829Z"}
+{"id":"test","label":"Test all packages","duration":1614,"exitCode":0,"status":"success","timestamp":"2026-06-02T20:24:50.874Z"}
+{"id":"deploy-publish","label":"Publish package","duration":1468,"exitCode":1,"status":"failure","timestamp":"2026-06-02T20:25:16.699Z"}

package/.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [20, 22]
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+      - run: npm ci
+      - run: npm run build
+      - run: npm test
+
+  publish:
+    needs: build
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: https://registry.npmjs.org
+      - run: npm ci
+      - run: npm run build
+      - name: Publish packages
+        run: |
+          for pkg in packages/config packages/status packages/plugins packages/core packages/ui packages/cli packages/preset-node packages/preset-react; do
+            cd "$pkg"
+            npm publish --access public 2>/dev/null || echo "skipping $pkg (already published)"
+            cd ../..
+          done
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/AGENTS.md

@@ -0,0 +1,51 @@
+# AGENTS.md
+
+## Build & Run
+
+- Build all packages: `npm run build` (runs `tsc -b` at root)
+- Watch mode: `npm run dev` (`tsc -b -w`)
+- Clean builds: `npm run clean` (`tsc -b --clean`)
+- Run CLI: `npm start` (or `node packages/cli/dist/index.js`)
+- Run tests: `npm test` (`vitest --run`)
+- Watch tests: `npm run test:watch` (`vitest`)
+- **ESM-only**: all packages use `"type": "module"`. Config files can be `.mjs`, `.cjs`, or `.js` (with `"type": "module"` context).
+
+## Monorepo Structure
+
+- npm workspaces with 6 packages under `packages/*`.
+- TypeScript project references; root `tsc -b` builds all.
+- Base tsconfig at `tsconfig.base.json`; each package extends it.
+
+Package dependency order (bottom-up):
+- `config/` — standalone, loads `developer-control-center.config.js` (CJS/ESM)
+- `status/` — standalone, `StatusStore` with subscribe pattern
+- `plugins/` — standalone, plugin registry
+- `core/` — depends on config + status + plugins; owns `Runtime`, `EventBus`, `TaskRunner`
+- `ui/` — depends on core + config + status; Ink 7 + React 19, renders `App` component
+- `cli.ts` — depends on config + core + ui; bin entrypoint
+
+## Architecture
+
+- Runtime flow: `CLI -> Config Loader -> Core Runtime -> Ink UI`
+- Core runtime owns `TaskRunner` (spawns child processes), `StatusStore` (observable task state), `EventBus` (typed events), and `PluginManager`.
+- Config is project-local `developer-control-center.config.{mjs,cjs,js}` using `export default` (ESM) or `module.exports` (CJS); see `docs/config.md`.
+- MVP scope per `docs/mvp.md`; CI/cloud/plugin-marketplace are out of scope.
+
+## Design Docs
+
+- `docs/*.md` describe planned intent, not necessarily what is implemented.
+- Current Phase 2: search/filter (`/` key), confirmation prompts for `confirm: true` commands, scrollable output (50 lines active / 10 inactive), git branch in header, status persistence in `.developer-control-center/status.json`.
+- Phase 1 delivered: foundation monorepo, command execution, config loading, Ink UI shell with keyboard nav.
+
+## Config
+
+```js
+// developer-control-center.config.js
+export default {
+  name: 'my-project',
+  commands: [
+    { id: 'build', label: 'Build', command: 'npm run build' },
+    { id: 'deploy', label: 'Deploy', command: 'npm run deploy', confirm: true },
+  ],
+};
+```

package/PLUGINS.md

@@ -0,0 +1,145 @@
+# Plugin Author Guide
+
+developer-control-center supports a plugin system that hooks into the task lifecycle. Plugins are npm packages loaded at startup.
+
+## Plugin Interface
+
+A plugin is a module that exports an object conforming to `ProkomPlugin`:
+
+```ts
+interface ProkomPlugin {
+  name: string;
+  hooks: {
+    beforeRun?: (command: ProkomCommand) => void | Promise<void>;
+    afterRun?: (command: ProkomCommand, result: { exitCode?: number; status: string }) => void | Promise<void>;
+    onOutput?: (taskId: string, text: string) => void | Promise<void>;
+    onError?: (taskId: string, error: Error) => void | Promise<void>;
+  };
+}
+```
+
+### Hook Reference
+
+| Hook | Arguments | When |
+|------|-----------|------|
+| `beforeRun` | `(command)` | Before a command starts executing |
+| `afterRun` | `(command, result)` | After a command finishes (success or failure) |
+| `onOutput` | `(taskId, text)` | On each chunk of stdout/stderr |
+| `onError` | `(taskId, error)` | On spawn errors |
+
+## Creating a Plugin
+
+### 1. Create the package
+
+```
+my-dcc-plugin/
+├── package.json
+├── index.js
+└── README.md
+```
+
+### 2. Implement the hooks
+
+```js
+// index.js
+export default {
+  name: 'my-plugin',
+  hooks: {
+    beforeRun(command) {
+      console.log(`[my-plugin] starting: ${command.label}`);
+    },
+    afterRun(command, result) {
+      console.log(`[my-plugin] finished: ${command.label} (exit ${result.exitCode})`);
+    },
+  },
+};
+```
+
+### 3. Use it in config
+
+```js
+// developer-control-center.config.js
+export default {
+  plugins: ['my-dcc-plugin'],
+  commands: [ /* ... */ ],
+};
+```
+
+### Plugin Resolution
+
+- Plugins are resolved via `require()`, so they must be installed or linked.
+- Use npm/yarn workspaces for local plugins: `"my-plugin": "file:./plugins/my-plugin"`.
+
+## Using Hooks
+
+### Simple Observer
+
+```js
+export default {
+  name: 'logger',
+  hooks: {
+    onOutput(taskId, text) {
+      // stream output to a log file
+      fs.appendFileSync(`logs/${taskId}.log`, text);
+    },
+  },
+};
+```
+
+### Guard Plugin (prevent execution)
+
+```js
+export default {
+  name: 'time-guard',
+  hooks: {
+    beforeRun(command) {
+      const hour = new Date().getHours();
+      if (command.id === 'deploy' && (hour < 9 || hour > 17)) {
+        throw new Error('Deployments only allowed during working hours');
+      }
+    },
+  },
+};
+```
+
+### Plugin with State
+
+```js
+export default {
+  name: 'stats',
+  hooks: {
+    beforeRun() { this.startTime = Date.now(); },
+    afterRun(command, result) {
+      const elapsed = Date.now() - this.startTime;
+      console.log(`[stats] ${command.id}: ${elapsed}ms`);
+    },
+  },
+};
+```
+
+## Presets
+
+Presets are reusable command collections. Built-in presets are `node` and `react`.
+
+A preset exports a `ProkomPreset`:
+
+```ts
+interface ProkomPreset {
+  name: string;
+  commands: ProkomCommand[];
+}
+```
+
+Example:
+
+```js
+export default {
+  name: 'node',
+  commands: [
+    { id: 'test', label: 'Test', command: 'npm test' },
+    { id: 'build', label: 'Build', command: 'npm run build' },
+  ],
+};
+```
+
+Built-in presets: `node`, `react`.

package/README.md

@@ -0,0 +1,147 @@
+# developer-control-center
+
+A project-local developer control center — a TUI launcher for commands, builds, pipelines, and status tracking.
+
+## Features
+
+- **Command menu** — keyboard-navigable list of project commands
+- **Search** — press `/` to filter commands by name
+- **Parallel execution** — run multiple tasks simultaneously
+- **Pipelines** — chain commands with sequential step execution
+- **Watch mode** — auto-re-run commands on file changes
+- **Confirmation prompts** — guard destructive commands with `confirm: true`
+- **Status panel** — live output, exit codes, duration, scrollable history
+- **Environment profiles** — switch command sets with `--profile`
+- **Workspace detection** — auto-detect monorepo packages
+- **Git branch** — shows current branch in header
+- **CI integration** — auto-detects CI environments, applies `ci` profile
+- **Desktop notifications** — alerts on task completion/failure
+- **Presets** — reusable command collections (node, react)
+- **Plugin API** — lifecycle hooks for custom extensions
+
+## Installation
+
+```bash
+npm install -g @hartvig/developer-control-center
+```
+
+Or run from a local checkout:
+
+```bash
+git clone <url>
+cd developer-control-center
+npm install
+npm run build
+npm start
+```
+
+## Usage
+
+```bash
+# Launch in current directory
+dcc
+
+# Use a specific config file
+dcc ./configs/developer-control-center.config.js
+
+# Use a CI profile
+dcc --profile ci
+
+# Show help
+dcc --help
+```
+
+### Keyboard Controls
+
+| Key | Action |
+|-----|--------|
+| `↑`/`↓` | Navigate commands / scroll status |
+| `Enter` | Run selected command |
+| `/` | Enter search mode |
+| `Tab` | Focus status panel |
+| `Esc` | Back to commands / exit search |
+| `y`/`n` | Confirm / cancel (confirmation prompts) |
+| `Ctrl+C` / `Esc` (in command mode) | Quit |
+
+## Configuration
+
+Create `developer-control-center.config.js` (or `.mjs` / `.cjs`) in your project root:
+
+```js
+export default {
+  name: 'my-project',
+  commands: [
+    {
+      id: 'build',
+      label: 'Build',
+      command: 'npm run build',
+    },
+    {
+      id: 'deploy',
+      label: 'Deploy to staging',
+      command: 'npm run deploy:staging',
+      confirm: true,
+    },
+    {
+      id: 'dev-watch',
+      label: 'Dev server',
+      command: 'npm run dev',
+      watch: true,
+    },
+  ],
+};
+```
+
+### Presets
+
+```js
+export default {
+  presets: ['node'],  // loads built-in node preset
+  commands: [
+    // your project-specific overrides
+  ],
+};
+```
+
+Built-in presets: `node` (test, build, lint, typecheck, clean), `react` (dev, build, test, lint, typecheck, preview).
+
+### Profiles
+
+```js
+export default {
+  profiles: {
+    ci: {
+      commands: [
+        { id: 'build', label: 'Build (CI)', command: 'npm run build' },
+      ],
+    },
+  },
+};
+```
+
+### Pipelines
+
+```js
+export default {
+  pipelines: [
+    {
+      id: 'deploy-all',
+      label: 'Build, test, deploy',
+      steps: ['build', 'test', 'deploy'],
+    },
+  ],
+};
+```
+
+Full options documented in [docs/config.md](docs/config.md).
+
+## Development
+
+```bash
+npm run dev      # watch mode
+npm test         # run tests
+npm run build    # compile TypeScript
+npm start        # run CLI
+```
+
+See [PLUGINS.md](PLUGINS.md) for the plugin API and [docs/architecture.md](docs/architecture.md) for the system architecture.

package/developer-control-center.config.example.js

@@ -0,0 +1,91 @@
+export default {
+  name: 'my-project',
+  menuRows: 8,
+  // outputRows: 12, // defaults to menuRows
+
+  commands: [
+    // --- Simple command ---
+    {
+      id: 'build',
+      label: 'Build',
+      description: 'Build the project.',
+      command: 'npm run build',
+    },
+
+    // --- Toggle (start/stop) ---
+    {
+      id: 'dev',
+      label: 'Watch mode',
+      description: 'Start or stop the file watcher.',
+      toggle: { start: 'npm run dev' },
+    },
+
+    // --- Confirm before running ---
+    {
+      id: 'deploy',
+      label: 'Deploy',
+      description: 'Deploy to production.',
+      command: 'npm run deploy',
+      confirm: true,
+    },
+
+    // --- Prompt for input ---
+    {
+      id: 'bump-version',
+      label: 'Bump version',
+      description: 'Increment the project version.',
+      command: 'npm version {input}',
+      confirm: true,
+      input: { message: 'Bump type? (patch/minor/major):', placeholder: 'patch', default: 'patch' },
+    },
+
+    // --- Conditional follow-up on non-zero exit ---
+    {
+      id: 'check-outdated',
+      label: 'Check outdated deps',
+      description: 'List outdated npm dependencies.',
+      command: 'npm outdated',
+      onNonZeroExit: {
+        label: 'Update all',
+        command: 'npm update',
+      },
+    },
+
+    // --- Run in a specific directory ---
+    {
+      id: 'build-sub',
+      label: 'Build sub-package',
+      description: 'Build only the sub-package.',
+      command: 'npm run build',
+      cwd: 'packages/sub',
+    },
+
+    // --- Parallel-safe task ---
+    {
+      id: 'sleep-long',
+      label: 'Long task',
+      description: 'Demo task that runs 10 seconds.',
+      command: 'sleep 10',
+      parallel: true,
+    },
+  ],
+
+  // --- Profiles (override/extend commands for different environments) ---
+  profiles: {
+    ci: {
+      commands: [
+        { id: 'build', label: 'Build (CI)', command: 'npm run build' },
+        { id: 'lint', label: 'Lint', command: 'npm run lint' },
+      ],
+    },
+  },
+
+  // --- Pipelines (run multiple commands sequentially) ---
+  pipelines: [
+    {
+      id: 'pipeline-full-check',
+      label: 'Full check',
+      steps: ['lint', 'build', 'test'],
+    },
+  ],
+};

package/developer-control-center.config.js

@@ -0,0 +1,177 @@
+export default {
+  name: 'developer-control-center',
+  menuRows: 10, 
+  // Available presets (use: presets: ['node'] or presets: ['react']):
+  //   node  — Test, Build, Lint, TypeCheck, Clean (npm run / npm test)
+  //   react — Dev server, Build, Test, Lint, TypeCheck, Preview build
+  // To use both: presets: ['node', 'react']
+
+  commands: [
+    {
+      id: 'dev',
+      label: 'Watch mode',
+      description: 'Start or stop the TypeScript project-reference watcher.',
+      toggle: { start: 'npm run dev', stop: 'pkill -f "tsc -w" 2>/dev/null || true' },
+      group: 'Development',
+    },
+    {
+      id: 'test',
+      label: 'Test all packages',
+      description: 'Run the full Vitest suite once.',
+      command: 'npm test',
+      group: 'Development',
+    },
+    {
+      id: 'clean',
+      label: 'Clean builds',
+      description: 'Remove TypeScript project-reference build output.',
+      command: 'npm run clean',
+      group: 'Development',
+    },
+    {
+      id: 'install',
+      label: 'Install all packages',
+      description: 'Install all npm dependencies across workspaces.',
+      command: 'npm install',
+      group: 'Development',
+    },
+    {
+      id: 'bump-version',
+      label: 'Bump version',
+      description: 'Increment the project version. Prompts for patch, minor, or major.',
+      command: 'npm version --no-git-tag-version {input}',
+      group: 'Build',
+      confirm: true,
+      input: { message: 'Bump type? (patch/minor/major):', placeholder: 'patch', default: 'patch' },
+    },
+    {
+      id: 'build',
+      label: 'Build all packages',
+      description: 'Compile all TypeScript.',
+      command: 'npm run build',
+      group: 'Build',
+    },
+    {
+      id: 'deploy-dry-run',
+      label: 'Publish dry run',
+      description: 'Preview publishing without publishing (uses npm token auth).',
+      command: 'npm publish --dry-run',
+      group: 'Deploy',
+    },
+    {
+      id: 'deploy-publish',
+      label: 'Publish package',
+      description: 'Publish to npm (uses npm token auth).',
+      command: 'npm publish --access public',
+      group: 'Deploy',
+      confirm: true,
+    },
+    {
+      id: 'dev-server-toggle',
+      label: 'Dev server',
+      description: 'Demo toggle command that simulates a long-running server.',
+      toggle: { start: 'sleep 60', stop: 'echo "server stopped"' },
+      group: 'Demo',
+    },
+    {
+      id: 'parallel-demo',
+      label: 'Parallel demo (sleep 3)',
+      description: 'Demo command that can run alongside other parallel tasks.',
+      command: 'sleep 3',
+      parallel: true,
+      group: 'Demo',
+    },
+    {
+      id: 'parallel-demo-2',
+      label: 'Parallel demo (sleep 5)',
+      description: 'Second demo command for parallel execution.',
+      command: 'sleep 5',
+      parallel: true,
+      group: 'Demo',
+    },
+    {
+      id: 'demo-confirm-overlay',
+      label: 'Confirm overlay demo',
+      description: 'Shows a yes/no overlay inside the command pane.',
+      command: '',
+      group: 'Demo',
+    },
+    {
+      id: 'parallel-steps-demo',
+      label: 'Parallel steps (sleep 3 + 5)',
+      description: 'Run both demo sleep tasks concurrently as one command.',
+      command: '',
+      parallelSteps: ['parallel-demo', 'parallel-demo-2'],
+      group: 'Demo',
+    },
+    {
+      id: 'status-git',
+      label: 'Git status',
+      description: 'Show concise git working-tree status.',
+      command: 'git status --short',
+      group: 'Management',
+    },
+    {
+      id: 'git-commit-push',
+      label: 'Commit & push',
+      description: 'Prompt for a commit message, commit all changes, then push.',
+      command: 'git add -A && git commit --allow-empty -m "{input}" && git push',
+      group: 'Management',
+      confirm: true,
+      input: { message: 'Commit message:', placeholder: 'type a message…' },
+    },
+    {
+      id: 'git-push',
+      label: 'Git push',
+      description: 'Push the current branch to its configured remote.',
+      command: 'git push',
+      group: 'Management',
+    },
+    {
+      id: 'status-outdated',
+      label: 'Check outdated deps',
+      description: 'List outdated npm dependencies.',
+      command: 'npm outdated',
+      group: 'Management',
+      onNonZeroExit: {
+        label: 'Update all',
+        command: 'npm update',
+      },
+    },
+    {
+      id: 'status-packages',
+      label: 'List workspace packages',
+      description: 'List installed top-level packages.',
+      command: 'npm ls --depth=0',
+      group: 'Management',
+    },
+  ],
+  profiles: {
+    ci: {
+      commands: [
+        {
+          id: 'build',
+          label: 'Build (CI)',
+          command: 'npm run build',
+        },
+        {
+          id: 'status-git',
+          label: 'Check git diff',
+          command: 'git diff --stat',
+        },
+      ],
+    },
+  },
+  pipelines: [
+    {
+      id: 'pipeline-build-clean',
+      label: 'Build then clean',
+      steps: ['build', 'clean'],
+    },
+    {
+      id: 'pipeline-status',
+      label: 'Full status check',
+      steps: ['status-git', 'status-outdated', 'status-packages'],
+    },
+  ],
+};

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}