@stacksjs/defaults 0.75.109 → 0.75.111

package/ai/skills/stacks-forms/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: stacks-forms
+description: Use when building persisted form definitions, conditional fields, uploads, payments, submissions, or CSV exports. Covers @stacksjs/forms and config/forms.ts.
+license: MIT
+compatibility: Bun >= 1.3.0, TypeScript
+allowed-tools: Read Edit Write Bash Grep Glob
+---
+
+# Native forms
+
+Use the persisted form-builder API for forms managed as data. This is distinct
+from browser useForm state and validation; read stacks-composables for that.
+
+## Definitions and submissions
+
+createForm(siteId, input) creates or updates a form by its site-scoped handle.
+Re-provisioning replaces its field document; it does not merge removed fields.
+Fields declare name, label, type, required status, options, conditions and width.
+loadFormByHandle and loadFormByUuid read definitions; publicDefinition removes
+private settings from the public projection.
+
+Use evaluateConditions/visibleFields and validateSubmission rather than
+duplicating conditional-required logic in a route. submitForm persists the
+accepted input; fetchSubmissions and exportSubmissionsCsv serve administrative
+reads. Supply the site identity from trusted request context. A null site id is
+the single-site/global context, not a tenant identity from a client.
+
+## Uploads, notifications, and paid forms
+
+Use resolveUploadLimits, checkUpload, fileFieldNamed, formUploadPrefix and
+isOwnedUploadPath for the upload workflow. Do not accept an arbitrary storage
+path as proof that a submitted file belongs to this form/site.
+dispatchSubmissionNotifications currently sends submission email through the
+configured notification/email transport; it is not a six-channel form notifier.
+computeAmountCents and completeSubmissionPayment support the paid-submission
+flow; verify payment through the server's provider contract, not a browser flag.
+
+Enable/install the forms bundle and migrate its models before persistence.
+Read stacks-sites, stacks-storage, stacks-payments and stacks-notifications for
+their actual boundaries. Test hidden/conditional fields, upload ownership,
+duplicate or invalid payments, and a different site's form identifier.
+
+Source: core/forms/src/{create,definition,conditions,validate,submissions,uploads,
+notifications}.ts. Retained tests: forms.test.ts and uploads.test.ts.

package/ai/skills/stacks-git/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matt Pocock
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/ai/skills/stacks-git/NOTICE.md

