Run Slugkit development independently on port 3013 #302

Merged

erik merged 1 commit from fix/task-431d12b5-slugkit-dev-port into main

2026-10-13 16:57:51 -05:00

erik commented

2026-10-13 16:55:14 -05:00

Owner

Updated environment examples, setup defaults, documentation, and existing development environment regression expectations. The local environment was started through make dev, and only the slugkit-dev CLI API address was changed to http://localhost:3013/api/v1; the existing key and all other entries were preserved.

Validation: full ./scripts/pre-pr.sh passed (1,261 tests). Installed CLI Doctor passes all seven checks, including contract 1.1.0 and authentication. The served spec matches the official archived reference. Database records, credentials, and federation keys match the pre-start backup, excluding expected API-key usage timestamps. Rott remains reachable on port 3000, and all three Slugkit Overmind services are running. No production rollout or npm release is required.

Task: task-431d12b5 — Run versioned Slugkit development on port 3013.

The Slugkit toolkit development defaults conflicted with Rott on port 3000 and another website's Garage ports. Repository startup now defaults to port 3013, exports the resolved APP_PORT into Overmind, and uses dedicated Garage ports 3930–3933. Generated website defaults remain unchanged. Updated environment examples, setup defaults, documentation, and existing development environment regression expectations. The local environment was started through `make dev`, and only the `slugkit-dev` CLI API address was changed to `http://localhost:3013/api/v1`; the existing key and all other entries were preserved. Validation: full `./scripts/pre-pr.sh` passed (1,261 tests). Installed CLI Doctor passes all seven checks, including contract 1.1.0 and authentication. The served spec matches the official archived reference. Database records, credentials, and federation keys match the pre-start backup, excluding expected API-key usage timestamps. Rott remains reachable on port 3000, and all three Slugkit Overmind services are running. No production rollout or npm release is required. Task: task-431d12b5 — Run versioned Slugkit development on port 3013.

erik added 1 commit

2026-10-13 16:55:14 -05:00

fix: isolate Slugkit development on port 3013

CI / build-lint-test (pull_request) Successful in 58s

Details

607a967b88

Task: #task-431d12b5

erik commented

2026-10-13 16:56:59 -05:00

Author

Owner

Independent review

PR: Slugkit #302 — open, reviewed head 607a967b88546fea9099098d7329bddc0e5cc9da.
Verdict: approved. Blocking issues: 0. Warnings: 0.
Summary: Toolkit development defaults consistently use app port 3013 and Garage ports 3930–3933. Make exports the resolved app port into Overmind, while the existing API path remains /api/v1. Generated-site defaults remain unchanged. Documentation distinguishes global and repository-local CLI entries and records the repeatable startup procedure.
Acceptance criterion 1: met — recorded live Make/Overmind verification shows Slugkit on port 3013 and Rott retained on port 3000.
Acceptance criterion 2: met — only the global Slugkit development entry was updated to the actual localhost API address; repository-local config uses the resolved app port.
Acceptance criterion 3: met — live metadata and packaged specification match official contract 1.1.0.
Acceptance criterion 4: met — installed Doctor passes all seven checks, including official conformance and existing development authentication.
Acceptance criterion 5: met — recorded configuration comparison preserves other entries and credentials; Rott remains reachable. Backup/table comparison preserves database records and federation keys apart from expected API-key usage timestamps.
Acceptance criterion 6: met — README records the port, API base, normal Make startup, Garage isolation, and configuration guidance.
Verification: reviewer inspected the bounded diff, relevant Make/Procfile/setup behavior, and task evidence. Parent verified exact-head CI run 525 and full local checks with 1,261 tests; broad checks were not rerun.
Next: wait for explicit human merge and task-closure approval. No production deployment or npm release belongs to this task.

### Independent review - PR: [Slugkit #302](https://forge.caradoc.com/erik/slugkit/pulls/302) — open, reviewed head `607a967b88546fea9099098d7329bddc0e5cc9da`. - Verdict: approved. Blocking issues: 0. Warnings: 0. - Summary: Toolkit development defaults consistently use app port 3013 and Garage ports 3930–3933. Make exports the resolved app port into Overmind, while the existing API path remains `/api/v1`. Generated-site defaults remain unchanged. Documentation distinguishes global and repository-local CLI entries and records the repeatable startup procedure. - Acceptance criterion 1: met — recorded live Make/Overmind verification shows Slugkit on port 3013 and Rott retained on port 3000. - Acceptance criterion 2: met — only the global Slugkit development entry was updated to the actual localhost API address; repository-local config uses the resolved app port. - Acceptance criterion 3: met — live metadata and packaged specification match official contract 1.1.0. - Acceptance criterion 4: met — installed Doctor passes all seven checks, including official conformance and existing development authentication. - Acceptance criterion 5: met — recorded configuration comparison preserves other entries and credentials; Rott remains reachable. Backup/table comparison preserves database records and federation keys apart from expected API-key usage timestamps. - Acceptance criterion 6: met — README records the port, API base, normal Make startup, Garage isolation, and configuration guidance. - Verification: reviewer inspected the bounded diff, relevant Make/Procfile/setup behavior, and task evidence. Parent verified exact-head CI run 525 and full local checks with 1,261 tests; broad checks were not rerun. - Next: wait for explicit human merge and task-closure approval. No production deployment or npm release belongs to this task.

erik merged commit ac34f5ed07 into main

2026-10-13 16:57:51 -05:00

erik deleted branch fix/task-431d12b5-slugkit-dev-port

2026-10-13 16:57:51 -05:00

erik referenced this pull request from a commit

2026-10-13 16:57:52 -05:00

Merge pull request 'Run Slugkit development independently on port 3013' (#302) from fix/task-431d12b5-slugkit-dev-port into main