@1aboveio/skills 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +30 -2
- package/bin/cli.mjs +14 -0
- package/bin/select-core.mjs +172 -0
- package/package.json +146 -4
- package/skills/app-dev/airflow/LICENSE +3 -0
- package/skills/app-dev/airflow/SKILL.md +199 -0
- package/skills/app-dev/airflow/release-check.mjs +93 -0
- package/skills/app-dev/android-foundation/LICENSE +3 -0
- package/skills/app-dev/android-foundation/SKILL.md +192 -0
- package/skills/app-dev/android-foundation/assets/android-ci-job.yml +217 -0
- package/skills/app-dev/android-foundation/references/ci.md +87 -0
- package/skills/app-dev/android-foundation/references/gotchas.md +221 -0
- package/skills/app-dev/android-foundation/references/setup.md +164 -0
- package/skills/app-dev/android-foundation/release-check.mjs +93 -0
- package/skills/app-dev/android-foundation/scripts/device-run.sh +176 -0
- package/skills/app-dev/android-foundation/scripts/device-run.test.mjs +172 -0
- package/skills/app-dev/app-debug/LICENSE +3 -0
- package/skills/app-dev/app-debug/SKILL.md +110 -0
- package/skills/app-dev/app-debug/references/common-errors.md +128 -0
- package/skills/app-dev/app-debug/release-check.mjs +93 -0
- package/skills/app-dev/better-auth/LICENSE +3 -0
- package/skills/app-dev/better-auth/SKILL.md +598 -0
- package/skills/app-dev/better-auth/references/feishu-api.md +270 -0
- package/skills/app-dev/better-auth/release-check.mjs +93 -0
- package/skills/app-dev/data-catalog/LICENSE +3 -0
- package/skills/app-dev/data-catalog/SKILL.md +204 -0
- package/skills/app-dev/data-catalog/agents/openai.yaml +3 -0
- package/skills/app-dev/data-catalog/references/data-catalog-conventions.md +75 -0
- package/skills/app-dev/data-catalog/references/field-definitions.md +116 -0
- package/skills/app-dev/data-catalog/references/format.md +121 -0
- package/skills/app-dev/data-catalog/release-check.mjs +93 -0
- package/skills/app-dev/data-catalog/scripts/data-catalog.test.mjs +36 -0
- package/skills/app-dev/data-catalog/scripts/data_catalog.py +1392 -0
- package/skills/app-dev/data-catalog/scripts/persist-conventions-core.mjs +117 -0
- package/skills/app-dev/data-catalog/scripts/persist-conventions.mjs +17 -0
- package/skills/app-dev/data-catalog/scripts/test_data_catalog.py +571 -0
- package/skills/app-dev/ios-foundation/LICENSE +3 -0
- package/skills/app-dev/ios-foundation/SKILL.md +184 -0
- package/skills/app-dev/ios-foundation/references/setup.md +243 -0
- package/skills/app-dev/ios-foundation/release-check.mjs +93 -0
- package/skills/app-dev/monorepo/LICENSE +3 -0
- package/skills/app-dev/monorepo/SKILL.md +462 -0
- package/skills/app-dev/monorepo/release-check.mjs +93 -0
- package/skills/app-dev/nextjs-fullstack/LICENSE +3 -0
- package/skills/app-dev/nextjs-fullstack/SKILL.md +211 -0
- package/skills/app-dev/nextjs-fullstack/conventions.md +318 -0
- package/skills/app-dev/nextjs-fullstack/frontend-conventions.md +61 -0
- package/skills/app-dev/nextjs-fullstack/nextjs16.md +287 -0
- package/skills/app-dev/nextjs-fullstack/release-check.mjs +93 -0
- package/skills/app-dev/nextjs-fullstack/server-actions.md +409 -0
- package/skills/app-dev/prisma-setup/LICENSE +3 -0
- package/skills/app-dev/prisma-setup/SKILL.md +181 -0
- package/skills/app-dev/prisma-setup/nextjs.md +258 -0
- package/skills/app-dev/prisma-setup/release-check.mjs +93 -0
- package/skills/app-dev/prisma-setup/turborepo.md +301 -0
- package/skills/app-dev/pyspark/LICENSE +3 -0
- package/skills/app-dev/pyspark/SKILL.md +127 -0
- package/skills/app-dev/pyspark/assets/templates/etl.py +748 -0
- package/skills/app-dev/pyspark/assets/templates/utils/__init__.py +1 -0
- package/skills/app-dev/pyspark/assets/templates/utils/hudi_metadata.py +14 -0
- package/skills/app-dev/pyspark/references/diagnosis-and-profiling.md +169 -0
- package/skills/app-dev/pyspark/references/etl-contract.md +129 -0
- package/skills/app-dev/pyspark/references/production-validation.md +131 -0
- package/skills/app-dev/pyspark/references/reconciliation.md +38 -0
- package/skills/app-dev/pyspark/references/transformation-design.md +190 -0
- package/skills/app-dev/pyspark/references/velocity-feature-calculation.md +193 -0
- package/skills/app-dev/pyspark/release-check.mjs +93 -0
- package/skills/app-dev/pyspark/scripts/spark_eventlog_summary.py +223 -0
- package/skills/app-dev/python-backend/LICENSE +3 -0
- package/skills/app-dev/python-backend/SKILL.md +325 -0
- package/skills/app-dev/python-backend/assets/uv-install.sh +48 -0
- package/skills/app-dev/python-backend/references/uv-installs.md +83 -0
- package/skills/app-dev/python-backend/release-check.mjs +93 -0
- package/skills/app-dev/shadcn/LICENSE +3 -0
- package/skills/app-dev/shadcn/SKILL.md +120 -0
- package/skills/app-dev/shadcn/assets/shadcn-small.png +0 -0
- package/skills/app-dev/shadcn/assets/shadcn.png +0 -0
- package/skills/app-dev/shadcn/cli.md +411 -0
- package/skills/app-dev/shadcn/customization.md +224 -0
- package/skills/app-dev/shadcn/mcp.md +101 -0
- package/skills/app-dev/shadcn/release-check.mjs +93 -0
- package/skills/app-dev/shadcn/rules/base-vs-radix.md +323 -0
- package/skills/app-dev/shadcn/rules/component-selection.md +67 -0
- package/skills/app-dev/shadcn/rules/composition.md +195 -0
- package/skills/app-dev/shadcn/rules/data-table.md +201 -0
- package/skills/app-dev/shadcn/rules/forms.md +255 -0
- package/skills/app-dev/shadcn/rules/icons.md +103 -0
- package/skills/app-dev/shadcn/rules/styling.md +167 -0
- package/skills/app-dev/zod-v4/LICENSE +3 -0
- package/skills/app-dev/zod-v4/SKILL.md +286 -0
- package/skills/app-dev/zod-v4/release-check.mjs +93 -0
- package/skills/cicd/cloud-build/LICENSE +3 -0
- package/skills/cicd/cloud-build/SKILL.md +707 -0
- package/skills/cicd/cloud-build/release-check.mjs +93 -0
- package/skills/cicd/cloud-debug/LICENSE +3 -0
- package/skills/cicd/cloud-debug/SKILL.md +315 -0
- package/skills/cicd/cloud-debug/references/build-failures.md +238 -0
- package/skills/cicd/cloud-debug/references/deploy-failures.md +376 -0
- package/skills/cicd/cloud-debug/references/pipeline-failures.md +378 -0
- package/skills/cicd/cloud-debug/release-check.mjs +93 -0
- package/skills/cicd/cloud-deploy/LICENSE +3 -0
- package/skills/cicd/cloud-deploy/SKILL.md +230 -0
- package/skills/cicd/cloud-deploy/references/config-templates.md +257 -0
- package/skills/cicd/cloud-deploy/release-check.mjs +93 -0
- package/skills/cicd/docker/LICENSE +3 -0
- package/skills/cicd/docker/SKILL.md +151 -0
- package/skills/cicd/docker/release-check.mjs +93 -0
- package/skills/cicd/github-actions/LICENSE +3 -0
- package/skills/cicd/github-actions/SKILL.md +111 -0
- package/skills/cicd/github-actions/references/audit-profile-optimize.md +150 -0
- package/skills/cicd/github-actions/references/ci-case-studies.md +141 -0
- package/skills/cicd/github-actions/references/conditional-ci.md +214 -0
- package/skills/cicd/github-actions/references/debugging.md +13 -0
- package/skills/cicd/github-actions/references/pipeline.md +87 -0
- package/skills/cicd/github-actions/references/post-deploy-and-publishing.md +33 -0
- package/skills/cicd/github-actions/references/runners.md +253 -0
- package/skills/cicd/github-actions/references/security.md +29 -0
- package/skills/cicd/github-actions/references/speed-and-audit.md +115 -0
- package/skills/cicd/github-actions/references/two-pass-reading.md +92 -0
- package/skills/cicd/github-actions/release-check.mjs +93 -0
- package/skills/cicd/github-actions/scripts/ci-run-audit-core.mjs +612 -0
- package/skills/cicd/github-actions/scripts/ci-run-audit.mjs +4 -0
- package/skills/cicd/github-actions/scripts/ci-run-audit.test.mjs +637 -0
- package/skills/cicd/github-flow/LICENSE +3 -0
- package/skills/cicd/github-flow/SKILL.md +123 -0
- package/skills/cicd/github-flow/references/ci-conventions.md +14 -0
- package/skills/cicd/github-flow/release-check.mjs +93 -0
- package/skills/cicd/github-flow/scripts/flow-core.mjs +105 -0
- package/skills/cicd/github-flow/scripts/flow.mjs +81 -0
- package/skills/cicd/github-flow/scripts/flow.test.mjs +114 -0
- package/skills/cicd/github-flow/scripts/persist-conventions-core.mjs +117 -0
- package/skills/cicd/github-flow/scripts/persist-conventions.mjs +49 -0
- package/skills/cicd/github-flow/scripts/persist-conventions.test.mjs +108 -0
- package/skills/cicd/google-cloud/LICENSE +3 -0
- package/skills/cicd/google-cloud/SKILL.md +119 -0
- package/skills/cicd/google-cloud/references/gcs.md +469 -0
- package/skills/cicd/google-cloud/references/iam.md +451 -0
- package/skills/cicd/google-cloud/references/project.md +349 -0
- package/skills/cicd/google-cloud/references/secrets.md +336 -0
- package/skills/cicd/google-cloud/references/vpc.md +312 -0
- package/skills/cicd/google-cloud/release-check.mjs +93 -0
- package/skills/cicd/google-cloud/scripts/create-sa.sh +36 -0
- package/skills/cicd/google-cloud/scripts/gcp-config.sh +31 -0
- package/skills/cicd/google-cloud/scripts/grant-iap.sh +41 -0
- package/skills/cicd/google-cloud/scripts/setup-secrets.sh +48 -0
- package/skills/cicd/mergify/LICENSE +3 -0
- package/skills/cicd/mergify/SKILL.md +102 -0
- package/skills/cicd/mergify/assets/templates/mergify.yml +215 -0
- package/skills/cicd/mergify/assets/templates/ruleset.json +46 -0
- package/skills/cicd/mergify/references/branch-protection.md +282 -0
- package/skills/cicd/mergify/references/configuration.md +274 -0
- package/skills/cicd/mergify/references/diagnosis.md +109 -0
- package/skills/cicd/mergify/references/stacks.md +84 -0
- package/skills/cicd/mergify/references/traps.md +119 -0
- package/skills/cicd/mergify/references/watch-contract.md +274 -0
- package/skills/cicd/mergify/release-check.mjs +93 -0
- package/skills/cicd/mergify/scripts/audit-core.mjs +208 -0
- package/skills/cicd/mergify/scripts/audit.mjs +4 -0
- package/skills/cicd/mergify/scripts/audit.test.mjs +201 -0
- package/skills/cicd/mergify/scripts/entrypoints.test.mjs +106 -0
- package/skills/cicd/mergify/scripts/pr-620-mergify-comments.fixture.json +30 -0
- package/skills/cicd/mergify/scripts/stack-push-core.mjs +258 -0
- package/skills/cicd/mergify/scripts/stack-push.mjs +4 -0
- package/skills/cicd/mergify/scripts/stack-push.test.mjs +233 -0
- package/skills/cicd/mergify/scripts/watch-pr-delivery-core.mjs +1065 -0
- package/skills/cicd/mergify/scripts/watch-pr-delivery.mjs +4 -0
- package/skills/cicd/mergify/scripts/watch-pr-delivery.test.mjs +1826 -0
- package/skills/cicd/podman/LICENSE +3 -0
- package/skills/cicd/podman/SKILL.md +71 -0
- package/skills/cicd/podman/agents/openai.yaml +4 -0
- package/skills/cicd/podman/assets/templates/podman-compose-socket-directory.yml +6 -0
- package/skills/cicd/podman/assets/templates/podman-service-override.conf +3 -0
- package/skills/cicd/podman/references/compose-compatibility.md +70 -0
- package/skills/cicd/podman/references/networking-and-ports.md +74 -0
- package/skills/cicd/podman/references/rootless-services-and-sockets.md +156 -0
- package/skills/cicd/podman/references/troubleshooting.md +98 -0
- package/skills/cicd/podman/release-check.mjs +93 -0
- package/skills/content/article-review/LICENSE +3 -0
- package/skills/content/article-review/SKILL.md +66 -0
- package/skills/content/article-review/references/report-format.md +68 -0
- package/skills/content/article-review/references/template-guide.md +79 -0
- package/skills/content/article-review/references/template-wechat-payments.md +125 -0
- package/skills/content/article-review/release-check.mjs +93 -0
- package/skills/content/article-to-image/LICENSE +3 -0
- package/skills/content/article-to-image/SKILL.md +91 -0
- package/skills/content/article-to-image/references/formats.md +53 -0
- package/skills/content/article-to-image/release-check.mjs +93 -0
- package/skills/content/flowchart-svg/LICENSE +3 -0
- package/skills/content/flowchart-svg/SKILL.md +43 -0
- package/skills/content/flowchart-svg/release-check.mjs +93 -0
- package/skills/content/flowchart-svg/scripts/export_png.sh +8 -0
- package/skills/content/image-gen/LICENSE +3 -0
- package/skills/content/image-gen/SKILL.md +192 -0
- package/skills/content/image-gen/release-check.mjs +93 -0
- package/skills/content/image-gen/scripts/credentials.mjs +217 -0
- package/skills/content/image-gen/scripts/credentials.test.mjs +212 -0
- package/skills/content/image-gen/scripts/generate.mjs +240 -0
- package/skills/content/image-gen/scripts/options.mjs +293 -0
- package/skills/content/image-gen/scripts/options.test.mjs +245 -0
- package/skills/content/mermaid/LICENSE +3 -0
- package/skills/content/mermaid/SKILL.md +635 -0
- package/skills/content/mermaid/release-check.mjs +93 -0
- package/skills/content/wechat-article-writer/LICENSE +3 -0
- package/skills/content/wechat-article-writer/SKILL.md +92 -0
- package/skills/content/wechat-article-writer/references/style-selector.md +133 -0
- package/skills/content/wechat-article-writer/references/writing-rules.md +152 -0
- package/skills/content/wechat-article-writer/release-check.mjs +93 -0
- package/skills/content/wechat-article-writer/templates/wechat-comparison.md +52 -0
- package/skills/content/wechat-article-writer/templates/wechat-howto.md +51 -0
- package/skills/content/wechat-article-writer/templates/wechat-insight.md +50 -0
- package/skills/content/wechat-article-writer/templates/wechat-pitfall.md +52 -0
- package/skills/content/wechat-publisher/LICENSE +3 -0
- package/skills/content/wechat-publisher/SKILL.md +171 -0
- package/skills/content/wechat-publisher/references/api.md +105 -0
- package/skills/content/wechat-publisher/references/layout-rules.md +57 -0
- package/skills/content/wechat-publisher/references/wechat-safe-template.html +86 -0
- package/skills/content/wechat-publisher/release-check.mjs +93 -0
- package/skills/content/wechat-publisher/scripts/md_to_wechat_html.py +194 -0
- package/skills/content/wechat-publisher/scripts/publish.py +239 -0
- package/skills/content/wechat-search/LICENSE +3 -0
- package/skills/content/wechat-search/SKILL.md +211 -0
- package/skills/content/wechat-search/release-check.mjs +93 -0
- package/skills/content/wechat-search/scripts/start-chrome.sh +83 -0
- package/skills/content/xai-search/LICENSE +3 -0
- package/skills/content/xai-search/SKILL.md +79 -0
- package/skills/content/xai-search/release-check.mjs +93 -0
- package/skills/content/xai-search/scripts/xai_search.sh +187 -0
- package/skills/content/xai-search/tests/smoke_test.sh +36 -0
- package/skills/core/distill-writing/LICENSE +3 -0
- package/skills/core/distill-writing/SKILL.md +74 -0
- package/skills/core/distill-writing/references/extraction.md +95 -0
- package/skills/core/distill-writing/references/updating.md +46 -0
- package/skills/core/distill-writing/release-check.mjs +93 -0
- package/skills/core/doc-to-md/LICENSE +3 -0
- package/skills/core/doc-to-md/SKILL.md +78 -0
- package/skills/core/doc-to-md/release-check.mjs +93 -0
- package/skills/core/doc-to-md/scripts/convert.py +157 -0
- package/skills/core/editorial-review/LICENSE +3 -0
- package/skills/core/editorial-review/SKILL.md +79 -0
- package/skills/core/editorial-review/references/checklist.md +94 -0
- package/skills/core/editorial-review/release-check.mjs +93 -0
- package/skills/core/house-style/LICENSE +3 -0
- package/skills/core/house-style/SKILL.md +33 -0
- package/skills/core/house-style/references/defaults.md +66 -0
- package/skills/core/house-style/references/rules.md +267 -0
- package/skills/core/house-style/references/sources.md +27 -0
- package/skills/core/house-style/references/style-en.md +131 -0
- package/skills/core/house-style/references/style-zh.md +141 -0
- package/skills/core/house-style/references/terminology-zh.md +223 -0
- package/skills/core/house-style/release-check.mjs +93 -0
- package/skills/core/house-style/templates/brd.md +103 -0
- package/skills/core/house-style/templates/commercial-proposal.md +93 -0
- package/skills/core/house-style/templates/compliance-policy.md +109 -0
- package/skills/core/house-style/templates/gap-analysis.md +105 -0
- package/skills/core/house-style/templates/general.md +63 -0
- package/skills/core/house-style/templates/integration-guide.md +98 -0
- package/skills/core/house-style/templates/prd.md +81 -0
- package/skills/core/house-style/templates/risk-operations-procedure.md +94 -0
- package/skills/core/house-style/templates/technical-spec.md +96 -0
- package/skills/core/polish-cn/LICENSE +3 -0
- package/skills/core/polish-cn/SKILL.md +102 -0
- package/skills/core/polish-cn/references/brief.md +93 -0
- package/skills/core/polish-cn/references/models.md +76 -0
- package/skills/core/polish-cn/release-check.mjs +93 -0
- package/skills/core/polish-cn/scripts/polish-cn.test.mjs +244 -0
- package/skills/core/polish-cn/scripts/polish_blocks.py +489 -0
- package/skills/core/reg-parser/LICENSE +3 -0
- package/skills/core/reg-parser/SKILL.md +212 -0
- package/skills/core/reg-parser/references/checklist-schema.md +223 -0
- package/skills/core/reg-parser/references/checklists/hk-amlo-checklist.json +1306 -0
- package/skills/core/reg-parser/references/checklists/hk-amlo-checklist.md +469 -0
- package/skills/core/reg-parser/references/checklists/hk-fi-corporate-onboarding-cdd-checklist.json +634 -0
- package/skills/core/reg-parser/references/checklists/hk-fi-corporate-onboarding-cdd-checklist.md +233 -0
- package/skills/core/reg-parser/references/checklists/hk-mso-guideline-checklist.json +2194 -0
- package/skills/core/reg-parser/references/checklists/hk-mso-guideline-checklist.md +771 -0
- package/skills/core/reg-parser/references/checklists/kyc-aml-checklist.md +258 -0
- package/skills/core/reg-parser/references/checklists/visa-vars-checklist.md +1058 -0
- package/skills/core/reg-parser/references/mandates/hk-amlo-cap615.md +389 -0
- package/skills/core/reg-parser/references/mandates/visa-vars.md +205 -0
- package/skills/core/reg-parser/release-check.mjs +93 -0
- package/skills/core/reg-parser/scripts/compare_checklist.py +230 -0
- package/skills/core/reg-parser/scripts/dump_checklist.py +361 -0
- package/skills/core/reg-parser/scripts/preprocess-mandate.sh +187 -0
- package/skills/core/reg-parser/scripts/reg-parser.test.mjs +165 -0
- package/skills/core/reg-parser/scripts/test_quarantine.sh +105 -0
- package/skills/core/reg-parser/scripts/validate_checklist.py +563 -0
- package/skills/core/reg-parser/scripts/validate_mandate.py +273 -0
- package/skills/core/terminology/LICENSE +3 -0
- package/skills/core/terminology/SKILL.md +62 -0
- package/skills/core/terminology/references/format.md +50 -0
- package/skills/core/terminology/references/init.md +32 -0
- package/skills/core/terminology/release-check.mjs +93 -0
- package/skills/core/write-doc/LICENSE +3 -0
- package/skills/core/write-doc/SKILL.md +141 -0
- package/skills/core/write-doc/references/bilingual.md +60 -0
- package/skills/core/write-doc/release-check.mjs +93 -0
- package/skills/engineering/better-review/LICENSE +3 -0
- package/skills/engineering/better-review/SKILL.md +249 -0
- package/skills/engineering/better-review/agents/openai.yaml +9 -0
- package/skills/engineering/better-review/references/domain-hazards.md +53 -0
- package/skills/engineering/better-review/references/passes.md +147 -0
- package/skills/engineering/better-review/references/result.md +151 -0
- package/skills/engineering/better-review/release-check.mjs +93 -0
- package/skills/engineering/better-review/scripts/pr-context.mjs +212 -0
- package/skills/engineering/better-review/scripts/pr-context.test.mjs +168 -0
- package/skills/engineering/better-review/scripts/rereview-scope.mjs +503 -0
- package/skills/engineering/better-review/scripts/rereview-scope.test.mjs +587 -0
- package/skills/engineering/better-review/scripts/scan-diff.mjs +365 -0
- package/skills/engineering/better-review/scripts/scan-diff.test.mjs +414 -0
- package/skills/engineering/better-review/scripts/vendor-sync.test.mjs +96 -0
- package/skills/engineering/e2e-test/LICENSE +3 -0
- package/skills/engineering/e2e-test/SKILL.md +98 -0
- package/skills/engineering/e2e-test/assets/ci-gates.cloudbuild.yaml +24 -0
- package/skills/engineering/e2e-test/references/authoring/auth-flows.md +159 -0
- package/skills/engineering/e2e-test/references/authoring/playwright-config.md +73 -0
- package/skills/engineering/e2e-test/references/authoring/playwright-patterns.md +144 -0
- package/skills/engineering/e2e-test/references/ci-integration.md +25 -0
- package/skills/engineering/e2e-test/references/ci-playwright-container.md +290 -0
- package/skills/engineering/e2e-test/references/presentation-sweep.md +104 -0
- package/skills/engineering/e2e-test/references/reviewing.md +41 -0
- package/skills/engineering/e2e-test/references/route-manifest.md +51 -0
- package/skills/engineering/e2e-test/release-check.mjs +93 -0
- package/skills/engineering/e2e-test/scripts/detect-routes-nextjs.mjs +200 -0
- package/skills/engineering/e2e-test/scripts/presentation-checks.mjs +171 -0
- package/skills/engineering/e2e-test/scripts/presentation-checks.test.mjs +106 -0
- package/skills/engineering/e2e-test/scripts/presentation-perceivability.mjs +179 -0
- package/skills/engineering/e2e-test/scripts/presentation-perceivability.test.mjs +117 -0
- package/skills/engineering/e2e-test/scripts/presentation-reachability.mjs +154 -0
- package/skills/engineering/e2e-test/scripts/presentation-reachability.test.mjs +69 -0
- package/skills/engineering/e2e-test/scripts/presentation-render-health.mjs +141 -0
- package/skills/engineering/e2e-test/scripts/presentation-render-health.test.mjs +98 -0
- package/skills/engineering/e2e-test/scripts/presentation-sweep.mjs +147 -0
- package/skills/engineering/e2e-test/scripts/presentation-sweep.test.mjs +71 -0
- package/skills/engineering/e2e-test/scripts/presentation-temporal.mjs +127 -0
- package/skills/engineering/e2e-test/scripts/presentation-temporal.test.mjs +59 -0
- package/skills/engineering/e2e-test/scripts/project-route-manifest.mjs +82 -0
- package/skills/engineering/e2e-test/scripts/project-route-manifest.test.mjs +76 -0
- package/skills/engineering/e2e-test/scripts/validate-manifest.mjs +106 -0
- package/skills/engineering/engineering-runtime/LICENSE +3 -0
- package/skills/engineering/engineering-runtime/SKILL.md +11 -0
- package/skills/engineering/engineering-runtime/agents/openai.yaml +6 -0
- package/skills/engineering/engineering-runtime/coherence/workflow.json +597 -0
- package/skills/engineering/engineering-runtime/engineering-runtime.test.mjs +68 -0
- package/skills/engineering/engineering-runtime/release-check.mjs +93 -0
- package/skills/engineering/engineering-runtime/scripts/exact-head-artifact.mjs +131 -0
- package/skills/engineering/engineering-runtime/scripts/head-check-set.mjs +398 -0
- package/skills/engineering/engineering-runtime/scripts/invocation-policy.mjs +187 -0
- package/skills/engineering/engineering-runtime/scripts/invocation-policy.test.mjs +95 -0
- package/skills/engineering/engineering-runtime/scripts/main-module.mjs +79 -0
- package/skills/engineering/engineering-runtime/scripts/main-module.test.mjs +288 -0
- package/skills/engineering/engineering-runtime/scripts/mergify-yaml.mjs +11 -0
- package/skills/engineering/engineering-runtime/scripts/package-lock.json +43 -0
- package/skills/engineering/engineering-runtime/scripts/package.json +10 -0
- package/skills/engineering/engineering-runtime/scripts/required-check-plan.mjs +223 -0
- package/skills/engineering/engineering-runtime/scripts/required-check-plan.test.mjs +96 -0
- package/skills/engineering/engineering-runtime/scripts/review-completion.mjs +56 -0
- package/skills/engineering/engineering-runtime/scripts/workflow-coherence.mjs +595 -0
- package/skills/engineering/engineering-runtime/scripts/workflow-policy.mjs +189 -0
- package/skills/engineering/engineering-runtime/scripts/yaml-mapping.mjs +18 -0
- package/skills/engineering/ensure-coverage/LICENSE +3 -0
- package/skills/engineering/ensure-coverage/SKILL.md +129 -0
- package/skills/engineering/ensure-coverage/references/breadth/coverage-ledger.md +92 -0
- package/skills/engineering/ensure-coverage/references/breadth/inventory-contract.md +85 -0
- package/skills/engineering/ensure-coverage/references/breadth/surface-baseline.md +44 -0
- package/skills/engineering/ensure-coverage/references/breadth/surface-discovery.md +16 -0
- package/skills/engineering/ensure-coverage/references/depth/characterization.md +68 -0
- package/skills/engineering/ensure-coverage/references/depth/coverage.config.example.json +19 -0
- package/skills/engineering/ensure-coverage/references/depth/grading.md +35 -0
- package/skills/engineering/ensure-coverage/references/depth/mock-policy.md +57 -0
- package/skills/engineering/ensure-coverage/references/depth/test-smells.md +39 -0
- package/skills/engineering/ensure-coverage/references/enforcement/ci-contract.md +44 -0
- package/skills/engineering/ensure-coverage/references/examples/coverage-ledger.md +110 -0
- package/skills/engineering/ensure-coverage/references/examples/refund-flow.md +35 -0
- package/skills/engineering/ensure-coverage/references/presentation/axis.md +64 -0
- package/skills/engineering/ensure-coverage/references/process/audit-mode.md +27 -0
- package/skills/engineering/ensure-coverage/references/process/output-template.md +139 -0
- package/skills/engineering/ensure-coverage/references/process/test-strategy.md +56 -0
- package/skills/engineering/ensure-coverage/release-check.mjs +93 -0
- package/skills/engineering/ensure-coverage/schemas/coverage-config.schema.json +67 -0
- package/skills/engineering/ensure-coverage/schemas/coverage-file.schema.json +140 -0
- package/skills/engineering/ensure-coverage/scripts/README.md +99 -0
- package/skills/engineering/ensure-coverage/scripts/adapters/nextjs-inventory.mjs +182 -0
- package/skills/engineering/ensure-coverage/scripts/adapters/nextjs-inventory.test.mjs +96 -0
- package/skills/engineering/ensure-coverage/scripts/check-quarantine-expiry.mjs +105 -0
- package/skills/engineering/ensure-coverage/scripts/check-quarantine-expiry.test.mjs +47 -0
- package/skills/engineering/ensure-coverage/scripts/ci-audit.mjs +137 -0
- package/skills/engineering/ensure-coverage/scripts/ci-audit.test.mjs +86 -0
- package/skills/engineering/ensure-coverage/scripts/coverage-ledger.mjs +674 -0
- package/skills/engineering/ensure-coverage/scripts/coverage-ledger.test.mjs +447 -0
- package/skills/engineering/ensure-coverage/scripts/design-parity.mjs +591 -0
- package/skills/engineering/ensure-coverage/scripts/design-parity.test.mjs +552 -0
- package/skills/engineering/ensure-coverage/scripts/lint-tests.mjs +282 -0
- package/skills/engineering/ensure-coverage/scripts/lint-tests.test.mjs +289 -0
- package/skills/engineering/ensure-coverage/scripts/mock-policy-config.mjs +176 -0
- package/skills/engineering/ensure-coverage/scripts/mock-policy-config.test.mjs +119 -0
- package/skills/engineering/ensure-coverage/scripts/package.json +19 -0
- package/skills/engineering/golden-path/LICENSE +3 -0
- package/skills/engineering/golden-path/SKILL.md +230 -0
- package/skills/engineering/golden-path/agents/openai.yaml +3 -0
- package/skills/engineering/golden-path/assets/golden-paths.example.json +57 -0
- package/skills/engineering/golden-path/references/contract.md +239 -0
- package/skills/engineering/golden-path/references/migration.md +111 -0
- package/skills/engineering/golden-path/release-check.mjs +93 -0
- package/skills/engineering/golden-path/scripts/golden-path-core.mjs +1779 -0
- package/skills/engineering/golden-path/scripts/golden-path.mjs +6 -0
- package/skills/engineering/golden-path/scripts/golden-path.test.mjs +1457 -0
- package/skills/engineering/harness-runtime/LICENSE +3 -0
- package/skills/engineering/harness-runtime/SKILL.md +19 -0
- package/skills/engineering/harness-runtime/agents/openai.yaml +6 -0
- package/skills/engineering/harness-runtime/bin/discover-models.mjs +4 -0
- package/skills/engineering/harness-runtime/bin/model-catalog.mjs +4 -0
- package/skills/engineering/harness-runtime/contracts.md +15 -0
- package/skills/engineering/harness-runtime/discover-models.mjs +392 -0
- package/skills/engineering/harness-runtime/discover-models.test.mjs +363 -0
- package/skills/engineering/harness-runtime/fixtures/native-question-schemas.json +33 -0
- package/skills/engineering/harness-runtime/fixtures/question-responses.json +54 -0
- package/skills/engineering/harness-runtime/harness-runtime.test.mjs +967 -0
- package/skills/engineering/harness-runtime/index.mjs +767 -0
- package/skills/engineering/harness-runtime/model-catalog-seed.test.mjs +829 -0
- package/skills/engineering/harness-runtime/model-catalog.mjs +787 -0
- package/skills/engineering/harness-runtime/model-catalog.test.mjs +366 -0
- package/skills/engineering/harness-runtime/native-question-contracts.md +37 -0
- package/skills/engineering/harness-runtime/references/model-catalog-seed.json +408 -0
- package/skills/engineering/harness-runtime/references/model-catalog.md +57 -0
- package/skills/engineering/harness-runtime/release-check.mjs +93 -0
- package/skills/engineering/resolve-issues/LICENSE +3 -0
- package/skills/engineering/resolve-issues/SKILL.md +250 -0
- package/skills/engineering/resolve-issues/agents/openai.yaml +9 -0
- package/skills/engineering/resolve-issues/plugin-hooks.json +17 -0
- package/skills/engineering/resolve-issues/references/canary.md +28 -0
- package/skills/engineering/resolve-issues/references/ci.md +105 -0
- package/skills/engineering/resolve-issues/references/done.md +25 -0
- package/skills/engineering/resolve-issues/references/dropbox.md +90 -0
- package/skills/engineering/resolve-issues/references/expire.md +318 -0
- package/skills/engineering/resolve-issues/references/exploration.md +202 -0
- package/skills/engineering/resolve-issues/references/implementation.md +303 -0
- package/skills/engineering/resolve-issues/references/preflight.md +445 -0
- package/skills/engineering/resolve-issues/references/review.md +228 -0
- package/skills/engineering/resolve-issues/references/shared-modules.md +44 -0
- package/skills/engineering/resolve-issues/references/task-plan.md +264 -0
- package/skills/engineering/resolve-issues/release-check.mjs +93 -0
- package/skills/engineering/resolve-issues/scripts/cleanup-runs.mjs +364 -0
- package/skills/engineering/resolve-issues/scripts/cleanup-runs.test.mjs +280 -0
- package/skills/engineering/resolve-issues/scripts/discover-models.mjs +9 -0
- package/skills/engineering/resolve-issues/scripts/dropbox.mjs +473 -0
- package/skills/engineering/resolve-issues/scripts/dropbox.test.mjs +346 -0
- package/skills/engineering/resolve-issues/scripts/findings-reuse.mjs +98 -0
- package/skills/engineering/resolve-issues/scripts/findings-reuse.test.mjs +88 -0
- package/skills/engineering/resolve-issues/scripts/github-reviews.mjs +384 -0
- package/skills/engineering/resolve-issues/scripts/github-reviews.test.mjs +264 -0
- package/skills/engineering/resolve-issues/scripts/install-hooks.mjs +135 -0
- package/skills/engineering/resolve-issues/scripts/install-hooks.test.mjs +79 -0
- package/skills/engineering/resolve-issues/scripts/issue-tree.mjs +162 -0
- package/skills/engineering/resolve-issues/scripts/issue-tree.test.mjs +107 -0
- package/skills/engineering/resolve-issues/scripts/manual-invocation.test.mjs +14 -0
- package/skills/engineering/resolve-issues/scripts/model-catalog.mjs +9 -0
- package/skills/engineering/resolve-issues/scripts/next-actions-capacity.test.mjs +149 -0
- package/skills/engineering/resolve-issues/scripts/next-actions.mjs +856 -0
- package/skills/engineering/resolve-issues/scripts/next-actions.test.mjs +915 -0
- package/skills/engineering/resolve-issues/scripts/plan-sync.mjs +269 -0
- package/skills/engineering/resolve-issues/scripts/plan-sync.test.mjs +156 -0
- package/skills/engineering/resolve-issues/scripts/preflight-models.mjs +736 -0
- package/skills/engineering/resolve-issues/scripts/preflight-models.test.mjs +448 -0
- package/skills/engineering/resolve-issues/scripts/ready-check.mjs +185 -0
- package/skills/engineering/resolve-issues/scripts/ready-check.test.mjs +217 -0
- package/skills/engineering/resolve-issues/scripts/rehydrate.mjs +98 -0
- package/skills/engineering/resolve-issues/scripts/rehydrate.test.mjs +91 -0
- package/skills/engineering/resolve-issues/scripts/review-verdict.mjs +509 -0
- package/skills/engineering/resolve-issues/scripts/review-verdict.test.mjs +1060 -0
- package/skills/engineering/resolve-issues/scripts/size-check.mjs +492 -0
- package/skills/engineering/resolve-issues/scripts/size-check.test.mjs +458 -0
- package/skills/engineering/resolve-release/LICENSE +3 -0
- package/skills/engineering/resolve-release/SKILL.md +215 -0
- package/skills/engineering/resolve-release/agents/openai.yaml +8 -0
- package/skills/engineering/resolve-release/flows/cloud-run-canary.md +13 -0
- package/skills/engineering/resolve-release/flows/cloud-run.md +7 -0
- package/skills/engineering/resolve-release/flows/root-tag-npm.md +13 -0
- package/skills/engineering/resolve-release/flows/workspace-npm.md +22 -0
- package/skills/engineering/resolve-release/references/canary.md +51 -0
- package/skills/engineering/resolve-release/references/candidate.md +41 -0
- package/skills/engineering/resolve-release/references/cut.md +131 -0
- package/skills/engineering/resolve-release/references/dark-launch.md +66 -0
- package/skills/engineering/resolve-release/references/flows.md +150 -0
- package/skills/engineering/resolve-release/references/preflight.md +154 -0
- package/skills/engineering/resolve-release/references/prepared-metadata.md +260 -0
- package/skills/engineering/resolve-release/references/promotion.md +82 -0
- package/skills/engineering/resolve-release/references/publish.md +232 -0
- package/skills/engineering/resolve-release/references/workspace-npm.md +103 -0
- package/skills/engineering/resolve-release/release-check.mjs +93 -0
- package/skills/engineering/resolve-release/scripts/apply.mjs +212 -0
- package/skills/engineering/resolve-release/scripts/apply.test.mjs +99 -0
- package/skills/engineering/resolve-release/scripts/dark-flags.mjs +134 -0
- package/skills/engineering/resolve-release/scripts/dark-flags.test.mjs +100 -0
- package/skills/engineering/resolve-release/scripts/flow.mjs +500 -0
- package/skills/engineering/resolve-release/scripts/flow.test.mjs +340 -0
- package/skills/engineering/resolve-release/scripts/green-head.mjs +231 -0
- package/skills/engineering/resolve-release/scripts/green-head.test.mjs +101 -0
- package/skills/engineering/resolve-release/scripts/npm-version-absence.mjs +138 -0
- package/skills/engineering/resolve-release/scripts/npm-version-absence.test.mjs +426 -0
- package/skills/engineering/resolve-release/scripts/plan-npm.test.mjs +659 -0
- package/skills/engineering/resolve-release/scripts/plan-toml-boundary.test.mjs +317 -0
- package/skills/engineering/resolve-release/scripts/plan-uv.test.mjs +291 -0
- package/skills/engineering/resolve-release/scripts/plan.mjs +806 -0
- package/skills/engineering/resolve-release/scripts/plan.test.mjs +428 -0
- package/skills/engineering/rush-issues/LICENSE +3 -0
- package/skills/engineering/rush-issues/SKILL.md +58 -0
- package/skills/engineering/rush-issues/agents/openai.yaml +8 -0
- package/skills/engineering/rush-issues/rehydrate.mjs +10 -0
- package/skills/engineering/rush-issues/release-check.mjs +93 -0
- package/skills/engineering/rush-release/LICENSE +3 -0
- package/skills/engineering/rush-release/SKILL.md +35 -0
- package/skills/engineering/rush-release/agents/openai.yaml +8 -0
- package/skills/engineering/rush-release/release-check.mjs +93 -0
- package/skills/engineering/test-quality/LICENSE +3 -0
- package/skills/engineering/test-quality/SKILL.md +79 -0
- package/skills/engineering/test-quality/references/audit.md +80 -0
- package/skills/engineering/test-quality/references/lint.md +24 -0
- package/skills/engineering/test-quality/references/principles.md +143 -0
- package/skills/engineering/test-quality/references/testing-conventions.md +9 -0
- package/skills/engineering/test-quality/release-check.mjs +93 -0
- package/skills/engineering/test-quality/scripts/lint-tests.mjs +574 -0
- package/skills/engineering/test-quality/scripts/lint-tests.test.mjs +591 -0
- package/skills/engineering/test-quality/scripts/mock-policy-config.mjs +176 -0
- package/skills/engineering/test-quality/scripts/mock-policy-config.test.mjs +119 -0
- package/skills/engineering/test-quality/scripts/persist-conventions-core.mjs +117 -0
- package/skills/engineering/test-quality/scripts/persist-conventions.mjs +17 -0
- package/skills/engineering/test-quality/scripts/persist-conventions.test.mjs +104 -0
- package/skills/risk-compliance/compliance-audit/LICENSE +3 -0
- package/skills/risk-compliance/compliance-audit/SKILL.md +439 -0
- package/skills/risk-compliance/compliance-audit/references/findings-schema.md +293 -0
- package/skills/risk-compliance/compliance-audit/references/normalization-rules.md +45 -0
- package/skills/risk-compliance/compliance-audit/references/vars-checklist.md +1068 -0
- package/skills/risk-compliance/compliance-audit/references/vars-findings-schema.md +398 -0
- package/skills/risk-compliance/compliance-audit/release-check.mjs +93 -0
- package/skills/risk-compliance/compliance-audit/scripts/compliance-audit.test.mjs +14 -0
- package/skills/risk-compliance/compliance-audit/scripts/export_tracker_xlsx.py +221 -0
- package/skills/risk-compliance/compliance-audit/scripts/reconcile_tracker.py +458 -0
- package/skills/risk-compliance/compliance-audit/scripts/test_export_tracker_xlsx.py +97 -0
- package/skills/risk-compliance/compliance-audit/scripts/test_validate_tracker.py +157 -0
- package/skills/risk-compliance/compliance-audit/scripts/validate_tracker.py +829 -0
- package/skills/risk-compliance/contract-compare/LICENSE +3 -0
- package/skills/risk-compliance/contract-compare/SKILL.md +199 -0
- package/skills/risk-compliance/contract-compare/references/comparison-dimensions.md +209 -0
- package/skills/risk-compliance/contract-compare/release-check.mjs +93 -0
- package/skills/risk-compliance/contract-review/LICENSE +3 -0
- package/skills/risk-compliance/contract-review/SKILL.md +240 -0
- package/skills/risk-compliance/contract-review/references/review-criteria.md +223 -0
- package/skills/risk-compliance/contract-review/release-check.mjs +93 -0
- package/skills/risk-compliance/doc-authenticity/LICENSE +3 -0
- package/skills/risk-compliance/doc-authenticity/SKILL.md +160 -0
- package/skills/risk-compliance/doc-authenticity/agents/openai.yaml +8 -0
- package/skills/risk-compliance/doc-authenticity/manual-invocation.test.mjs +12 -0
- package/skills/risk-compliance/doc-authenticity/references/agreement.md +66 -0
- package/skills/risk-compliance/doc-authenticity/references/bank-statement.md +150 -0
- package/skills/risk-compliance/doc-authenticity/references/forensic-signals.md +157 -0
- package/skills/risk-compliance/doc-authenticity/references/image-signals.md +114 -0
- package/skills/risk-compliance/doc-authenticity/references/invoice.md +66 -0
- package/skills/risk-compliance/doc-authenticity/references/issuer-profiles.md +86 -0
- package/skills/risk-compliance/doc-authenticity/references/verdict-and-report.md +95 -0
- package/skills/risk-compliance/doc-authenticity/references/verdict.schema.json +81 -0
- package/skills/risk-compliance/doc-authenticity/release-check.mjs +93 -0
- package/skills/risk-compliance/doc-authenticity/scripts/image_forensics.py +294 -0
- package/skills/risk-compliance/doc-authenticity/scripts/pdf_forensics.py +401 -0
- package/skills/risk-compliance/doc-authenticity/scripts/validate_codes.py +224 -0
- package/skills/risk-compliance/doc-authenticity/scripts/validate_verdict.py +308 -0
- package/skills/risk-compliance/doc-authenticity/scripts/validate_verdict.test.mjs +212 -0
- package/skills/risk-compliance/fraud-analysis/LICENSE +3 -0
- package/skills/risk-compliance/fraud-analysis/SKILL.md +114 -0
- package/skills/risk-compliance/fraud-analysis/references/archetypes/authorized-payment-scam.md +41 -0
- package/skills/risk-compliance/fraud-analysis/references/archetypes/first-party-fraud.md +44 -0
- package/skills/risk-compliance/fraud-analysis/references/archetypes/third-party-fraud.md +27 -0
- package/skills/risk-compliance/fraud-analysis/references/contexts/bank-transfer.md +24 -0
- package/skills/risk-compliance/fraud-analysis/references/contexts/card-payment.md +30 -0
- package/skills/risk-compliance/fraud-analysis/references/contexts/payment-collection.md +20 -0
- package/skills/risk-compliance/fraud-analysis/references/contexts/payout.md +20 -0
- package/skills/risk-compliance/fraud-analysis/references/feature-engineering.md +158 -0
- package/skills/risk-compliance/fraud-analysis/references/mechanisms/account-takeover.md +36 -0
- package/skills/risk-compliance/fraud-analysis/references/report-rationale.md +45 -0
- package/skills/risk-compliance/fraud-analysis/references/report-template.md +190 -0
- package/skills/risk-compliance/fraud-analysis/references/review-checklist.md +175 -0
- package/skills/risk-compliance/fraud-analysis/references/taxonomy.md +79 -0
- package/skills/risk-compliance/fraud-analysis/references/terminology.md +108 -0
- package/skills/risk-compliance/fraud-analysis/references/workflow.md +175 -0
- package/skills/risk-compliance/fraud-analysis/release-check.mjs +93 -0
- package/skills/risk-compliance/payment-analysis/LICENSE +3 -0
- package/skills/risk-compliance/payment-analysis/SKILL.md +180 -0
- package/skills/risk-compliance/payment-analysis/references/auth-rate-actions.md +30 -0
- package/skills/risk-compliance/payment-analysis/references/chargebacks.md +208 -0
- package/skills/risk-compliance/payment-analysis/references/chinese-polish.md +51 -0
- package/skills/risk-compliance/payment-analysis/references/event-layers.md +127 -0
- package/skills/risk-compliance/payment-analysis/references/fx.md +59 -0
- package/skills/risk-compliance/payment-analysis/references/journey.md +79 -0
- package/skills/risk-compliance/payment-analysis/references/metrics.md +67 -0
- package/skills/risk-compliance/payment-analysis/references/report-template.md +119 -0
- package/skills/risk-compliance/payment-analysis/references/terminology.md +95 -0
- package/skills/risk-compliance/payment-analysis/references/visualization.md +56 -0
- package/skills/risk-compliance/payment-analysis/release-check.mjs +93 -0
- package/skills/risk-compliance/report-writing/LICENSE +3 -0
- package/skills/risk-compliance/report-writing/SKILL.md +220 -0
- package/skills/risk-compliance/report-writing/references/audit-report-template.md +121 -0
- package/skills/risk-compliance/report-writing/references/external-assessment-template.md +167 -0
- package/skills/risk-compliance/report-writing/references/management-report-template.md +145 -0
- package/skills/risk-compliance/report-writing/references/vars-report-template.md +224 -0
- package/skills/risk-compliance/report-writing/release-check.mjs +93 -0
- package/skills/risk-compliance/similar-domain/LICENSE +3 -0
- package/skills/risk-compliance/similar-domain/SKILL.md +203 -0
- package/skills/risk-compliance/similar-domain/references/entities.md +67 -0
- package/skills/risk-compliance/similar-domain/references/fingerprints.md +134 -0
- package/skills/risk-compliance/similar-domain/references/pivots.md +82 -0
- package/skills/risk-compliance/similar-domain/references/report-template.md +93 -0
- package/skills/risk-compliance/similar-domain/references/scoring.md +130 -0
- package/skills/risk-compliance/similar-domain/references/terminology.md +41 -0
- package/skills/risk-compliance/similar-domain/references/workflow.md +85 -0
- package/skills/risk-compliance/similar-domain/release-check.mjs +93 -0
- package/skills/risk-compliance/tld-detection/LICENSE +3 -0
- package/skills/risk-compliance/tld-detection/SKILL.md +245 -0
- package/skills/risk-compliance/tld-detection/agents/openai.yaml +9 -0
- package/skills/risk-compliance/tld-detection/references/chinese-polish.md +55 -0
- package/skills/risk-compliance/tld-detection/references/clean.md +51 -0
- package/skills/risk-compliance/tld-detection/references/clustering.md +235 -0
- package/skills/risk-compliance/tld-detection/references/decision.md +189 -0
- package/skills/risk-compliance/tld-detection/references/fx-conversion.md +232 -0
- package/skills/risk-compliance/tld-detection/references/report-template.md +272 -0
- package/skills/risk-compliance/tld-detection/references/streams.md +141 -0
- package/skills/risk-compliance/tld-detection/references/terminology.md +95 -0
- package/skills/risk-compliance/tld-detection/references/workflow.md +95 -0
- package/skills/risk-compliance/tld-detection/release-check.mjs +93 -0
- package/skills/risk-compliance/tld-detection/scripts/detect_ladders.py +390 -0
- package/skills/risk-compliance/tld-detection/scripts/detect_ladders.test.mjs +14 -0
- package/skills/risk-compliance/tld-detection/scripts/detect_streams.py +650 -0
- package/skills/risk-compliance/tld-detection/scripts/detect_streams.test.mjs +14 -0
- package/skills/risk-compliance/tld-detection/tests/test_detect_ladders.py +134 -0
- package/skills/risk-compliance/tld-detection/tests/test_detect_streams.py +520 -0
|
@@ -0,0 +1,221 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Export a compliance audit tracker (tracker.md) to an Excel workbook.
|
|
3
|
+
|
|
4
|
+
Usage:
|
|
5
|
+
python3 export_tracker_xlsx.py <tracker.md> [--output tracker.xlsx]
|
|
6
|
+
|
|
7
|
+
Writes two sheets:
|
|
8
|
+
Tracker one row per Control ID, columns as in the markdown table header.
|
|
9
|
+
``<br>`` becomes an in-cell line break; ``**bold**`` markers are
|
|
10
|
+
dropped. Header row is bold and frozen; long cells wrap.
|
|
11
|
+
Metadata the ``- **Key:** value`` lines of the tracker header.
|
|
12
|
+
|
|
13
|
+
tracker.md stays the source of truth: re-run this after every change to it
|
|
14
|
+
(reconciliation, normalization, remediation updates). Standard library only.
|
|
15
|
+
"""
|
|
16
|
+
from __future__ import annotations
|
|
17
|
+
|
|
18
|
+
import argparse
|
|
19
|
+
import html
|
|
20
|
+
import re
|
|
21
|
+
import sys
|
|
22
|
+
import zipfile
|
|
23
|
+
from pathlib import Path
|
|
24
|
+
from xml.sax.saxutils import escape
|
|
25
|
+
|
|
26
|
+
TABLE_ROW_RE = re.compile(r"^\s*\|.*\|\s*$")
|
|
27
|
+
SEPARATOR_RE = re.compile(r"^\s*\|?(?:\s*:?-+:?\s*\|)+\s*:?-*:?\s*$")
|
|
28
|
+
META_RE = re.compile(r"^\s*[-*]\s+\*\*(?P<key>[^*]+?):?\*\*:?\s*(?P<value>.*)$")
|
|
29
|
+
BR_RE = re.compile(r"<br\s*/?>", re.IGNORECASE)
|
|
30
|
+
# Characters XML 1.0 forbids; a stray one makes Excel refuse the whole file.
|
|
31
|
+
INVALID_XML_RE = re.compile(r"[\x00-\x08\x0b\x0c\x0e-\x1f]")
|
|
32
|
+
|
|
33
|
+
# Width in Excel character units for known columns; others get DEFAULT_WIDTH.
|
|
34
|
+
COLUMN_WIDTHS = {
|
|
35
|
+
"control id": 14,
|
|
36
|
+
"control title": 28,
|
|
37
|
+
"archetype": 11,
|
|
38
|
+
"observations": 70,
|
|
39
|
+
"issue description": 60,
|
|
40
|
+
"control effectiveness rating": 18,
|
|
41
|
+
"effectiveness": 16,
|
|
42
|
+
"proposed remediation": 40,
|
|
43
|
+
"complete by": 13,
|
|
44
|
+
"remediation status": 30,
|
|
45
|
+
}
|
|
46
|
+
DEFAULT_WIDTH = 24
|
|
47
|
+
MAX_WIDTH = 100
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
def split_row(line: str) -> list[str]:
|
|
51
|
+
"""Split a markdown table row on unescaped pipes."""
|
|
52
|
+
body = line.strip()
|
|
53
|
+
if body.startswith("|"):
|
|
54
|
+
body = body[1:]
|
|
55
|
+
if body.endswith("|") and not body.endswith("\\|"):
|
|
56
|
+
body = body[:-1]
|
|
57
|
+
cells = re.split(r"(?<!\\)\|", body)
|
|
58
|
+
return [c.strip().replace("\\|", "|") for c in cells]
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
def cell_text(raw: str) -> str:
|
|
62
|
+
text = BR_RE.sub("\n", raw)
|
|
63
|
+
text = re.sub(r"\*\*(.+?)\*\*", r"\1", text, flags=re.S)
|
|
64
|
+
text = html.unescape(text)
|
|
65
|
+
text = "\n".join(part.strip() for part in text.split("\n"))
|
|
66
|
+
return INVALID_XML_RE.sub("", text)
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
def parse_tracker(text: str) -> tuple[list[tuple[str, str]], list[str], list[list[str]]]:
|
|
70
|
+
"""Return (metadata pairs, header, rows) from the first table in tracker.md."""
|
|
71
|
+
metadata: list[tuple[str, str]] = []
|
|
72
|
+
header: list[str] = []
|
|
73
|
+
rows: list[list[str]] = []
|
|
74
|
+
lines = text.splitlines()
|
|
75
|
+
i = 0
|
|
76
|
+
while i < len(lines):
|
|
77
|
+
line = lines[i]
|
|
78
|
+
if not header:
|
|
79
|
+
m = META_RE.match(line)
|
|
80
|
+
if m:
|
|
81
|
+
metadata.append((m.group("key").strip(), cell_text(m.group("value").strip())))
|
|
82
|
+
elif TABLE_ROW_RE.match(line) and i + 1 < len(lines) and SEPARATOR_RE.match(lines[i + 1]):
|
|
83
|
+
header = [cell_text(c) for c in split_row(line)]
|
|
84
|
+
i += 2
|
|
85
|
+
continue
|
|
86
|
+
else:
|
|
87
|
+
if not TABLE_ROW_RE.match(line):
|
|
88
|
+
break
|
|
89
|
+
cells = [cell_text(c) for c in split_row(line)]
|
|
90
|
+
cells += [""] * (len(header) - len(cells))
|
|
91
|
+
rows.append(cells[: len(header)])
|
|
92
|
+
i += 1
|
|
93
|
+
return metadata, header, rows
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
def column_letter(index: int) -> str:
|
|
97
|
+
letters = ""
|
|
98
|
+
index += 1
|
|
99
|
+
while index:
|
|
100
|
+
index, rem = divmod(index - 1, 26)
|
|
101
|
+
letters = chr(65 + rem) + letters
|
|
102
|
+
return letters
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
def sheet_xml(rows: list[list[str]], widths: list[int], freeze_header: bool) -> str:
|
|
106
|
+
out = ['<?xml version="1.0" encoding="UTF-8" standalone="yes"?>',
|
|
107
|
+
'<worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">']
|
|
108
|
+
if freeze_header:
|
|
109
|
+
out.append('<sheetViews><sheetView workbookViewId="0"><pane ySplit="1" topLeftCell="A2" '
|
|
110
|
+
'activePane="bottomLeft" state="frozen"/></sheetView></sheetViews>')
|
|
111
|
+
out.append("<cols>")
|
|
112
|
+
for n, width in enumerate(widths, start=1):
|
|
113
|
+
out.append(f'<col min="{n}" max="{n}" width="{width}" customWidth="1"/>')
|
|
114
|
+
out.append("</cols><sheetData>")
|
|
115
|
+
for r, row in enumerate(rows, start=1):
|
|
116
|
+
style = 1 if r == 1 else 2 # 1 = bold header, 2 = wrapped body
|
|
117
|
+
out.append(f'<row r="{r}">')
|
|
118
|
+
for c, value in enumerate(row):
|
|
119
|
+
ref = f"{column_letter(c)}{r}"
|
|
120
|
+
out.append(f'<c r="{ref}" s="{style}" t="inlineStr"><is><t xml:space="preserve">'
|
|
121
|
+
f"{escape(value)}</t></is></c>")
|
|
122
|
+
out.append("</row>")
|
|
123
|
+
out.append("</sheetData>")
|
|
124
|
+
if freeze_header and rows:
|
|
125
|
+
out.append(f'<autoFilter ref="A1:{column_letter(len(rows[0]) - 1)}{len(rows)}"/>')
|
|
126
|
+
out.append("</worksheet>")
|
|
127
|
+
return "".join(out)
|
|
128
|
+
|
|
129
|
+
|
|
130
|
+
STYLES_XML = (
|
|
131
|
+
'<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
|
|
132
|
+
'<styleSheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">'
|
|
133
|
+
'<fonts count="2"><font><sz val="11"/><name val="Calibri"/></font>'
|
|
134
|
+
'<font><b/><sz val="11"/><name val="Calibri"/></font></fonts>'
|
|
135
|
+
'<fills count="2"><fill><patternFill patternType="none"/></fill>'
|
|
136
|
+
'<fill><patternFill patternType="gray125"/></fill></fills>'
|
|
137
|
+
'<borders count="1"><border><left/><right/><top/><bottom/><diagonal/></border></borders>'
|
|
138
|
+
'<cellStyleXfs count="1"><xf numFmtId="0" fontId="0" fillId="0" borderId="0"/></cellStyleXfs>'
|
|
139
|
+
'<cellXfs count="3">'
|
|
140
|
+
'<xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0"/>'
|
|
141
|
+
'<xf numFmtId="0" fontId="1" fillId="0" borderId="0" xfId="0" applyFont="1" applyAlignment="1">'
|
|
142
|
+
'<alignment vertical="top" wrapText="1"/></xf>'
|
|
143
|
+
'<xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0" applyAlignment="1">'
|
|
144
|
+
'<alignment vertical="top" wrapText="1"/></xf>'
|
|
145
|
+
"</cellXfs>"
|
|
146
|
+
'<cellStyles count="1"><cellStyle name="Normal" xfId="0" builtinId="0"/></cellStyles>'
|
|
147
|
+
"</styleSheet>"
|
|
148
|
+
)
|
|
149
|
+
|
|
150
|
+
|
|
151
|
+
def write_xlsx(path: Path, sheets: list[tuple[str, str]]) -> None:
|
|
152
|
+
content_types = ['<?xml version="1.0" encoding="UTF-8" standalone="yes"?>',
|
|
153
|
+
'<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">',
|
|
154
|
+
'<Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>',
|
|
155
|
+
'<Default Extension="xml" ContentType="application/xml"/>',
|
|
156
|
+
'<Override PartName="/xl/workbook.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml"/>',
|
|
157
|
+
'<Override PartName="/xl/styles.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml"/>']
|
|
158
|
+
workbook = ['<?xml version="1.0" encoding="UTF-8" standalone="yes"?>',
|
|
159
|
+
'<workbook xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" '
|
|
160
|
+
'xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"><sheets>']
|
|
161
|
+
rels = ['<?xml version="1.0" encoding="UTF-8" standalone="yes"?>',
|
|
162
|
+
'<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">']
|
|
163
|
+
for n, (name, _) in enumerate(sheets, start=1):
|
|
164
|
+
content_types.append(f'<Override PartName="/xl/worksheets/sheet{n}.xml" '
|
|
165
|
+
'ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml"/>')
|
|
166
|
+
workbook.append(f'<sheet name="{escape(name)}" sheetId="{n}" r:id="rId{n}"/>')
|
|
167
|
+
rels.append(f'<Relationship Id="rId{n}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet" '
|
|
168
|
+
f'Target="worksheets/sheet{n}.xml"/>')
|
|
169
|
+
rels.append(f'<Relationship Id="rId{len(sheets) + 1}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles" '
|
|
170
|
+
'Target="styles.xml"/>')
|
|
171
|
+
content_types.append("</Types>")
|
|
172
|
+
workbook.append("</sheets></workbook>")
|
|
173
|
+
rels.append("</Relationships>")
|
|
174
|
+
root_rels = ('<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
|
|
175
|
+
'<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">'
|
|
176
|
+
'<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" '
|
|
177
|
+
'Target="xl/workbook.xml"/></Relationships>')
|
|
178
|
+
with zipfile.ZipFile(path, "w", zipfile.ZIP_DEFLATED) as zf:
|
|
179
|
+
zf.writestr("[Content_Types].xml", "".join(content_types))
|
|
180
|
+
zf.writestr("_rels/.rels", root_rels)
|
|
181
|
+
zf.writestr("xl/workbook.xml", "".join(workbook))
|
|
182
|
+
zf.writestr("xl/_rels/workbook.xml.rels", "".join(rels))
|
|
183
|
+
zf.writestr("xl/styles.xml", STYLES_XML)
|
|
184
|
+
for n, (_, xml) in enumerate(sheets, start=1):
|
|
185
|
+
zf.writestr(f"xl/worksheets/sheet{n}.xml", xml)
|
|
186
|
+
|
|
187
|
+
|
|
188
|
+
def export(tracker: Path, output: Path) -> tuple[int, int]:
|
|
189
|
+
metadata, header, rows = parse_tracker(tracker.read_text(encoding="utf-8"))
|
|
190
|
+
if not header:
|
|
191
|
+
raise ValueError(f"no markdown table found in {tracker}")
|
|
192
|
+
if not rows:
|
|
193
|
+
raise ValueError(f"tracker table in {tracker} has no control rows")
|
|
194
|
+
widths = []
|
|
195
|
+
for c, name in enumerate(header):
|
|
196
|
+
longest = max((len(line) for row in rows for line in row[c].split("\n")), default=0)
|
|
197
|
+
widths.append(min(COLUMN_WIDTHS.get(name.lower(), max(DEFAULT_WIDTH, min(longest, 40))), MAX_WIDTH))
|
|
198
|
+
sheets = [("Tracker", sheet_xml([header] + rows, widths, freeze_header=True))]
|
|
199
|
+
if metadata:
|
|
200
|
+
sheets.append(("Metadata", sheet_xml([["Field", "Value"]] + [list(p) for p in metadata], [32, 80], freeze_header=False)))
|
|
201
|
+
write_xlsx(output, sheets)
|
|
202
|
+
return len(rows), len(metadata)
|
|
203
|
+
|
|
204
|
+
|
|
205
|
+
def main() -> int:
|
|
206
|
+
ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
|
|
207
|
+
ap.add_argument("tracker", type=Path, help="path to tracker.md")
|
|
208
|
+
ap.add_argument("--output", type=Path, default=None, help="xlsx path (default: tracker.xlsx next to the tracker)")
|
|
209
|
+
args = ap.parse_args()
|
|
210
|
+
output = args.output or args.tracker.with_suffix(".xlsx")
|
|
211
|
+
try:
|
|
212
|
+
n_rows, n_meta = export(args.tracker, output)
|
|
213
|
+
except (OSError, ValueError) as exc:
|
|
214
|
+
print(f"export_tracker_xlsx: {exc}", file=sys.stderr)
|
|
215
|
+
return 1
|
|
216
|
+
print(f"wrote {output} ({n_rows} control rows, {n_meta} metadata fields)")
|
|
217
|
+
return 0
|
|
218
|
+
|
|
219
|
+
|
|
220
|
+
if __name__ == "__main__":
|
|
221
|
+
sys.exit(main())
|
|
@@ -0,0 +1,458 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Reconcile validated findings into the tracker (Step 9E).
|
|
3
|
+
|
|
4
|
+
Reads ``tracker.md`` and applies findings that are deterministically
|
|
5
|
+
verifiable, so hallucinated coverage cannot survive into the deliverable:
|
|
6
|
+
|
|
7
|
+
- From ``validate_tracker.py --json``: citation_grounding "missing clause"
|
|
8
|
+
warnings. The cited ``section X`` is not in the evidence file, so the citation
|
|
9
|
+
is hallucinated. Bullet flips to ``Not addressed`` with the reason.
|
|
10
|
+
- From the citation-judge JSON sidecars (Variant C, Step 9C): verdicts of
|
|
11
|
+
``Off-target`` and ``Missing`` flip the bullet to ``Not addressed`` with
|
|
12
|
+
the judge's reason quoted.
|
|
13
|
+
|
|
14
|
+
Findings that are *not* auto-applied (judge ``Weak``, adversarial-challenger
|
|
15
|
+
recommendations) are surfaced in the reconciliation log for the human
|
|
16
|
+
reviewer to decide on.
|
|
17
|
+
|
|
18
|
+
After flipping bullets, the Control Effectiveness Rating is recomputed using
|
|
19
|
+
the same rubric as ``validate_tracker.py``. A line tagging the row as
|
|
20
|
+
"reconciled by Step 9E" is prepended to the Issue Description cell so the
|
|
21
|
+
reviewer can see what changed at a glance; the existing prose is preserved.
|
|
22
|
+
|
|
23
|
+
Usage:
|
|
24
|
+
python3 reconcile_tracker.py <tracker.md> --checklist <path> \\
|
|
25
|
+
[--validation <validate_tracker --json output>] \\
|
|
26
|
+
[--judge <judge-<group>.json>]... \\
|
|
27
|
+
[--output <path>] [--log <reconciliation.md>] [--dry-run]
|
|
28
|
+
|
|
29
|
+
Default ``--output`` is the tracker path itself (in-place rewrite).
|
|
30
|
+
Default ``--log`` is ``reconciliation.md`` next to the tracker.
|
|
31
|
+
"""
|
|
32
|
+
|
|
33
|
+
from __future__ import annotations
|
|
34
|
+
|
|
35
|
+
import argparse
|
|
36
|
+
import json
|
|
37
|
+
import re
|
|
38
|
+
import sys
|
|
39
|
+
from dataclasses import dataclass, field
|
|
40
|
+
from datetime import datetime, timezone
|
|
41
|
+
from pathlib import Path
|
|
42
|
+
from typing import Optional
|
|
43
|
+
|
|
44
|
+
SCRIPT_DIR = Path(__file__).resolve().parent
|
|
45
|
+
sys.path.insert(0, str(SCRIPT_DIR))
|
|
46
|
+
|
|
47
|
+
from validate_tracker import ( # noqa: E402 (import after sys.path)
|
|
48
|
+
BULLET_PREFIX_RE,
|
|
49
|
+
BULLET_SPLIT_RE,
|
|
50
|
+
Observation,
|
|
51
|
+
classify_status,
|
|
52
|
+
derive_expected_rating,
|
|
53
|
+
normalize_item_id,
|
|
54
|
+
parse_checklist,
|
|
55
|
+
)
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
VALIDATION_MISSING_CLAUSE_RE = re.compile(
|
|
59
|
+
r"^\((?P<item>[^)]+)\)\s*clause\s*'(?:§\s*|section\s+)(?P<clause>[^']+?)'\s*not\s+found\s+in\s+(?P<doc>.+?)\s*$",
|
|
60
|
+
re.IGNORECASE,
|
|
61
|
+
)
|
|
62
|
+
VALIDATION_NO_DOC_RE = re.compile(
|
|
63
|
+
r"^\((?P<item>[^)]+)\)\s*no\s+evidence\s+file\s+matches\s*'(?P<doc>[^']+)'",
|
|
64
|
+
re.IGNORECASE,
|
|
65
|
+
)
|
|
66
|
+
|
|
67
|
+
CONTROL_ID_RE = re.compile(r"^[A-Z][A-Z0-9]*\.C\d+(?:\.\d+)?$")
|
|
68
|
+
TABLE_HEADER_RE = re.compile(r"^\|\s*Control ID\s*\|", re.IGNORECASE)
|
|
69
|
+
SEPARATOR_RE = re.compile(r"^\|[\s\-:|]+\|\s*$")
|
|
70
|
+
BULLET_PREFIX_LITERAL_RE = re.compile(r"^([\s•\-\*]*)Control\s+([^:]+):\s*(.*)$", re.IGNORECASE)
|
|
71
|
+
|
|
72
|
+
|
|
73
|
+
@dataclass
|
|
74
|
+
class AutoApplyFinding:
|
|
75
|
+
"""A single finding that should auto-flip a bullet."""
|
|
76
|
+
|
|
77
|
+
control_id: str
|
|
78
|
+
item: str # canonical item id
|
|
79
|
+
source: str # "9B-clause-missing" | "9B-doc-missing" | "9C-off-target" | "9C-missing"
|
|
80
|
+
reason: str
|
|
81
|
+
|
|
82
|
+
def short_label(self) -> str:
|
|
83
|
+
return {
|
|
84
|
+
"9B-clause-missing": "9B — cited clause not in evidence",
|
|
85
|
+
"9B-doc-missing": "9B — cited document not found",
|
|
86
|
+
"9C-off-target": "9C judge — Off-target",
|
|
87
|
+
"9C-missing": "9C judge — Missing",
|
|
88
|
+
}.get(self.source, self.source)
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
@dataclass
|
|
92
|
+
class ReviewerMediated:
|
|
93
|
+
"""A finding that needs human judgement; not auto-applied."""
|
|
94
|
+
|
|
95
|
+
control_id: str
|
|
96
|
+
item: str
|
|
97
|
+
source: str # "9C-weak" | "9D-challenge"
|
|
98
|
+
reason: str
|
|
99
|
+
|
|
100
|
+
|
|
101
|
+
@dataclass
|
|
102
|
+
class RowChange:
|
|
103
|
+
control_id: str
|
|
104
|
+
flips: list[tuple[str, str]] = field(default_factory=list) # (item, reason)
|
|
105
|
+
old_rating: str = ""
|
|
106
|
+
new_rating: str = ""
|
|
107
|
+
|
|
108
|
+
|
|
109
|
+
def load_validation_findings(path: Path) -> tuple[list[AutoApplyFinding], list[str]]:
|
|
110
|
+
"""Extract auto-apply findings from validate_tracker.py --json output.
|
|
111
|
+
|
|
112
|
+
Returns (findings, unparsed_messages). Unparsed messages are surfaced in
|
|
113
|
+
the reconciliation log so the reviewer knows the validator flagged
|
|
114
|
+
something the reconciler didn't know how to act on.
|
|
115
|
+
"""
|
|
116
|
+
data = json.loads(path.read_text(encoding="utf-8"))
|
|
117
|
+
findings: list[AutoApplyFinding] = []
|
|
118
|
+
unparsed: list[str] = []
|
|
119
|
+
for entry in data.get("warnings", []):
|
|
120
|
+
if entry.get("check") != "citation_grounding":
|
|
121
|
+
continue
|
|
122
|
+
ctrl = entry.get("control_id") or ""
|
|
123
|
+
msg = entry.get("message") or ""
|
|
124
|
+
m = VALIDATION_MISSING_CLAUSE_RE.match(msg)
|
|
125
|
+
if m:
|
|
126
|
+
findings.append(
|
|
127
|
+
AutoApplyFinding(
|
|
128
|
+
control_id=ctrl,
|
|
129
|
+
item=normalize_item_id(m.group("item")),
|
|
130
|
+
source="9B-clause-missing",
|
|
131
|
+
reason=f"cited clause section {m.group('clause').strip()} not found in {m.group('doc').strip()}",
|
|
132
|
+
)
|
|
133
|
+
)
|
|
134
|
+
continue
|
|
135
|
+
m = VALIDATION_NO_DOC_RE.match(msg)
|
|
136
|
+
if m:
|
|
137
|
+
findings.append(
|
|
138
|
+
AutoApplyFinding(
|
|
139
|
+
control_id=ctrl,
|
|
140
|
+
item=normalize_item_id(m.group("item")),
|
|
141
|
+
source="9B-doc-missing",
|
|
142
|
+
reason=f"cited document '{m.group('doc')}' not found among evidence files",
|
|
143
|
+
)
|
|
144
|
+
)
|
|
145
|
+
continue
|
|
146
|
+
unparsed.append(f"[{ctrl or '-'}] {msg}")
|
|
147
|
+
return findings, unparsed
|
|
148
|
+
|
|
149
|
+
|
|
150
|
+
def load_judge_findings(path: Path) -> tuple[list[AutoApplyFinding], list[ReviewerMediated]]:
|
|
151
|
+
auto: list[AutoApplyFinding] = []
|
|
152
|
+
mediated: list[ReviewerMediated] = []
|
|
153
|
+
raw = json.loads(path.read_text(encoding="utf-8"))
|
|
154
|
+
if not isinstance(raw, list):
|
|
155
|
+
raise ValueError(f"{path}: expected a JSON array of verdicts")
|
|
156
|
+
for entry in raw:
|
|
157
|
+
ctrl = (entry.get("control_id") or "").strip()
|
|
158
|
+
item_raw = (entry.get("item") or "").strip()
|
|
159
|
+
verdict = (entry.get("verdict") or "").strip()
|
|
160
|
+
reason = (entry.get("reason") or "").strip()
|
|
161
|
+
if not ctrl or not item_raw or not verdict:
|
|
162
|
+
continue
|
|
163
|
+
item = normalize_item_id(item_raw)
|
|
164
|
+
v_low = verdict.lower()
|
|
165
|
+
if v_low == "off-target":
|
|
166
|
+
auto.append(AutoApplyFinding(ctrl, item, "9C-off-target", reason or "judge: clause does not address the requirement"))
|
|
167
|
+
elif v_low == "missing":
|
|
168
|
+
auto.append(AutoApplyFinding(ctrl, item, "9C-missing", reason or "judge: cited clause not located in evidence"))
|
|
169
|
+
elif v_low == "weak":
|
|
170
|
+
mediated.append(ReviewerMediated(ctrl, item, "9C-weak", reason or "judge: clause references topic but does not operationalise"))
|
|
171
|
+
elif v_low == "confirmed":
|
|
172
|
+
continue
|
|
173
|
+
else:
|
|
174
|
+
mediated.append(ReviewerMediated(ctrl, item, f"9C-{v_low}", reason))
|
|
175
|
+
return auto, mediated
|
|
176
|
+
|
|
177
|
+
|
|
178
|
+
# --- Tracker mutation -----------------------------------------------------
|
|
179
|
+
|
|
180
|
+
|
|
181
|
+
def split_bullets(cell: str) -> list[str]:
|
|
182
|
+
pieces = [c for c in BULLET_SPLIT_RE.split(cell)]
|
|
183
|
+
return pieces
|
|
184
|
+
|
|
185
|
+
|
|
186
|
+
def join_bullets(bullets: list[str]) -> str:
|
|
187
|
+
return "<br>".join(bullets)
|
|
188
|
+
|
|
189
|
+
|
|
190
|
+
def parse_bullet(text: str) -> Optional[tuple[str, str, str, str]]:
|
|
191
|
+
"""Return (leading_whitespace_and_bullet, item_raw, item_canon, body) or None."""
|
|
192
|
+
m = BULLET_PREFIX_LITERAL_RE.match(text)
|
|
193
|
+
if not m:
|
|
194
|
+
return None
|
|
195
|
+
prefix = m.group(1) or ""
|
|
196
|
+
item_raw = m.group(2).strip()
|
|
197
|
+
body = m.group(3).strip()
|
|
198
|
+
return (prefix, item_raw, normalize_item_id(item_raw), body)
|
|
199
|
+
|
|
200
|
+
|
|
201
|
+
def flip_bullet_text(original_bullet: str, reason: str) -> Optional[str]:
|
|
202
|
+
parsed = parse_bullet(original_bullet)
|
|
203
|
+
if not parsed:
|
|
204
|
+
return None
|
|
205
|
+
prefix, item_raw, _canon, _body = parsed
|
|
206
|
+
return f"{prefix}Control {item_raw}: Not addressed — {reason}"
|
|
207
|
+
|
|
208
|
+
|
|
209
|
+
def parse_table_row(line: str) -> Optional[list[str]]:
|
|
210
|
+
if not line.startswith("|"):
|
|
211
|
+
return None
|
|
212
|
+
body = line.strip()[1:]
|
|
213
|
+
if body.endswith("|") and not body.endswith("\\|"):
|
|
214
|
+
body = body[:-1]
|
|
215
|
+
# Split on unescaped pipes only; cells keep their "\|" escapes for re-rendering.
|
|
216
|
+
cells = [c.strip() for c in re.split(r"(?<!\\)\|", body)]
|
|
217
|
+
if not cells or not cells[0]:
|
|
218
|
+
return None
|
|
219
|
+
if not CONTROL_ID_RE.match(cells[0]):
|
|
220
|
+
return None
|
|
221
|
+
return cells
|
|
222
|
+
|
|
223
|
+
|
|
224
|
+
def render_table_row(cells: list[str]) -> str:
|
|
225
|
+
return "| " + " | ".join(cells) + " |"
|
|
226
|
+
|
|
227
|
+
|
|
228
|
+
def reconcile_row(
|
|
229
|
+
cells: list[str],
|
|
230
|
+
findings: list[AutoApplyFinding],
|
|
231
|
+
control_items: list,
|
|
232
|
+
change: RowChange,
|
|
233
|
+
) -> list[str]:
|
|
234
|
+
"""Apply auto-apply findings to a single tracker row's cells."""
|
|
235
|
+
if len(cells) < 6:
|
|
236
|
+
return cells
|
|
237
|
+
|
|
238
|
+
obs_cell = cells[3]
|
|
239
|
+
issue_cell = cells[4]
|
|
240
|
+
rating_cell = cells[5]
|
|
241
|
+
|
|
242
|
+
bullets = split_bullets(obs_cell)
|
|
243
|
+
findings_by_item: dict[str, list[AutoApplyFinding]] = {}
|
|
244
|
+
for f in findings:
|
|
245
|
+
findings_by_item.setdefault(f.item, []).append(f)
|
|
246
|
+
|
|
247
|
+
new_bullets: list[str] = []
|
|
248
|
+
for raw in bullets:
|
|
249
|
+
chunk = BULLET_PREFIX_RE.sub("", raw).strip()
|
|
250
|
+
if not chunk:
|
|
251
|
+
new_bullets.append(raw)
|
|
252
|
+
continue
|
|
253
|
+
parsed = parse_bullet(raw)
|
|
254
|
+
if not parsed:
|
|
255
|
+
new_bullets.append(raw)
|
|
256
|
+
continue
|
|
257
|
+
prefix, item_raw, item_canon, body = parsed
|
|
258
|
+
applicable = findings_by_item.get(item_canon)
|
|
259
|
+
if not applicable:
|
|
260
|
+
new_bullets.append(raw)
|
|
261
|
+
continue
|
|
262
|
+
# Skip if the bullet already says Not addressed (no-op flip).
|
|
263
|
+
if classify_status(body) == "not_addressed":
|
|
264
|
+
new_bullets.append(raw)
|
|
265
|
+
continue
|
|
266
|
+
reasons = "; ".join(f.reason for f in applicable)
|
|
267
|
+
flipped = flip_bullet_text(raw, reasons)
|
|
268
|
+
if flipped is None:
|
|
269
|
+
new_bullets.append(raw)
|
|
270
|
+
continue
|
|
271
|
+
new_bullets.append(flipped)
|
|
272
|
+
change.flips.append((item_raw, "; ".join(f.short_label() for f in applicable)))
|
|
273
|
+
|
|
274
|
+
new_obs = join_bullets(new_bullets)
|
|
275
|
+
|
|
276
|
+
# Recompute rating from the new bullet states.
|
|
277
|
+
observations: list[Observation] = []
|
|
278
|
+
for raw in new_bullets:
|
|
279
|
+
parsed = parse_bullet(raw)
|
|
280
|
+
if not parsed:
|
|
281
|
+
continue
|
|
282
|
+
_prefix, item_raw, _canon, body = parsed
|
|
283
|
+
observations.append(Observation(item_raw, classify_status(body), body))
|
|
284
|
+
|
|
285
|
+
new_rating = derive_expected_rating(observations, control_items)
|
|
286
|
+
change.old_rating = rating_cell
|
|
287
|
+
change.new_rating = new_rating or rating_cell
|
|
288
|
+
|
|
289
|
+
rating_out = new_rating if new_rating else rating_cell
|
|
290
|
+
|
|
291
|
+
if change.flips:
|
|
292
|
+
flipped_summary = "; ".join(
|
|
293
|
+
f"Control {item} ({label})" for item, label in change.flips
|
|
294
|
+
)
|
|
295
|
+
annotation = f"**[Step 9E reconciled]:** {flipped_summary}.<br>"
|
|
296
|
+
if not issue_cell.startswith("**[Step 9E reconciled]"):
|
|
297
|
+
issue_cell = annotation + issue_cell
|
|
298
|
+
|
|
299
|
+
new_cells = list(cells)
|
|
300
|
+
new_cells[3] = new_obs
|
|
301
|
+
new_cells[4] = issue_cell
|
|
302
|
+
new_cells[5] = rating_out
|
|
303
|
+
return new_cells
|
|
304
|
+
|
|
305
|
+
|
|
306
|
+
def reconcile_tracker(
|
|
307
|
+
tracker_text: str,
|
|
308
|
+
auto_findings: list[AutoApplyFinding],
|
|
309
|
+
controls: dict,
|
|
310
|
+
) -> tuple[str, list[RowChange]]:
|
|
311
|
+
findings_by_control: dict[str, list[AutoApplyFinding]] = {}
|
|
312
|
+
for f in auto_findings:
|
|
313
|
+
findings_by_control.setdefault(f.control_id, []).append(f)
|
|
314
|
+
|
|
315
|
+
out_lines: list[str] = []
|
|
316
|
+
changes: list[RowChange] = []
|
|
317
|
+
for line in tracker_text.splitlines():
|
|
318
|
+
cells = parse_table_row(line)
|
|
319
|
+
if cells is None:
|
|
320
|
+
out_lines.append(line)
|
|
321
|
+
continue
|
|
322
|
+
ctrl_id = cells[0]
|
|
323
|
+
applicable = findings_by_control.get(ctrl_id, [])
|
|
324
|
+
control = controls.get(ctrl_id)
|
|
325
|
+
if not applicable or control is None:
|
|
326
|
+
out_lines.append(line)
|
|
327
|
+
continue
|
|
328
|
+
change = RowChange(control_id=ctrl_id)
|
|
329
|
+
new_cells = reconcile_row(cells, applicable, control.items, change)
|
|
330
|
+
if change.flips:
|
|
331
|
+
changes.append(change)
|
|
332
|
+
out_lines.append(render_table_row(new_cells))
|
|
333
|
+
else:
|
|
334
|
+
out_lines.append(line)
|
|
335
|
+
|
|
336
|
+
return "\n".join(out_lines) + ("\n" if tracker_text.endswith("\n") else ""), changes
|
|
337
|
+
|
|
338
|
+
|
|
339
|
+
# --- Reconciliation log ----------------------------------------------------
|
|
340
|
+
|
|
341
|
+
|
|
342
|
+
def write_log(
|
|
343
|
+
log_path: Path,
|
|
344
|
+
tracker_path: Path,
|
|
345
|
+
output_path: Path,
|
|
346
|
+
auto_findings: list[AutoApplyFinding],
|
|
347
|
+
mediated: list[ReviewerMediated],
|
|
348
|
+
unparsed_validation: list[str],
|
|
349
|
+
changes: list[RowChange],
|
|
350
|
+
) -> None:
|
|
351
|
+
now = datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M UTC")
|
|
352
|
+
lines: list[str] = []
|
|
353
|
+
lines.append("# Reconciliation Log (Step 9E)")
|
|
354
|
+
lines.append("")
|
|
355
|
+
lines.append(f"- **Generated:** {now}")
|
|
356
|
+
lines.append(f"- **Source tracker:** `{tracker_path}`")
|
|
357
|
+
lines.append(f"- **Reconciled tracker:** `{output_path}`")
|
|
358
|
+
lines.append(f"- **Auto-applied findings:** {len(auto_findings)}")
|
|
359
|
+
lines.append(f"- **Reviewer-mediated findings:** {len(mediated)}")
|
|
360
|
+
lines.append(f"- **Rows changed:** {len(changes)}")
|
|
361
|
+
lines.append("")
|
|
362
|
+
|
|
363
|
+
lines.append("## Auto-applied")
|
|
364
|
+
if not changes:
|
|
365
|
+
lines.append("")
|
|
366
|
+
lines.append("_None — no auto-apply findings hit any tracker bullet._")
|
|
367
|
+
else:
|
|
368
|
+
for change in changes:
|
|
369
|
+
lines.append("")
|
|
370
|
+
lines.append(f"### {change.control_id}")
|
|
371
|
+
lines.append("")
|
|
372
|
+
lines.append(f"- **Rating:** `{change.old_rating}` → **`{change.new_rating}`**")
|
|
373
|
+
lines.append("- **Bullets flipped:**")
|
|
374
|
+
for item, label in change.flips:
|
|
375
|
+
lines.append(f" - Control {item}: {label}")
|
|
376
|
+
lines.append("")
|
|
377
|
+
|
|
378
|
+
lines.append("## Pending review (NOT auto-applied)")
|
|
379
|
+
if not mediated:
|
|
380
|
+
lines.append("")
|
|
381
|
+
lines.append("_None._")
|
|
382
|
+
else:
|
|
383
|
+
by_ctrl: dict[str, list[ReviewerMediated]] = {}
|
|
384
|
+
for m in mediated:
|
|
385
|
+
by_ctrl.setdefault(m.control_id, []).append(m)
|
|
386
|
+
for ctrl_id, items in sorted(by_ctrl.items()):
|
|
387
|
+
lines.append("")
|
|
388
|
+
lines.append(f"### {ctrl_id}")
|
|
389
|
+
lines.append("")
|
|
390
|
+
for m in items:
|
|
391
|
+
lines.append(f"- **Control {m.item}** ({m.source}): {m.reason}")
|
|
392
|
+
lines.append("")
|
|
393
|
+
|
|
394
|
+
if unparsed_validation:
|
|
395
|
+
lines.append("## Validator messages the reconciler could not parse")
|
|
396
|
+
lines.append("")
|
|
397
|
+
lines.append("These were emitted by `validate_tracker.py` but did not match a known auto-apply pattern. Review manually.")
|
|
398
|
+
lines.append("")
|
|
399
|
+
for msg in unparsed_validation:
|
|
400
|
+
lines.append(f"- {msg}")
|
|
401
|
+
lines.append("")
|
|
402
|
+
|
|
403
|
+
log_path.write_text("\n".join(lines), encoding="utf-8")
|
|
404
|
+
|
|
405
|
+
|
|
406
|
+
# --- CLI -------------------------------------------------------------------
|
|
407
|
+
|
|
408
|
+
|
|
409
|
+
def main() -> int:
|
|
410
|
+
ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
|
|
411
|
+
ap.add_argument("tracker", type=Path, help="path to tracker.md")
|
|
412
|
+
ap.add_argument("--checklist", type=Path, required=True)
|
|
413
|
+
ap.add_argument("--validation", type=Path, default=None, help="JSON output from validate_tracker.py --json")
|
|
414
|
+
ap.add_argument("--judge", type=Path, action="append", default=[], help="judge-<group>.json sidecar (may be passed multiple times)")
|
|
415
|
+
ap.add_argument("--output", type=Path, default=None, help="where to write the reconciled tracker (default: overwrite input)")
|
|
416
|
+
ap.add_argument("--log", type=Path, default=None, help="reconciliation log path (default: reconciliation.md alongside tracker)")
|
|
417
|
+
ap.add_argument("--dry-run", action="store_true", help="don't write the reconciled tracker; still write the log")
|
|
418
|
+
args = ap.parse_args()
|
|
419
|
+
|
|
420
|
+
if not args.tracker.exists():
|
|
421
|
+
print(f"tracker not found: {args.tracker}", file=sys.stderr)
|
|
422
|
+
return 1
|
|
423
|
+
|
|
424
|
+
controls = parse_checklist(args.checklist)
|
|
425
|
+
|
|
426
|
+
auto: list[AutoApplyFinding] = []
|
|
427
|
+
mediated: list[ReviewerMediated] = []
|
|
428
|
+
unparsed: list[str] = []
|
|
429
|
+
|
|
430
|
+
if args.validation:
|
|
431
|
+
v_auto, v_unparsed = load_validation_findings(args.validation)
|
|
432
|
+
auto.extend(v_auto)
|
|
433
|
+
unparsed.extend(v_unparsed)
|
|
434
|
+
|
|
435
|
+
for jp in args.judge:
|
|
436
|
+
j_auto, j_mediated = load_judge_findings(jp)
|
|
437
|
+
auto.extend(j_auto)
|
|
438
|
+
mediated.extend(j_mediated)
|
|
439
|
+
|
|
440
|
+
tracker_text = args.tracker.read_text(encoding="utf-8")
|
|
441
|
+
new_text, changes = reconcile_tracker(tracker_text, auto, controls)
|
|
442
|
+
|
|
443
|
+
output_path = args.output or args.tracker
|
|
444
|
+
if not args.dry_run:
|
|
445
|
+
output_path.write_text(new_text, encoding="utf-8")
|
|
446
|
+
|
|
447
|
+
log_path = args.log or args.tracker.with_name("reconciliation.md")
|
|
448
|
+
write_log(log_path, args.tracker, output_path, auto, mediated, unparsed, changes)
|
|
449
|
+
|
|
450
|
+
print(f"auto-applied: {sum(len(c.flips) for c in changes)} bullet(s) across {len(changes)} control(s)", file=sys.stderr)
|
|
451
|
+
print(f"reviewer-mediated: {len(mediated)} finding(s)", file=sys.stderr)
|
|
452
|
+
print(f"reconciled tracker: {output_path}", file=sys.stderr)
|
|
453
|
+
print(f"log: {log_path}", file=sys.stderr)
|
|
454
|
+
return 0
|
|
455
|
+
|
|
456
|
+
|
|
457
|
+
if __name__ == "__main__":
|
|
458
|
+
sys.exit(main())
|