@@ -0,0 +1,10 @@
+# Source and license
+
+The upstream MIT notice is preserved in [LICENSE](LICENSE).
+
+## setup-pre-commit
+
+Source: [skills/misc/setup-pre-commit/SKILL.md](https://github.com/mattpocock/skills/blob/49dd158d1076134a641b33efb035946536778336/skills/misc/setup-pre-commit/SKILL.md),
+revision `49dd158d1076134a641b33efb035946536778336`.
+
+Use the existing bun-git-hooks and pickier integration supplied by better-dx instead of adding Husky, lint-staged, and Prettier.

package/ai/skills/stacks-git/SKILL.md

@@ -176,6 +176,17 @@ Credit: adapted from Matt Pocock's `resolving-merge-conflicts` skill (MIT),
 <https://github.com/mattpocock/skills>.
 
 ## Gotchas
+
+### Setting up pre-commit checks
+
+The current Matt Pocock `setup-pre-commit` workflow maps to Stacks' existing
+hooks, rather than adding Husky, lint-staged, or Prettier. Inspect `package.json`,
+the installed `better-dx` tooling, `config/git.ts`, and CI. Keep staged formatting
+on pickier and run the repository's actual typecheck and test commands at the
+appropriate gate. Preserve existing hook actions. Prove a deliberate temporary
+violation fails, restore it, and prove the valid state passes. Do not create a
+commit merely to exercise a hook. See [NOTICE.md](NOTICE.md) and
+[the Stacks adaptation rules](../stacks-flow/ENGINEERING.md).
 - **`@stacksjs/git` is mostly re-exports** - actual functionality in `@stacksjs/gitlint`, `@stacksjs/gitit`, `bun-git-hooks`
 - **Pre-commit runs lint-staged** - the only default hook
 - **Emoji disabled by default** - `useEmoji: false` but emoji mappings exist for each type

package/ai/skills/stacks-grill-with-docs/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matt Pocock
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/ai/skills/stacks-grill-with-docs/NOTICE.md

@@ -0,0 +1,10 @@
+# Source and license
+
+The upstream MIT notice is preserved in [LICENSE](LICENSE).
+
+## grill-with-docs
+
+Source: [skills/engineering/grill-with-docs/SKILL.md](https://github.com/mattpocock/skills/blob/49dd158d1076134a641b33efb035946536778336/skills/engineering/grill-with-docs/SKILL.md),
+revision `49dd158d1076134a641b33efb035946536778336`.
+
+Ported with Stacks skill names, canonical guidance, local-tracker fallback, TypeScript/Bun tooling, and conditional external actions.

package/ai/skills/stacks-grill-with-docs/PLAYBOOK.md

@@ -0,0 +1,4 @@
+> Adapted playbook. Read [the Stacks rules](../stacks-flow/ENGINEERING.md) first. Commit, push, publish, and tracker mutations are conditional on the user's authorization.
+
+
+Call the Skill tool twice, for "stacks-grilling" and "stacks-domain-modeling".

package/ai/skills/stacks-grill-with-docs/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: stacks-grill-with-docs
+description: A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go. Covers Stacks engineering workflows.
+disable-model-invocation: true
+license: MIT
+compatibility: Bun >= 1.3.0, TypeScript
+allowed-tools: Read Edit Write Bash Grep Glob
+---
+
+# Grill With Docs
+
+Read [the Stacks adaptation rules](../stacks-flow/ENGINEERING.md), then
+[PLAYBOOK.md](PLAYBOOK.md). The playbook preserves this workflow's decision
+criteria; the Stacks rules govern APIs, tooling, tracking, and authorization.
+
+Credit: adapted from Matt Pocock's `grill-with-docs` skill, MIT licensed.
+See [NOTICE.md](NOTICE.md) and [LICENSE](LICENSE).
+
+## Completion
+
+Produce the requested behavior or reviewable artifact and satisfy the
+playbook's completion criteria. Preserve existing decisions and user edits.
+Use the native Stacks skills for implementation and verification, and carry
+existing authorization through the workflow.

package/ai/skills/stacks-grilling/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matt Pocock
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/ai/skills/stacks-grilling/NOTICE.md

@@ -0,0 +1,17 @@
+# Source and license
+
+The upstream MIT notice is preserved in [LICENSE](LICENSE).
+
+## grill-me
+
+Source: [skills/productivity/grill-me/SKILL.md](https://github.com/mattpocock/skills/blob/49dd158d1076134a641b33efb035946536778336/skills/productivity/grill-me/SKILL.md),
+revision `49dd158d1076134a641b33efb035946536778336`.
+
+Reviewed against the existing Stacks workflow. Stacks API guidance is retained; current workflow changes and supporting references are integrated where applicable.
+
+## grilling
+
+Source: [skills/productivity/grilling/SKILL.md](https://github.com/mattpocock/skills/blob/49dd158d1076134a641b33efb035946536778336/skills/productivity/grilling/SKILL.md),
+revision `49dd158d1076134a641b33efb035946536778336`.
+
+Reviewed against the existing Stacks workflow. Stacks API guidance is retained; current workflow changes and supporting references are integrated where applicable.

package/ai/skills/stacks-grilling/SKILL.md

@@ -28,6 +28,8 @@ guessing at answers you have not heard yet.
 
 Ask the whole frontier in one round. Number each question and give your
 recommended answer. Then wait for the user's answers before the next round.
+Word questions so a simple "yes" accepts the recommendation. Keep dependent
+questions for later rounds and do not re-ask decisions already settled.
 
 ```
 ❓ **Q1** - **<question title>**: <question body, possibly several paragraphs,
@@ -81,5 +83,10 @@ runnable answer, reach for `stacks-prototype` and bring the result back.
 
 ## Downstream
 
+For an interview that persists its glossary and decisions, use
+`stacks-grill-with-docs`. For a decision too large for one session, use
+`stacks-wayfinder`. Current upstream provenance is in [NOTICE.md](NOTICE.md);
+read [the Stacks adaptation rules](../stacks-flow/ENGINEERING.md) with this workflow.
+
 > Frontier empty? `/stacks-plan-review` turns the understanding into an
 > implementation plan, or `/stacks-new-feature` slices it into tracer bullets.

package/ai/skills/stacks-guard/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matt Pocock
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/ai/skills/stacks-guard/NOTICE.md

@@ -0,0 +1,10 @@
+# Source and license
+
+The upstream MIT notice is preserved in [LICENSE](LICENSE).
+
+## git-guardrails-claude-code
+
+Source: [skills/misc/git-guardrails-claude-code/SKILL.md](https://github.com/mattpocock/skills/blob/49dd158d1076134a641b33efb035946536778336/skills/misc/git-guardrails-claude-code/SKILL.md),
+revision `49dd158d1076134a641b33efb035946536778336`.
+
+Reviewed against the existing Stacks workflow. Stacks API guidance is retained; current workflow changes and supporting references are integrated where applicable.

package/ai/skills/stacks-guard/SKILL.md

@@ -171,3 +171,9 @@ have `buddy setup:ai` users point their hook at that path.
 > Guard installed? `/stacks-retro` is where a near-miss becomes a permanent
 > check, and `/stacks-wizard` is for the production steps a human should be
 > doing by hand anyway.
+
+## Upstream provenance
+
+The reviewed source revision and MIT notice are in [NOTICE.md](NOTICE.md) and
+[LICENSE](LICENSE). Read [the Stacks adaptation rules](../stacks-flow/ENGINEERING.md)
+with this workflow. Existing Stacks APIs and supporting helpers remain authoritative.

package/ai/skills/stacks-handoff/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matt Pocock
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/ai/skills/stacks-handoff/NOTICE.md

@@ -0,0 +1,17 @@
+# Source and license
+
+The upstream MIT notice is preserved in [LICENSE](LICENSE).
+
+## claude-handoff
+
+Source: [skills/in-progress/claude-handoff/SKILL.md](https://github.com/mattpocock/skills/blob/49dd158d1076134a641b33efb035946536778336/skills/in-progress/claude-handoff/SKILL.md),
+revision `49dd158d1076134a641b33efb035946536778336`. This workflow is in progress upstream.
+
+Reviewed against the existing Stacks workflow. Stacks API guidance is retained; current workflow changes and supporting references are integrated where applicable.
+
+## handoff
+
+Source: [skills/productivity/handoff/SKILL.md](https://github.com/mattpocock/skills/blob/49dd158d1076134a641b33efb035946536778336/skills/productivity/handoff/SKILL.md),
+revision `49dd158d1076134a641b33efb035946536778336`.
+
+Reviewed against the existing Stacks workflow. Stacks API guidance is retained; current workflow changes and supporting references are integrated where applicable.

package/ai/skills/stacks-handoff/SKILL.md

@@ -10,6 +10,14 @@ allowed-tools: Read Edit Write Bash Grep Glob
 
 # Handoff
 
+For an explicitly requested handoff to a new worker, first produce the same
+portable summary, then dispatch it through the harness's native agent or chat
+tool when available. Creating a document alone does not start another chat.
+Avoid shell interpolation of the summary; pass it as structured prompt data.
+Track the worker's status and retain the source artifacts. The upstream
+`claude-handoff` variant is covered by this harness-neutral mode. See
+[NOTICE.md](NOTICE.md) and [the Stacks adaptation rules](../stacks-flow/ENGINEERING.md).
+
 Write a handoff document summarising the current conversation so a fresh agent
 can continue the work. Save it to the OS temp directory, not the workspace: a
 handoff is scaffolding for one hop, and a stray `HANDOFF.md` in the repo is