golem15/summercms
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(planning): commit accumulated workflow artifacts

Browse Source
This commit is contained in:
Jakub Zych
2026-10-06 22:31:37 +02:00
parent fdee6b626e
commit c05ad09dc2
29 changed files with 1129 additions and 107 deletions
Download Patch File Download Diff File Expand all files Collapse all files

281
.planning/tmp/14.2.1-verify-command-paths.json Normal file
View File

@@ -0,0 +1,281 @@
{
"status": "ok",
"commands": [
{
"command": "git ls-remote git@git.golem15.com:golem15/sm-translate-plugin.git",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-01-PLAN.md",
"task": "Task 1: Create the public Gitea remote and authorize local repository setup"
},
{
"command": "test -f /media/nvme/dev/golem15/fonoteka/plugins/golem15/translate/models/Locale.php && git -C /media/nvme/dev/golem15/fonoteka/plugins/golem15/translate rev-parse HEAD",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-01-PLAN.md",
"task": "Task 2: Confirm the one-way table contract"
},
{
"command": "go -C ../sm-translate-plugin vet ./... && go -C ../sm-translate-plugin test ./... -short -count=1 && go vet ./modules/surf/... && go test ./modules/surf -short -count=1",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-01-PLAN.md",
"task": "Task 3: Resolve one URL-prefixed request through the plugin, enabled Locale row, surf, and context"
},
{
"command": "go -C ../sm-translate-plugin test ./classes -count=1 -v -run '^(TestFixtureTranslatableSaveRead)$'",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-02-PLAN.md",
"task": "Task 1: Save one fixture title in en and pl, then read pl through the exported API"
},
{
"command": "go -C ../sm-translate-plugin vet ./... && go -C ../sm-translate-plugin test ./classes -count=1 -v -run '^(TestFixtureTranslatableSaveRead|TestFixtureTranslatedIndexSmoke)$'",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-02-PLAN.md",
"task": "Task 2: Add indexed locale lookup, WithLocale query scope, and default fallback"
},
{
"command": "go -C ../sm-translate-plugin vet ./... && go -C ../sm-translate-plugin test ./... -short -count=1 -v -run '^(TestLocalesAdminSmoke|TestLocalesAdminForbiddenSmoke)$'",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-02-PLAN.md",
"task": "Task 3: Manage Locales through permissioned YAML CRUD and separate phrasebook catalogs"
},
{
"command": "go test ./modules/cabana -count=1 -v -run '^(TestMLNestedSaveSmoke)$' && npm --prefix admin test -- --run admin/tests/form/MLFields.test.ts",
"status": "ok",
"severity": "none",
"reason": null,
"form": "prefix",
"rawTarget": "admin",
"target": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go/admin",
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-03-PLAN.md",
"task": "Task 1: Submit one mltext map through cabana and persist default plus Polish values"
},
{
"command": "git -C ../sm-grzybyfunkcjonalne-app rev-parse --is-inside-work-tree && git -C ../sm-grzybyfunkcjonalne-app remote get-url origin",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-03-PLAN.md",
"task": "Task 2: Confirm the one-way proof-host submodule layout"
},
{
"command": "go test ./cmd/summer -count=1 -run 'TestDocsTree' && go run ./cmd/summer docs:build --check && npm --prefix admin run typecheck && npm --prefix admin test -- --run admin/tests/form/registry.test.ts admin/tests/form/MLFields.test.ts && npm --prefix admin run build && go -C ../sm-grzybyfunkcjonalne-app vet ./... && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -run '^(TestBootUserTranslate)$'",
"status": "ok",
"severity": "none",
"reason": null,
"form": "prefix",
"rawTarget": "admin",
"target": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go/admin",
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-03-PLAN.md",
"task": "Task 3: Complete docs/OpenAPI/TS/dist and boot the user+translate proof host"
},
{
"command": "go -C ../sm-translate-plugin test ./... -count=1 -v -run '^(TestTranslateEndToEnd)$' && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -run '^(TestBootUserTranslate)$'",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-04-PLAN.md",
"task": "Task 1: Prove migration → activation → resolver → Locales admin → ML save → WithLocale read end to end"
},
{
"command": "go -C ../sm-translate-plugin test ./... -count=1 -race && go test ./modules/surf ./modules/cabana -count=1 -race && npm --prefix admin test -- --run admin/tests/form/registry.test.ts admin/tests/form/MLFields.test.ts admin/tests/form/MarkdownField.test.ts",
"status": "ok",
"severity": "none",
"reason": null,
"form": "prefix",
"rawTarget": "admin",
"target": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go/admin",
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-04-PLAN.md",
"task": "Task 2: Complete migration, Translator, Translatable, admin, ML, markdown, and SPA test matrices"
},
{
"command": "bash scripts/check-phase14.2.1.sh --all",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-04-PLAN.md",
"task": "Task 3: Build the fail-closed phase gate, security review, and validation sign-off"
},
{
"command": "test -f modules/cabana/field_ml.go && test -f ../sm-translate-plugin/classes/translatable.go && test -f ../sm-translate-plugin/classes/admin_writer.go",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-05-PLAN.md",
"task": "Task 1: Confirm TranslationWriter.TranslatedExact as the hydration contract"
},
{
"command": "go test ./modules/cabana -count=1 -v -run '^(TestMLHydration|TestMLNestedSave)$' && npm --prefix admin test -- --run admin/tests/form/MLFields.test.ts",
"status": "ok",
"severity": "none",
"reason": null,
"form": "prefix",
"rawTarget": "admin",
"target": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go/admin",
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-05-PLAN.md",
"task": "Task 2: Hydrate one mltext create/GET/save path and show en+pl on the SPA"
},
{
"command": "go test ./cmd/summer -count=1 -run 'TestDocsTree' && go run ./cmd/summer docs:build --check && bash scripts/check-admin-openapi.sh --check && npm --prefix admin run typecheck && npm --prefix admin test -- --run admin/tests/form/MLFields.test.ts admin/tests/form/formState.test.ts && npm --prefix admin run build && go -C ../sm-translate-plugin vet ./... && go -C ../sm-translate-plugin test ./classes -count=1 -v -run '^(TestTranslatableGetSet)$'",
"status": "ok",
"severity": "none",
"reason": null,
"form": "prefix",
"rawTarget": "admin",
"target": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go/admin",
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-05-PLAN.md",
"task": "Task 3: Cover mlmarkdown, relation-child adopt, and regenerate docs/OpenAPI/TS/dist"
},
{
"command": "go test ./modules/cabana -count=1 -v -run '^(TestRelationChildMLNestedSave)$'",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-06-PLAN.md",
"task": "Task 1: Lift one nested mltext map through CreateChild"
},
{
"command": "go test ./modules/cabana -count=1 -v -run '^(TestRelationChildMLNestedSave)$' && go test ./cmd/summer -count=1 -run 'TestDocsTree' && go run ./cmd/summer docs:build --check",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-06-PLAN.md",
"task": "Task 2: Mirror lift/apply/hydrate on UpdateChild and ShowChild"
},
{
"command": "go vet ./modules/cabana ./modules/surf ./cmd/summer && go test ./modules/cabana -count=1 -v -run '^(TestMLHydration|TestMLNestedSave|TestRelationChildMLNestedSave|TestMLFieldTypes)$' && npm --prefix admin test -- --run admin/tests/form/MLFields.test.ts && go -C ../sm-translate-plugin vet ./... && go -C ../sm-translate-plugin test ./... -count=1 -v -run '^(TestTranslateEndToEnd)$' && go -C ../sm-grzybyfunkcjonalne-app vet ./... && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -run '^(TestBootUserTranslate)$' && bash scripts/check-phase14.2.1.sh --all",
"status": "ok",
"severity": "none",
"reason": null,
"form": "prefix",
"rawTarget": "admin",
"target": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go/admin",
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "14.2.1-06-PLAN.md",
"task": "Task 3: Named unit/Vitest/cabana tests and the phase gate (last plan of 14.2.1)"
}
],
"counts": {
"blocker": 0,
"warning": 0,
"total": 18
},
"readError": null
}

