erik/slugkit

Fork 0

Research erikcraddock.me Slugkit API migration #4

New issue

Closed

opened 2026-05-19 19:51:44 -05:00 by erik · 2 comments

erik commented

2026-05-19 19:51:44 -05:00

Owner

Goal

Research how to adapt the current erikcraddock.me site to the Slugkit API contract and save the findings as a conversion document in ~/Private/code/github/evcraddock/erikcraddock.me/docs.

Reference docs: docs/reference-site-findings.md, docs/api-design.md, and all route specs in docs/specs/ from the Slugkit repository.

Requirements

Use the current repository ~/Private/code/github/evcraddock/erikcraddock.me as the reference; do not use erikcraddock-old.me.
Research only: do not implement API changes in this task.
Compare the current site API/OpenAPI behavior against the Slugkit API specs.
Identify mismatches in route names, resource terminology, request JSON, response JSON, auth behavior, OpenAPI operation IDs, and standardized error shapes.
Preserve existing site behavior assumptions by documenting migration risks instead of changing code.
Document practical conversion steps, recommended implementation order, likely risks, and any follow-on tasks needed.
Save the final conversion document in ~/Private/code/github/evcraddock/erikcraddock.me/docs.

Acceptance criteria

Current erikcraddock.me API is audited against every Slugkit route spec.
A conversion document exists in ~/Private/code/github/evcraddock/erikcraddock.me/docs.
The document lists required route, terminology, request/response, OpenAPI, auth, and error-shape changes.
The document identifies changes that are safe, risky, blocked, or need follow-up tasks.
The document includes a recommended implementation sequence for later coding tasks.
No functional API migration changes are implemented in this task.

Dependencies

task-c272cbda
task-47be19ea
task-782a7074
task-8fbb8c0c
task-e8b46ccd
task-43f5a652
task-fb0840e3
task-8b14c508
task-a5f5c185
task-11469f4d
task-b26679e3
task-64b4aa7e
task-7dac3c73

## Goal Research how to adapt the current `erikcraddock.me` site to the Slugkit API contract and save the findings as a conversion document in `~/Private/code/github/evcraddock/erikcraddock.me/docs`. Reference docs: `docs/reference-site-findings.md`, `docs/api-design.md`, and all route specs in `docs/specs/` from the Slugkit repository. ## Requirements - Use the current repository `~/Private/code/github/evcraddock/erikcraddock.me` as the reference; do not use `erikcraddock-old.me`. - Research only: do not implement API changes in this task. - Compare the current site API/OpenAPI behavior against the Slugkit API specs. - Identify mismatches in route names, resource terminology, request JSON, response JSON, auth behavior, OpenAPI operation IDs, and standardized error shapes. - Preserve existing site behavior assumptions by documenting migration risks instead of changing code. - Document practical conversion steps, recommended implementation order, likely risks, and any follow-on tasks needed. - Save the final conversion document in `~/Private/code/github/evcraddock/erikcraddock.me/docs`. ## Acceptance criteria - [ ] Current `erikcraddock.me` API is audited against every Slugkit route spec. - [ ] A conversion document exists in `~/Private/code/github/evcraddock/erikcraddock.me/docs`. - [ ] The document lists required route, terminology, request/response, OpenAPI, auth, and error-shape changes. - [ ] The document identifies changes that are safe, risky, blocked, or need follow-up tasks. - [ ] The document includes a recommended implementation sequence for later coding tasks. - [ ] No functional API migration changes are implemented in this task. ## Dependencies - task-c272cbda - task-47be19ea - task-782a7074 - task-8fbb8c0c - task-e8b46ccd - task-43f5a652 - task-fb0840e3 - task-8b14c508 - task-a5f5c185 - task-11469f4d - task-b26679e3 - task-64b4aa7e - task-7dac3c73

erik added the

labels

2026-05-19 19:51:44 -05:00

erik added

priority:low

and removed

priority:medium

labels

2026-06-11 07:35:07 -05:00

erik changed title from ~~Adapt erikcraddock.me to Slugkit API~~ to Research erikcraddock.me Slugkit API migration

2026-06-30 14:34:58 -05:00

erik added

status:inprogress

and removed

status:active

labels

2026-06-30 14:40:39 -05:00

erik commented

2026-06-30 14:46:17 -05:00

Author

Owner

Synced from todu comment by @todu on 2026-06-30T19:45:54.385Z

PR ready for review

Created research-only conversion document in erikcraddock.me: docs/SLUGKIT_API_CONVERSION.md.
Opened PR: https://github.com/evcraddock/erikcraddock.me/pull/192
CI: GitHub Quality Checks passed.
Verification run: npm exec --package=prettier@3.0.0 -- prettier --check docs/SLUGKIT_API_CONVERSION.md.
Scope respected: no functional API migration changes were made; only the conversion research document was added.

Waiting for human review/merge approval.

_Synced from todu comment by @todu on 2026-06-30T19:45:54.385Z_ ### PR ready for review - Created research-only conversion document in `erikcraddock.me`: `docs/SLUGKIT_API_CONVERSION.md`. - Opened PR: https://github.com/evcraddock/erikcraddock.me/pull/192 - CI: GitHub Quality Checks passed. - Verification run: `npm exec --package=prettier@3.0.0 -- prettier --check docs/SLUGKIT_API_CONVERSION.md`. - Scope respected: no functional API migration changes were made; only the conversion research document was added. Waiting for human review/merge approval.

erik

2026-06-30 14:57:40 -05:00

closed this issue
added
status:done
and removed
status:inprogress
labels

erik commented

2026-06-30 14:57:42 -05:00

Author

Owner

Synced from todu comment by @todu on 2026-06-30T19:52:18.496Z

Closing summary

Research-only scope is complete.

Evidence:

Added conversion document in erikcraddock.me: docs/SLUGKIT_API_CONVERSION.md.
The document audits the current API against Slugkit specs 00-11 and covers route names, terminology, request/response shapes, OpenAPI/operation IDs, auth, standardized errors, risks, and recommended implementation order.
No functional API migration changes were made; only the documentation file was added.
PR #192 exists for the documentation branch and GitHub Quality Checks passed.
Follow-on design task created: task-2663ab5b.

_Synced from todu comment by @todu on 2026-06-30T19:52:18.496Z_ ### Closing summary Research-only scope is complete. Evidence: - Added conversion document in `erikcraddock.me`: `docs/SLUGKIT_API_CONVERSION.md`. - The document audits the current API against Slugkit specs 00-11 and covers route names, terminology, request/response shapes, OpenAPI/operation IDs, auth, standardized errors, risks, and recommended implementation order. - No functional API migration changes were made; only the documentation file was added. - PR #192 exists for the documentation branch and GitHub Quality Checks passed. - Follow-on design task created: `task-2663ab5b`.