Praxis Files Upload AI Validation
Use this skill for AI authoring and registry validation of @praxisui/files-upload. Pair it with the runtime, backend, or form-field skill for the concrete surface being changed.
Source Audit
Before editing code or guidance, inspect:
projects/praxis-files-upload/AGENTS.md
projects/praxis-files-upload/README.md
projects/praxis-files-upload/src/lib/ai/praxis-files-upload-authoring-manifest.ts
projects/praxis-files-upload/src/lib/ai/files-upload-ai.adapter.ts
projects/praxis-files-upload/src/lib/ai/files-upload-ai-capabilities.ts
projects/praxis-files-upload/src/lib/ai/files-upload-context-pack.ts
- AI manifest and adapter specs
- config editor, widget editor, runtime component, and docs that expose the same operations
tools/ai-registry/** when component docs, capabilities, context packs, or package AI assets change
Canonical Decision Boundary
AI must operate through governed manifest operations and semantic context. It must not decide upload intent through keywords, regexes, filename text, local command strings, or arbitrary JSON patches.
Text matching may rank error codes, config paths, or target fields only after the component scope and semantic operation are resolved by the manifest, context pack, or declared tool contract.
Manifest Rules
PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST governs:
- accepted types through
ui.accept, options.allowedExtensions, and options.acceptMimeTypes
- size limits through
limits.maxFileSizeBytes and options.maxUploadSizeMb
- file count and bulk size limits
- endpoint strategy through
baseUrl and strategy
- security policy through strict validation, virus scanning, conflict policy, target directory, quotas, rate-limit feedback, and headers
- error message overrides under
messages.errors
- display mode and visual UI flags
Endpoint operations are security-sensitive and require confirmation. They should preserve canonical baseUrl-derived paths and reject per-operation URL overrides unless the platform contract changes.
AI Authoring Checks
Before considering the AI path complete, verify:
- The requested edit maps to an operation, target, validator, affected path, and submission impact in the manifest.
- Security-sensitive edits require confirmation and preserve the backend contract.
- Client-side and backend-facing settings stay consistent, especially accept lists and file size limits.
- Settings Panel apply/save/reset/reopen consumes the same config document that the manifest patches.
- Context packs expose safe component facts, not local prompt classifiers.
- Registry projection and docs are updated or explicitly ruled out.
- Public API exports remain owned by
@praxisui/files-upload.
Validation
Use the smallest reliable proof:
praxis-files-upload-authoring-manifest.spec.ts
files-upload-ai.adapter.spec.ts
- config editor and widget editor specs when authoring round-trip changes
npm run validate:authoring-contracts when the repo-level authoring contract gate is in scope
npm run generate:registry:ingestion or narrower AI registry validation when registry projection changes
- docs/playground validation when public examples or docs change
Report exactly what was validated and what remained unvalidated.
Companion Skills
- Use
praxis-files-upload-runtime for runtime config, states, i18n, Settings Panel, and events.
- Use
praxis-files-upload-backend-contract for endpoint, presign, quota, rate-limit, headers, and error-code semantics.
- Use
praxis-files-upload-form-field when AI-authored config affects form values or valueMode.
- Use
praxis-ai-authoring-manifests, praxis-ai-registry-ingestion, praxis-authoring-editors, and praxis-angular-docs-playgrounds for their governed surfaces.
1---2name: praxis-files-upload-ai-validation3description: Use when Codex must change, audit, or validate AI-assisted authoring for `@praxisui/files-upload`, including `PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST`, files-upload AI adapter, capabilities, context packs, endpoint and strategy operations, accepted types, limits, security policy, quota and rate-limit authoring, error-message operations, Settings Panel round-trip, component registry ingestion, docs, examples, or assistant validation for Praxis upload surfaces.4metadata:5 source: https://skillmd.com/skills/codexrodrigues/praxis-files-upload-ai-validation6---78# Praxis Files Upload AI Validation910Use this skill for AI authoring and registry validation of `@praxisui/files-upload`. Pair it with the runtime, backend, or form-field skill for the concrete surface being changed.1112## Source Audit1314Before editing code or guidance, inspect:1516- `projects/praxis-files-upload/AGENTS.md`17- `projects/praxis-files-upload/README.md`18- `projects/praxis-files-upload/src/lib/ai/praxis-files-upload-authoring-manifest.ts`19- `projects/praxis-files-upload/src/lib/ai/files-upload-ai.adapter.ts`20- `projects/praxis-files-upload/src/lib/ai/files-upload-ai-capabilities.ts`21- `projects/praxis-files-upload/src/lib/ai/files-upload-context-pack.ts`22- AI manifest and adapter specs23- config editor, widget editor, runtime component, and docs that expose the same operations24- `tools/ai-registry/**` when component docs, capabilities, context packs, or package AI assets change2526## Canonical Decision Boundary2728AI must operate through governed manifest operations and semantic context. It must not decide upload intent through keywords, regexes, filename text, local command strings, or arbitrary JSON patches.2930Text matching may rank error codes, config paths, or target fields only after the component scope and semantic operation are resolved by the manifest, context pack, or declared tool contract.3132## Manifest Rules3334`PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST` governs:3536- accepted types through `ui.accept`, `options.allowedExtensions`, and `options.acceptMimeTypes`37- size limits through `limits.maxFileSizeBytes` and `options.maxUploadSizeMb`38- file count and bulk size limits39- endpoint strategy through `baseUrl` and `strategy`40- security policy through strict validation, virus scanning, conflict policy, target directory, quotas, rate-limit feedback, and headers41- error message overrides under `messages.errors`42- display mode and visual UI flags4344Endpoint operations are security-sensitive and require confirmation. They should preserve canonical `baseUrl`-derived paths and reject per-operation URL overrides unless the platform contract changes.4546## AI Authoring Checks4748Before considering the AI path complete, verify:4950- The requested edit maps to an operation, target, validator, affected path, and submission impact in the manifest.51- Security-sensitive edits require confirmation and preserve the backend contract.52- Client-side and backend-facing settings stay consistent, especially accept lists and file size limits.53- Settings Panel apply/save/reset/reopen consumes the same config document that the manifest patches.54- Context packs expose safe component facts, not local prompt classifiers.55- Registry projection and docs are updated or explicitly ruled out.56- Public API exports remain owned by `@praxisui/files-upload`.5758## Validation5960Use the smallest reliable proof:6162- `praxis-files-upload-authoring-manifest.spec.ts`63- `files-upload-ai.adapter.spec.ts`64- config editor and widget editor specs when authoring round-trip changes65- `npm run validate:authoring-contracts` when the repo-level authoring contract gate is in scope66- `npm run generate:registry:ingestion` or narrower AI registry validation when registry projection changes67- docs/playground validation when public examples or docs change6869Report exactly what was validated and what remained unvalidated.7071## Companion Skills7273- Use `praxis-files-upload-runtime` for runtime config, states, i18n, Settings Panel, and events.74- Use `praxis-files-upload-backend-contract` for endpoint, presign, quota, rate-limit, headers, and error-code semantics.75- Use `praxis-files-upload-form-field` when AI-authored config affects form values or `valueMode`.76- Use `praxis-ai-authoring-manifests`, `praxis-ai-registry-ingestion`, `praxis-authoring-editors`, and `praxis-angular-docs-playgrounds` for their governed surfaces.