155
.planning/tmp/14.2.1-verify-failure-directions.json Normal file
View File

@@ -0,0 +1,155 @@
{
"status": "ok",
"commands": [
{
"command": "git ls-remote git@git.golem15.com:golem15/sm-translate-plugin.git",
"statement": "Non-zero exit, authentication denial, or repository-not-found text.",
"status": "ok",
"severity": "none",
"plan": "14.2.1-01-PLAN.md",
"task": "Task 1: Create the public Gitea remote and authorize local repository setup"
},
{
"command": "test -f /media/nvme/dev/golem15/fonoteka/plugins/golem15/translate/models/Locale.php && git -C /media/nvme/dev/golem15/fonoteka/plugins/golem15/translate rev-parse HEAD",
"statement": "Non-zero exit or the printed SHA is not `725d547ec839f02b5fdc0f0a6faaed601a414d50`.",
"status": "ok",
"severity": "none",
"plan": "14.2.1-01-PLAN.md",
"task": "Task 2: Confirm the one-way table contract"
},
{
"command": "go -C ../sm-translate-plugin vet ./... && go -C ../sm-translate-plugin test ./... -short -count=1 && go vet ./modules/surf/... && go test ./modules/surf -short -count=1",
"statement": "Non-zero exit, any package reports build failed, or either test command reports FAIL.",
"status": "ok",
"severity": "none",
"plan": "14.2.1-01-PLAN.md",
"task": "Task 3: Resolve one URL-prefixed request through the plugin, enabled Locale row, surf, and context"
},
{
"command": "go -C ../sm-translate-plugin test ./classes -count=1 -v -run '^(TestFixtureTranslatableSaveRead)$'",
"statement": "Non-zero exit, output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\", or lacks \"--- PASS: TestFixtureTranslatableSaveRead\".",
"status": "ok",
"severity": "none",
"plan": "14.2.1-02-PLAN.md",
"task": "Task 1: Save one fixture title in en and pl, then read pl through the exported API"
},
{
"command": "go -C ../sm-translate-plugin vet ./... && go -C ../sm-translate-plugin test ./classes -count=1 -v -run '^(TestFixtureTranslatableSaveRead|TestFixtureTranslatedIndexSmoke)$'",
"statement": "Non-zero exit, output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\", or either named PASS line is absent.",
"status": "ok",
"severity": "none",
"plan": "14.2.1-02-PLAN.md",
"task": "Task 2: Add indexed locale lookup, WithLocale query scope, and default fallback"
},
{
"command": "go -C ../sm-translate-plugin vet ./... && go -C ../sm-translate-plugin test ./... -short -count=1 -v -run '^(TestLocalesAdminSmoke|TestLocalesAdminForbiddenSmoke)$'",
"statement": "Non-zero exit, output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\", or either named PASS line is absent.",
"status": "ok",
"severity": "none",
"plan": "14.2.1-02-PLAN.md",
"task": "Task 3: Manage Locales through permissioned YAML CRUD and separate phrasebook catalogs"
},
{
"command": "go test ./modules/cabana -count=1 -v -run '^(TestMLNestedSaveSmoke)$' && npm --prefix admin test -- --run admin/tests/form/MLFields.test.ts",
"statement": "Non-zero exit; Go output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\", lacks \"--- PASS: TestMLNestedSaveSmoke\", or Vitest reports no test files/tests or any failed test.",
"status": "ok",
"severity": "none",
"plan": "14.2.1-03-PLAN.md",
"task": "Task 1: Submit one mltext map through cabana and persist default plus Polish values"
},
{
"command": "git -C ../sm-grzybyfunkcjonalne-app rev-parse --is-inside-work-tree && git -C ../sm-grzybyfunkcjonalne-app remote get-url origin",
"statement": "Non-zero exit or origin is not the existing sm-grzybyfunkcjonalne-app remote.",
"status": "ok",
"severity": "none",
"plan": "14.2.1-03-PLAN.md",
"task": "Task 2: Confirm the one-way proof-host submodule layout"
},
{
"command": "go test ./cmd/summer -count=1 -run 'TestDocsTree' && go run ./cmd/summer docs:build --check && npm --prefix admin run typecheck && npm --prefix admin test -- --run admin/tests/form/registry.test.ts admin/tests/form/MLFields.test.ts && npm --prefix admin run build && go -C ../sm-grzybyfunkcjonalne-app vet ./... && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -run '^(TestBootUserTranslate)$'",
"statement": "Non-zero exit; docs checker reports stale identifiers/links/forbidden names; Vitest reports no tests or failures; build omits index.html/assets; host output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\", or lacks \"--- PASS: TestBootUserTranslate\".",
"status": "ok",
"severity": "none",
"plan": "14.2.1-03-PLAN.md",
"task": "Task 3: Complete docs/OpenAPI/TS/dist and boot the user+translate proof host"
},
{
"command": "go -C ../sm-translate-plugin test ./... -count=1 -v -run '^(TestTranslateEndToEnd)$' && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -run '^(TestBootUserTranslate)$'",
"statement": "Non-zero exit; either run prints \"--- FAIL\", \"--- SKIP\", \"no tests to run\", container startup failure treated as skip, or lacks its named \"--- PASS\" line.",
"status": "ok",
"severity": "none",
"plan": "14.2.1-04-PLAN.md",
"task": "Task 1: Prove migration → activation → resolver → Locales admin → ML save → WithLocale read end to end"
},
{
"command": "go -C ../sm-translate-plugin test ./... -count=1 -race && go test ./modules/surf ./modules/cabana -count=1 -race && npm --prefix admin test -- --run admin/tests/form/registry.test.ts admin/tests/form/MLFields.test.ts admin/tests/form/MarkdownField.test.ts",
"statement": "Non-zero exit; Go race detector reports a race; any package/test reports FAIL; integration tests unexpectedly SKIP in the plugin run; or Vitest reports no tests or failures.",
"status": "ok",
"severity": "none",
"plan": "14.2.1-04-PLAN.md",
"task": "Task 2: Complete migration, Translator, Translatable, admin, ML, markdown, and SPA test matrices"
},
{
"command": "bash scripts/check-phase14.2.1.sh --all",
"statement": "Non-zero exit; any stage is absent/skipped; output contains FAIL, a Go race, no-tests-to-run, unexpected SKIP, stale generated artifacts, forbidden deferred surface, unmitigated high threat, or lacks the final `Phase 14.2.1 gate passed` line.",
"status": "ok",
"severity": "none",
"plan": "14.2.1-04-PLAN.md",
"task": "Task 3: Build the fail-closed phase gate, security review, and validation sign-off"
},
{
"command": "test -f modules/cabana/field_ml.go && test -f ../sm-translate-plugin/classes/translatable.go && test -f ../sm-translate-plugin/classes/admin_writer.go",
"statement": "Non-zero exit, or any of the three paths is missing.",
"status": "ok",
"severity": "none",
"plan": "14.2.1-05-PLAN.md",
"task": "Task 1: Confirm TranslationWriter.TranslatedExact as the hydration contract"
},
{
"command": "go test ./modules/cabana -count=1 -v -run '^(TestMLHydration|TestMLNestedSave)$' && npm --prefix admin test -- --run admin/tests/form/MLFields.test.ts",
"statement": "Non-zero exit; Go output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\", lacks \"--- PASS: TestMLHydration\" or \"--- PASS: TestMLNestedSave\"; Vitest reports no test files/tests or any failed test.",
"status": "ok",
"severity": "none",
"plan": "14.2.1-05-PLAN.md",
"task": "Task 2: Hydrate one mltext create/GET/save path and show en+pl on the SPA"
},
{
"command": "go test ./cmd/summer -count=1 -run 'TestDocsTree' && go run ./cmd/summer docs:build --check && bash scripts/check-admin-openapi.sh --check && npm --prefix admin run typecheck && npm --prefix admin test -- --run admin/tests/form/MLFields.test.ts admin/tests/form/formState.test.ts && npm --prefix admin run build && go -C ../sm-translate-plugin vet ./... && go -C ../sm-translate-plugin test ./classes -count=1 -v -run '^(TestTranslatableGetSet)$'",
"statement": "Non-zero exit; docs checker reports stale identifiers, broken links, or a consuming-application name; OpenAPI --check reports stale committed output; Vitest reports no tests or failures; build omits index.html/assets; plugin output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\", or lacks \"--- PASS: TestTranslatableGetSet\".",
"status": "ok",
"severity": "none",
"plan": "14.2.1-05-PLAN.md",
"task": "Task 3: Cover mlmarkdown, relation-child adopt, and regenerate docs/OpenAPI/TS/dist"
},
{
"command": "go test ./modules/cabana -count=1 -v -run '^(TestRelationChildMLNestedSave)$'",
"statement": "Non-zero exit; output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\"; output lacks \"--- PASS: TestRelationChildMLNestedSave\".",
"status": "ok",
"severity": "none",
"plan": "14.2.1-06-PLAN.md",
"task": "Task 1: Lift one nested mltext map through CreateChild"
},
{
"command": "go test ./modules/cabana -count=1 -v -run '^(TestRelationChildMLNestedSave)$' && go test ./cmd/summer -count=1 -run 'TestDocsTree' && go run ./cmd/summer docs:build --check",
"statement": "Non-zero exit; cabana output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\", or lacks \"--- PASS: TestRelationChildMLNestedSave\"; docs checker reports stale identifiers, broken links, or a consuming-application name.",
"status": "ok",
"severity": "none",
"plan": "14.2.1-06-PLAN.md",
"task": "Task 2: Mirror lift/apply/hydrate on UpdateChild and ShowChild"
},
{
"command": "go vet ./modules/cabana ./modules/surf ./cmd/summer && go test ./modules/cabana -count=1 -v -run '^(TestMLHydration|TestMLNestedSave|TestRelationChildMLNestedSave|TestMLFieldTypes)$' && npm --prefix admin test -- --run admin/tests/form/MLFields.test.ts && go -C ../sm-translate-plugin vet ./... && go -C ../sm-translate-plugin test ./... -count=1 -v -run '^(TestTranslateEndToEnd)$' && go -C ../sm-grzybyfunkcjonalne-app vet ./... && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -run '^(TestBootUserTranslate)$' && bash scripts/check-phase14.2.1.sh --all",
"statement": "Non-zero exit; any Go output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\"; output lacks \"--- PASS: TestMLHydration\", \"--- PASS: TestMLNestedSave\", \"--- PASS: TestRelationChildMLNestedSave\", \"--- PASS: TestMLFieldTypes\", \"--- PASS: TestTranslateEndToEnd\", or \"--- PASS: TestBootUserTranslate\"; Vitest reports no tests or failures; gate output lacks the exact line \"Phase 14.2.1 gate passed\" or reports a missing required test / unmapped high threat.",
"status": "ok",
"severity": "none",
"plan": "14.2.1-06-PLAN.md",
"task": "Task 3: Named unit/Vitest/cabana tests and the phase gate (last plan of 14.2.1)"
}
],
"counts": {
"blocker": 0,
"warning": 0,
"total": 18
},
"readError": null
}

