@uipath/delegate-sdk 1.203.1 → 1.203.3
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 +41 -3
- package/dist/index.mjs +2 -2
- package/dist/skills/business-analysis/SKILL.md +729 -0
- package/dist/skills/business-analysis/as-is-capture.md +444 -0
- package/dist/skills/business-analysis/assets/progress.yaml +19 -0
- package/dist/skills/business-analysis/assets/task-list.md +34 -0
- package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
- package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
- package/dist/skills/business-analysis/case-to-be-design.md +223 -0
- package/dist/skills/business-analysis/diagram-authoring.md +224 -0
- package/dist/skills/business-analysis/industry-gaps.md +134 -0
- package/dist/skills/business-analysis/interview-spine.md +297 -0
- package/dist/skills/business-analysis/locales/de.json +54 -0
- package/dist/skills/business-analysis/locales/en.json +54 -0
- package/dist/skills/business-analysis/locales/es-MX.json +54 -0
- package/dist/skills/business-analysis/locales/es.json +54 -0
- package/dist/skills/business-analysis/locales/fr.json +54 -0
- package/dist/skills/business-analysis/locales/ja.json +54 -0
- package/dist/skills/business-analysis/locales/ko.json +54 -0
- package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
- package/dist/skills/business-analysis/locales/pt.json +54 -0
- package/dist/skills/business-analysis/locales/ro.json +54 -0
- package/dist/skills/business-analysis/locales/tr.json +54 -0
- package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
- package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
- package/dist/skills/business-analysis/pdd-generation.md +204 -0
- package/dist/skills/business-analysis/pdd-template.md +562 -0
- package/dist/skills/business-analysis/progress-presentation.json +13 -0
- package/dist/skills/business-analysis/recording-first.md +19 -0
- package/dist/skills/business-analysis/recording-processing.md +152 -0
- package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
- package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
- package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
- package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
- package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
- package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
- package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
- package/dist/skills/business-analysis/research-offer.md +104 -0
- package/dist/skills/business-analysis/research-pass.md +149 -0
- package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
- package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
- package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
- package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
- package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
- package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
- package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
- package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
- package/dist/skills/business-analysis/to-be-design.md +199 -0
- package/dist/skills/confluence/SKILL.md +386 -0
- package/dist/skills/doc-coauthoring/SKILL.md +295 -0
- package/dist/skills/excel-architect/SKILL.macos.md +161 -0
- package/dist/skills/excel-architect/SKILL.md +180 -0
- package/dist/skills/excel-architect/SKILL.windows.md +61 -0
- package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
- package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
- package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
- package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
- package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
- package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
- package/dist/skills/excel-architect/building.md +279 -0
- package/dist/skills/excel-architect/create.md +64 -0
- package/dist/skills/excel-architect/data-and-formulas.md +186 -0
- package/dist/skills/excel-architect/generator.md +272 -0
- package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
- package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
- package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
- package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
- package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
- package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
- package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
- package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
- package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
- package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
- package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
- package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
- package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
- package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
- package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
- package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
- package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
- package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
- package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
- package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
- package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
- package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
- package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
- package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
- package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
- package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
- package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
- package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
- package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
- package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
- package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
- package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
- package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
- package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
- package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
- package/dist/skills/excel-architect/reference/api/basic.md +747 -0
- package/dist/skills/excel-architect/reference/guides.md +348 -0
- package/dist/skills/excel-architect/reference/repair.md +174 -0
- package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
- package/dist/skills/excel-architect/scripting.md +266 -0
- package/dist/skills/excel-architect/styling-and-features.md +433 -0
- package/dist/skills/excel-architect/windows/api/composites.md +337 -0
- package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
- package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
- package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
- package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
- package/dist/skills/github/SKILL.md +446 -0
- package/dist/skills/github/recipes/add-comment.md +85 -0
- package/dist/skills/github/recipes/check-pr-status.md +122 -0
- package/dist/skills/github/recipes/compare-branches.md +79 -0
- package/dist/skills/github/recipes/create-issue.md +103 -0
- package/dist/skills/github/recipes/create-pr.md +97 -0
- package/dist/skills/github/recipes/get-file-contents.md +76 -0
- package/dist/skills/github/recipes/get-last-commit.md +128 -0
- package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
- package/dist/skills/github/recipes/list-recent-commits.md +84 -0
- package/dist/skills/github/recipes/search-issues.md +115 -0
- package/dist/skills/google-workspace/SKILL.md +217 -0
- package/dist/skills/google-workspace/services/calendar.md +311 -0
- package/dist/skills/google-workspace/services/docs.md +426 -0
- package/dist/skills/google-workspace/services/drive.md +504 -0
- package/dist/skills/google-workspace/services/gmail.md +466 -0
- package/dist/skills/google-workspace/services/sheets.md +370 -0
- package/dist/skills/internal-comms/SKILL.md +35 -0
- package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
- package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
- package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
- package/dist/skills/internal-comms/examples/general-comms.md +15 -0
- package/dist/skills/jira/SKILL.md +397 -0
- package/dist/skills/jira/recipes/add-comment.md +123 -0
- package/dist/skills/jira/recipes/assign-issue.md +157 -0
- package/dist/skills/jira/recipes/create-issue.md +274 -0
- package/dist/skills/jira/recipes/get-issue-details.md +154 -0
- package/dist/skills/jira/recipes/list-projects.md +151 -0
- package/dist/skills/jira/recipes/my-issues.md +180 -0
- package/dist/skills/jira/recipes/search-issues.md +215 -0
- package/dist/skills/jira/recipes/transition-issue.md +154 -0
- package/dist/skills/jira/recipes/troubleshooting.md +387 -0
- package/dist/skills/knowledge-base/SKILL.md +289 -0
- package/dist/skills/media-tools/SKILL.md +204 -0
- package/dist/skills/media-tools/references/encode-runbook.md +24 -0
- package/dist/skills/media-tools/references/resolve-binaries.md +88 -0
- package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
- package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
- package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
- package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
- package/dist/skills/office-download/SKILL.md +161 -0
- package/dist/skills/outlook-365/SKILL.macos.md +331 -0
- package/dist/skills/outlook-365/SKILL.md +171 -0
- package/dist/skills/outlook-365/SKILL.windows.md +124 -0
- package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
- package/dist/skills/outlook-365/api/check-availability.md +87 -0
- package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
- package/dist/skills/outlook-365/api/download-attachments.md +149 -0
- package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
- package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
- package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
- package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
- package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
- package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
- package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
- package/dist/skills/outlook-365/api/send-email.md +396 -0
- package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
- package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
- package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
- package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
- package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
- package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
- package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
- package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
- package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
- package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
- package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
- package/dist/skills/outlook-365/uia/README.md +75 -0
- package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
- package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
- package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
- package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
- package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
- package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
- package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
- package/dist/skills/pdf-architect/SKILL.md +640 -0
- package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
- package/dist/skills/powerpoint-architect/SKILL.md +853 -0
- package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
- package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
- package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
- package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
- package/dist/skills/powerpoint-architect/images-guide.md +207 -0
- package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
- package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
- package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
- package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
- package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
- package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
- package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
- package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
- package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
- package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
- package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
- package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
- package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
- package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
- package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
- package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
- package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
- package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
- package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
- package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
- package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
- package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
- package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
- package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
- package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
- package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
- package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
- package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
- package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
- package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
- package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
- package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
- package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
- package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
- package/dist/skills/project-task-list/SKILL.md +174 -0
- package/dist/skills/slack-operation/SKILL.md +97 -0
- package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
- package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
- package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
- package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
- package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
- package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
- package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
- package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
- package/dist/skills/system-diagnostics/SKILL.md +263 -0
- package/dist/skills/teams-operation/SKILL.md +79 -0
- package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
- package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
- package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
- package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
- package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
- package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
- package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
- package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
- package/dist/skills/transcribe-media/SKILL.md +142 -0
- package/dist/skills/uipath-integrations/SKILL.md +370 -0
- package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
- package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
- package/dist/skills/uipath-integrations/reference/errors.md +211 -0
- package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
- package/dist/skills/uipath-integrations/reference/operations.md +297 -0
- package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
- package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
- package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
- package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
- package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
- package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
- package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
- package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
- package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
- package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
- package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
- package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
- package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
- package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
- package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
- package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
- package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
- package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
- package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
- package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
- package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
- package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
- package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
- package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
- package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
- package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
- package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
- package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
- package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
- package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
- package/dist/skills/word-architect/SKILL.macos.md +147 -0
- package/dist/skills/word-architect/SKILL.md +502 -0
- package/dist/skills/word-architect/SKILL.windows.md +55 -0
- package/dist/skills/word-architect/api/advanced.md +522 -0
- package/dist/skills/word-architect/api/basic.md +378 -0
- package/dist/skills/word-architect/api/expert.md +302 -0
- package/dist/skills/word-architect/generation.md +308 -0
- package/dist/skills/word-architect/layouts/01-professional.md +168 -0
- package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
- package/dist/skills/word-architect/layouts/03-academic.md +83 -0
- package/dist/skills/word-architect/layouts/04-creative.md +242 -0
- package/dist/skills/word-architect/layouts/05-operational.md +94 -0
- package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
- package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
- package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
- package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
- package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
- package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
- package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
- package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
- package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
- package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
- package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
- package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
- package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
- package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
- package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
- package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
- package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
- package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
- package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
- package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
- package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
- package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
- package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
- package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
- package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
- package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
- package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
- package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
- package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
- package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
- package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
- package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
- package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
- package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
- package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
- package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
- package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
- package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
- package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
- package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
- package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
- package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
- package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
- package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
- package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
- package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
- package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
- package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
- package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
- package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
- package/dist/skills/word-architect/reference/formatting.md +119 -0
- package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
- package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
- package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
- package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
- package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
- package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
- package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
- package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
- package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
- package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
- package/dist/skills/word-architect/reference/tables.md +62 -0
- package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
- package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
- package/dist/skills/word-architect/reference/visual-elements.md +82 -0
- package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
- package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
- package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
- package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
- package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
- package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
- package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
- package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
- package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
- package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
- package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
- package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
- package/package.json +5 -4
|
@@ -0,0 +1,453 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Assemble the PDD part files into the living draft (macOS / Linux).
|
|
3
|
+
#
|
|
4
|
+
# Shipped, byte-stable script. The model RUNS this file by path; it never
|
|
5
|
+
# retypes the body, so the inter-part separator below cannot be escape-doubled
|
|
6
|
+
# into a literal backslash-n. `printf '\n\n'` (single backslash) emits two real
|
|
7
|
+
# LF bytes, so every part's first-line `<!-- doc:section -->` anchor stays a
|
|
8
|
+
# standalone top-level HTML node (a literal `\n\n` would glue it inline -> the
|
|
9
|
+
# anchor degrades to escaped text and its heading drops from the TOC).
|
|
10
|
+
#
|
|
11
|
+
# Usage: assemble-pdd.sh --drafts <draftsDir> --slug <process-slug> [--current-state]
|
|
12
|
+
# draftsDir : the project drafts directory (may contain spaces, $, quotes)
|
|
13
|
+
# slug : the process slug, [a-z0-9-] only
|
|
14
|
+
# --current-state : the recording-first draft; require the current process on disk, not a future one
|
|
15
|
+
# Exit: 0 ok | 1 incomplete part set | 2 no future process on disk (current, with --current-state) | 3 stale part | 4 bad arguments
|
|
16
|
+
# | 5 hollow part set (a repeated or heading-only section body)
|
|
17
|
+
# | 7 a to-be page or a part carries literal backslash-n escape sequences
|
|
18
|
+
# | 8 no PK record, or no PDD entry in it
|
|
19
|
+
# Guard order: 1, 2, 8, 3, 5, 7 -- presence, then provenance, then staleness, then
|
|
20
|
+
# content, so the content guards judge freshly re-composed text.
|
|
21
|
+
# Stdout: `PDDPHASE:start` first, then `PDDPHASE:concat-ok` / `:promoted`, then
|
|
22
|
+
# `:cleaned` (canonical set complete) or `:parts-kept` (parts preserved). Both are success.
|
|
23
|
+
# No `PDDPHASE:` line at all means this file never ran (bad path or cwd), whatever
|
|
24
|
+
# the exit code.
|
|
25
|
+
|
|
26
|
+
# Liveness sentinel BEFORE any guard, argument parsing or work. Session ca6518d8
|
|
27
|
+
# (2026-09-10): the model's invocation never resolved this file, the shell
|
|
28
|
+
# reported exit 0 with nothing on stdout, and "ran and died before the first
|
|
29
|
+
# marker" was indistinguishable from "never ran" -- 163 retries over 2h17m.
|
|
30
|
+
echo "PDDPHASE:start"
|
|
31
|
+
# Keep `-o pipefail` outside the short-flag cluster: just-bash rejects a
|
|
32
|
+
# clustered `-o`, while this form is equivalent in bash and zsh.
|
|
33
|
+
set -eu -o pipefail
|
|
34
|
+
|
|
35
|
+
DRAFTS=
|
|
36
|
+
SLUG=
|
|
37
|
+
# The process the document must find on disk (guard below). The recording-first
|
|
38
|
+
# draft documents today's process before any future design exists, so
|
|
39
|
+
# --current-state swaps the future process for the current one.
|
|
40
|
+
SCOPE=to-be
|
|
41
|
+
MISSING="no future process on disk"
|
|
42
|
+
FIX="Write the future design per the route's Phase 2 guide (case-to-be-design.md, bpmn-to-be-design.md or to-be-design.md)"
|
|
43
|
+
while [ $# -gt 0 ]; do
|
|
44
|
+
case "$1" in
|
|
45
|
+
--drafts) DRAFTS="${2-}"; shift 2 ;;
|
|
46
|
+
--slug) SLUG="${2-}"; shift 2 ;;
|
|
47
|
+
--current-state)
|
|
48
|
+
SCOPE=as-is
|
|
49
|
+
MISSING="no current process on disk"
|
|
50
|
+
FIX="Capture the current process per as-is-capture.md"
|
|
51
|
+
shift ;;
|
|
52
|
+
*) echo "ERROR: unknown argument: $1" >&2; exit 4 ;;
|
|
53
|
+
esac
|
|
54
|
+
done
|
|
55
|
+
if [ -z "$DRAFTS" ] || [ -z "$SLUG" ]; then
|
|
56
|
+
echo "ERROR: usage: assemble-pdd.sh --drafts <draftsDir> --slug <process-slug> [--current-state]" >&2
|
|
57
|
+
exit 4
|
|
58
|
+
fi
|
|
59
|
+
|
|
60
|
+
PARTS="$DRAFTS/.$SLUG-PDD.parts"
|
|
61
|
+
TMP="$DRAFTS/.$SLUG-PDD.md.tmp"
|
|
62
|
+
DEST="$DRAFTS/$SLUG-PDD.md"
|
|
63
|
+
|
|
64
|
+
# Count section parts (NN-*.md, excluding 00-doc.md). Iterate the glob only AFTER
|
|
65
|
+
# confirming 00-doc.md exists, so an unmatched glob never fires -- portable to zsh,
|
|
66
|
+
# which errors on a no-match. No shopt/setopt and no shell arrays.
|
|
67
|
+
sections=0
|
|
68
|
+
if [ -f "$PARTS/00-doc.md" ]; then
|
|
69
|
+
for f in "$PARTS"/[0-9][0-9]-*.md; do
|
|
70
|
+
if [ "${f##*/}" != "00-doc.md" ]; then sections=$((sections + 1)); fi
|
|
71
|
+
done
|
|
72
|
+
fi
|
|
73
|
+
# Guard: require 00-doc.md AND at least one NN-*.md section part before touching TMP/DEST/PARTS.
|
|
74
|
+
if [ ! -f "$PARTS/00-doc.md" ] || [ "$sections" -lt 1 ]; then
|
|
75
|
+
echo "ERROR: incomplete part set -- 00-doc.md must exist and at least one section part (NN-*.md) must be present. Aborting without touching the draft or parts dir." >&2
|
|
76
|
+
exit 1
|
|
77
|
+
fi
|
|
78
|
+
|
|
79
|
+
# Guard: the PDD projects the wiki, so a future process that exists only in the
|
|
80
|
+
# conversation produces a document with nothing behind it. On run
|
|
81
|
+
# 2026-08-26_04-24-39 five tasks assembled a draft with no `to-be/` files at
|
|
82
|
+
# all -- four different routes, same end state -- so this is checked here rather
|
|
83
|
+
# than left to prose the model can walk past. `DraftsDir` is a sibling of the
|
|
84
|
+
# wiki, which is what makes the location derivable without a new argument.
|
|
85
|
+
WIKI="$(dirname -- "$DRAFTS")/wiki"
|
|
86
|
+
PROCESS="$WIKI/$SCOPE"
|
|
87
|
+
# No glob and no shell detection here, both deliberately. A to-be/ dir legitimately
|
|
88
|
+
# holds only ONE of the two extensions (Mermaid routes write diagram.md, the BPMN
|
|
89
|
+
# route process.bpmn) and may be empty -- and empty is exactly the state this guard
|
|
90
|
+
# exists to catch, so an unmatched pattern is expected input rather than something to
|
|
91
|
+
# rule out first. zsh has `nomatch` on by default and kills the script on one, but
|
|
92
|
+
# the obvious dodge -- `setopt no_nomatch` behind a `${ZSH_VERSION-}` probe to keep it
|
|
93
|
+
# zsh-only -- breaks just-bash instead: under `set -u` just-bash rejects an unset name
|
|
94
|
+
# in BOTH the `${VAR-}` and `${VAR:-}` form, so the probe aborts with "ZSH_VERSION:
|
|
95
|
+
# unbound variable" before the guard runs (that was 2afa6455). `find` sidesteps the
|
|
96
|
+
# glob entirely and returns the same depth-1 answer under bash, zsh and just-bash.
|
|
97
|
+
#
|
|
98
|
+
# Unwrapped on purpose: `find` on an absent to-be/ prints nothing and exits 0 here, so
|
|
99
|
+
# no `[ -d ]` test is needed -- and it must not have an `else`, because just-bash
|
|
100
|
+
# returns the CONDITION's status from an if/else whose condition is false (bash returns
|
|
101
|
+
# 0), which would exit 1 under `set -e` on exactly the missing-dir case.
|
|
102
|
+
#
|
|
103
|
+
# ponytail: a presence test, not a count, because the guard only asks "is there
|
|
104
|
+
# anything?". If a route ever needs the tally, count lines of this same output --
|
|
105
|
+
# do not reintroduce a glob.
|
|
106
|
+
found="$(find "$PROCESS" -maxdepth 1 -type f \( -name '*.md' -o -name '*.bpmn' \) 2>/dev/null || true)"
|
|
107
|
+
if [ -z "$found" ]; then
|
|
108
|
+
echo "ERROR: $MISSING -- $PROCESS holds no .md or .bpmn files, so there is nothing for the document to project. $FIX, then run this again. Aborting without touching the draft or parts dir." >&2
|
|
109
|
+
exit 2
|
|
110
|
+
fi
|
|
111
|
+
|
|
112
|
+
# Guard: the retrieval record is part of the document's provenance, not bookkeeping
|
|
113
|
+
# -- it is what lets a later session (or a reviewer) tell which facts came from a
|
|
114
|
+
# retrieval and which from the user. Runs made the calls and left no record, so the
|
|
115
|
+
# next session cannot tell either. Presence, at the fixed path, plus one token: what
|
|
116
|
+
# else belongs in the file is the guide's business, and its wording is the project's
|
|
117
|
+
# language, not this script's.
|
|
118
|
+
# Content, not size: `-s` reads the stat size, and Delegate Web's just-bash adapter
|
|
119
|
+
# reports every file as 0 bytes (see the stale-part guard below), so `-s` refused
|
|
120
|
+
# every web project. `grep -l .` reads the bytes instead, on every host. Captured
|
|
121
|
+
# into a variable and tested with `[ -z ]` -- the same shape as the future-process
|
|
122
|
+
# guard above, the one just-bash is proven to run -- rather than a negated `||`
|
|
123
|
+
# condition. A missing file prints nothing, which reads as empty.
|
|
124
|
+
pk_record="$(LC_ALL=C grep -l . "$WIKI/process-knowledge.md" 2>/dev/null || true)"
|
|
125
|
+
if [ -z "$pk_record" ]; then
|
|
126
|
+
echo "ERROR: no Process Knowledge record -- $WIKI/process-knowledge.md is missing or empty, so the document cannot say where its retrieved facts came from. Record the checkpoint for each phase that ran per SKILL.md, then run this again. Aborting without touching the draft or parts dir." >&2
|
|
127
|
+
exit 8
|
|
128
|
+
fi
|
|
129
|
+
|
|
130
|
+
# The PDD phase gate (pdd-generation.md) makes a PDD checkpoint mandatory before any
|
|
131
|
+
# part is written, and the guide spells its token: `Phase: PDD`. One run retrieved,
|
|
132
|
+
# then only bumped the record's timestamp, so the file held an initial entry and no
|
|
133
|
+
# PDD one -- and assembled anyway (onenz, 2026-09-28). "PDD" is the skill's token, not
|
|
134
|
+
# the project's language, so a record written in another language still carries it;
|
|
135
|
+
# any whole-word PDD counts, on a heading or a phase line alike.
|
|
136
|
+
pk_pdd="$(LC_ALL=C grep -ilE '(^|[^A-Za-z])pdd([^A-Za-z]|$)' "$WIKI/process-knowledge.md" 2>/dev/null || true)"
|
|
137
|
+
if [ -z "$pk_pdd" ]; then
|
|
138
|
+
echo "ERROR: no PDD checkpoint in the Process Knowledge record -- $WIKI/process-knowledge.md has no entry for the PDD phase. Run the PDD Process Knowledge checkpoint per pdd-generation.md, append a \`Phase: PDD\` entry with its result status, then run this again. Aborting without touching the draft or parts dir." >&2
|
|
139
|
+
exit 8
|
|
140
|
+
fi
|
|
141
|
+
|
|
142
|
+
# Guard: a wiki source edited AFTER the part that projects it leaves that part
|
|
143
|
+
# stale, and concat would ship a document contradicting the wiki. On session
|
|
144
|
+
# ca6518d8 (2026-09-10) a binding business correction landed mid-generation --
|
|
145
|
+
# the wiki was updated, the 16 already-written parts were not, and assembly
|
|
146
|
+
# concatenated the pre-correction text -- so this is checked here rather than
|
|
147
|
+
# left to prose the model can walk past. The link is already on disk: every
|
|
148
|
+
# part's first-line anchor declares its own `sources=`, so the guard reads only
|
|
149
|
+
# what the compose loop already wrote.
|
|
150
|
+
#
|
|
151
|
+
# A declared source that does not exist is skipped, not flagged: a P0-gap
|
|
152
|
+
# section serializes its intended path before the page is captured
|
|
153
|
+
# (pdd-template.md, "sources"). A directory source (`entities/people/`) is
|
|
154
|
+
# checked recursively -- `find` on a dir reports the dir itself (an entry added
|
|
155
|
+
# or removed) and any newer descendant, which is the same question for a file.
|
|
156
|
+
#
|
|
157
|
+
# The whole comparison is skipped where the host's stat metadata is SYNTHETIC.
|
|
158
|
+
# Delegate Web runs this script under just-bash over a RootFileSystem whose
|
|
159
|
+
# adapter answers every stat with `size: 0, mtime: new Date()`
|
|
160
|
+
# (justBashFileSystemAdapter.ts `_makeStat`), so two "mtimes" are two readings
|
|
161
|
+
# of the wall clock and `-newer` is a coin flip: measured at 19 spurious
|
|
162
|
+
# refusals in 25 runs of an 8-part fixture. Size is the deterministic tell --
|
|
163
|
+
# a part file always has bytes, so a stat layer that reports every file as 0
|
|
164
|
+
# bytes is not reporting real metadata and its mtimes cannot be trusted either.
|
|
165
|
+
# On such a host the guard is inert and re-projection rests on the skill prose,
|
|
166
|
+
# which is the pre-existing behaviour rather than a regression.
|
|
167
|
+
realstat="$(find "$PARTS" -type f -size +0c 2>/dev/null || true)"
|
|
168
|
+
if [ -n "$realstat" ]; then
|
|
169
|
+
stale=0
|
|
170
|
+
for f in "$PARTS"/[0-9][0-9]-*.md; do
|
|
171
|
+
# The anchor is the part's first line by contract. Read it by redirection so
|
|
172
|
+
# a leading-dash path cannot turn into an option, and `|| true` because
|
|
173
|
+
# `read` exits 1 on a final line with no newline, fatal under `set -e`.
|
|
174
|
+
anchor=
|
|
175
|
+
IFS= read -r anchor < "$f" || true
|
|
176
|
+
case "$anchor" in *sources=*) ;; *) continue ;; esac
|
|
177
|
+
# Drop quotes so the canonical `sources=a.md,b.md` and a quoted
|
|
178
|
+
# `sources="a.md,b.md"` parse the same; commas become spaces, then word
|
|
179
|
+
# splitting yields one token per path. The first token that is another
|
|
180
|
+
# attribute (`reproj=g0`) or the comment close ends the list.
|
|
181
|
+
#
|
|
182
|
+
# The split MUST come from a command substitution in the for-list, not from
|
|
183
|
+
# an unquoted variable: zsh does not field-split a parameter expansion (only
|
|
184
|
+
# `SH_WORD_SPLIT` turns that on), so `for s in $attrs` hands zsh the whole
|
|
185
|
+
# attribute string as ONE word and the guard silently passes everything.
|
|
186
|
+
# zsh does split `$(...)`, as do bash and POSIX sh.
|
|
187
|
+
for s in $(printf '%s' "${anchor#*sources=}" | tr -d '"' | tr ',' ' '); do
|
|
188
|
+
case "$s" in *=*|'-->') break ;; esac
|
|
189
|
+
if [ -n "$(find "$WIKI/$s" -newer "$f" 2>/dev/null || true)" ]; then
|
|
190
|
+
echo "STALEPART: ${f##*/} <- $s" >&2
|
|
191
|
+
stale=1
|
|
192
|
+
break
|
|
193
|
+
fi
|
|
194
|
+
done
|
|
195
|
+
done
|
|
196
|
+
if [ "$stale" -ne 0 ]; then
|
|
197
|
+
echo "ERROR: stale part(s) -- each STALEPART line above names a part whose wiki source changed after the part was written, so assembling would ship a document that contradicts the wiki. Re-compose those parts from the current wiki, advance each one's reproj= token, then run this again. Aborting without touching the draft or parts dir." >&2
|
|
198
|
+
exit 3
|
|
199
|
+
fi
|
|
200
|
+
fi
|
|
201
|
+
|
|
202
|
+
# Normalized part body: the part minus its headings, HTML comments (the
|
|
203
|
+
# `pdd:section` anchor included) and refine links, with all whitespace collapsed
|
|
204
|
+
# to single spaces and trimmed. This is what "same body" means to the guard
|
|
205
|
+
# below, and a template varies exactly the parts stripped here -- the anchor id,
|
|
206
|
+
# the heading, the refine link's id -- so a stamped set cannot hide behind them.
|
|
207
|
+
# LC_ALL=C keeps sed/tr byte-exact on parts that are not valid UTF-8 (the concat
|
|
208
|
+
# itself is byte-exact and must stay so).
|
|
209
|
+
#
|
|
210
|
+
# A function, not the pipeline inlined twice: the refusal path re-normalizes to
|
|
211
|
+
# name which parts carry the duplicated body, and two copies of the sed would
|
|
212
|
+
# drift. POSIX function syntax, no `function` keyword.
|
|
213
|
+
#
|
|
214
|
+
# `delegate:` links are deliberately NOT stripped. Only the `[Refine section]`
|
|
215
|
+
# boilerplate is, because that is the only link the template stamps into every
|
|
216
|
+
# section. An `[Open TO-BE diagram](delegate:open-diagram?...)` link is required
|
|
217
|
+
# section CONTENT (pdd-generation.md item 2, pdd-template.md Appendix A), so
|
|
218
|
+
# stripping it read an Appendix A of heading-plus-two-links as holding nothing.
|
|
219
|
+
#
|
|
220
|
+
# Whitespace handling is byte-oriented and must stay identical in the .ps1 twin:
|
|
221
|
+
# ' \t\r\n' collapses, and nothing else does. `\r` is in the set so a CRLF part
|
|
222
|
+
# normalizes the same as its LF twin -- without it the shell kept the `\r` and
|
|
223
|
+
# PowerShell's `\s+` dropped it, so the same file was hollow on one platform and
|
|
224
|
+
# not the other. A leading UTF-8 BOM is stripped for the same reason: just-bash's
|
|
225
|
+
# VFS removes it on read, so `^#` matched the heading there and not on host bash.
|
|
226
|
+
# The twin must NOT use `\s+`, which also swallows NBSP and U+2028.
|
|
227
|
+
part_body() {
|
|
228
|
+
LC_ALL=C sed \
|
|
229
|
+
-e "1s/^$(printf '\357\273\277')//" \
|
|
230
|
+
-e '/^#\{1,6\} /d' \
|
|
231
|
+
-e 's/<!--[^>]*-->//g' \
|
|
232
|
+
-e 's/\[Refine section\]([^)]*)//g' \
|
|
233
|
+
"$1" | LC_ALL=C tr -s ' \t\r\n' ' ' | LC_ALL=C sed -e 's/^ *//' -e 's/ *$//'
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
# Guard: a part set whose sections repeat one body is a template, not a document.
|
|
237
|
+
# Each section is composed from its own sources, so when the same normalized body
|
|
238
|
+
# appears in two or more parts, or a part holds nothing beyond its heading,
|
|
239
|
+
# nothing was composed -- assembling it ships an empty shell the host cannot tell
|
|
240
|
+
# from a real draft. One observed run passed every structural gate with 13
|
|
241
|
+
# sections carrying an identical placeholder sentence. Exit 5 is a repair signal:
|
|
242
|
+
# compose the named parts.
|
|
243
|
+
#
|
|
244
|
+
# Runs AFTER the two presence guards on purpose: a missing part set still reports
|
|
245
|
+
# 1 and a missing future process still reports 2, so the cheapest repair is
|
|
246
|
+
# always the one named. It also runs after the exit-8 record check and the
|
|
247
|
+
# exit-3 stale-part guard: a stale part is re-composed before its body is judged,
|
|
248
|
+
# so this checks the text that will actually ship. `00-doc.md` is exempt -- it is the doc marker, and has
|
|
249
|
+
# neither a heading nor a body to compose.
|
|
250
|
+
#
|
|
251
|
+
# Safe to glob: the exit-1 guard already proved 00-doc.md exists and at least one
|
|
252
|
+
# NN-*.md section part is present, so zsh's `nomatch` cannot fire. No arrays, no
|
|
253
|
+
# temp files, and nothing written before the refusal.
|
|
254
|
+
#
|
|
255
|
+
# A part carrying the mandated "Needs capture" callout is exempt from BOTH halves.
|
|
256
|
+
# pdd-generation.md item 1 ORDERS that callout for compliance / kpis / raci when
|
|
257
|
+
# the wiki source is absent or unreadable, and item 4 makes it a MANDATORY gate --
|
|
258
|
+
# so three such sections legitimately carry near-identical bodies, and the repair
|
|
259
|
+
# this guard names ("compose from its own wiki sources") is impossible, because the
|
|
260
|
+
# absent source is the whole reason the callout exists. Keyed off the literal the
|
|
261
|
+
# guide mandates, not a paraphrase of it.
|
|
262
|
+
bodies=""
|
|
263
|
+
hollow=""
|
|
264
|
+
for f in "$PARTS"/[0-9][0-9]-*.md; do
|
|
265
|
+
if [ "${f##*/}" != "00-doc.md" ] && ! LC_ALL=C grep -qF 'Needs capture' "$f"; then
|
|
266
|
+
body="$(part_body "$f")"
|
|
267
|
+
if [ -z "$body" ]; then hollow="$hollow ${f##*/}"; fi
|
|
268
|
+
bodies="$(printf '%s\n%s' "$bodies" "$body")"
|
|
269
|
+
fi
|
|
270
|
+
done
|
|
271
|
+
# One body per line (a normalized body holds no newline, so a line is a whole
|
|
272
|
+
# body); `sort | uniq -d` reports the repeated one. Only the first is named: one
|
|
273
|
+
# stamped body is already the whole finding.
|
|
274
|
+
#
|
|
275
|
+
# `|| true` is load-bearing under `-o pipefail`: `head -1` closes the pipe after
|
|
276
|
+
# one line, so a set with TWO stamped bodies big enough to overflow the pipe
|
|
277
|
+
# buffer leaves `uniq` killed by SIGPIPE, and `set -e` then aborts on the
|
|
278
|
+
# assignment itself. Verified: four parts in two duplicate groups of ~1.4 MB
|
|
279
|
+
# exit 141 with no message at all without it, and exit 5 naming the parts with
|
|
280
|
+
# it. Oversized parts are a supported shape (pdd-generation.md item 6 chunks a
|
|
281
|
+
# section past ~50 KB), so this is reachable. Fail-open on a broken toolchain,
|
|
282
|
+
# like the `find` above.
|
|
283
|
+
dups="$(printf '%s\n' "$bodies" | LC_ALL=C sed -e '/^ *$/d' | LC_ALL=C sort | LC_ALL=C uniq -d | head -1 || true)"
|
|
284
|
+
if [ -n "$hollow" ] || [ -n "$dups" ]; then
|
|
285
|
+
if [ -n "$hollow" ]; then
|
|
286
|
+
echo "ERROR: hollow part set -- these parts hold nothing beyond their heading:$hollow." >&2
|
|
287
|
+
fi
|
|
288
|
+
if [ -n "$dups" ]; then
|
|
289
|
+
stamped=""
|
|
290
|
+
for f in "$PARTS"/[0-9][0-9]-*.md; do
|
|
291
|
+
if [ "${f##*/}" != "00-doc.md" ] && ! LC_ALL=C grep -qF 'Needs capture' "$f" \
|
|
292
|
+
&& [ "$(part_body "$f")" = "$dups" ]; then
|
|
293
|
+
stamped="$stamped ${f##*/}"
|
|
294
|
+
fi
|
|
295
|
+
done
|
|
296
|
+
echo "ERROR: hollow part set -- these parts share one identical body (a template stamped across sections):$stamped." >&2
|
|
297
|
+
fi
|
|
298
|
+
echo "Each section must be composed from its own wiki sources before assembly. Aborting without touching the draft or parts dir." >&2
|
|
299
|
+
exit 5
|
|
300
|
+
fi
|
|
301
|
+
|
|
302
|
+
# Guard: a page or part carrying the two-character sequence backslash-n was
|
|
303
|
+
# emitted through a string escape -- a printf format, a heredoc variable, a
|
|
304
|
+
# write_text string -- rather than composed and written as a file. Its tables
|
|
305
|
+
# render as one line, so the section reaches the reader as a single run-on row.
|
|
306
|
+
# Three drafts shipped this way in one run (81, 58 and 225 occurrences) and each
|
|
307
|
+
# was a blocking defect. `grep -cF` matches the two characters literally, never as
|
|
308
|
+
# a regex, which is what keeps this route-agnostic: no language dependency and no
|
|
309
|
+
# knowledge of which pages the route owes.
|
|
310
|
+
#
|
|
311
|
+
# It fires on a COUNT, not on presence, because the sequence has legitimate uses:
|
|
312
|
+
# a business rule reading "reject payloads where \n appears literally", a glossary
|
|
313
|
+
# row defining it, a regex in a rule, a `json` fence carrying an escaped string --
|
|
314
|
+
# all sanctioned content, and all refused by a presence test whose repair message
|
|
315
|
+
# ("rewrite with real newlines") is impossible when the two characters ARE the
|
|
316
|
+
# content. The three observed defects held 81, 58 and 225 occurrences in one file;
|
|
317
|
+
# a legitimate mention is one or two. ESC_MAX sits at 3: above any real mention,
|
|
318
|
+
# two orders of magnitude below every observed defect. Exit 7 names the count so
|
|
319
|
+
# the repair is checkable.
|
|
320
|
+
#
|
|
321
|
+
# Counts OCCURRENCES, not matching lines: `grep -c` would return 1 for a whole
|
|
322
|
+
# escaped table, because collapsing to a single line is exactly the defect. So
|
|
323
|
+
# `grep -oF | grep -c .`, which is also what the .ps1 twin's Split() does.
|
|
324
|
+
#
|
|
325
|
+
# The file list is expanded into the positional parameters BEFORE the loop, not
|
|
326
|
+
# piped into a `while read`. Two wrong shapes were measured getting here: a
|
|
327
|
+
# `while read` whose body counts occurrences lets just-bash's command
|
|
328
|
+
# substitution consume the rest of the loop's stdin, so only the FIRST offending
|
|
329
|
+
# page was ever reported (bash and zsh report all of them); and reading on fd 3
|
|
330
|
+
# to dodge that fails outright in just-bash with "3: Bad file descriptor". The
|
|
331
|
+
# `-n` and `-f` tests are required because an absent or empty to-be/ makes `find`
|
|
332
|
+
# print nothing, which splits to a single empty parameter.
|
|
333
|
+
# to-be/ in both modes: --current-state changes only the process exit 2 requires.
|
|
334
|
+
TOBE="$WIKI/to-be"
|
|
335
|
+
ESC_MAX=3
|
|
336
|
+
esc=""
|
|
337
|
+
ESC_OLDIFS="$IFS"
|
|
338
|
+
IFS='
|
|
339
|
+
'
|
|
340
|
+
# The substitution runs HERE, outside any loop, so nothing can eat the loop's
|
|
341
|
+
# stdin. IFS is newline-only for the split, which keeps a filename containing
|
|
342
|
+
# spaces or `$` in one piece; `set --` then gives positional parameters, which
|
|
343
|
+
# word-split identically in bash, zsh and just-bash (see the canonical-id list
|
|
344
|
+
# below for the same construct and the same reason).
|
|
345
|
+
set -- $(find "$TOBE" -type f -name '*.md' 2>/dev/null | LC_ALL=C sort || true)
|
|
346
|
+
IFS="$ESC_OLDIFS"
|
|
347
|
+
for p do
|
|
348
|
+
if [ -n "$p" ] && [ -f "$p" ]; then
|
|
349
|
+
n="$(LC_ALL=C grep -oF '\n' "$p" | LC_ALL=C grep -c . || true)"
|
|
350
|
+
if [ "${n:-0}" -ge "$ESC_MAX" ]; then esc="$esc to-be/${p#"$TOBE"/}($n)"; fi
|
|
351
|
+
fi
|
|
352
|
+
done
|
|
353
|
+
# 00-doc.md is checked here (unlike the body guard above): an escaped doc marker
|
|
354
|
+
# breaks the cover and TOC the host synthesizes from it.
|
|
355
|
+
for f in "$PARTS"/[0-9][0-9]-*.md; do
|
|
356
|
+
n="$(LC_ALL=C grep -oF '\n' "$f" | LC_ALL=C grep -c . || true)"
|
|
357
|
+
if [ "${n:-0}" -ge "$ESC_MAX" ]; then esc="$esc .parts/${f##*/}($n)"; fi
|
|
358
|
+
done
|
|
359
|
+
if [ -n "$esc" ]; then
|
|
360
|
+
echo "ERROR: literal backslash-n escape sequences (file(count), threshold $ESC_MAX) in:$esc -- the file was emitted through a string escape, so its tables render as one line. Rewrite each named page with WriteFile and real newlines rather than a printf, heredoc or write_text escape, then run this again. A rule or glossary entry that genuinely quotes the sequence once or twice is below this threshold and never reported. Aborting without touching the draft or parts dir." >&2
|
|
361
|
+
exit 7
|
|
362
|
+
fi
|
|
363
|
+
|
|
364
|
+
: > "$TMP"
|
|
365
|
+
# Blank line between parts (printf '\n\n' = two real LF bytes) so each part's
|
|
366
|
+
# first-line anchor is its own top-level HTML node. Pure byte insert; each
|
|
367
|
+
# part's own bytes stay exact. The glob is already name-sorted, so 00-doc.md
|
|
368
|
+
# leads, then 01-, 02- ...
|
|
369
|
+
first=1
|
|
370
|
+
for f in "$PARTS"/[0-9][0-9]-*.md; do
|
|
371
|
+
if [ "$first" -ne 1 ]; then printf '\n\n' >> "$TMP"; fi
|
|
372
|
+
cat "$f" >> "$TMP"
|
|
373
|
+
first=0
|
|
374
|
+
done
|
|
375
|
+
echo "PDDPHASE:concat-ok"
|
|
376
|
+
|
|
377
|
+
# Record the promotion beside the draft. The draft itself stays byte-exact -- that
|
|
378
|
+
# is a guarantee this script already makes and must keep -- so the receipt is its own
|
|
379
|
+
# dot-prefixed file, named like the parts dir and ignored by the same flat scan. It
|
|
380
|
+
# matters because a draft composed from parts and one written whole are otherwise
|
|
381
|
+
# identical: same doc marker, same section anchors, same refine links. This file is
|
|
382
|
+
# written here, from the parts actually promoted, and an author does not produce it
|
|
383
|
+
# because it is not authored. Part ids only, no prose, so it is the same in any
|
|
384
|
+
# project language.
|
|
385
|
+
ids=""
|
|
386
|
+
for f in "$PARTS"/[0-9][0-9]-*.md; do
|
|
387
|
+
b="${f##*/}"; b="${b%.md}"; ids="$ids ${b#*-}"
|
|
388
|
+
done
|
|
389
|
+
mv -f -- "$TMP" "$DEST"
|
|
390
|
+
# The receipt vouches for the draft now on disk, so it is written only after the
|
|
391
|
+
# promotion succeeded: a failed `mv` exits here under `set -e` and leaves the
|
|
392
|
+
# previous receipt untouched.
|
|
393
|
+
# ponytail: a direct write, not a staged .tmp + rename -- Delegate Web's persistent
|
|
394
|
+
# mount refuses to rename that file ("Operation not permitted on this mount"), and
|
|
395
|
+
# the receipt is one short line. If a torn receipt ever matters, stage it on a
|
|
396
|
+
# path the mount allows to be renamed, as the draft's own .tmp is.
|
|
397
|
+
printf 'parts=%s\n' "${ids# }" > "$DRAFTS/.$SLUG-PDD.assembled"
|
|
398
|
+
echo "PDDPHASE:promoted"
|
|
399
|
+
|
|
400
|
+
# Progressive assembly. The draft is promoted on EVERY run; the parts dir is
|
|
401
|
+
# removed only by the run that completes the canonical section set. Cleanup used
|
|
402
|
+
# to be unconditional, so a turn that ended after composing some sections
|
|
403
|
+
# promoted a partial draft and then deleted every finished part -- the next turn
|
|
404
|
+
# had to recompose from nothing. Run 13286573 left two tasks each holding
|
|
405
|
+
# finished parts and no usable document.
|
|
406
|
+
#
|
|
407
|
+
# The id list is the anchored section order in pdd-template.md's "Section slug
|
|
408
|
+
# reference". It is written ONCE, as the positional parameters below -- holding it
|
|
409
|
+
# in a variable as well would put the same list in two places, which is the drift
|
|
410
|
+
# this comment used to warn about.
|
|
411
|
+
#
|
|
412
|
+
# ponytail: a membership scan over one string, not an associative array or a
|
|
413
|
+
# sorted-diff, because the set is 15 fixed ids checked once per run. If the list
|
|
414
|
+
# ever grows past a screenful, move it to a shipped reference file and read it
|
|
415
|
+
# here -- do not reach for arrays, which just-bash cannot execute.
|
|
416
|
+
|
|
417
|
+
# Safe to glob: 00-doc.md was confirmed above and sections >= 1, so this pattern
|
|
418
|
+
# has at least one match and zsh's `nomatch` cannot fire.
|
|
419
|
+
ids_seen=""
|
|
420
|
+
for f in "$PARTS"/[0-9][0-9]-*.md; do
|
|
421
|
+
base="${f##*/}"
|
|
422
|
+
if [ "$base" != "00-doc.md" ]; then
|
|
423
|
+
id="${base#[0-9][0-9]-}"
|
|
424
|
+
ids_seen="$ids_seen ${id%.md}"
|
|
425
|
+
fi
|
|
426
|
+
done
|
|
427
|
+
|
|
428
|
+
missing=""
|
|
429
|
+
# `set --` with the ids as separate literal tokens, NOT `for sid in $some_string`:
|
|
430
|
+
# zsh does not word-split an unquoted parameter expansion, so that form saw one
|
|
431
|
+
# blob, `missing` was always 15, and the parts dir was never cleaned under zsh
|
|
432
|
+
# even when the set WAS complete. Positional parameters split identically in
|
|
433
|
+
# bash, zsh and just-bash.
|
|
434
|
+
set -- business-context scope current-state target-state business-rules \
|
|
435
|
+
data-model people raci exceptions compliance kpis assumptions-risks \
|
|
436
|
+
glossary next-steps appendix-a
|
|
437
|
+
for sid do
|
|
438
|
+
case " $ids_seen " in
|
|
439
|
+
*" $sid "*) ;;
|
|
440
|
+
*) missing="$missing $sid" ;;
|
|
441
|
+
esac
|
|
442
|
+
done
|
|
443
|
+
|
|
444
|
+
if [ -z "$missing" ]; then
|
|
445
|
+
rm -rf -- "$PARTS"
|
|
446
|
+
echo "PDDPHASE:cleaned"
|
|
447
|
+
else
|
|
448
|
+
# Not an error: the draft on disk is real and readable, and the surviving
|
|
449
|
+
# parts are what make the next run cheap. Name what is still missing so the
|
|
450
|
+
# next turn writes only that.
|
|
451
|
+
echo "PDDPHASE:parts-kept missing=$(printf '%s' "$missing" | wc -w | tr -d ' ')"
|
|
452
|
+
echo "PDDPHASE:parts-kept ids=$(printf '%s' "${missing# }")"
|
|
453
|
+
fi
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# Phase readiness check for the business-analysis skill (Windows).
|
|
2
|
+
# Parity with check-phase-ready.sh, which carries the rationale and the runs
|
|
3
|
+
# this came from. Same exit codes, same sentinels, same required page sets:
|
|
4
|
+
# 0 ready | 1 not ready | 4 bad arguments.
|
|
5
|
+
[CmdletBinding()]
|
|
6
|
+
param(
|
|
7
|
+
[Parameter(Mandatory = $true)][string]$Wiki,
|
|
8
|
+
[Parameter(Mandatory = $true)][string]$Phase,
|
|
9
|
+
[Parameter(Mandatory = $true)][string]$Route
|
|
10
|
+
)
|
|
11
|
+
$ErrorActionPreference = 'Stop'
|
|
12
|
+
|
|
13
|
+
if ($Phase -notin @('as-is', 'to-be')) {
|
|
14
|
+
Write-Error -ErrorAction Continue "ERROR: --phase must be as-is or to-be (got: $Phase)"
|
|
15
|
+
exit 4
|
|
16
|
+
}
|
|
17
|
+
if ($Route -notin @('case', 'bpmn', 'rpa')) {
|
|
18
|
+
Write-Error -ErrorAction Continue "ERROR: --route must be case, bpmn or rpa (got: $Route)"
|
|
19
|
+
exit 4
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
# Fail-open on an unresolvable wiki -- parity with the shell twin. Never silent.
|
|
23
|
+
if (-not (Test-Path -LiteralPath $Wiki -PathType Container)) {
|
|
24
|
+
Write-Output "PHASEREADY:skipped wiki not found at $Wiki -- check did not run"
|
|
25
|
+
exit 0
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
$missing = @()
|
|
29
|
+
|
|
30
|
+
function Test-NonEmptyFile {
|
|
31
|
+
param([string]$Relative)
|
|
32
|
+
$p = Join-Path $Wiki $Relative
|
|
33
|
+
# Non-empty, not merely present: a page created empty is the failure this exists to catch.
|
|
34
|
+
if (-not (Test-Path -LiteralPath $p -PathType Leaf) -or (Get-Item -LiteralPath $p).Length -eq 0) {
|
|
35
|
+
$script:missing += $Relative
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
function Test-DirHasMarkdown {
|
|
39
|
+
param([string]$Relative)
|
|
40
|
+
$p = Join-Path $Wiki $Relative
|
|
41
|
+
$hit = $null
|
|
42
|
+
if (Test-Path -LiteralPath $p -PathType Container) {
|
|
43
|
+
$hit = Get-ChildItem -LiteralPath $p -File -Filter '*.md' -ErrorAction SilentlyContinue | Select-Object -First 1
|
|
44
|
+
}
|
|
45
|
+
if (-not $hit) { $script:missing += "$Relative(no .md pages)" }
|
|
46
|
+
}
|
|
47
|
+
if ($Phase -eq 'as-is') {
|
|
48
|
+
Test-NonEmptyFile 'as-is/overview.md'
|
|
49
|
+
# Deliberately NOT requiring as-is/diagram.md -- the legacy overview.md map
|
|
50
|
+
# fallback is still supported, and a gate refusing it fired on correct docs.
|
|
51
|
+
# No column checks here, in any language -- see the sh twin: a wiki page's table
|
|
52
|
+
# headers follow the engagement language, so a header match refuses non-English work.
|
|
53
|
+
}
|
|
54
|
+
else {
|
|
55
|
+
Test-NonEmptyFile 'to-be/overview.md'
|
|
56
|
+
switch ($Route) {
|
|
57
|
+
'case' { Test-NonEmptyFile 'to-be/diagram.md'; Test-DirHasMarkdown 'to-be/stages' }
|
|
58
|
+
'bpmn' { Test-NonEmptyFile 'to-be/process.bpmn' }
|
|
59
|
+
'rpa' { Test-NonEmptyFile 'to-be/diagram.md' }
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
if ($missing.Count -gt 0) {
|
|
64
|
+
if ($missing.Count -gt 0) {
|
|
65
|
+
Write-Error -ErrorAction Continue "PHASEREADY:not-ready phase=$Phase route=$Route missing pages: $($missing -join ' ')"
|
|
66
|
+
}
|
|
67
|
+
Write-Error -ErrorAction Continue 'Write the named pages from the facts you have confirmed, then run this again. Do not present the review while this reports not-ready -- a review given with the pages unwritten has closed nothing.'
|
|
68
|
+
exit 1
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
Write-Output "PHASEREADY:ok phase=$Phase route=$Route"
|
|
72
|
+
exit 0
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Phase readiness check for the business-analysis skill (macOS / Linux).
|
|
3
|
+
#
|
|
4
|
+
# A phase closes on its own OUTPUT, not on its argument. Run this as the last
|
|
5
|
+
# silent step of a phase's closing sequence, before the review stop: a non-zero
|
|
6
|
+
# exit lists what is still missing, and the stop is not presented until it
|
|
7
|
+
# passes. Prose said this already and did not bind -- on
|
|
8
|
+
# `pdd-interview-commercial-loan-origination`, 4 of 5 blocked runs presented a
|
|
9
|
+
# Future Process Review with `to-be/` empty, and the manifest that would have
|
|
10
|
+
# caught it lives one phase later in pdd-generation.md's readiness gate. That
|
|
11
|
+
# lateness is itself the backwards-repair loop.
|
|
12
|
+
#
|
|
13
|
+
# Read-only: it lists and greps, never writes. There is deliberately no repair
|
|
14
|
+
# the agent can perform by DELETING design, which is how the branch's arm-level
|
|
15
|
+
# checks were escaped.
|
|
16
|
+
#
|
|
17
|
+
# Usage: check-phase-ready.sh --wiki <wikiDir> --phase <as-is|to-be> --route <case|bpmn|rpa>
|
|
18
|
+
# Exit: 0 ready | 1 not ready (missing pages or columns) | 4 bad arguments
|
|
19
|
+
#
|
|
20
|
+
# Scope is deliberately the pages whose absence was OBSERVED failing, not each
|
|
21
|
+
# route's full declared page set. The guides declare 9-14 pages per route and
|
|
22
|
+
# several are conditional ("only when exceptions differ from AS-IS"), so
|
|
23
|
+
# requiring the declared set would refuse correct work. Anything beyond the
|
|
24
|
+
# observed failures needs its own calibration before it goes in here.
|
|
25
|
+
set -eu -o pipefail
|
|
26
|
+
|
|
27
|
+
WIKI=
|
|
28
|
+
PHASE=
|
|
29
|
+
ROUTE=
|
|
30
|
+
while [ $# -gt 0 ]; do
|
|
31
|
+
case "$1" in
|
|
32
|
+
--wiki) WIKI="${2-}"; shift 2 ;;
|
|
33
|
+
--phase) PHASE="${2-}"; shift 2 ;;
|
|
34
|
+
--route) ROUTE="${2-}"; shift 2 ;;
|
|
35
|
+
*) echo "ERROR: unknown argument: $1" >&2; exit 4 ;;
|
|
36
|
+
esac
|
|
37
|
+
done
|
|
38
|
+
if [ -z "$WIKI" ] || [ -z "$PHASE" ] || [ -z "$ROUTE" ]; then
|
|
39
|
+
echo "ERROR: usage: check-phase-ready.sh --wiki <wikiDir> --phase <as-is|to-be> --route <case|bpmn|rpa>" >&2
|
|
40
|
+
exit 4
|
|
41
|
+
fi
|
|
42
|
+
case "$PHASE" in as-is|to-be) ;; *) echo "ERROR: --phase must be as-is or to-be (got: $PHASE)" >&2; exit 4 ;; esac
|
|
43
|
+
case "$ROUTE" in case|bpmn|rpa) ;; *) echo "ERROR: --route must be case, bpmn or rpa (got: $ROUTE)" >&2; exit 4 ;; esac
|
|
44
|
+
|
|
45
|
+
# Fail-open on an unresolvable wiki, like assemble-pdd.sh's `find`: a wrong
|
|
46
|
+
# refusal here would block every project, and the phase guides already name the
|
|
47
|
+
# pages. Never silent -- the agent needs to know the check did not run.
|
|
48
|
+
if [ ! -d "$WIKI" ]; then
|
|
49
|
+
echo "PHASEREADY:skipped wiki not found at $WIKI -- check did not run"
|
|
50
|
+
exit 0
|
|
51
|
+
fi
|
|
52
|
+
|
|
53
|
+
missing=""
|
|
54
|
+
# `-s` not `-e`: a page created empty is the failure this exists to catch.
|
|
55
|
+
# Content, not `-s`: the stat size is 0 for every file under Delegate Web's
|
|
56
|
+
# just-bash adapter, so a size test reads every page as empty there. The output
|
|
57
|
+
# is captured, then tested with a plain `if`: inside a function, just-bash under
|
|
58
|
+
# `set -e` exits silently when the left side of `a || b` fails (measured), so no
|
|
59
|
+
# helper here uses `||`. A missing file prints nothing and reads as empty.
|
|
60
|
+
need_file() {
|
|
61
|
+
hit="$(LC_ALL=C grep -l . "$WIKI/$1" 2>/dev/null || true)"
|
|
62
|
+
if [ -z "$hit" ]; then missing="$missing $1"; fi
|
|
63
|
+
}
|
|
64
|
+
# At least one .md in a directory. `find` rather than a glob: an absent dir must
|
|
65
|
+
# read as a miss, not kill the script under zsh's nomatch.
|
|
66
|
+
need_dir_md() {
|
|
67
|
+
hit="$(find "$WIKI/$1" -maxdepth 1 -type f -name '*.md' 2>/dev/null | head -1 || true)"
|
|
68
|
+
if [ -z "$hit" ]; then missing="$missing $1(no .md pages)"; fi
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
if [ "$PHASE" = "as-is" ]; then
|
|
72
|
+
need_file "as-is/overview.md"
|
|
73
|
+
# Deliberately NOT requiring as-is/diagram.md: diagram-authoring.md keeps a
|
|
74
|
+
# legacy fallback for projects whose map still lives in overview.md, and a
|
|
75
|
+
# gate that refuses those was measured firing on correct documents.
|
|
76
|
+
else
|
|
77
|
+
need_file "to-be/overview.md"
|
|
78
|
+
case "$ROUTE" in
|
|
79
|
+
case) need_file "to-be/diagram.md"; need_dir_md "to-be/stages" ;;
|
|
80
|
+
bpmn) need_file "to-be/process.bpmn" ;;
|
|
81
|
+
rpa) need_file "to-be/diagram.md" ;;
|
|
82
|
+
esac
|
|
83
|
+
fi
|
|
84
|
+
|
|
85
|
+
# No column checks here, in any language. A wiki page follows the engagement
|
|
86
|
+
# language (SKILL.md: "wiki pages, diagram labels, the PDD and the SDD all follow
|
|
87
|
+
# it"), so its table headers are translated with everything else -- a header match
|
|
88
|
+
# is a check that passes in English and refuses every other project. The guides
|
|
89
|
+
# state the column contracts; whether a cell is filled well is a judgement, and
|
|
90
|
+
# whether the header is spelled the English way is not a defect at all.
|
|
91
|
+
if [ -n "$missing" ]; then
|
|
92
|
+
echo "PHASEREADY:not-ready phase=$PHASE route=$ROUTE missing pages:$missing" >&2
|
|
93
|
+
echo "Write the named pages from the facts you have confirmed, then run this again. Do not present the review while this reports not-ready -- a review given with the pages unwritten has closed nothing." >&2
|
|
94
|
+
exit 1
|
|
95
|
+
fi
|
|
96
|
+
|
|
97
|
+
echo "PHASEREADY:ok phase=$PHASE route=$ROUTE"
|
|
98
|
+
exit 0
|