dAppCore · Snider · Apr 30, 2026 · Apr 30, 2026 · Apr 30, 2026 · Apr 30, 2026
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -0,0 +1,80 @@
+name: CI
+
+on:
+  push:
+    branches: [dev, main]
+  pull_request:
+    branches: [dev, main]
+
+permissions:
+  contents: read
+
+env:
+  GOFLAGS: -buildvcs=false
+  GOWORK: "off"
+  GOPROXY: "direct"
+  GOSUMDB: "off"
+
+jobs:
+  test:
+    name: Test + Coverage
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-go@v6
+        with:
+          go-version: '1.26'
+      - name: Test with coverage
+        working-directory: go
+        run: go test -race -coverprofile=coverage.out -covermode=atomic -count=1 ./...
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: go/coverage.out
+          flags: unittests
+          fail_ci_if_error: false
+
+  lint:
+    name: golangci-lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-go@v6
+        with:
+          go-version: '1.26'
+      - uses: golangci/golangci-lint-action@v9
+        with:
+          version: latest
+          working-directory: go
+          args: --timeout=5m --tests=false
+
+  sonarcloud:
+    name: SonarCloud
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-go@v6
+        with:
+          go-version: '1.26'
+      - name: Test for coverage
+        working-directory: go
+        run: go test -coverprofile=coverage.out -covermode=atomic -count=1 ./...
+      - name: SonarCloud Scan
+        uses: SonarSource/sonarqube-scan-action@v6
+        env:
+          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
+        with:
+          args: >
+            -Dsonar.organization=dappcore
+            -Dsonar.projectKey=dappcore_go-process
+            -Dsonar.sources=go
+            -Dsonar.exclusions=**/vendor/**,**/third_party/**,**/.tmp/**,**/*_test.go
+            -Dsonar.tests=go
+            -Dsonar.test.inclusions=**/*_test.go
+            -Dsonar.go.coverage.reportPaths=go/coverage.out
diff --git a/.gitmodules b/.gitmodules
@@ -0,0 +1,4 @@
+[submodule "external/go"]
+	path = external/go
+	url = https://github.com/dappcore/go.git
+	branch = dev
diff --git a/.woodpecker.yml b/.woodpecker.yml
@@ -14,7 +14,7 @@ steps:
       GOFLAGS: -buildvcs=false
       GOWORK: "off"
     commands:
-      - golangci-lint run --timeout=5m ./...
+      - cd go && golangci-lint run --timeout=5m ./...
 
   - name: go-test
     image: golang:1.26-alpine
@@ -25,7 +25,7 @@ steps:
       CGO_ENABLED: "1"
     commands:
       - apk add --no-cache git build-base
-      - go test -race -coverprofile=coverage.out -covermode=atomic -count=1 ./...
+      - cd go && go test -race -coverprofile=coverage.out -covermode=atomic -count=1 ./...
   - name: sonar
     image: sonarsource/sonar-scanner-cli:latest
     depends_on: [go-test]

diff --git a/CLAUDE.md b/CLAUDE.md
@@ -4,7 +4,39 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-`dappco.re/go/core/process` is the process management framework for CoreGO. It handles process execution (spawn, monitor, stream, kill), daemon lifecycle (PID files, health checks, graceful shutdown, registry), and pipeline orchestration (parallel, sequential, or DAG-ordered multi-process runs). All process events broadcast via Core IPC actions.
+`dappco.re/go/process` is the process management framework for CoreGO. It handles process execution (spawn, monitor, stream, kill), daemon lifecycle (PID files, health checks, graceful shutdown, registry), and pipeline orchestration (parallel, sequential, or DAG-ordered multi-process runs). All process events are broadcast via Core IPC actions.
+
+## Repo Layout
+
+```text
+core/go-process/
+├── go/                   ← primary Go module root (dappco.re/go/process)
+│   ├── go.mod            ← kept at module root to preserve import path
+│   ├── go.sum
+│   ├── *.go
+│   ├── exec/
+│   ├── pkg/
+│   ├── tests/
+│   ├── README.md         ← symlink to repo root README.md
+│   ├── CLAUDE.md         ← symlink to repo root CLAUDE.md
+│   ├── AGENTS.md         ← symlink to repo root AGENTS.md
+│   └── docs/             ← symlink to repo root docs/
+├── ui/                   ← TypeScript frontend UI (not part of Go module)
+├── docs/                 ← shared process docs/spec references
+├── specs/                ← process specs YAML (cross-language)
+├── .woodpecker.yml
+├── sonar-project.properties
+└── other cross-language repository files
+```
+
+## Go Resolution Modes
+
+| Mode | When | What runs |
+|------|------|-----------|
+| **CI module mode** | CI and scripted verification | `cd go && GOWORK=off` with pinned module cache and short mode test/vet runs. This is the reproducible dependency mode. |
+| **Local contributor mode** | day-to-day development | `cd go && go test ./...` from the Go module root. No `go.work` is present in this repo. |
+
+Prefer running module tooling from `go/` so commands resolve module paths consistently.
 
 ## Commands
 

diff --git a/README.md b/README.md
@@ -1,5 +1,21 @@
+<!-- SPDX-License-Identifier: EUPL-1.2 -->
+
 # go-process
 
+> Process orchestration — daemons, runners, registry, pidfiles, IPC bus
+
+[![CI](https://github.com/dappcore/go-process/actions/workflows/ci.yml/badge.svg?branch=dev)](https://github.com/dappcore/go-process/actions/workflows/ci.yml)
+[![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=dappcore_go-process&metric=alert_status)](https://sonarcloud.io/dashboard?id=dappcore_go-process)
+[![Coverage](https://codecov.io/gh/dappcore/go-process/branch/dev/graph/badge.svg)](https://codecov.io/gh/dappcore/go-process)
+[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=dappcore_go-process&metric=security_rating)](https://sonarcloud.io/dashboard?id=dappcore_go-process)
+[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=dappcore_go-process&metric=sqale_rating)](https://sonarcloud.io/dashboard?id=dappcore_go-process)
+[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=dappcore_go-process&metric=reliability_rating)](https://sonarcloud.io/dashboard?id=dappcore_go-process)
+[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=dappcore_go-process&metric=code_smells)](https://sonarcloud.io/dashboard?id=dappcore_go-process)
+[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=dappcore_go-process&metric=ncloc)](https://sonarcloud.io/dashboard?id=dappcore_go-process)
+[![Go Reference](https://pkg.go.dev/badge/dappco.re/go/go-process.svg)](https://pkg.go.dev/dappco.re/go/go-process)
+[![License: EUPL-1.2](https://img.shields.io/badge/License-EUPL--1.2-blue.svg)](https://eupl.eu/1.2/en/)
+
+
 `go-process` is the process-management service for Core applications. It wraps
 external command execution, lifecycle tracking, output capture, daemon PID files,
 health endpoints, and REST/WebSocket provider integration around the `dappco.re/go`

diff --git a/external/go b/external/go
diff --git a/go.work b/go.work
@@ -0,0 +1,9 @@
+go 1.26.2
+
+// Workspace mode for development: pulls fresh code from external/ submodules.
+// CI uses GOWORK=off to fall back to go/go.mod tags (reproducible).
+
+use (
+	./go
+	./external/go
+)
diff --git a/go/AGENTS.md b/go/AGENTS.md
@@ -0,0 +1 @@
+../AGENTS.md
diff --git a/go/CLAUDE.md b/go/CLAUDE.md
@@ -0,0 +1 @@
+../CLAUDE.md
diff --git a/go/README.md b/go/README.md
@@ -0,0 +1 @@
+../README.md
diff --git a/actions.go → go/actions.go b/actions.go → go/actions.go
diff --git a/actions_example_test.go → go/actions_example_test.go b/actions_example_test.go → go/actions_example_test.go
diff --git a/actions_test.go → go/actions_test.go b/actions_test.go → go/actions_test.go
diff --git a/buffer.go → go/buffer.go b/buffer.go → go/buffer.go
diff --git a/buffer_example_test.go → go/buffer_example_test.go b/buffer_example_test.go → go/buffer_example_test.go
diff --git a/buffer_test.go → go/buffer_test.go b/buffer_test.go → go/buffer_test.go
diff --git a/daemon.go → go/daemon.go b/daemon.go → go/daemon.go
diff --git a/daemon_example_test.go → go/daemon_example_test.go b/daemon_example_test.go → go/daemon_example_test.go
diff --git a/daemon_test.go → go/daemon_test.go b/daemon_test.go → go/daemon_test.go
diff --git a/go/docs b/go/docs
@@ -0,0 +1 @@
+../docs
diff --git a/errors.go → go/errors.go b/errors.go → go/errors.go
diff --git a/errors_example_test.go → go/errors_example_test.go b/errors_example_test.go → go/errors_example_test.go
diff --git a/errors_test.go → go/errors_test.go b/errors_test.go → go/errors_test.go
diff --git a/exec/doc.go → go/exec/doc.go b/exec/doc.go → go/exec/doc.go
diff --git a/exec/exec.go → go/exec/exec.go b/exec/exec.go → go/exec/exec.go
diff --git a/exec/exec_example_test.go → go/exec/exec_example_test.go b/exec/exec_example_test.go → go/exec/exec_example_test.go
diff --git a/exec/exec_test.go → go/exec/exec_test.go b/exec/exec_test.go → go/exec/exec_test.go
diff --git a/exec/logger.go → go/exec/logger.go b/exec/logger.go → go/exec/logger.go
diff --git a/exec/logger_example_test.go → go/exec/logger_example_test.go b/exec/logger_example_test.go → go/exec/logger_example_test.go
diff --git a/exec/logger_test.go → go/exec/logger_test.go b/exec/logger_test.go → go/exec/logger_test.go
diff --git a/go.mod → go/go.mod b/go.mod → go/go.mod
diff --git a/go.sum → go/go.sum b/go.sum → go/go.sum
diff --git a/health.go → go/health.go b/health.go → go/health.go
diff --git a/health_example_test.go → go/health_example_test.go b/health_example_test.go → go/health_example_test.go
diff --git a/health_test.go → go/health_test.go b/health_test.go → go/health_test.go
diff --git a/os_exec_link.go → go/os_exec_link.go b/os_exec_link.go → go/os_exec_link.go
diff --git a/pidfile.go → go/pidfile.go b/pidfile.go → go/pidfile.go
diff --git a/pidfile_example_test.go → go/pidfile_example_test.go b/pidfile_example_test.go → go/pidfile_example_test.go
diff --git a/pidfile_test.go → go/pidfile_test.go b/pidfile_test.go → go/pidfile_test.go
diff --git a/pidfile_unix.go → go/pidfile_unix.go b/pidfile_unix.go → go/pidfile_unix.go
diff --git a/pidfile_windows.go → go/pidfile_windows.go b/pidfile_windows.go → go/pidfile_windows.go
diff --git a/pkg/api/embed.go → go/pkg/api/embed.go b/pkg/api/embed.go → go/pkg/api/embed.go
diff --git a/pkg/api/provider.go → go/pkg/api/provider.go b/pkg/api/provider.go → go/pkg/api/provider.go
@@ -308,17 +308,7 @@ func (p *ProcessProvider) runProcess(c *gin.Context) {
 		return
 	}
 
-	result := p.service.RunWithOptions(c.Request.Context(), process.RunOptions{
-		Command:        req.Command,
-		Args:           req.Args,
-		Dir:            req.Dir,
-		Env:            req.Env,
-		DisableCapture: req.DisableCapture,
-		Detach:         req.Detach,
-		Timeout:        req.Timeout,
-		GracePeriod:    req.GracePeriod,
-		KillGroup:      req.KillGroup,
-	})
+	result := p.service.RunWithOptions(c.Request.Context(), process.RunOptions(req))
 	if !result.OK {
 		c.JSON(http.StatusInternalServerError, failWithDetails("run_failed", result.Error(), map[string]any{
 			"output": "",
@@ -660,11 +650,6 @@ func PIDAlive(pid int) bool {
 }
 
 // intParam parses a URL param as int, returning 0 on failure.
-func intParam(c *gin.Context, name string) int {
-	v, _ := strconv.Atoi(c.Param(name))
-	return v
-}
-
 func pidFromString(value string) (int, bool) {
 	pid, err := strconv.Atoi(core.Trim(value))
 	if err != nil || pid <= 0 {

diff --git a/pkg/api/provider_example_test.go → go/pkg/api/provider_example_test.go b/pkg/api/provider_example_test.go → go/pkg/api/provider_example_test.go
diff --git a/pkg/api/provider_test.go → go/pkg/api/provider_test.go b/pkg/api/provider_test.go → go/pkg/api/provider_test.go
diff --git a/pkg/api/response.go → go/pkg/api/response.go b/pkg/api/response.go → go/pkg/api/response.go
diff --git a/pkg/api/test_helpers_test.go → go/pkg/api/test_helpers_test.go b/pkg/api/test_helpers_test.go → go/pkg/api/test_helpers_test.go
diff --git a/pkg/api/websocket.go → go/pkg/api/websocket.go b/pkg/api/websocket.go → go/pkg/api/websocket.go
@@ -20,12 +20,6 @@ type messageType string
 const (
 	// typeEvent indicates a generic event.
 	typeEvent messageType = "event"
-	// typeError indicates an error message.
-	typeError messageType = "error"
-	// typeSubscribe requests subscription to a channel.
-	typeSubscribe messageType = "subscribe"
-	// typeUnsubscribe requests unsubscription from a channel.
-	typeUnsubscribe messageType = "unsubscribe"
 )
 
 // hubMessage is the standard WebSocket event payload emitted by the provider.

diff --git a/process.go → go/process.go b/process.go → go/process.go
diff --git a/process_example_test.go → go/process_example_test.go b/process_example_test.go → go/process_example_test.go
diff --git a/process_global.go → go/process_global.go b/process_global.go → go/process_global.go
diff --git a/process_global_example_test.go → go/process_global_example_test.go b/process_global_example_test.go → go/process_global_example_test.go
diff --git a/process_global_test.go → go/process_global_test.go b/process_global_test.go → go/process_global_test.go
diff --git a/process_test.go → go/process_test.go b/process_test.go → go/process_test.go
diff --git a/program.go → go/program.go b/program.go → go/program.go
diff --git a/program_example_test.go → go/program_example_test.go b/program_example_test.go → go/program_example_test.go
diff --git a/program_test.go → go/program_test.go b/program_test.go → go/program_test.go
diff --git a/registry.go → go/registry.go b/registry.go → go/registry.go
diff --git a/registry_example_test.go → go/registry_example_test.go b/registry_example_test.go → go/registry_example_test.go
diff --git a/registry_test.go → go/registry_test.go b/registry_test.go → go/registry_test.go
diff --git a/runner.go → go/runner.go b/runner.go → go/runner.go
diff --git a/runner_example_test.go → go/runner_example_test.go b/runner_example_test.go → go/runner_example_test.go
diff --git a/runner_test.go → go/runner_test.go b/runner_test.go → go/runner_test.go
diff --git a/service.go → go/service.go b/service.go → go/service.go
@@ -43,7 +43,7 @@ func (s *Service) coreApp() *core.Core {
 	if s == nil || s.ServiceRuntime == nil {
 		return nil
 	}
-	return s.ServiceRuntime.Core()
+	return s.Core()
 }
 
 // Options configures the process service.
@@ -822,22 +822,12 @@ func (s *Service) handleTask(c *core.Core, task core.Message) core.Result {
 		}
 		proc := result.Value.(*Process)
 		return core.Ok(proc.Info())
-	case TaskProcessRun:
-		result := s.RunWithOptions(c.Context(), RunOptions{
-			Command:        m.Command,
-			Args:           m.Args,
-			Dir:            m.Dir,
-			Env:            m.Env,
-			DisableCapture: m.DisableCapture,
-			Detach:         m.Detach,
-			Timeout:        m.Timeout,
-			GracePeriod:    m.GracePeriod,
-			KillGroup:      m.KillGroup,
-		})
-		if !result.OK {
-			return result
-		}
-		return core.Ok(result.Value)
+		case TaskProcessRun:
+			result := s.RunWithOptions(c.Context(), RunOptions(m))
+			if !result.OK {
+				return result
+			}
+			return core.Ok(result.Value)
 	case TaskProcessKill:
 		switch {
 		case m.ID != "":

diff --git a/service_example_test.go → go/service_example_test.go b/service_example_test.go → go/service_example_test.go
diff --git a/service_test.go → go/service_test.go b/service_test.go → go/service_test.go
diff --git a/test_helpers_test.go → go/test_helpers_test.go b/test_helpers_test.go → go/test_helpers_test.go
diff --git a/tests/cli/process/Taskfile.yaml → go/tests/cli/process/Taskfile.yaml b/tests/cli/process/Taskfile.yaml → go/tests/cli/process/Taskfile.yaml
diff --git a/types.go → go/types.go b/types.go → go/types.go
diff --git a/types_example_test.go → go/types_example_test.go b/types_example_test.go → go/types_example_test.go
diff --git a/types_test.go → go/types_test.go b/types_test.go → go/types_test.go