107
.planning/tmp/15-failing-directions.json Normal file
View File

@@ -0,0 +1,107 @@
{
"status": "ok",
"commands": [
{
"command": "git ls-remote git@git.golem15.com:golem15/sm-journal-plugin.git && git -C /media/nvme/dev/golem15/fonoteka/plugins/golem15/journal rev-parse HEAD && go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -count=1 -v -run '^(TestPostTranslatableSmoke)$' && go -C ../sm-grzybyfunkcjonalne-app vet ./... && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -run '^(TestBootUserTranslateJournal)$'",
"statement": "Non-zero exit; PHP SHA is not 02110eb1c0c3861370b0b9b47b209a0702ac5d88; output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\"; either named PASS line is absent; journal remote is missing.",
"status": "ok",
"severity": "none",
"plan": "15-01-PLAN.md",
"task": "Task 1: Clone the plugin, persist one en/pl Post title, and boot the host with three plugins"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./updates -count=1 -v -run '^(TestJournalTables)$'",
"statement": "Non-zero exit; output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\"; lacks \"--- PASS: TestJournalTables\".",
"status": "ok",
"severity": "none",
"plan": "15-01-PLAN.md",
"task": "Task 2: Add categories, tags, pivots, settings singleton, and author_slug"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -short -count=1 && python3 -c 'import pathlib,sys; t=pathlib.Path(\"../sm-journal-plugin/README.md\").read_text(); bad=[\"grzybyfunkcjonalne\",\"Płytarium\",\"fonoteka.go\",\"plytarium\"];\nsys.exit(1 if any(b.lower() in t.lower() for b in bad) else 0)' && grep -F \"_journal/api/*\" ../sm-grzybyfunkcjonalne-app/config/http.yaml && test -f ../sm-journal-plugin/lang/en/lang.yaml && test -f ../sm-journal-plugin/lang/pl/lang.yaml",
"statement": "Non-zero exit; plugin tests FAIL; README python check exits 1; grep does not print _journal/api/*; either lang YAML is missing.",
"status": "ok",
"severity": "none",
"plan": "15-01-PLAN.md",
"task": "Task 3: Add en/pl phrasebook, neutral README, and host CORS"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -count=1 -v -run '^(TestPostsFormCompiles|TestPostsAdminCreateSmoke)$'",
"statement": "Non-zero exit; output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\"; either named PASS line is absent.",
"status": "ok",
"severity": "none",
"plan": "15-02-PLAN.md",
"task": "Task 1: Create one Post through cabana with mlmarkdown and FormatHTML"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -short -count=1 && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -run '^(TestBootUserTranslateJournal)$'",
"statement": "Non-zero exit; output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\"; host run lacks \"--- PASS: TestBootUserTranslateJournal\".",
"status": "ok",
"severity": "none",
"plan": "15-02-PLAN.md",
"task": "Task 2: Categories, Tags, Settings screens and remaining query guards"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -count=1 -v -run '^(TestJournalCommands)$'",
"statement": "Non-zero exit; output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\"; lacks \"--- PASS: TestJournalCommands\".",
"status": "ok",
"severity": "none",
"plan": "15-02-PLAN.md",
"task": "Task 3: Register journal:export-posts and journal:import-posts plus Posts toolbar"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -count=1 -v -run '^(TestJournalPublicList|TestJournalBuckets)$'",
"statement": "Non-zero exit; output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\"; either named PASS line is absent.",
"status": "ok",
"severity": "none",
"plan": "15-03-PLAN.md",
"task": "Task 1: Serve anonymous GET /_journal/api/v1/posts as a published list"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -count=1 -v -run '^(TestJournalWriteUnauthenticated|TestJournal005DraftShow|TestJournalPublicCategories|TestJournalPublicTags|TestJournalFeaturedImageUnauthenticated)$'",
"statement": "Non-zero exit; output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\"; any of the named PASS lines is absent (TestJournalWriteUnauthenticated, TestJournal005DraftShow, TestJournalPublicCategories, TestJournalPublicTags, TestJournalFeaturedImageUnauthenticated).",
"status": "ok",
"severity": "none",
"plan": "15-03-PLAN.md",
"task": "Task 2: Slug show, draft 404, and backend-Bearer writes"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -count=1 -v -run '^(TestJournal006MediaUpload|TestSearchGateOff|TestJournalRSS)$' && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -run '^(TestBootUserTranslateJournal)$'",
"statement": "Non-zero exit; output contains \"--- FAIL\", \"--- SKIP\", or \"no tests to run\"; any of the named PASS lines is absent (TestJournal006MediaUpload, TestSearchGateOff, TestJournalRSS, TestBootUserTranslateJournal).",
"status": "ok",
"severity": "none",
"plan": "15-03-PLAN.md",
"task": "Task 3: Media upload, RSS, Typesense gate, and host route assertion"
},
{
"command": "go -C ../sm-journal-plugin test ./... -count=1 -v -run '^(TestJournalEndToEnd)$' && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -run '^(TestBootUserTranslateJournal)$'",
"statement": "Non-zero exit; either run prints \"--- FAIL\", \"--- SKIP\", \"no tests to run\", or container startup treated as skip; lacks its named PASS line.",
"status": "ok",
"severity": "none",
"plan": "15-04-PLAN.md",
"task": "Task 1: Prove migrate → admin save → anonymous list → Bearer write → draft 404 end to end"
},
{
"command": "go -C ../sm-journal-plugin test ./... -count=1 -v -race && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -race",
"statement": "Non-zero exit; Go race detector reports a race; any package reports FAIL; integration tests unexpectedly SKIP in the plugin run; output lacks PASS lines for TestJournalPublicCategories, TestJournalPublicTags, TestJournalRSS, and TestJournalFeaturedImageUnauthenticated.",
"status": "ok",
"severity": "none",
"plan": "15-04-PLAN.md",
"task": "Task 2: Complete PHPUnit map, migrations, YAML, FormatHTML, and search-gate tests"
},
{
"command": "bash scripts/check-phase15.sh --all",
"statement": "Non-zero exit; any stage absent or skipped; output contains FAIL, a Go race, no-tests-to-run, unexpected SKIP, unmitigated high threat, PHP tree dirty; lacks PASS evidence for TestJournalPublicCategories, TestJournalPublicTags, TestJournalRSS, or TestJournalFeaturedImageUnauthenticated; or lacks the final Phase 15 gate passed line.",
"status": "ok",
"severity": "none",
"plan": "15-04-PLAN.md",
"task": "Task 3: Phase gate, security review, and validation sign-off"
}
],
"counts": {
"blocker": 0,
"warning": 0,
"total": 12
},
"readError": null
}

191
.planning/tmp/15-verify-paths.json Normal file
View File

@@ -0,0 +1,191 @@
{
"status": "not_applicable",
"commands": [
{
"command": "git ls-remote git@git.golem15.com:golem15/sm-journal-plugin.git && git -C /media/nvme/dev/golem15/fonoteka/plugins/golem15/journal rev-parse HEAD && go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -count=1 -v -run '^(TestPostTranslatableSmoke)$' && go -C ../sm-grzybyfunkcjonalne-app vet ./... && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -run '^(TestBootUserTranslateJournal)$'",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "15-01-PLAN.md",
"task": "Task 1: Clone the plugin, persist one en/pl Post title, and boot the host with three plugins"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./updates -count=1 -v -run '^(TestJournalTables)$'",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "15-01-PLAN.md",
"task": "Task 2: Add categories, tags, pivots, settings singleton, and author_slug"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -short -count=1 && python3 -c 'import pathlib,sys; t=pathlib.Path(\"../sm-journal-plugin/README.md\").read_text(); bad=[\"grzybyfunkcjonalne\",\"Płytarium\",\"fonoteka.go\",\"plytarium\"];\nsys.exit(1 if any(b.lower() in t.lower() for b in bad) else 0)' && grep -F \"_journal/api/*\" ../sm-grzybyfunkcjonalne-app/config/http.yaml && test -f ../sm-journal-plugin/lang/en/lang.yaml && test -f ../sm-journal-plugin/lang/pl/lang.yaml",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "15-01-PLAN.md",
"task": "Task 3: Add en/pl phrasebook, neutral README, and host CORS"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -count=1 -v -run '^(TestPostsFormCompiles|TestPostsAdminCreateSmoke)$'",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "15-02-PLAN.md",
"task": "Task 1: Create one Post through cabana with mlmarkdown and FormatHTML"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -short -count=1 && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -run '^(TestBootUserTranslateJournal)$'",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "15-02-PLAN.md",
"task": "Task 2: Categories, Tags, Settings screens and remaining query guards"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -count=1 -v -run '^(TestJournalCommands)$'",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "15-02-PLAN.md",
"task": "Task 3: Register journal:export-posts and journal:import-posts plus Posts toolbar"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -count=1 -v -run '^(TestJournalPublicList|TestJournalBuckets)$'",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "15-03-PLAN.md",
"task": "Task 1: Serve anonymous GET /_journal/api/v1/posts as a published list"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -count=1 -v -run '^(TestJournalWriteUnauthenticated|TestJournal005DraftShow|TestJournalPublicCategories|TestJournalPublicTags|TestJournalFeaturedImageUnauthenticated)$'",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "15-03-PLAN.md",
"task": "Task 2: Slug show, draft 404, and backend-Bearer writes"
},
{
"command": "go -C ../sm-journal-plugin vet ./... && go -C ../sm-journal-plugin test ./... -count=1 -v -run '^(TestJournal006MediaUpload|TestSearchGateOff|TestJournalRSS)$' && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -run '^(TestBootUserTranslateJournal)$'",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "15-03-PLAN.md",
"task": "Task 3: Media upload, RSS, Typesense gate, and host route assertion"
},
{
"command": "go -C ../sm-journal-plugin test ./... -count=1 -v -run '^(TestJournalEndToEnd)$' && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -run '^(TestBootUserTranslateJournal)$'",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "15-04-PLAN.md",
"task": "Task 1: Prove migrate → admin save → anonymous list → Bearer write → draft 404 end to end"
},
{
"command": "go -C ../sm-journal-plugin test ./... -count=1 -v -race && go -C ../sm-grzybyfunkcjonalne-app test ./... -count=1 -v -race",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "15-04-PLAN.md",
"task": "Task 2: Complete PHPUnit map, migrations, YAML, FormatHTML, and search-gate tests"
},
{
"command": "bash scripts/check-phase15.sh --all",
"status": "not_applicable",
"severity": "none",
"reason": null,
"form": null,
"rawTarget": null,
"target": null,
"manifest": null,
"script": null,
"sentinel": false,
"base": "/media/nvme/dev/golem15/summercms.io/summercms/summercms.go",
"plan": "15-04-PLAN.md",
"task": "Task 3: Phase gate, security review, and validation sign-off"
}
],
"counts": {
"blocker": 0,
"warning": 0,
"total": 12
},
"readError": null
}

139
.planning/tmp/plan-pre-ai-integration.md Normal file
View File

@@ -0,0 +1,139 @@
# API Coverage Decision Checkpoint
> Full API Coverage by Default — Opt Out, Never Opt In. Fires when a phase
> integrates an external API / SDK / service. Most non-API phases will not fire
> it — that is the point.
## Why this exists
"We integrated the API" too often silently means "we integrated whatever the
first use case exercised." Every un-built capability is then an invisible hole,
discovered later by a user who reasonably expected it to work. The phase sealed
green because its tasks completed; nobody decided the gaps were acceptable,
because nobody enumerated them. This checkpoint makes the surface **visible and
decided** before the phase can seal.
## Detect whether this phase integrates an external API
The detector is a deterministic scan over the phase scope. It strips fenced
code blocks first, so a trigger term inside a code snippet does not fire. It
returns a typed result: `{ detected, signals[], terms }`. Run it on the phase
scope (the concatenation of this phase's ROADMAP section + the PLAN body):
```bash
SCOPE="$(cat "${PHASE_DIR}"/*-PLAN.md 2>/dev/null) $(gsd_run query roadmap.get-phase "${PHASE}" 2>/dev/null || true)"
API_COVERAGE_JSON=$(printf '%s' "$SCOPE" | node gsd-core/bin/lib/api-coverage.cjs --json 2>/dev/null) || true
[ -n "$API_COVERAGE_JSON" ] || API_COVERAGE_JSON='{"skipped":true,"reason":"probe_unavailable"}'
```
The `|| true` neutralizes the assignment's status without discarding the
detector's own payload: the detector exits **1** for a real "no integration"
verdict, so treating any non-zero exit as failure would throw away a correct
answer. Emptiness — not exit status — is what proves the probe never ran, and
the second line is the only place the fragment manufactures a payload of its
own — one that records the *absence* of a verdict rather than asserting one.
The detector's exit code and `--json` payload now distinguish a real negative
from an unexamined input (ADR-3889 Phase 3, #3907): empty/whitespace-only
`$SCOPE` or a stdin read failure emit `{"skipped":true,"reason":"no_input"|
"stdin_error"}` — no `detected` key at all. **Check for `skipped` before
reading `detected`**: a `skipped` payload is not a confirmed "no API
integration" verdict, it means the detector never examined real input. Do not
treat it as `detected:false`. Read `API_COVERAGE_JSON.detected` only when
`skipped` is absent — act on it only, do **not** pattern-match the prose
yourself.
**If `skipped` is `true`:** the detector could not establish a scope (empty
`$SCOPE`) or failed to run (stdin read error). Skip the checkpoint for this
run rather than asserting a verdict about input that was never examined; do
not raise it with the user.
**If `detected` is `false`:** this phase does not integrate an external API. Skip
the checkpoint entirely and continue planning. Do not raise it with the user.
**If `detected` is `true`:** an external-API integration is in scope. You MUST
produce a **coverage matrix** before the plan is finalized.
**If `detected` is `true` but the phase genuinely integrates no external API**
(the detector is deterministic, not infallible — confirm by re-reading the phase
scope, not by preference): do NOT fabricate a matrix row for a capability that
does not exist. Write a reasoned declaration to `${PHASE_DIR}/COVERAGE.md`
instead:
```markdown
No external API integration: <one-line reason — what the phase touches instead>.
```
The reason is required, exactly like an `OPT-OUT` reason. The seal-time gate
accepts this declaration in place of a matrix.
## Produce the coverage matrix
Enumerate the external API's full **capability surface** — the verb/endpoint/method
list (e.g. for a music service: `search`, `play`, `pause`, `skip`, `set_volume`,
`get_playlist`, `create_playlist`, `add_to_playlist`, …). For each capability
record a decision, starting from **full coverage** as the default:
| capability | decision | reason |
|---|---|---|
| `<capability-id>` | `INTEGRATE` \| `OPT-OUT` | `<one-line reason if OPT-OUT>` |
Rules:
- **`INTEGRATE` is the default.** Every capability starts as INTEGRATE; the
matrix is the *subtraction record*.
- **Every `OPT-OUT` MUST carry a one-line reason** (`not needed`, `not needed
yet`, `explicitly out of scope`, …). An opt-out without a reason is an
un-decided hole — the exact failure mode this gate exists to close.
- **A second integration against the same need** (e.g. a second platform for the
same capability) starts from the **same full-coverage baseline** as the first.
Do not carry over the first integration's opt-outs silently — re-decide each
capability for the new surface, so a first-class/fallback asymmetry cannot
accumulate.
Write the matrix to `${PHASE_DIR}/COVERAGE.md` (canonical markdown-table form):
```markdown
# API Coverage — <service>
> Full coverage by default. Opt-outs are explicit, reasoned decisions.
| capability | decision | reason |
|---|---|---|
| search | INTEGRATE | |
| playlists | INTEGRATE | |
| skip | OPT-OUT | not needed yet — tracked for follow-up phase |
```
A fenced ` ```coverage ` JSON block is also accepted for machine-generated
matrices; the markdown table is preferred (human-editable, diff-friendly).
## The seal-time gate
This checkpoint is enforced. At `verify:pre` the `api-coverage.verify-pre` gate
runs `check api-coverage.verify-pre <phase-dir>`:
- If `COVERAGE.md` exists, it is validated — every row needs a valid decision and
every `OPT-OUT` a reason. A malformed/partial matrix **blocks the seal**. A
reasoned `No external API integration: …` declaration (and no rows) passes.
- If `COVERAGE.md` is absent, the detector runs again over the phase scope. If a
strong external-API-integration signal is found, the seal is **blocked** until a
matrix is produced. If no signal is found, the phase is treated as a non-API
phase and the seal proceeds.
So: an API-integrating phase cannot seal without a decided matrix. Produce it at
plan time; do not leave it for seal time.
## Tuning the vocabulary (optional)
The trigger vocabulary is a curated, additive-only set in
`gsd-core/bin/lib/api-coverage.cjs` (`DEFAULT_API_COVERAGE_TERMS`). To widen it
for a project, override at the call site:
```bash
printf '%s' "$SCOPE" | node gsd-core/bin/lib/api-coverage.cjs --json \
--verbs integrate,wrap,connect,embed --nouns api,sdk,rest,grpc,webhook,plugin
```
The whole checkpoint is toggleable via `workflow.api_coverage_gate` in
`.planning/config.json`.

56
.planning/tmp/plan-pre-assumption-delta.md Normal file
View File

@@ -0,0 +1,56 @@
# Assumption-Delta Architecture Checkpoint
> Advisory, non-blocking. Fires **only** when the phase scope shows a singular→plural / required→optional / derived→chosen transition. When it fires, it surfaces ONE identity-model question before the plan is finalized. Most phases will not fire it — that is the point.
## Why this exists
Most quietly-imported architectural debt does not come from a missing upfront design phase. It comes at the *seam*: a later phase introduces a second case (a second platform, auth method, tenant, region, source of truth) and nobody re-asks whether the original abstraction still names the right thing. The phase that adds the second case is exactly the 20-minute conversation that prevents an afternoon of later cleanup.
## Run the detector
The detector is a deterministic scan over the phase scope text. It strips fenced code blocks first, so a trigger word that appears only inside a code snippet does not fire. It returns a typed result: `{ detected, signals[], terms }`. Resolve it through the `assumption-delta scan` query (same phase-section resolver as `roadmap.get-phase`):
```bash
ASSUMPTION_DELTA_JSON=$(gsd_run query assumption-delta scan "${PHASE}" --json 2>/dev/null) || true
[ -n "$ASSUMPTION_DELTA_JSON" ] || ASSUMPTION_DELTA_JSON='{"skipped":true,"reason":"probe_unavailable"}'
```
> If the phase section cannot be resolved (no `ROADMAP.md` / unknown phase, or a section with no body), the query emits `{ "skipped": true, "reason": "phase_unresolved" }` — **not** `detected:false`. A probe that never had input does not get to assert that this phase changes no core assumption. The checkpoint does not fire either way; the difference is that a skip is now distinguishable from a real negative. Do not block on it.
>
> Optional tuning — pass `--terms <comma-list>` to replace the curated pluralization cues for this project (the `optional`/`chosen` cues keep their defaults): `gsd_run query assumption-delta scan "${PHASE}" --json --terms second,alternative,fallback`.
## Decision branch
Read `ASSUMPTION_DELTA_JSON`. Act on `detected` only — do **not** pattern-match the human prose.
**If `skipped` is `true`:** the detector never examined a phase section — it could not resolve one (`phase_unresolved`) or could not run at all (`probe_unavailable`). Skip the checkpoint for this run rather than asserting a verdict about input that was never examined; do not raise it with the user. **Check for `skipped` before reading `detected`** — a skipped payload carries no `detected` key, and treating its absence as `false` re-creates the fabrication this branch exists to prevent.
**If `detected` is `false`:** this phase does not change a core assumption. Skip the checkpoint entirely and continue planning. Do not raise it with the user.
**If `detected` is `true`:** a core assumption may have lost its monopoly. The `signals[]` array tells you which family fired:
| `kind` | What changed | The question to answer |
|---|---|---|
| `pluralization` | A second X was introduced where there was one (second platform / auth method / tenant / region / source of truth) | Does the current primary key / identity model still name the right noun? |
| `optional` | A required / `only` field became optional | Is the field still the right anchor, or has the anchor moved? |
| `chosen` | A derived value became chosen, or a constant became a parameter | Has a configuration decision become a modeling decision? |
Before finalizing the plan, answer this for the user and record the decision explicitly:
> **Promote vs. add-alongside.** The usual correct move when a generalization occurs is to **promote** the new general representation to the primary and **demote** the old specific one to a detail of one variant — *not* to add the new one alongside the still-required old one. Adding alongside silently contradicts the generalized intent (a later variant that does not fit the old primary can be stored but never confirmed as a default).
Record the outcome in the PLAN.md front matter / a `<assumption_delta_decision>` block:
- The **noun** that is now primary (the generalized identity).
- The **decision**: `promote` | `add-alongside` | `no-change`, with a one-line rationale.
- If `add-alongside`: call it out as accepted debt and note what would force a later promote.
## Optional companion: an invariant test
When `detected` is `true`, suggest (do not require) a contract/invariant test that encodes the now-generalized intent — e.g. *"every confirmed default round-trips through the primary use-path, for every supported variant."* That test goes red the instant a future phase reintroduces the singular assumption, so the regression cannot land silently. If the user accepts, add the test as a task in the plan.
## Tuning the vocabulary (optional)
The trigger vocabulary is a curated, additive-only set in `gsd-core/bin/lib/assumption-delta.cjs` (`DEFAULT_ASSUMPTION_DELTA_TERMS`). Bare "or" is intentionally excluded — it is too common in prose and would make the gate fire constantly. To widen or narrow the cues for a project, override at the call site with `--terms <comma-list>` (replaces the pluralization cues; `optional`/`chosen` keep defaults). The whole checkpoint is toggleable via `workflow.assumption_delta` in `.planning/config.json`.
This checkpoint is advisory: it informs and records; it never blocks the phase.

61
.planning/tmp/plan-pre-schema-gate.md Normal file
View File

@@ -0,0 +1,61 @@
# Schema Push Detection Gate
> Detects schema-relevant files in the phase scope and injects a mandatory `[BLOCKING]` schema push task into the plan. Prevents false-positive verification where build/types pass because TypeScript types come from config, not the live database.
Check if any files in the phase scope match schema patterns:
```bash
PHASE_SECTION=$(gsd_run query roadmap.get-phase "${PHASE}" --pick section 2>/dev/null)
```
Scan `PHASE_SECTION`, `CONTEXT.md` (if loaded), and `RESEARCH.md` (if exists) for file paths matching these ORM patterns:
| ORM | File Patterns |
|-----|--------------|
| Payload CMS | `src/collections/**/*.ts`, `src/globals/**/*.ts` |
| Prisma | `prisma/schema.prisma`, `prisma/schema/*.prisma` |
| Drizzle | `drizzle/schema.ts`, `src/db/schema.ts`, `drizzle/*.ts` |
| Supabase | `supabase/migrations/*.sql` |
| TypeORM | `src/entities/**/*.ts`, `src/migrations/**/*.ts` |
Also check if any existing PLAN.md files for this phase already reference these file patterns in `files_modified`.
**If schema-relevant files detected:**
Set `SCHEMA_PUSH_REQUIRED=true` and `SCHEMA_ORM={detected_orm}`.
Determine the push command for the detected ORM:
| ORM | Push Command | Non-TTY Workaround |
|-----|-------------|-------------------|
| Payload CMS | `npx payload migrate` | `CI=true PAYLOAD_MIGRATING=true npx payload migrate` |
| Prisma | `npx prisma db push` | `npx prisma db push --accept-data-loss` (if destructive) |
| Drizzle | `npx drizzle-kit push` | `npx drizzle-kit push` |
| Supabase | `supabase db push` | Set `SUPABASE_ACCESS_TOKEN` env var |
| TypeORM | `npx typeorm migration:run` | `npx typeorm migration:run -d src/data-source.ts` |
Inject the following into the planner prompt (step 8) as an additional constraint:
```markdown
<schema_push_requirement>
**[BLOCKING] Schema Push Required**
This phase modifies schema-relevant files ({detected_files}). The planner MUST include
a `[BLOCKING]` task that runs the database schema push command AFTER all schema file
modifications are complete but BEFORE verification.
- ORM detected: {SCHEMA_ORM}
- Push command: {push_command}
- Non-TTY workaround: {env_hint}
- If push requires interactive prompts that cannot be suppressed, flag the task for
manual intervention with `autonomous: false`
This task is mandatory — the phase CANNOT pass verification without it. Build and
type checks will pass without the push (types come from config, not the live database),
creating a false-positive verification state.
</schema_push_requirement>
```
Display: `Schema files detected ({SCHEMA_ORM}) — [BLOCKING] push task will be injected into plans`
**If no schema-relevant files detected:** Skip silently.

1
.planning/tmp/plan-pre-security.md Normal file
View File

@@ -0,0 +1 @@
Each PLAN.md must include a <threat_model> block when security enforcement is active. Use the configured ASVS level and blocking threshold from workflow.security_asvs_level and workflow.security_block_on.