From 65e2838aa9bdd0ffed9d9ed7d66b4daefb4ccd41 Mon Sep 17 00:00:00 2001 From: break Date: Fri, 7 Aug 2026 11:59:42 +0800 Subject: [PATCH 1/4] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E5=AE=A1=E8=AE=A1?= =?UTF-8?q?=E5=85=B3=E8=81=94=E8=B5=84=E6=BA=90=E4=B8=BB=E4=BD=93=E6=8A=95?= =?UTF-8?q?=E5=BD=B1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- internal/infrastructure/audit/writer.go | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/internal/infrastructure/audit/writer.go b/internal/infrastructure/audit/writer.go index 5489e10..ad8b71c 100644 --- a/internal/infrastructure/audit/writer.go +++ b/internal/infrastructure/audit/writer.go @@ -1025,7 +1025,10 @@ func (w *Writer) buildResources(inputs []ResourceInput, action ActionDefinition) } visibility := input.SubjectVisibility if visibility == "" { - visibility = action.DefaultVisibility + visibility = constants.AuditSubjectInternalOnly + if input.Relation == constants.AuditResourceRelationPrimary { + visibility = action.DefaultVisibility + } } subjectDataInput, err := validateSubjectProjection(input, action, visibility) if err != nil { From f45b296b70d4f7cea4046b4699a0aad7fe6d3f99 Mon Sep 17 00:00:00 2001 From: break Date: Fri, 7 Aug 2026 15:13:41 +0800 Subject: [PATCH 2/4] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E5=8D=A1=E5=A5=97?= =?UTF-8?q?=E9=A4=90=E8=B0=83=E6=95=B4=E5=AE=A1=E8=AE=A1=E8=B5=84=E4=BA=A7?= =?UTF-8?q?=E7=B1=BB=E5=9E=8B=E9=94=99=E8=AF=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- internal/service/asset/manual_adjustment_audit.go | 1 + 1 file changed, 1 insertion(+) diff --git a/internal/service/asset/manual_adjustment_audit.go b/internal/service/asset/manual_adjustment_audit.go index 9203c5c..55a2fa2 100644 --- a/internal/service/asset/manual_adjustment_audit.go +++ b/internal/service/asset/manual_adjustment_audit.go @@ -30,6 +30,7 @@ func (s *Service) appendPackageAdjustmentAudit( } usageID := strconv.FormatUint(uint64(usage.ID), 10) assetResourceID := strconv.FormatUint(uint64(assetID), 10) + assetType = assetAuditSvc.NormalizeAssetType(assetType) var resourceType string switch assetType { case constants.AssetTypeIotCard: From 6611ca52265fa5a7d1ac7fd1dc841decd47fcf8e Mon Sep 17 00:00:00 2001 From: break Date: Fri, 7 Aug 2026 16:14:38 +0800 Subject: [PATCH 3/4] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E8=A1=8C=E4=B8=9A?= =?UTF-8?q?=E5=8D=A1=E6=89=8B=E5=8A=A8=E5=81=9C=E5=A4=8D=E6=9C=BA=E5=AE=9E?= =?UTF-8?q?=E5=90=8D=E6=A0=A1=E9=AA=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- internal/service/iot_card/stop_resume_service.go | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/internal/service/iot_card/stop_resume_service.go b/internal/service/iot_card/stop_resume_service.go index 38ce086..3af1062 100644 --- a/internal/service/iot_card/stop_resume_service.go +++ b/internal/service/iot_card/stop_resume_service.go @@ -762,7 +762,7 @@ func (s *StopResumeService) ManualStopCard(ctx context.Context, iccid string) er } actionCode, summary := stopAuditAction(ctx, constants.StopReasonManual) - if card.RealNameStatus != constants.RealNameStatusVerified { + if !s.isRealnameOK(card) { denyErr := errors.New(errors.CodeForbidden, "卡未实名，无法操作") s.recordCardCommandAudit(ctx, card, actionCode, summary+"被拒绝", constants.AuditResultDenied, "", cardSnapshot(card), nil, denyErr) return denyErr @@ -814,7 +814,7 @@ func (s *StopResumeService) ManualStartCard(ctx context.Context, iccid string) e return denyErr } - if card.RealNameStatus != constants.RealNameStatusVerified { + if !s.isRealnameOK(card) { denyErr := errors.New(errors.CodeForbidden, "卡未实名，无法操作") s.recordCardCommandAudit(ctx, card, actionCode, summary+"被拒绝", constants.AuditResultDenied, "", cardSnapshot(card), nil, denyErr) return denyErr From 79e2d9ff929d39fc1984c0c6783e22c8b609e8ac Mon Sep 17 00:00:00 2001 From: break Date: Fri, 7 Aug 2026 16:18:07 +0800 Subject: [PATCH 4/4] =?UTF-8?q?=E9=87=8D=E7=BD=AE=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E4=B8=8A=E4=B8=8B=E6=96=87=E4=B8=8E=E8=A7=84=E8=8C=83=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/rules/ponytail.md | 30 - .agents/skills/ask-matt/SKILL.md | 78 - .agents/skills/ask-matt/agents/openai.yaml | 5 - .agents/skills/caveman/SKILL.md | 49 - .agents/skills/code-review/SKILL.md | 89 - .agents/skills/code-review/agents/openai.yaml | 3 - .agents/skills/codebase-design/DEEPENING.md | 37 - .../skills/codebase-design/DESIGN-IT-TWICE.md | 44 - .agents/skills/codebase-design/SKILL.md | 114 - .../skills/codebase-design/agents/openai.yaml | 3 - .agents/skills/diagnose/SKILL.md | 117 - .../diagnose/scripts/hitl-loop.template.sh | 41 - .agents/skills/diagnosing-bugs/SKILL.md | 134 - .../skills/diagnosing-bugs/agents/openai.yaml | 3 - .../scripts/hitl-loop.template.sh | 41 - .agents/skills/domain-modeling/ADR-FORMAT.md | 47 - .../skills/domain-modeling/CONTEXT-FORMAT.md | 60 - .agents/skills/domain-modeling/SKILL.md | 74 - .../skills/domain-modeling/agents/openai.yaml | 3 - .agents/skills/grill-me/SKILL.md | 7 - .agents/skills/grill-me/agents/openai.yaml | 5 - .agents/skills/grill-with-docs/SKILL.md | 7 - .../skills/grill-with-docs/agents/openai.yaml | 5 - .agents/skills/grilling/SKILL.md | 12 - .agents/skills/grilling/agents/openai.yaml | 3 - .agents/skills/handoff/SKILL.md | 16 - .agents/skills/handoff/agents/openai.yaml | 5 - .agents/skills/implement/SKILL.md | 15 - .agents/skills/implement/agents/openai.yaml | 5 - .../HTML-REPORT.md | 123 - .../improve-codebase-architecture/SKILL.md | 71 - .../agents/openai.yaml | 5 - .agents/skills/prototype/LOGIC.md | 79 - .agents/skills/prototype/SKILL.md | 26 - .agents/skills/prototype/UI.md | 112 - .agents/skills/prototype/agents/openai.yaml | 3 - .agents/skills/research/SKILL.md | 12 - .agents/skills/research/agents/openai.yaml | 3 - .../skills/resolving-merge-conflicts/SKILL.md | 14 - .../agents/openai.yaml | 3 - .../skills/setup-matt-pocock-skills/SKILL.md | 116 - .../agents/openai.yaml | 5 - .../skills/setup-matt-pocock-skills/domain.md | 51 - .../issue-tracker-github.md | 45 - .../issue-tracker-gitlab.md | 46 - .../issue-tracker-local.md | 30 - .../setup-matt-pocock-skills/triage-labels.md | 15 - .agents/skills/tdd/SKILL.md | 36 - .agents/skills/tdd/agents/openai.yaml | 3 - .agents/skills/tdd/mocking.md | 59 - .agents/skills/tdd/tests.md | 77 - .agents/skills/teach/GLOSSARY-FORMAT.md | 35 - .../skills/teach/LEARNING-RECORD-FORMAT.md | 46 - .agents/skills/teach/MISSION-FORMAT.md | 31 - .agents/skills/teach/RESOURCES-FORMAT.md | 32 - .agents/skills/teach/SKILL.md | 140 - .agents/skills/teach/agents/openai.yaml | 5 - .agents/skills/to-issues/SKILL.md | 84 - .agents/skills/to-prd/SKILL.md | 75 - .agents/skills/to-spec/SKILL.md | 75 - .agents/skills/to-spec/agents/openai.yaml | 5 - .agents/skills/to-tickets/SKILL.md | 107 - .agents/skills/to-tickets/agents/openai.yaml | 5 - .agents/skills/triage/AGENT-BRIEF.md | 207 - .agents/skills/triage/OUT-OF-SCOPE.md | 105 - .agents/skills/triage/SKILL.md | 112 - .agents/skills/triage/agents/openai.yaml | 5 - .agents/skills/wayfinder/SKILL.md | 128 - .agents/skills/wayfinder/agents/openai.yaml | 5 - .agents/skills/write-a-skill/SKILL.md | 117 - .../skills/writing-great-skills/GLOSSARY.md | 201 - .agents/skills/writing-great-skills/SKILL.md | 83 - .../writing-great-skills/agents/openai.yaml | 5 - .agents/skills/zoom-out/SKILL.md | 7 - .claude/settings.json | 5 - .claude/skills/api-routing/SKILL.md | 151 - .claude/skills/ask-matt | 1 - .claude/skills/caveman | 1 - .claude/skills/code-review | 1 - .claude/skills/codebase-design | 1 - .claude/skills/comment-standards/SKILL.md | 139 - .claude/skills/db-migration/SKILL.md | 212 - .claude/skills/db-validation/SKILL.md | 151 - .claude/skills/diagnose | 1 - .claude/skills/diagnosing-bugs | 1 - .claude/skills/doc-management/SKILL.md | 141 - .claude/skills/domain-modeling | 1 - .claude/skills/dto-standards/SKILL.md | 246 - .claude/skills/grill-me | 1 - .claude/skills/grill-with-docs | 1 - .claude/skills/grilling | 1 - .claude/skills/handoff | 1 - .claude/skills/hurl-test/SKILL.md | 777 - .claude/skills/implement | 1 - .claude/skills/improve-codebase-architecture | 1 - .claude/skills/model-standards/SKILL.md | 93 - .claude/skills/openspec-api-contract/SKILL.md | 97 - .../skills/openspec-lock-consensus/SKILL.md | 281 - .claude/skills/prototype | 1 - .claude/skills/research | 1 - .claude/skills/resolving-merge-conflicts | 1 - .claude/skills/setup-matt-pocock-skills | 1 - .claude/skills/tdd | 1 - .claude/skills/teach | 1 - .claude/skills/to-issues | 1 - .claude/skills/to-prd | 1 - .claude/skills/to-spec | 1 - .claude/skills/to-tickets | 1 - .claude/skills/triage | 1 - .claude/skills/wayfinder | 1 - .claude/skills/write-a-skill | 1 - .claude/skills/writing-great-skills | 1 - .claude/skills/zoom-out | 1 - .codex/prompts/opsx-apply.md | 150 - .codex/prompts/opsx-archive.md | 155 - .codex/prompts/opsx-bulk-archive.md | 240 - .codex/prompts/opsx-continue.md | 112 - .codex/prompts/opsx-explore.md | 172 - .codex/prompts/opsx-ff.md | 92 - .codex/prompts/opsx-new.md | 67 - .codex/prompts/opsx-onboard.md | 523 - .codex/prompts/opsx-sync.md | 132 - .codex/prompts/opsx-verify.md | 162 - .codex/skills/export-datasource/SKILL.md | 198 - .../export-datasource/agents/openai.yaml | 4 - .../references/export-scene-template.md | 222 - .codex/skills/openspec-apply-change/SKILL.md | 160 - .../skills/openspec-archive-change/SKILL.md | 118 - .codex/skills/openspec-explore/SKILL.md | 290 - .codex/skills/openspec-propose/SKILL.md | 114 - .codex/skills/openspec-sync-specs/SKILL.md | 148 - .codex/skills/openspec-update-change/SKILL.md | 86 - .gitignore | 3 + .planning/PROJECT.md | 187 - .planning/REQUIREMENTS.md | 168 - .planning/ROADMAP.md | 168 - .planning/STATE.md | 142 - .planning/codebase/ARCHITECTURE.md | 179 - .planning/codebase/CONCERNS.md | 173 - .planning/codebase/CONVENTIONS.md | 168 - .planning/codebase/INTEGRATIONS.md | 215 - .planning/codebase/STACK.md | 177 - .planning/codebase/STRUCTURE.md | 250 - .planning/codebase/TESTING.md | 182 - .planning/config.json | 36 - .planning/phases/01-p0/01-01-PLAN.md | 224 - .planning/phases/01-p0/01-01-SUMMARY.md | 233 - .planning/phases/01-p0/01-02-PLAN.md | 225 - .planning/phases/01-p0/01-02-SUMMARY.md | 131 - .planning/phases/01-p0/01-03-PLAN.md | 314 - .planning/phases/01-p0/01-03-SUMMARY.md | 132 - .planning/phases/01-p0/01-04-PLAN.md | 164 - .planning/phases/01-p0/01-04-SUMMARY.md | 126 - .planning/phases/01-p0/01-05-PLAN.md | 233 - .planning/phases/01-p0/01-05-SUMMARY.md | 181 - .planning/phases/01-p0/01-CONTEXT.md | 127 - .planning/phases/01-p0/01-DISCUSSION-LOG.md | 69 - .planning/phases/01-p0/01-VERIFICATION.md | 234 - .../02-perm-fin-realname-poll/02-01-PLAN.md | 434 - .../02-01-SUMMARY.md | 148 - .../02-perm-fin-realname-poll/02-02-PLAN.md | 444 - .../02-02-SUMMARY.md | 95 - .../02-perm-fin-realname-poll/02-CONTEXT.md | 143 - .../02-DISCUSSION-LOG.md | 58 - .../02-VERIFICATION.md | 203 - .../phases/03-device-system/03-01-PLAN.md | 403 - .../phases/03-device-system/03-01-SUMMARY.md | 93 - .../phases/03-device-system/03-02-PLAN.md | 405 - .../phases/03-device-system/03-02-SUMMARY.md | 83 - .../phases/03-device-system/03-CONTEXT.md | 132 - .../03-device-system/03-DISCUSSION-LOG.md | 70 - .../03-device-system/03-VERIFICATION.md | 141 - .../03.1-01-PLAN.md | 637 - .../03.1-01-SUMMARY.md | 185 - .../03.1-CONTEXT.md | 170 - .../03.1-DISCUSSION-LOG.md | 147 - .../03.1-VERIFICATION.md | 160 - .../phases/04-refund-pay-ops/04-CONTEXT.md | 164 - .../04-refund-pay-ops/04-DISCUSSION-LOG.md | 200 - .planning/research/ARCHITECTURE.md | 474 - .planning/research/FEATURES.md | 263 - .planning/research/PITFALLS.md | 245 - .planning/research/STACK.md | 353 - .planning/research/SUMMARY.md | 121 - .scratch/customer-binding-architecture/PRD.md | 126 - .../01-customer-binding-module-refactor.md | 50 - .../issues/02-no-virtual-no-card-cend-flow.md | 52 - .../03-exchange-binding-migration-fix.md | 45 - .../PRD.md | 143 - ...-card-enterprise-auth-unique-constraint.md | 28 - ...2-standalone-card-network-status-filter.md | 22 - .../issues/03-asset-exchange-status-fields.md | 34 - .../04-main-wallet-asset-identifier-filter.md | 23 - .../05-refund-asset-identifier-filter.md | 23 - ...-standalone-card-list-enterprise-filter.md | 33 - .../07-device-list-enterprise-filter.md | 32 - .../08-enterprise-card-auth-multi-mode.md | 42 - .../09-enterprise-device-auth-multi-mode.md | 38 - .../iot-risk-import-voucher-remark/PRD.md | 124 - .../issues/01-risk-resume-block.md | 28 - .../issues/02-polling-auto-stop-risk-card.md | 28 - .../issues/03-import-task-creator-name.md | 30 - .../04-batch-invalidate-package-task.md | 43 - .../issues/05-voucher-multi-migration.md | 36 - .../issues/06-order-voucher-multi.md | 27 - .../issues/07-refund-voucher-multi.md | 29 - .../08-agent-recharge-voucher-remark.md | 35 - .scratch/tech-global-audit/PRD.md | 166 - .../issues/00-full-audit-surface-inventory.md | 18 - .../issues/01-audit-event-write-loop.md | 21 - .../issues/02-integration-log-attempt-loop.md | 18 - .../issues/03-access-log-route-hardening.md | 21 - ...account-role-permission-audit-migration.md | 18 - ...05-card-asset-lifecycle-audit-migration.md | 18 - .../06-device-import-audit-migration.md | 18 - .../07-shop-package-config-audit-migration.md | 18 - .../08-finance-order-audit-migration.md | 21 - ...manual-polling-task-integration-cutover.md | 24 - .../issues/10-legacy-audit-read-projection.md | 18 - .../issues/11-global-event-resource-query.md | 23 - .../issues/12-actor-risk-query.md | 21 - ...equest-correlation-integration-timeline.md | 24 - .../issues/14-finance-audit-timeline.md | 21 - .../issues/15-sensitive-read-self-audit.md | 22 - .../16-audit-export-permission-snapshot.md | 24 - .../17-retention-cleanup-observability.md | 21 - .../18-frontend-contract-acceptance-pack.md | 25 - .../issues/19-one-time-audit-cutover-gate.md | 41 - .../issues/20-system-config-audit-adapter.md | 20 - .../21-outbox-recovery-audit-adapter.md | 20 - .scratch/tech-global-audit/审计覆盖基线.md | 268 - .scratch/tech-global-audit/审计覆盖清单.json | 15953 ------- .scratch/tech-inapp-notifications/PRD.md | 132 - ...dmin-direct-recipient-notification-loop.md | 20 - ...in-notification-filter-summary-read-all.md | 19 - .../03-personal-customer-notification-loop.md | 19 - .../issues/04-dynamic-recipient-resolution.md | 24 - ...ntrolled-notification-target-resolution.md | 24 - ...06-notification-retention-observability.md | 25 - .../07-frontend-contract-acceptance-pack.md | 25 - .../issues/08-notification-release-gate.md | 31 - .scratch/tech-public-foundation/PRD.md | 291 - ...01-public-migration-ownership-and-gates.md | 18 - .../02-transactional-public-outbox-write.md | 18 - .../03-outbox-at-least-once-delivery.md | 18 - .../04-outbox-observability-and-recovery.md | 18 - .../issues/05-command-idempotency-contract.md | 18 - .../issues/06-unified-async-task-contract.md | 18 - .../07-controlled-system-config-read.md | 18 - .../08-controlled-system-config-update.md | 18 - .../09-access-log-recursive-redaction.md | 18 - .../10-sensitive-route-safe-summaries.md | 18 - ...ublic-migration-and-rollback-validation.md | 18 - ...n-release-gate-and-integration-contract.md | 19 - .scratch/ur33-package-expiry-reminder/PRD.md | 129 - .scratch/ur34-agent-recharge/PRD.md | 291 - .scratch/ur35-refund-wecom-approval/PRD.md | 219 - .scratch/ur36-bulk-package-purchase/PRD.md | 290 - .../01-batch-unique-asset-resolution.md | 19 - .../02-controlled-upload-object-ownership.md | 19 - .../03-real-dependency-integration-harness.md | 19 - ...04-unified-admin-package-purchasability.md | 19 - ...5-single-asset-package-purchase-command.md | 23 - .../06-idempotent-bulk-purchase-creation.md | 28 - .../issues/07-validate-csv-persist-items.md | 25 - .../issues/08-offline-bulk-row-purchase.md | 24 - .../09-wallet-bulk-row-purchase-recovery.md | 23 - .../issues/10-bulk-purchase-task-queries.md | 22 - .../issues/11-real-chain-release-gate.md | 27 - .../ur37-wecom-approval-foundation/PRD.md | 262 - .../01-wecom-connection-status-and-adapter.md | 18 - .../02-self-service-wecom-account-binding.md | 21 - ...3-approval-scene-first-template-publish.md | 22 - ...ation-prerequisite-and-transaction-port.md | 22 - ...tachment-upload-and-approval-submission.md | 22 - ...ne-pause-template-switch-and-validation.md | 21 - ...crypted-callback-and-authoritative-sync.md | 22 - ...polling-compensation-and-terminal-event.md | 21 - ...pproval-operations-query-and-projection.md | 22 - .../issues/10-unknown-submission-recovery.md | 23 - .../11-approval-result-inapp-notification.md | 21 - .../12-legacy-approval-migration-contract.md | 25 - .../13-wecom-ui-contract-acceptance-pack.md | 23 - ...14-refund-first-real-wecom-release-gate.md | 36 - .scratch/ur38-agent-main-wallet-credit/PRD.md | 188 - .../01-agent-main-wallet-credit-foundation.md | 18 - .../issues/02-role-default-credit-template.md | 21 - .../issues/03-atomic-shop-credit-snapshot.md | 18 - .../issues/04-manage-shop-credit-limit.md | 21 - .../issues/05-unified-agent-wallet-debit.md | 23 - .../06-unified-agent-wallet-reservation.md | 22 - .../07-unified-agent-wallet-credit-posting.md | 22 - .../issues/08-unified-agent-wallet-refund.md | 23 - .../issues/09-fund-summary-credit-query.md | 21 - .../issues/10-credit-wallet-cutover-gate.md | 30 - .../ur40-off-shelf-package-renewal/PRD.md | 142 - ...-purchasability-and-history-eligibility.md | 21 - ...2-normal-package-marketplace-projection.md | 18 - .../03-current-package-renewal-projection.md | 18 - .../04-package-history-renewal-projection.md | 19 - ...lient-order-renew-only-write-validation.md | 20 - ...n-personal-entrypoint-shelf-enforcement.md | 19 - .../issues/07-renew-only-audit-events.md | 22 - ...tract-release-and-entrypoint-acceptance.md | 30 - .../PRD.md | 292 - .../PRD.md | 171 - .../issues/01-initial-bulk-authorization.md | 13 - .../issues/02-atomic-package-commands.md | 13 - .../issues/03-management-ui-and-release.md | 13 - .../PRD.md | 161 - .scratch/ur45-exchange-asset-search/PRD.md | 90 - .../01-unify-exchange-asset-snapshots.md | 22 - .../02-independent-old-new-asset-search.md | 27 - .scratch/ur46-estimated-final-expiry/PRD.md | 104 - ...min-asset-detail-estimated-final-expiry.md | 21 - ...02-iot-card-list-estimated-final-expiry.md | 17 - .../03-device-list-estimated-final-expiry.md | 17 - .../04-client-asset-estimated-final-expiry.md | 16 - .scratch/ur47-manual-card-speed-limit/PRD.md | 142 - .../issues/01-保障设备当前绑卡唯一性.md | 12 - .../02-建立限速gateway渠道适配与受控映射.md | 13 - .../03-提供统一资产手动限速接口与审计.md | 15 - .../issues/04-提供资产详情限速能力展示契约.md | 13 - .scratch/ur48-asset-payment-methods/PRD.md | 175 - .../01-payment-config-asset-contract.md | 16 - ...02-asset-wallet-recharge-payment-policy.md | 16 - ...ment-method-snapshot-and-force-recharge.md | 17 - .../04-order-snapshot-pay-and-cancel.md | 16 - .../issues/05-payment-method-release-gate.md | 22 - .../系统配置调研.md | 47 - .../ur49-device-batch-allocation-csv/PRD.md | 187 - .../01-device-batch-allocation-foundation.md | 22 - .../issues/02-csv-batch-assign-shop.md | 18 - .../issues/03-csv-batch-assign-series.md | 18 - ...end-api-contract-and-release-acceptance.md | 18 - .../issues/05-real-chain-release-gate.md | 22 - .scratch/ur53-asset-realname-filter/PRD.md | 108 - .scratch/ur55-package-expiry-base/PRD.md | 102 - ...-create-allocation-expiry-base-override.md | 16 - ...-update-allocation-expiry-base-override.md | 17 - ...-snapshot-synchronous-package-purchases.md | 17 - ...4-snapshot-auto-purchase-package-usages.md | 16 - ...tivate-and-queue-from-package-snapshots.md | 21 - .../ur57-block-exchange-active-refund/PRD.md | 89 - .scratch/ur60-shop-phone-search/PRD.md | 201 - .../01-修复店铺列表参数校验与默认分页.md | 22 - .../02-交付联系电话精确查询与数据库索引.md | 27 - .../03-禁止企业账号访问核心店铺管理路由.md | 22 - .scratch/ur62-h5-realname-order/PRD.md | 104 - .scratch/ur73-resume-realname-policy/PRD.md | 95 - .scratch/ur86-asset-exchange-trace/PRD.md | 96 - .../01-asset-previous-exchange-trace.md | 21 - .../issues/02-asset-next-exchange-trace.md | 23 - .../ur94-card-state-events-callbacks/PRD.md | 137 - .../01-callback-iccid-uniqueness-gate.md | 17 - .../02-realname-observation-write-loop.md | 23 - .../03-traffic-observation-write-loop.md | 17 - .../04-network-observation-write-loop.md | 18 - .../issues/05-polling-observation-cutover.md | 23 - .../issues/06-observation-series-loop.md | 25 - ...7-read-and-realname-trigger-integration.md | 18 - ...-resume-and-package-trigger-integration.md | 18 - .../09-device-control-trigger-integration.md | 18 - .../issues/10-ctcc-realname-callback.md | 22 - .../issues/11-cmcc-realname-callback.md | 22 - .../12-cucc-realname-removal-callback.md | 20 - .../issues/13-ur94-release-gate.md | 29 - .scratch/ur96-shop-business-owner/PRD.md | 129 - .../01-shop-business-owner-persistence.md | 18 - .../02-platform-create-shop-business-owner.md | 19 - .../03-agent-inherit-shop-business-owner.md | 19 - ...04-update-and-audit-shop-business-owner.md | 22 - .../issues/05-query-shop-business-owner.md | 22 - ...-owner-recipient-resolution-and-release.md | 27 - .scratch/ur97-wallet-low-balance-alert/PRD.md | 106 - .scratch/ur98-exchange-inherit-shop/PRD.md | 105 - ...nge-allocation-and-ownership-foundation.md | 18 - ...change-completion-with-shop-inheritance.md | 20 - ...-exchange-inherited-shop-api-projection.md | 20 - ...inheritance-contract-release-acceptance.md | 19 - .sisyphus/drafts/add-gateway-admin-api.md | 93 - .sisyphus/drafts/gateway-integration-plan.md | 118 - .sisyphus/drafts/gateway-integration.md | 155 - .../add-gateway-admin-api/FINAL_REPORT.md | 306 - .../ORCHESTRATION_COMPLETE.md | 237 - .../add-gateway-admin-api/completion.md | 119 - .../notepads/add-gateway-admin-api/context.md | 81 - .../add-gateway-admin-api/learnings.md | 75 - .../notepads/add-gateway-admin-api/status.md | 76 - .../decisions.md | 27 - .../issues.md | 22 - .../learnings.md | 37 - .../notepads/tech-debt-cleanup/decisions.md | 15 - .../notepads/tech-debt-cleanup/issues.md | 5 - .../notepads/tech-debt-cleanup/learnings.md | 229 - .sisyphus/plans/add-force-recharge-system.md | 1715 - .sisyphus/plans/add-gateway-admin-api.md | 411 - .../gateway-integration-execution-plan.md | 1329 - .sisyphus/plans/gateway-integration.md | 1457 - .../realname-trigger-priority-enhancement.md | 691 - .sisyphus/plans/tech-debt-cleanup.md | 108 - .sisyphus/plans/修正业务-完整方案.md | 2130 - AGENTS.md | 431 +- ARCHITECTURE.md | 149 + CLAUDE.md | 20 +- CONTEXT.md | 113 - CONTEXT_RESET_PLAN.md | 477 - README.md | 1080 +- docs/002-gorm-postgres-asynq/使用指南.md | 581 - docs/002-gorm-postgres-asynq/功能总结.md | 403 - docs/002-gorm-postgres-asynq/架构说明.md | 352 - docs/003-error-handling/使用指南.md | 886 - docs/003-error-handling/功能总结.md | 253 - docs/003-error-handling/架构说明.md | 787 - docs/004-rbac-data-permission/使用指南.md | 723 - docs/004-rbac-data-permission/功能总结.md | 325 - docs/004-rbac-data-permission/架构说明.md | 264 - docs/7月迭代/7月迭代前后端任务工时表.md | 57 - docs/7月迭代/7月迭代技术方案-标准评审稿.md | 1674 - docs/7月迭代/7月迭代禅道研发需求拆分表.md | 242 - docs/7月迭代/7月迭代禅道研发需求逐条录入稿.md | 1941 - docs/7月迭代/README.md | 65 - docs/7月迭代/七月迭代-AI实施与验收操作手册.md | 417 - docs/7月迭代/七月迭代人工验收清单.md | 103 - docs/7月迭代/七月迭代实现与接口对接说明.md | 284 - docs/7月迭代/七月迭代测试与业务交付手册.md | 543 - docs/7月迭代/七月迭代联调交付说明.md | 138 - docs/7月迭代/七月迭代需求范围确认表.md | 654 - docs/7月迭代/企业微信审批官方接口调研.md | 202 - docs/7月迭代/来源材料/realname.go | 792 - docs/7月迭代/来源材料/业务需求.md | 396 - docs/7月迭代/来源材料/新需求.md | 721 - docs/7月迭代/物联网卡管系统-需求.csv | 404 - .../独立方案/历史方案/前端共性方案-历史稿.md | 271 - .../历史方案/本地通用审批流-已废弃方案.md | 1174 - .../独立方案/历史方案/站内消息-初版.md | 383 - .../独立方案/原需求/需求01-复机实名规则.md | 56 - .../独立方案/原需求/需求02-H5流程配置.md | 213 - .../原需求/需求03-07-11-12-13-简单改动.md | 321 - .../原需求/需求04-06-退款拦截与最后到期时间.md | 206 - .../独立方案/原需求/需求05-套餐分配生效条件.md | 195 - .../独立方案/原需求/需求08-设备批量分配Excel.md | 206 - .../独立方案/原需求/需求09-C端支付限制配置化.md | 146 - .../独立方案/原需求/需求10-限速规则.md | 136 - .../独立方案/原需求/需求14-导出功能.md | 412 - .../原需求/需求15-16-18-19-20-21-复杂需求.md | 446 - .../独立方案/原需求/需求17-信用额度.md | 349 - .../独立方案/原需求/需求22-套餐临期提醒.md | 297 - docs/7月迭代/独立方案/基础规范/DDD规范.md | 467 - docs/7月迭代/独立方案/基础规范/系统配置.md | 237 - .../新增需求/01-数据同步触发与轮询优化.md | 625 - .../独立方案/新增需求/02-企业微信审批接入.md | 891 - .../独立方案/新增需求/03-站内通知详细方案.md | 457 - .../独立方案/新增需求/04-全局多视角审计方案.md | 809 - .../独立方案/新增需求/05-代理钱包扫码充值.md | 456 - .../新增需求/06-换货归属与资产换货标识.md | 72 - .../新增需求/07-店铺业务员与钱包余额预警.md | 81 - .../独立方案/新增需求/08-代理系列套餐批量授权.md | 81 - docs/COMMISSION_DOCS_INDEX.md | 235 - docs/DEPLOYMENT_TROUBLESHOOTING.md | 449 - docs/ORDER_STATUS_INDEX.md | 250 - docs/PACKAGE_DOCS_INDEX.md | 244 - docs/PROJECT-COMPLETION-SUMMARY.md | 635 - docs/account-management-refactor/API文档.md | 588 - docs/account-management-refactor/功能总结.md | 375 - docs/account-management-refactor/迁移指南.md | 310 - .../add-asset-operation-audit-log/功能总结.md | 98 - .../手工验收脚本.sql | 89 - .../接口回放示例.md | 71 - .../操作内容字段说明.md | 102 - docs/add-default-admin-init/功能说明.md | 327 - docs/add-force-recharge-system/功能总结.md | 395 - .../提案完成总结.md | 444 - docs/add-user-organization-model/测试总结.md | 389 - .../用户体系设计文档.md | 831 - .../字段说明.md | 456 - .../数据模型设计.md | 624 - .../迁移验证报告.md | 292 - docs/admin-openapi.yaml | 37258 ---------------- docs/admin-openapi.yaml.old | 15750 ------- docs/agent-open-api/功能总结.md | 265 - docs/agent-recharge/功能总结.md | 227 - docs/agents/domain.md | 40 - docs/agents/issue-tracker.md | 19 - docs/agents/triage-labels.md | 15 - docs/ai-dto-guidelines-update.md | 265 - docs/alipay-integration/前端对接说明.md | 155 - docs/api-doc-update-summary.md | 380 - docs/api-documentation-guide.md | 700 - docs/api/auth.md | 511 - docs/architecture_diagram.md | 366 - docs/asset-detail-refactor-api-changes.md | 260 - docs/asset-package-batch-order/功能总结.md | 44 - docs/auth-architecture.md | 407 - docs/auth-usage-guide.md | 507 - docs/business-data-export/功能总结.md | 59 - docs/client-api-data-model-fixes/功能总结.md | 128 - docs/client-api-requirements/需求说明.md | 1214 - docs/client-asset-renewal-price/功能总结.md | 7 - docs/client-auth-system/功能总结.md | 141 - docs/client-core-business-api/功能总结.md | 122 - docs/client-exchange-system/功能总结.md | 94 - docs/client-wechat-appid/功能总结.md | 30 - docs/code-review-checklist.md | 326 - docs/commission-flow-diagram.md | 319 - docs/commission-package-model.md | 351 - docs/commission-quick-reference.md | 283 - docs/commission-search-result.md | 237 - docs/commission/accumulated-trigger-logic.md | 181 - docs/database-migration-summary.md | 179 - docs/deployment/deployment-guide.md | 455 - docs/deployment/gitea-secrets-setup.md | 114 - docs/deployment/生产数据库手工上线流程.md | 328 - docs/device-batch-allocation/功能总结.md | 53 - docs/device-imei-search/功能总结.md | 16 - docs/device-status-split/功能总结.md | 31 - docs/discussion/资产详情重构讨论纪要.md | 821 - docs/dto-improvement-summary.md | 215 - docs/engineering/工程约束.md | 289 + .../implementation-summary.md | 224 - docs/enum-status-standards.md | 250 - docs/environment-variables.md | 362 - docs/excel-import-frontend-guide.md | 219 - .../兼容映射清单.md | 41 - .../功能总结.md | 78 - .../手工验收清单.md | 39 - .../代理钱包扫码充值接口对接说明.md | 327 - .../功能总结.md | 85 - .../微信扫码支付产品边界核对.md | 103 - .../主体资源活动接口.md | 30 - .../外部集成调查接口.md | 26 - .../多视角审计中心功能总结.md | 267 - .../平台基础审计调查接口.md | 63 - .../归档灰度操作手册.md | 166 - .../跨视角调查与前端导航契约.md | 467 - .../功能总结.md | 139 - .../功能总结.md | 525 - .../部署指南.md | 538 - .../功能总结.md | 242 - docs/gateway-api-reference.md | 748 - docs/gateway-client-usage.md | 547 - docs/integrations/alipay/README.md | 30 + docs/integrations/fuiou/README.md | 28 + docs/integrations/gateway/README.md | 30 + docs/integrations/object-storage/README.md | 32 + docs/integrations/sms/README.md | 28 + docs/integrations/wechat/README.md | 34 + docs/integrations/wecom/README.md | 41 + docs/iot-card-speed-tier/功能总结.md | 55 - docs/iot-sim-management/分佣系统说明.md | 940 - docs/iot-sim-management/实施总结.md | 491 - docs/iot-sim-management/数据模型总结.md | 658 - docs/iot-sim-management/表结构详细说明.md | 1020 - docs/iot-sim-management/轮询机制说明.md | 776 - docs/login-menu-button-response/使用指南.md | 252 - docs/object-storage/使用指南.md | 163 - docs/object-storage/前端接入指南.md | 250 - docs/openapi-enhancement-summary.md | 317 - docs/order-expiration/功能总结.md | 181 - docs/order-payment/功能总结.md | 333 - docs/order_status_commission_analysis.md | 456 - docs/order_status_quick_reference.md | 196 - docs/order_status_search_summary.md | 174 - .../功能总结.md | 108 - .../最终验收清单.md | 44 - docs/package-system-upgrade/API文档.md | 277 - docs/package-system-upgrade/使用指南.md | 278 - docs/package-system-upgrade/功能总结.md | 183 - docs/package-system-upgrade/运维指南.md | 279 - docs/package_architecture_diagram.md | 366 - docs/package_quick_navigation.md | 147 - docs/package_structure_summary.md | 349 - docs/performance-benchmark-report.md | 283 - docs/permission-check-usage.md | 311 - docs/polling-system/README.md | 196 - docs/polling-system/deployment.md | 213 - .../polling-system/manual-trigger-analysis.md | 596 - docs/polling-system/manual-trigger-summary.md | 175 - .../manual-trigger-vs-alternatives.md | 309 - docs/polling-system/operations.md | 402 - docs/polling-system/performance-tuning.md | 174 - .../轮询配置二维条件重构计划.md | 94 - docs/proposals/单卡授权企业功能设计.md | 428 - docs/quality-gate-report.md | 529 - docs/quick_navigation.md | 147 - docs/rate-limiting.md | 1083 - .../前端接口迁移指南.md | 395 - docs/refactor-iot-model-location/重构总结.md | 252 - docs/remove-legacy-rbac-cleanup/清理总结.md | 430 - docs/security-audit-report.md | 297 - .../series-binding-bulk-selection/功能总结.md | 85 - docs/shop-management/API文档.md | 817 - docs/shop-management/使用指南.md | 422 - docs/shop-role-inheritance/功能总结.md | 274 - docs/system-audit-report.md | 945 - docs/tech-approval-core/功能总结.md | 58 - docs/tech-global-audit/当前实现进度.md | 27 - .../前端联调与验收契约.md | 107 - docs/tech-inapp-notifications/功能总结.md | 81 - .../发布与下游接入清单.md | 47 - .../创建命令幂等契约.md | 19 - .../前端即时接口交接.md | 49 - docs/tech-public-foundation/功能总结.md | 71 - .../数据库对象所有权与发布门禁.md | 22 - .../统一异步任务与前端轮询契约.md | 13 - .../迁移发布与数据安全回滚.md | 22 - docs/testing/test-connection-guide.md | 373 - .../traffic-model-unification/字段替换矩阵.md | 113 - .../手工验收脚本.sql | 140 - .../traffic-model-unification/接口回放样例.md | 150 - .../流量模型统一改造方案.md | 634 - docs/unified-export-task-system/功能总结.md | 103 - .../手工验证清单.md | 56 - docs/unified-export-task-system/验收记录.md | 59 - .../验收记录模板.md | 64 - .../验证数据样本.md | 84 - docs/ur33-package-expiry-reminder/功能总结.md | 29 - .../ur38-agent-main-wallet-credit/功能总结.md | 149 - .../功能总结.md | 72 - docs/ur45-exchange-asset-search/功能总结.md | 74 - docs/ur46-estimated-final-expiry/功能总结.md | 29 - docs/ur55-package-expiry-base/功能总结.md | 24 - docs/ur60-shop-phone-search/功能总结.md | 89 - docs/ur86-asset-exchange-trace/功能总结.md | 78 - .../功能总结.md | 211 - docs/ur96-shop-business-owner/功能总结.md | 58 - docs/wechat-config-management/功能总结.md | 239 - docs/wechat-integration/API文档.md | 564 - docs/wechat-integration/使用指南.md | 562 - docs/wechat-integration/验证指南.md | 675 - docs/wecom-application-connection/功能总结.md | 128 - .../存量审批切换清单.md | 62 - docs/workflow-optimization/方案总览.md | 386 - docs/优化说明/产品套餐汇总表11.10.xlsx | Bin 22273 -> 0 bytes docs/优化说明/企业客户管理.md | 17 - docs/优化说明/分佣正确逻辑.md | 183 - docs/优化说明/分佣正确逻辑补充.md | 31 - docs/优化说明/分佣表结构设计.md | 582 - docs/优化说明/分佣需要确认逻辑.md | 216 - docs/优化说明/模块.md | 35 - docs/前端建设/C端H5页面接口矩阵.md | 176 - docs/前端建设/README.md | 146 - docs/前端建设/前端选型与代码组织.md | 213 - docs/前端建设/权限矩阵与接口联调契约.md | 306 - docs/前端建设/管理端页面接口矩阵.md | 186 - docs/副本IoT卡导入模板-Chc9eI72.csv | 24 - docs/副本设备导入模板-B8BDRTVm.csv | 24 - docs/待沟通/2025-12-23T17:39:57沟通.md | 11 - .../一次性佣金出现两个套餐的情况.excalidraw | 845 - docs/待沟通/全局业务架构流程.md | 130 - docs/待沟通/关于分佣.md | 299 - docs/待沟通/关于分佣.pdf | Bin 420970 -> 0 bytes docs/待沟通/号卡流程.md | 44 - docs/批量回收设备脚本/功能总结.md | 21 - docs/批量套餐失效订单生成脚本/功能总结.md | 17 - docs/批量套餐过期时间修改脚本/功能总结.md | 18 - docs/批量换货脚本/功能总结.md | 49 - docs/批量购买套餐脚本/功能总结.md | 33 - docs/技术方案评审规范.md | 182 - docs/接入openapi.md | 266 - docs/改造方向.md | 343 - docs/第三方文档/SMS_HTTP_1.6.md | 1091 - docs/第三方文档/gateway设备详情同步接口.md | 191 - docs/系统流程图/0.代理佣金体系设计流程.md | 78 - docs/系统流程图/0.佣金提现配置流程.md | 61 - .../0.套餐设计流程(包含佣金设计).md | 98 - docs/系统流程图/0.微信配置流程.md | 97 - docs/系统流程图/0.权限设置流程.md | 49 - docs/系统流程图/0.资产导入流程.md | 73 - docs/系统流程图/0.超级密码设置流程.md | 62 - docs/系统流程图/10.退款流程.md | 53 - docs/系统流程图/11.后台订单流程.md | 84 - docs/系统流程图/12.C端订单流程.md | 91 - docs/系统流程图/13.换货流程.md | 74 - docs/系统流程图/14.资产日常管控流程.md | 78 - docs/系统流程图/15.企业客户入驻流程.md | 71 - docs/系统流程图/2.平台人员账号创建流程.md | 55 - docs/系统流程图/3.代理入驻(店铺新建)流程.md | 62 - docs/系统流程图/4.为资产预设套餐系列流程.md | 78 - docs/系统流程图/4.资产分配流程.md | 74 - docs/系统流程图/5.套餐分配流程.md | 63 - docs/系统流程图/6.购买套餐流程.md | 65 - docs/系统流程图/7.佣金产生细节说明.md | 64 - docs/系统流程图/8.代理佣金提现以及审批流程.md | 54 - docs/系统流程图/9.代理充值流程.md | 50 - docs/脚本/奇成数据迁移方案.md | 642 - docs/脚本/清理代理预充值.sql | 12 - docs/表设计/整合.md | 464 - docs/需求规划/账号与佣金管理模块需求规划.md | 1790 - .../outbox/recovery_integration_test.go | 129 - .../systemconfig/update_integration_test.go | 141 - internal/domain/package/terms_test.go | 41 - .../governance/auditcoverage/coverage_test.go | 46 - internal/handler/admin/exchange_test.go | 252 - ...op_package_expiry_base_integration_test.go | 373 - .../asynctask/store_integration_test.go | 130 - .../infrastructure/audit/security_test.go | 57 - .../repository_integration_test.go | 277 - .../outbox/relay_integration_test.go | 253 - .../outbox/repository_integration_test.go | 105 - .../releasegate/checker_test.go | 20 - .../releasegate/migration_integration_test.go | 222 - .../systemconfig/reader_integration_test.go | 115 - .../systemconfig/registry_test.go | 61 - internal/model/dto/shop_dto_test.go | 18 - internal/query/asset/exchange_trace_test.go | 435 - internal/query/exchange/list_test.go | 219 - .../query/outbox/metrics_integration_test.go | 73 - internal/query/packageexpiry/query_test.go | 420 - .../asset_exchange_trace_integration_test.go | 954 - internal/routes/shop_integration_test.go | 637 - .../routes/system_config_integration_test.go | 236 - internal/service/asset/usage_summary_test.go | 81 - .../service/customer_binding/service_test.go | 715 - .../service/exchange/asset_snapshot_test.go | 243 - .../iot_card/stop_resume_service_test.go | 26 - ...set_wallet_reservation_integration_test.go | 80 - .../order/package_terms_integration_test.go | 176 - .../activation_terms_integration_test.go | 233 - internal/service/package/terms_test.go | 57 - internal/service/package/usage_terms_test.go | 59 - ...package_terms_snapshot_integration_test.go | 59 - .../auto_purchase_terms_integration_test.go | 194 - .../task/polling_cardstatus_handler_test.go | 63 - internal/testutil/database.go | 74 - internal/testutil/outbox.go | 27 - internal/testutil/system_config.go | 22 - m.csv | 1 - .../add-direct-exchange-flow/.openspec.yaml | 2 - .../add-direct-exchange-flow/design.md | 303 - .../add-direct-exchange-flow/proposal.md | 56 - .../specs/asset-generation/spec.md | 73 - .../specs/asset-historical-orders/spec.md | 81 - .../specs/asset-lifecycle-status/spec.md | 68 - .../specs/device/spec.md | 52 - .../specs/exchange-admin-management/spec.md | 215 - .../exchange-client-notification/spec.md | 51 - .../specs/exchange-data-migration/spec.md | 132 - .../specs/exchange-order-model/spec.md | 135 - .../specs/iot-card/spec.md | 52 - .../specs/personal-customer/spec.md | 56 - .../changes/add-direct-exchange-flow/tasks.md | 65 - .../.openspec.yaml | 2 - .../add-open-api-device-endpoints/design.md | 67 - .../add-open-api-device-endpoints/proposal.md | 29 - .../specs/open-api-device-operations/spec.md | 87 - .../specs/open-api-device-traffic/spec.md | 53 - .../add-open-api-device-endpoints/tasks.md | 31 - .../.openspec.yaml | 2 - .../design.md | 195 - .../proposal.md | 67 - .../specs/commission-record-query/spec.md | 104 - .../tasks.md | 83 - .../.openspec.yaml | 2 - .../design.md | 677 - .../proposal.md | 74 - .../specs/iot-order/spec.md | 54 - .../specs/order-expiration/spec.md | 237 - .../specs/order-payment/spec.md | 67 - .../tasks.md | 184 - .../design.md | 221 - .../proposal.md | 45 - .../specs/user-organization/spec.md | 165 - .../tasks.md | 84 - .../IMPLEMENTATION.md | 121 - .../README.md | 101 - .../proposal.md | 31 - .../specs/openapi-generation/spec.md | 81 - .../tasks.md | 28 - .../design.md | 422 - .../proposal.md | 63 - .../specs/auth/spec.md | 61 - .../specs/data-permission/spec.md | 61 - .../specs/dependency-injection/spec.md | 52 - .../specs/error-handling/spec.md | 92 - .../tasks.md | 122 - .../proposal.md | 238 - .../specs/personal-customer/spec.md | 217 - .../tasks.md | 173 - .../design.md | 247 - .../proposal.md | 51 - .../specs/role-permission/spec.md | 163 - .../tasks.md | 136 - .../proposal.md | 61 - .../specs/legacy-cleanup/spec.md | 109 - .../tasks.md | 90 - .../.openspec.yaml | 2 - .../design.md | 537 - .../proposal.md | 152 - .../specs/model-organization/spec.md | 458 - .../tasks.md | 643 - .../.openspec.yaml | 2 - .../2026-01-12-iot-sim-management/design.md | 964 - .../2026-01-12-iot-sim-management/proposal.md | 113 - .../specs/iot-agent-commission/spec.md | 328 - .../specs/iot-card/spec.md | 291 - .../specs/iot-device/spec.md | 311 - .../specs/iot-number-card/spec.md | 160 - .../specs/iot-order/spec.md | 233 - .../specs/iot-package/spec.md | 211 - .../2026-01-12-iot-sim-management/tasks.md | 441 - .../.openspec.yaml | 2 - .../README.md | 3 - .../design.md | 230 - .../proposal.md | 107 - .../specs/model-organization/spec.md | 171 - .../tasks.md | 157 - .../.openspec.yaml | 2 - .../README.md | 3 - .../proposal.md | 102 - .../specs/card-replacement/spec.md | 183 - .../specs/carrier/spec.md | 76 - .../specs/iot-order/spec.md | 123 - .../specs/tag/spec.md | 218 - .../specs/wallet/spec.md | 199 - .../tasks.md | 47 - .../COMPLETION_SUMMARY.md | 242 - .../design.md | 757 - .../proposal.md | 242 - .../specs/tag/spec.md | 160 - .../specs/wallet/spec.md | 145 - .../tasks.md | 310 - .../proposal.md | 49 - .../specs/auth/spec.md | 153 - .../tasks.md | 84 - .../README.md | 388 - .../proposal.md | 128 - .../specs/role-permission/spec.md | 63 - .../specs/user-organization/spec.md | 125 - .../tasks.md | 134 - .../proposal.md | 55 - .../specs/role-permission/spec.md | 127 - .../tasks.md | 69 - .../proposal.md | 123 - .../specs/shop-account-management/spec.md | 173 - .../specs/shop-management/spec.md | 132 - .../tasks.md | 77 - .../design.md | 986 - .../proposal.md | 703 - .../specs/b-end-auth/spec.md | 141 - .../tasks.md | 604 - .../design.md | 237 - .../proposal.md | 47 - .../specs/permission-check/spec.md | 161 - .../tasks.md | 98 - .../proposal.md | 180 - .../specs/commission-model/spec.md | 142 - .../tasks.md | 171 - .../proposal.md | 80 - .../commission-withdrawal-approval/spec.md | 123 - .../tasks.md | 155 - .../proposal.md | 65 - .../commission-withdrawal-settings/spec.md | 101 - .../tasks.md | 106 - .../proposal.md | 66 - .../specs/customer-account-management/spec.md | 126 - .../tasks.md | 111 - .../proposal.md | 89 - .../enterprise-card-authorization/spec.md | 171 - .../tasks.md | 159 - .../proposal.md | 72 - .../specs/enterprise-management/spec.md | 142 - .../tasks.md | 119 - .../2026-01-21-add-my-commission/proposal.md | 71 - .../specs/my-commission/spec.md | 137 - .../2026-01-21-add-my-commission/tasks.md | 120 - .../proposal.md | 71 - .../specs/shop-commission-query/spec.md | 136 - .../tasks.md | 164 - .../design.md | 374 - .../proposal.md | 73 - .../specs/testing-standards/spec.md | 262 - .../tasks.md | 60 - .../.openspec.yaml | 2 - .../design.md | 228 - .../proposal.md | 54 - .../specs/error-code-validation/spec.md | 91 - .../tasks.md | 49 - .../.openspec.yaml | 2 - .../proposal.md | 56 - .../specs/iot-card-import-task/spec.md | 174 - .../specs/iot-card/spec.md | 246 - .../specs/iot-device/spec.md | 172 - .../tasks.md | 75 - .../.openspec.yaml | 2 - .../2026-01-24-add-object-storage/design.md | 233 - .../2026-01-24-add-object-storage/proposal.md | 97 - .../specs/object-storage/spec.md | 217 - .../2026-01-24-add-object-storage/tasks.md | 219 - .../.openspec.yaml | 2 - .../design.md | 114 - .../proposal.md | 36 - .../openapi-markdown-description/spec.md | 56 - .../tasks.md | 24 - .../proposal.md | 82 - .../specs/asset-allocation-record/spec.md | 101 - .../specs/iot-card/spec.md | 129 - .../tasks.md | 76 - .../.openspec.yaml | 2 - .../proposal.md | 35 - .../specs/iot-card-import-task/spec.md | 126 - .../tasks.md | 31 - .../.openspec.yaml | 2 - .../design.md | 123 - .../proposal.md | 57 - .../specs/authorization-record/spec.md | 114 - .../specs/data-permission/spec.md | 34 - .../tasks.md | 53 - .../.openspec.yaml | 2 - .../2026-01-26-deployment-self-init/design.md | 281 - .../proposal.md | 104 - .../specs/bootstrap-init/spec.md | 78 - .../specs/embedded-config/spec.md | 133 - .../2026-01-26-deployment-self-init/tasks.md | 82 - .../.openspec.yaml | 2 - .../design.md | 166 - .../proposal.md | 29 - .../enterprise-card-authorization/spec.md | 162 - .../specs/iot-card/spec.md | 42 - .../tasks.md | 63 - .../.openspec.yaml | 2 - .../design.md | 224 - .../proposal.md | 89 - .../specs/asset-allocation-record/spec.md | 120 - .../specs/device-import/spec.md | 193 - .../specs/device/spec.md | 327 - .../2026-01-27-add-device-management/tasks.md | 69 - .../.openspec.yaml | 2 - .../2026-01-27-add-package-module/design.md | 199 - .../2026-01-27-add-package-module/proposal.md | 63 - .../specs/package-management/spec.md | 180 - .../specs/package-series-management/spec.md | 99 - .../2026-01-27-add-package-module/tasks.md | 128 - .../.openspec.yaml | 2 - .../design.md | 96 - .../proposal.md | 32 - .../specs/carrier-management/spec.md | 79 - .../specs/iot-card-import/spec.md | 19 - .../specs/iot-card-query/spec.md | 26 - .../tasks.md | 62 - .../.openspec.yaml | 2 - .../design.md | 249 - .../proposal.md | 70 - .../specs/iot-device/spec.md | 159 - .../tasks.md | 76 - .../.openspec.yaml | 4 - .../design.md | 133 - .../proposal.md | 58 - .../specs/card-series-bindng/spec.md | 70 - .../specs/device-series-bindng/spec.md | 84 - .../tasks.md | 85 - .../任务完成报告.md | 167 - .../测试完成总结.md | 144 - .../.openspec.yaml | 2 - .../2026-01-28-add-order-payment/design.md | 282 - .../2026-01-28-add-order-payment/proposal.md | 70 - .../specs/order-management/spec.md | 85 - .../specs/order-payment/spec.md | 75 - .../specs/package-purchase-validation/spec.md | 67 - .../2026-01-28-add-order-payment/tasks.md | 106 - .../.openspec.yaml | 2 - .../design.md | 217 - .../proposal.md | 61 - .../specs/agent-available-packages/spec.md | 65 - .../specs/shop-commission-tier/spec.md | 77 - .../specs/shop-package-allocation/spec.md | 65 - .../specs/shop-series-allocation/spec.md | 103 - .../tasks.md | 167 - .../.openspec.yaml | 2 - .../COMPLETION_STATUS.md | 260 - .../FINAL_COMPLETION_REPORT.md | 818 - .../completion-summary.md | 392 - .../design.md | 584 - .../proposal.md | 74 - .../specs/agent-available-packages/spec.md | 58 - .../allocation-config-versioning/spec.md | 61 - .../specs/allocation-price-history/spec.md | 53 - .../specs/commission-stats-caching/spec.md | 81 - .../specs/shop-commission-tier/spec.md | 55 - .../shop-package-batch-allocation/spec.md | 101 - .../specs/shop-package-batch-pricing/spec.md | 29 - .../specs/shop-series-allocation/spec.md | 87 - .../tasks.md | 120 - .../test-migration-summary.md | 381 - .../tier-crud-removal-summary.md | 165 - .../.openspec.yaml | 2 - .../design.md | 169 - .../proposal.md | 59 - .../specs/test-infrastructure/spec.md | 115 - .../tasks.md | 51 - .../.openspec.yaml | 2 - .../design.md | 181 - .../proposal.md | 53 - .../enterprise-card-authorization/spec.md | 132 - .../enterprise-device-authorization/spec.md | 319 - .../tasks.md | 163 - .../.openspec.yaml | 2 - .../design.md | 592 - .../proposal.md | 77 - .../specs/commission-calculation/spec.md | 73 - .../specs/commission-record-query/spec.md | 67 - .../specs/one-time-commission-trigger/spec.md | 69 - .../tasks.md | 144 - .../.openspec.yaml | 2 - .../design.md | 99 - .../proposal.md | 27 - .../specs/role-request-validation/spec.md | 67 - .../tasks.md | 30 - .../.openspec.yaml | 3 - .../design.md | 48 - .../proposal.md | 25 - .../enterprise-card-authorization/spec.md | 45 - .../tasks.md | 18 - .../.openspec.yaml | 3 - .../design.md | 39 - .../proposal.md | 25 - .../specs/commission-trigger/spec.md | 122 - .../specs/order-commission-snapshot/spec.md | 60 - .../tasks.md | 24 - .../.openspec.yaml | 3 - .../design.md | 319 - .../proposal.md | 30 - .../specs/commission-calculation/spec.md | 80 - .../specs/one-time-commission-trigger/spec.md | 100 - .../tasks.md | 32 - .../.openspec.yaml | 3 - .../design.md | 105 - .../proposal.md | 26 - .../tasks.md | 56 - .../proposal.md | 227 - .../tasks.md | 164 - .../.openspec.yaml | 15 - .../design.md | 389 - .../proposal.md | 217 - .../specs/error-handling/spec.md | 337 - .../tasks.md | 243 - .../design.md | 543 - .../proposal.md | 191 - .../specs/ci-checks.md | 396 - .../specs/error-handling-updates.md | 298 - .../tasks.md | 372 - .../design.md | 380 - .../proposal.md | 274 - .../tasks.md | 281 - .../.openspec.yaml | 2 - .../design.md | 590 - .../proposal.md | 51 - .../specs/login-menu-button-response/spec.md | 198 - .../tasks.md | 114 - .../.openspec.yaml | 21 - .../design.md | 527 - .../proposal.md | 271 - .../specs/openapi-generation/spec.md | 143 - .../specs/personal-customer/spec.md | 137 - .../tasks.md | 273 - .../.openspec.yaml | 2 - .../design.md | 355 - .../proposal.md | 88 - .../specs/commission-calculation/spec.md | 17 - .../specs/commission-record-query/spec.md | 39 - .../specs/shop-commission-tier/spec.md | 47 - .../specs/shop-series-allocation/spec.md | 49 - .../tasks.md | 149 - .../.openspec.yaml | 2 - .../design.md | 368 - .../proposal.md | 62 - .../specs/wechat-official-account/spec.md | 147 - .../specs/wechat-payment/spec.md | 229 - .../status.yaml | 39 - .../tasks.md | 257 - .../.openspec.yaml | 2 - .../design.md | 724 - .../proposal.md | 82 - .../specs/commission-calculation/spec.md | 103 - .../specs/force-recharge-check/spec.md | 109 - .../specs/order-management/spec.md | 93 - .../specs/order-payment/spec.md | 75 - .../specs/purchase-on-behalf/spec.md | 139 - .../specs/shop-series-allocation/spec.md | 85 - .../specs/wallet-recharge/spec.md | 182 - .../tasks.md | 227 - .../.openspec.yaml | 2 - .../design.md | 267 - .../proposal.md | 76 - .../specs/order-management/spec.md | 118 - .../specs/shop-series-allocation/spec.md | 100 - .../tasks.md | 64 - .../2026-01-31-gateway-integration/design.md | 570 - .../proposal.md | 146 - .../specs/gateway-client/spec.md | 220 - .../specs/gateway-config/spec.md | 175 - .../specs/gateway-crypto/spec.md | 155 - .../2026-01-31-gateway-integration/tasks.md | 186 - .../.openspec.yaml | 2 - .../design.md | 369 - .../proposal.md | 63 - .../specs/device-import/spec.md | 127 - .../specs/iot-card-import-task/spec.md | 104 - .../tasks.md | 191 - .../.openspec.yaml | 2 - .../design.md | 432 - .../proposal.md | 84 - .../specs/card-series-bindng/spec.md | 114 - .../specs/device-series-bindng/spec.md | 128 - .../tasks.md | 191 - .../.openspec.yaml | 2 - .../design.md | 54 - .../proposal.md | 37 - .../specs/iot-card-import-task/spec.md | 76 - .../tasks.md | 18 - .../.openspec.yaml | 2 - .../design.md | 494 - .../proposal.md | 118 - .../specs/account-management/spec.md | 143 - .../specs/account-operation-audit/spec.md | 105 - .../specs/account-permission-check/spec.md | 127 - .../specs/unified-auth-api/spec.md | 86 - .../tasks.md | 171 - .../.openspec.yaml | 2 - .../design.md | 373 - .../proposal.md | 66 - .../specs/permission-check/spec.md | 226 - .../specs/shop-role-management/spec.md | 322 - .../2026-02-03-shop-role-inheritance/tasks.md | 266 - .../.openspec.yaml | 2 - .../design.md | 51 - .../proposal.md | 33 - .../specs/commission-trigger/spec.md | 9 - .../tasks.md | 19 - .../.openspec.yaml | 2 - .../design.md | 462 - .../proposal.md | 99 - .../accumulated-recharge-tracking/spec.md | 70 - .../specs/agent-available-packages/spec.md | 58 - .../specs/commission-calculation/spec.md | 72 - .../commission-chain-distribution/spec.md | 61 - .../specs/force-recharge-check/spec.md | 72 - .../specs/one-time-commission-trigger/spec.md | 99 - .../one-time-commission-validity/spec.md | 54 - .../specs/package-management/spec.md | 74 - .../specs/package-series-management/spec.md | 55 - .../specs/package-virtual-data/spec.md | 62 - .../specs/shop-commission-tier/spec.md | 53 - .../specs/shop-series-allocation/spec.md | 71 - .../tasks.md | 125 - .../consensus.md | 66 - .../design.md | 274 - .../proposal.md | 91 - .../specs/commission-calculation/spec.md | 147 - .../specs/commission-trigger/spec.md | 81 - .../specs/shop-series-allocation/spec.md | 166 - .../tasks.md | 174 - .../.openspec.yaml | 2 - .../design.md | 708 - .../proposal.md | 111 - .../specs/data-cleanup/spec.md | 315 - .../specs/iot-card/spec.md | 199 - .../specs/polling-alert/spec.md | 350 - .../specs/polling-carddata-check/spec.md | 196 - .../specs/polling-concurrency-control/spec.md | 226 - .../specs/polling-configuration/spec.md | 159 - .../specs/polling-manual-trigger/spec.md | 294 - .../specs/polling-monitoring/spec.md | 266 - .../specs/polling-package-check/spec.md | 254 - .../specs/polling-realname-check/spec.md | 172 - .../specs/polling-scheduler/spec.md | 187 - .../tasks.md | 224 - .../.openspec.yaml | 2 - .../consensus.md | 228 - .../design.md | 1468 - .../proposal.md | 114 - .../specs/addon-package-lifecycle/spec.md | 753 - .../specs/auto-stop-resume/spec.md | 391 - .../specs/iot-card/spec.md | 49 - .../specs/order-management/spec.md | 36 - .../specs/package-calendar-type/spec.md | 375 - .../specs/package-data-reset/spec.md | 809 - .../specs/package-management/spec.md | 575 - .../specs/package-queue-activation/spec.md | 430 - .../specs/package-realname-activation/spec.md | 972 - .../specs/package-usage-customer-view/spec.md | 367 - .../specs/package-usage-daily-record/spec.md | 465 - .../specs/package-usage-priority/spec.md | 420 - .../tasks.md | 253 - .../.openspec.yaml | 2 - .../design.md | 540 - .../proposal.md | 153 - .../specs/agent-wallet/spec.md | 318 - .../specs/card-wallet/spec.md | 333 - .../specs/wallet/spec.md | 78 - .../tasks.md | 208 - .../.openspec.yaml | 2 - .../design.md | 330 - .../proposal.md | 93 - .../specs/data-permission/spec.md | 90 - .../specs/data-scope-middleware/spec.md | 130 - .../tasks.md | 83 - .../.openspec.yaml | 2 - .../design.md | 403 - .../proposal.md | 95 - .../specs/admin-order-creation/spec.md | 248 - .../specs/order-payment/spec.md | 113 - .../tasks.md | 102 - .../.openspec.yaml | 2 - .../design.md | 85 - .../proposal.md | 31 - .../specs/agent-available-packages/spec.md | 49 - .../specs/allocation-shelf-status/spec.md | 52 - .../specs/package-management/spec.md | 37 - .../specs/package-purchase-validation/spec.md | 35 - .../tasks.md | 45 - .../.openspec.yaml | 2 - .../design.md | 188 - .../proposal.md | 54 - .../specs/agent-series-grant/spec.md | 181 - .../specs/force-recharge-check/spec.md | 75 - .../specs/shop-series-allocation/spec.md | 37 - .../tasks.md | 158 - .../.openspec.yaml | 2 - .../design.md | 66 - .../proposal.md | 47 - .../specs/agent-series-grant/spec.md | 109 - .../specs/package-series-management/spec.md | 38 - .../tasks.md | 55 - .../.openspec.yaml | 2 - .../design.md | 194 - .../proposal.md | 54 - .../specs/gateway-client/spec.md | 100 - .../specs/gateway-request-logging/spec.md | 33 - .../specs/gateway-retry/spec.md | 51 - .../specs/iot-card/spec.md | 89 - .../specs/iot-device/spec.md | 123 - .../tasks.md | 101 - .../.openspec.yaml | 2 - .../design.md | 121 - .../proposal.md | 72 - .../specs/asset-queries/spec.md | 166 - .../specs/asset-resolve/spec.md | 132 - .../specs/asset-suspend-resume/spec.md | 168 - .../specs/device/spec.md | 133 - .../specs/iot-card-import-task/spec.md | 81 - .../specs/iot-card/spec.md | 34 - .../specs/iot-package/spec.md | 63 - .../specs/polling-protect-consistency/spec.md | 46 - .../2026-03-14-asset-detail-refactor/tasks.md | 107 - .../.openspec.yaml | 2 - .../design.md | 353 - .../proposal.md | 60 - .../specs/asset-wallet-query/spec.md | 79 - .../specs/card-wallet/spec.md | 103 - .../tasks.md | 157 - .../.openspec.yaml | 2 - .../design.md | 364 - .../proposal.md | 61 - .../specs/agent-recharge/spec.md | 598 - .../specs/asset-recharge-adaptation/spec.md | 116 - .../specs/fuiou-payment/spec.md | 181 - .../specs/order-payment/spec.md | 184 - .../specs/wechat-config-management/spec.md | 997 - .../specs/wechat-payment/spec.md | 179 - .../tasks.md | 115 - .../.openspec.yaml | 2 - .../design.md | 164 - .../proposal.md | 67 - .../specs/agent-retail-price/spec.md | 51 - .../specs/asset-generation/spec.md | 55 - .../specs/asset-lifecycle-status/spec.md | 41 - .../specs/asset-recharge-adaptation/spec.md | 24 - .../specs/carrier-realname-config/spec.md | 44 - .../specs/device/spec.md | 15 - .../specs/h5-legacy-cleanup/spec.md | 47 - .../specs/iot-card/spec.md | 15 - .../specs/iot-order/spec.md | 19 - .../specs/one-time-commission-trigger/spec.md | 19 - .../specs/package-purchase-validation/spec.md | 31 - .../specs/personal-customer/spec.md | 13 - .../specs/wallet-recharge/spec.md | 24 - .../tasks.md | 111 - .../.openspec.yaml | 2 - .../2026-03-19-client-auth-system/design.md | 171 - .../2026-03-19-client-auth-system/proposal.md | 135 - .../specs/client-asset-token/spec.md | 71 - .../specs/client-phone-binding/spec.md | 94 - .../specs/client-token-management/spec.md | 57 - .../specs/client-wechat-login/spec.md | 105 - .../specs/personal-customer-openid/spec.md | 37 - .../specs/personal-customer/spec.md | 52 - .../specs/wechat-official-account/spec.md | 47 - .../2026-03-19-client-auth-system/tasks.md | 70 - .../.openspec.yaml | 2 - .../design.md | 177 - .../proposal.md | 175 - .../specs/client-asset-info/spec.md | 41 - .../specs/client-device-capability/spec.md | 51 - .../specs/client-order-purchase/spec.md | 46 - .../specs/client-realname-link/spec.md | 23 - .../specs/client-wallet-recharge/spec.md | 51 - .../specs/force-recharge-check/spec.md | 21 - .../specs/wallet-recharge/spec.md | 33 - .../tasks.md | 70 - .../.openspec.yaml | 2 - .../design.md | 149 - .../proposal.md | 162 - .../specs/card-replacement/spec.md | 31 - .../specs/device/spec.md | 24 - .../specs/exchange-admin-management/spec.md | 121 - .../exchange-client-notification/spec.md | 35 - .../specs/exchange-data-migration/spec.md | 60 - .../specs/exchange-order-model/spec.md | 69 - .../specs/iot-card/spec.md | 23 - .../specs/personal-customer/spec.md | 21 - .../tasks.md | 37 - .../.openspec.yaml | 2 - .../2026-03-28-add-refund-system/design.md | 126 - .../2026-03-28-add-refund-system/proposal.md | 32 - .../specs/refund-api/spec.md | 56 - .../specs/refund-asset-reset/spec.md | 49 - .../specs/refund-commission-deduct/spec.md | 26 - .../specs/refund-request/spec.md | 40 - .../2026-03-28-add-refund-system/tasks.md | 63 - .../.openspec.yaml | 2 - .../design.md | 65 - .../proposal.md | 33 - .../specs/admin-order-creation/spec.md | 12 - .../specs/asset-lifecycle-status/spec.md | 27 - .../specs/client-order-purchase/spec.md | 12 - .../specs/commission-pending-review/spec.md | 15 - .../specs/fuiou-payment/spec.md | 19 - .../tasks.md | 46 - .../.openspec.yaml | 2 - .../design.md | 85 - .../proposal.md | 32 - .../specs/admin-order-creation/spec.md | 12 - .../specs/asset-queries/spec.md | 8 - .../specs/asset-suspend-resume/spec.md | 12 - .../specs/client-order-purchase/spec.md | 14 - .../tasks.md | 48 - .../.openspec.yaml | 2 - .../design.md | 188 - .../proposal.md | 57 - .../specs/carrier/spec.md | 16 - .../specs/iot-card/spec.md | 37 - .../specs/package-usage-daily-record/spec.md | 16 - .../specs/traffic-daily-buffer/spec.md | 30 - .../specs/traffic-query-service/spec.md | 15 - .../tasks.md | 125 - .../.openspec.yaml | 2 - .../design.md | 81 - .../proposal.md | 44 - .../specs/auto-resume-on-purchase/spec.md | 36 - .../specs/auto-resume-on-reset/spec.md | 37 - .../specs/auto-stop-resume/spec.md | 56 - .../specs/package-queue-activation/spec.md | 46 - .../tasks.md | 80 - .../.openspec.yaml | 2 - .../design.md | 81 - .../proposal.md | 34 - .../specs/auto-stop-resume/spec.md | 31 - .../device-package-exhausted-stop/spec.md | 31 - .../specs/polling-protect-consistency/spec.md | 54 - .../tasks.md | 52 - .../.openspec.yaml | 2 - .../design.md | 75 - .../proposal.md | 33 - .../specs/asset-historical-orders/spec.md | 108 - .../tasks.md | 54 - .../.openspec.yaml | 2 - .../design.md | 131 - .../proposal.md | 53 - .../specs/asset-identifier-registry/spec.md | 46 - .../specs/asset-identifier-routes/spec.md | 78 - .../specs/asset-resolve/spec.md | 69 - .../specs/client-order-purchase/spec.md | 35 - .../specs/order-management/spec.md | 66 - .../specs/package-purchase-validation/spec.md | 19 - .../tasks.md | 81 - .../.openspec.yaml | 2 - .../design.md | 64 - .../proposal.md | 38 - .../specs/device-import/spec.md | 22 - .../specs/iot-card-import-task/spec.md | 40 - .../tasks.md | 66 - .../.openspec.yaml | 2 - .../design.md | 837 - .../proposal.md | 141 - .../specs/polling-config-manager/spec.md | 118 - .../specs/polling-queue-manager/spec.md | 173 - .../specs/polling-stop-resume-logic/spec.md | 164 - .../specs/polling-task-handlers/spec.md | 269 - .../tasks.md | 1554 - .../.openspec.yaml | 2 - .../design.md | 45 - .../proposal.md | 31 - .../specs/asset-resolve/spec.md | 58 - .../tasks.md | 20 - .../.openspec.yaml | 2 - .../design.md | 188 - .../proposal.md | 156 - .../specs/agent-fund-summary/spec.md | 63 - .../specs/agent-wallet/spec.md | 20 - .../specs/commission-record-query/spec.md | 150 - .../specs/main-wallet-transactions/spec.md | 65 - .../2026-04-09-agent-fund-visibility/tasks.md | 90 - .../.openspec.yaml | 2 - .../design.md | 57 - .../proposal.md | 31 - .../specs/device-import/spec.md | 101 - .../specs/iot-card-import-task/spec.md | 98 - .../2026-04-09-excel-import-refactor/tasks.md | 33 - .../.openspec.yaml | 2 - .../design.md | 92 - .../proposal.md | 42 - .../specs/iot-card-device-snapshot/spec.md | 59 - .../tasks.md | 39 - .../.openspec.yaml | 2 - .../2026-04-10-order-buyer-snapshot/design.md | 95 - .../proposal.md | 34 - .../specs/client-order-purchase/spec.md | 21 - .../specs/iot-order/spec.md | 28 - .../specs/order-management/spec.md | 52 - .../2026-04-10-order-buyer-snapshot/tasks.md | 55 - .../.openspec.yaml | 2 - .../design.md | 62 - .../proposal.md | 34 - .../specs/status-convention/spec.md | 29 - .../tasks.md | 41 - .../.openspec.yaml | 2 - .../design.md | 136 - .../proposal.md | 43 - .../client-realname-auto-trigger/spec.md | 64 - .../specs/polling-manual-trigger/spec.md | 151 - .../tasks.md | 52 - .../.openspec.yaml | 2 - .../2026-04-14-tech-debt-cleanup/design.md | 340 - .../2026-04-14-tech-debt-cleanup/proposal.md | 46 - .../specs/api-doc-coverage/spec.md | 45 - .../specs/dto-name-fields/spec.md | 83 - .../specs/payment-dynamic-config/spec.md | 69 - .../specs/polling-status-constants/spec.md | 44 - .../2026-04-14-tech-debt-cleanup/tasks.md | 298 - .../.openspec.yaml | 2 - .../design.md | 63 - .../proposal.md | 43 - .../specs/polling-card-status-task/spec.md | 77 - .../specs/polling-task-handlers/spec.md | 81 - .../tasks.md | 57 - .../.openspec.yaml | 2 - .../design.md | 143 - .../proposal.md | 41 - .../specs/asset-recharge-adaptation/spec.md | 30 - .../specs/client-order-purchase/spec.md | 33 - .../specs/force-recharge-check/spec.md | 14 - .../specs/order-payment/spec.md | 29 - .../specs/payment-record/spec.md | 40 - .../specs/recharge-order/spec.md | 50 - .../specs/wallet-recharge/spec.md | 31 - .../tasks.md | 79 - .../.openspec.yaml | 2 - .../design.md | 123 - .../proposal.md | 38 - .../specs/package-queue-activation/spec.md | 65 - .../specs/time-field-nullable-fix/spec.md | 66 - .../tasks.md | 49 - .../.openspec.yaml | 2 - .../design.md | 274 - .../proposal.md | 56 - .../tasks.md | 243 - .../.openspec.yaml | 2 - .../design.md | 57 - .../proposal.md | 32 - .../agent-recharge-payment-voucher/spec.md | 43 - .../tasks.md | 32 - .../.openspec.yaml | 2 - .../design.md | 86 - .../proposal.md | 48 - .../specs/asset-realname-policy/spec.md | 169 - .../specs/client-order-purchase/spec.md | 60 - .../specs/client-realname-link/spec.md | 45 - .../specs/client-wallet-recharge/spec.md | 43 - .../specs/device-import/spec.md | 31 - .../specs/iot-card-import-task/spec.md | 31 - .../2026-04-17-asset-realname-policy/tasks.md | 83 - .../.openspec.yaml | 2 - .../design.md | 62 - .../proposal.md | 27 - .../fund-summary-primary-account/spec.md | 24 - .../tasks.md | 14 - .../.openspec.yaml | 2 - .../design.md | 100 - .../proposal.md | 49 - .../specs/asset-queries/spec.md | 78 - .../spec.md | 44 - .../tasks.md | 32 - .../.openspec.yaml | 2 - .../design.md | 117 - .../proposal.md | 45 - .../specs/package-realname-activation/spec.md | 80 - .../specs/polling-task-handlers/spec.md | 69 - .../tasks.md | 89 - .../.openspec.yaml | 2 - .../design.md | 74 - .../proposal.md | 34 - .../specs/global-operation-password/spec.md | 58 - .../tasks.md | 55 - .../.openspec.yaml | 2 - .../baseline-evidence.md | 36 - .../design.md | 80 - .../proposal.md | 36 - .../specs/asset-queries/spec.md | 14 - .../specs/package-usage-priority/spec.md | 16 - .../specs/polling-task-handlers/spec.md | 18 - .../tasks.md | 29 - .../.openspec.yaml | 2 - .../design.md | 160 - .../proposal.md | 39 - .../specs/asset-operation-audit/spec.md | 64 - .../specs/auto-stop-resume/spec.md | 35 - .../specs/iot-device/spec.md | 31 - .../tasks.md | 60 - .../验收准备.md | 58 - .../.openspec.yaml | 2 - .../design.md | 111 - .../proposal.md | 32 - .../specs/device-import/spec.md | 178 - .../tasks.md | 17 - .../手工验收样例.md | 50 - .../.openspec.yaml | 2 - .../design.md | 109 - .../proposal.md | 38 - .../specs/agent-order-role-tracking/spec.md | 93 - .../specs/commission-calculation/spec.md | 71 - .../specs/commission-trigger/spec.md | 72 - .../specs/order-management/spec.md | 37 - .../specs/purchase-on-behalf/spec.md | 75 - .../tasks.md | 35 - .../.openspec.yaml | 2 - .../design.md | 134 - .../proposal.md | 42 - .../specs/polling-stop-resume-logic/spec.md | 44 - .../specs/polling-task-handlers/spec.md | 58 - .../tasks.md | 190 - .../.openspec.yaml | 2 - .../design.md | 186 - .../proposal.md | 39 - .../specs/iot-card-import-task/spec.md | 73 - .../specs/iot-card/spec.md | 121 - .../tasks.md | 82 - .../.openspec.yaml | 2 - .../design.md | 122 - .../proposal.md | 26 - .../asset-audit-readable-content/spec.md | 49 - .../specs/device-signal-summary/spec.md | 65 - .../tasks.md | 31 - .../.openspec.yaml | 2 - .../design.md | 89 - .../proposal.md | 34 - .../specs/agent-series-grant/spec.md | 17 - .../specs/client-asset-info/spec.md | 13 - .../specs/client-order-purchase/spec.md | 17 - .../specs/gift-package-policy/spec.md | 49 - .../specs/package-management/spec.md | 29 - .../specs/package-price-policy/spec.md | 57 - .../specs/package-purchase-validation/spec.md | 48 - .../tasks.md | 33 - .../实施基线与手工验证清单.md | 98 - .../.openspec.yaml | 2 - .../design.md | 164 - .../proposal.md | 38 - .../specs/asset-queries/spec.md | 53 - .../specs/asset-resolve/spec.md | 29 - .../specs/auto-stop-resume/spec.md | 27 - .../specs/client-asset-info/spec.md | 46 - .../specs/iot-package/spec.md | 39 - .../specs/package-usage-priority/spec.md | 22 - .../specs/traffic-model-semantics/spec.md | 56 - .../tasks.md | 34 - .../.openspec.yaml | 2 - .../design.md | 155 - .../proposal.md | 40 - .../specs/unified-export-task-system/spec.md | 129 - .../tasks.md | 54 - .../.openspec.yaml | 2 - .../2026-05-06-split-worker-roles/design.md | 99 - .../2026-05-06-split-worker-roles/proposal.md | 63 - .../specs/embedded-config/spec.md | 45 - .../specs/worker-role-management/spec.md | 125 - .../2026-05-06-split-worker-roles/tasks.md | 38 - .../.openspec.yaml | 2 - .../2026-05-11-add-agent-open-api/design.md | 176 - .../2026-05-11-add-agent-open-api/proposal.md | 47 - .../specs/agent-open-api/spec.md | 250 - .../2026-05-11-add-agent-open-api/tasks.md | 51 - .../.openspec.yaml | 2 - .../design.md | 169 - .../proposal.md | 39 - .../specs/agent-recharge/spec.md | 181 - .../tasks.md | 26 - .../ARCHIVED.md | 49 - .../NEXT_STEPS.md | 354 - .../PROGRESS.md | 316 - .../design.md | 63 - .../proposal.md | 62 - .../specs/error-handling/spec.md | 43 - .../specs/openapi-generation/spec.md | 28 - .../tasks.md | 59 - .../.openspec.yaml | 2 - .../build-multi-view-audit-center/design.md | 364 - .../build-multi-view-audit-center/proposal.md | 44 - .../specs/account-operation-audit/spec.md | 120 - .../asset-audit-readable-content/spec.md | 142 - .../specs/audit-event-recording/spec.md | 153 - .../specs/audit-governance-cutover/spec.md | 122 - .../specs/audit-investigation-queries/spec.md | 193 - .../specs/audit-log-retention/spec.md | 88 - .../integration-log-investigation/spec.md | 159 - .../specs/scoped-resource-activity/spec.md | 125 - .../build-multi-view-audit-center/tasks.md | 117 - .../.openspec.yaml | 2 - .../design.md | 255 - .../proposal.md | 41 - .../july-iteration-delivery-contract/spec.md | 95 - .../july-iteration-master-ledger/spec.md | 52 - .../july-iteration-test-release-gate/spec.md | 66 - .../tasks.md | 251 - .../.openspec.yaml | 2 - .../design.md | 89 - .../proposal.md | 32 - .../specs/error-code-validation/spec.md | 47 - .../specs/error-handling/spec.md | 78 - .../tasks.md | 34 - .../.openspec.yaml | 2 - .../design.md | 164 - .../proposal.md | 53 - .../specs/agent-recharge/spec.md | 27 - .../specs/agent-wallet/spec.md | 13 - .../specs/asset-package-batch-order/spec.md | 19 - .../specs/asset-queries/spec.md | 13 - .../specs/asset-realname-policy/spec.md | 23 - .../specs/asset-speed-tier-management/spec.md | 16 - .../specs/business-data-export/spec.md | 15 - .../specs/card-replacement/spec.md | 16 - .../specs/device/spec.md | 16 - .../specs/exchange-admin-management/spec.md | 9 - .../exchange-client-notification/spec.md | 13 - .../specs/order-management/spec.md | 19 - .../specs/package-expiration-reminder/spec.md | 16 - .../specs/package-management/spec.md | 16 - .../specs/payment-dynamic-config/spec.md | 46 - .../specs/refund-api/spec.md | 35 - .../specs/shop-client-login-control/spec.md | 20 - .../specs/wecom-approval-integration/spec.md | 60 - .../tasks.md | 61 - .../实施证据.md | 77 - .../fix-order-price-semantics/.openspec.yaml | 2 - .../fix-order-price-semantics/design.md | 77 - .../fix-order-price-semantics/proposal.md | 41 - .../specs/admin-order-creation/spec.md | 79 - .../specs/client-order-purchase/spec.md | 40 - .../spec.md | 81 - .../fix-order-price-semantics/tasks.md | 42 - .../.openspec.yaml | 2 - .../design.md | 120 - .../proposal.md | 36 - .../specs/package-queue-activation/spec.md | 99 - .../tasks.md | 29 - .../refactor-export-datasource/.openspec.yaml | 2 - .../refactor-export-datasource/design.md | 84 - .../refactor-export-datasource/proposal.md | 32 - .../specs/export-datasource/spec.md | 52 - .../specs/export-query-params/spec.md | 41 - .../specs/unified-export-task-system/spec.md | 61 - .../refactor-export-datasource/tasks.md | 52 - .../.openspec.yaml | 2 - .../design.md | 137 - .../proposal.md | 43 - .../specs/qicheng-migration-control/spec.md | 143 - .../tasks.md | 55 - openspec/config.yaml | 146 - openspec/specs/account-management/spec.md | 143 - .../specs/account-operation-audit/spec.md | 105 - .../specs/account-permission-check/spec.md | 127 - .../specs/addon-package-lifecycle/spec.md | 753 - openspec/specs/admin-order-creation/spec.md | 263 - .../specs/agent-available-packages/spec.md | 70 - openspec/specs/agent-fund-summary/spec.md | 68 - openspec/specs/agent-funds-commission/spec.md | 67 + openspec/specs/agent-open-api/spec.md | 260 +- .../specs/agent-order-role-tracking/spec.md | 167 - .../agent-recharge-payment-voucher/spec.md | 43 - openspec/specs/agent-recharge/spec.md | 577 - openspec/specs/agent-retail-price/spec.md | 54 - openspec/specs/agent-series-grant/spec.md | 224 - openspec/specs/agent-wallet/spec.md | 339 - .../allocation-config-versioning/spec.md | 67 - .../specs/allocation-price-history/spec.md | 59 - .../specs/allocation-shelf-status/spec.md | 58 - openspec/specs/api-doc-coverage/spec.md | 45 - .../specs/asset-allocation-record/spec.md | 123 - .../asset-audit-readable-content/spec.md | 53 - openspec/specs/asset-device/spec.md | 55 + openspec/specs/asset-generation/spec.md | 59 - .../specs/asset-historical-orders/spec.md | 106 - .../specs/asset-identifier-registry/spec.md | 52 - .../specs/asset-identifier-routes/spec.md | 86 - openspec/specs/asset-lifecycle-status/spec.md | 45 - openspec/specs/asset-queries/spec.md | 190 - openspec/specs/asset-realname-policy/spec.md | 171 - .../specs/asset-recharge-adaptation/spec.md | 150 - openspec/specs/asset-resolve/spec.md | 205 - openspec/specs/asset-suspend-resume/spec.md | 189 - openspec/specs/asset-wallet-query/spec.md | 84 - openspec/specs/auth/spec.md | 215 - openspec/specs/authorization-record/spec.md | 112 - .../specs/auto-resume-on-purchase/spec.md | 36 - openspec/specs/auto-resume-on-reset/spec.md | 37 - openspec/specs/auto-stop-resume/spec.md | 482 - openspec/specs/b-end-auth/spec.md | 143 - openspec/specs/bootstrap-init/spec.md | 78 - openspec/specs/card-replacement/spec.md | 219 - openspec/specs/card-series-bindng/spec.md | 70 - openspec/specs/card-wallet/spec.md | 274 - .../specs/carrier-realname-config/spec.md | 48 - openspec/specs/carrier/spec.md | 16 - openspec/specs/client-asset-info/spec.md | 47 - openspec/specs/client-asset-token/spec.md | 73 - .../specs/client-device-capability/spec.md | 51 - openspec/specs/client-order-purchase/spec.md | 109 - openspec/specs/client-phone-binding/spec.md | 96 - .../client-realname-auto-trigger/spec.md | 64 - openspec/specs/client-realname-link/spec.md | 47 - .../specs/client-token-management/spec.md | 59 - openspec/specs/client-wallet-recharge/spec.md | 75 - openspec/specs/client-wechat-login/spec.md | 107 - openspec/specs/commission-calculation/spec.md | 192 - .../specs/commission-record-query/spec.md | 160 - .../specs/commission-stats-caching/spec.md | 87 - openspec/specs/commission-trigger/spec.md | 124 - openspec/specs/data-permission/spec.md | 60 - openspec/specs/data-scope-middleware/spec.md | 130 - openspec/specs/dependency-injection/spec.md | 56 - openspec/specs/device-import/spec.md | 301 - .../device-package-exhausted-stop/spec.md | 61 - openspec/specs/device-series-bindng/spec.md | 84 - openspec/specs/device-signal-summary/spec.md | 69 - openspec/specs/device/spec.md | 397 - openspec/specs/dto-name-fields/spec.md | 83 - openspec/specs/embedded-config/spec.md | 157 - .../enterprise-card-authorization/spec.md | 180 - .../enterprise-device-authorization/spec.md | 319 - openspec/specs/error-code-validation/spec.md | 91 - openspec/specs/error-handling/spec.md | 269 - .../specs/exchange-admin-management/spec.md | 127 - .../exchange-client-notification/spec.md | 41 - .../specs/exchange-data-migration/spec.md | 66 - openspec/specs/exchange-order-model/spec.md | 75 - openspec/specs/export-task/spec.md | 25 + openspec/specs/external-integration/spec.md | 95 + openspec/specs/force-recharge-check/spec.md | 165 - openspec/specs/fuiou-payment/spec.md | 181 - .../fund-summary-primary-account/spec.md | 29 - openspec/specs/gateway-client/spec.md | 260 - openspec/specs/gateway-config/spec.md | 175 - openspec/specs/gateway-crypto/spec.md | 155 - .../specs/gateway-request-logging/spec.md | 39 - openspec/specs/gateway-retry/spec.md | 57 - .../specs/global-operation-password/spec.md | 56 - openspec/specs/h5-legacy-cleanup/spec.md | 51 - openspec/specs/identity-access/spec.md | 59 + openspec/specs/iot-agent-commission/spec.md | 345 - .../specs/iot-card-device-snapshot/spec.md | 59 - openspec/specs/iot-card-import-task/spec.md | 370 - openspec/specs/iot-card/spec.md | 37 - openspec/specs/iot-device/spec.md | 515 - openspec/specs/iot-number-card/spec.md | 174 - openspec/specs/iot-order/spec.md | 312 - openspec/specs/iot-package/spec.md | 247 - openspec/specs/legacy-cleanup/spec.md | 73 - .../specs/login-menu-button-response/spec.md | 209 - .../specs/main-wallet-transactions/spec.md | 70 - openspec/specs/model-organization/spec.md | 162 - openspec/specs/notification-delivery/spec.md | 39 + openspec/specs/object-storage/spec.md | 219 - .../specs/one-time-commission-trigger/spec.md | 162 - openspec/specs/openapi-generation/spec.md | 267 - .../openapi-markdown-description/spec.md | 60 - openspec/specs/operations-audit/spec.md | 29 + .../specs/order-commission-snapshot/spec.md | 62 - openspec/specs/order-expiration/spec.md | 237 - openspec/specs/order-management/spec.md | 289 - openspec/specs/order-payment-wallet/spec.md | 57 + openspec/specs/order-payment/spec.md | 565 - openspec/specs/order-refund-exchange/spec.md | 37 + openspec/specs/package-calendar-type/spec.md | 375 - openspec/specs/package-data-reset/spec.md | 809 - openspec/specs/package-lifecycle/spec.md | 59 + openspec/specs/package-management/spec.md | 275 - .../specs/package-purchase-validation/spec.md | 139 - .../specs/package-queue-activation/spec.md | 413 - .../specs/package-realname-activation/spec.md | 1055 - .../specs/package-series-management/spec.md | 136 - .../specs/package-usage-customer-view/spec.md | 367 - .../specs/package-usage-daily-record/spec.md | 16 - .../spec.md | 50 - openspec/specs/package-usage-priority/spec.md | 420 - openspec/specs/payment-dynamic-config/spec.md | 69 - openspec/specs/permission-check/spec.md | 347 - .../specs/personal-customer-openid/spec.md | 39 - openspec/specs/personal-customer/spec.md | 453 +- .../specs/polling-card-status-task/spec.md | 75 - openspec/specs/polling-config-manager/spec.md | 43 - openspec/specs/polling-manual-trigger/spec.md | 147 - openspec/specs/polling-operations/spec.md | 55 + .../specs/polling-protect-consistency/spec.md | 109 - openspec/specs/polling-queue-manager/spec.md | 171 - .../specs/polling-status-constants/spec.md | 44 - .../specs/polling-stop-resume-logic/spec.md | 162 - openspec/specs/polling-task-handlers/spec.md | 421 - openspec/specs/purchase-on-behalf/spec.md | 276 - openspec/specs/refund-api/spec.md | 56 - openspec/specs/refund-asset-reset/spec.md | 74 - .../specs/refund-commission-deduct/spec.md | 26 - openspec/specs/refund-request/spec.md | 40 - openspec/specs/role-permission/spec.md | 251 - .../specs/shop-account-management/spec.md | 177 - openspec/specs/shop-commission-tier/spec.md | 85 - openspec/specs/shop-management/spec.md | 136 - .../shop-package-batch-allocation/spec.md | 107 - .../specs/shop-package-batch-pricing/spec.md | 35 - openspec/specs/shop-role-management/spec.md | 323 - openspec/specs/shop-series-allocation/spec.md | 218 - openspec/specs/status-convention/spec.md | 29 - openspec/specs/system-operations/spec.md | 43 + openspec/specs/tag/spec.md | 276 - openspec/specs/testing-standards/spec.md | 264 - openspec/specs/traffic-daily-buffer/spec.md | 30 - openspec/specs/traffic-query-service/spec.md | 15 - openspec/specs/unified-auth-api/spec.md | 86 - openspec/specs/user-organization/spec.md | 269 - openspec/specs/wallet-recharge/spec.md | 242 - openspec/specs/wallet/spec.md | 88 - .../specs/wechat-config-management/spec.md | 997 - .../specs/wechat-official-account/spec.md | 193 - openspec/specs/wechat-payment/spec.md | 411 - openspec/specs/worker-role-management/spec.md | 130 - pkg/asynctask/contract_test.go | 105 - pkg/idempotency/fingerprint_test.go | 58 - pkg/idempotency/postgres_integration_test.go | 86 - pkg/logger/middleware_test.go | 242 - pkg/queue/client_test.go | 17 - .../test_batch_device_recall.cpython-313.pyc | Bin 6509 -> 0 bytes .../test_batch_device_recall.py | 127 - scripts/batch_exchange/test_batch_exchange.py | 172 - .../test_batch_update_package_expiry.py | 110 - scripts/benchmark/README.md | 54 - scripts/benchmark/generate_cards.go | 224 - scripts/benchmark/init_config.go | 156 - scripts/benchmark/mock_gateway.go | 263 - scripts/benchmark/monitor.sh | 224 - scripts/benchmark/start_redis.sh | 48 - scripts/context-health.sh | 88 + scripts/test-tech-public-foundation.sh | 27 - .../checklists/requirements.md | 84 - .../contracts/api.yaml | 432 - .../data-model.md | 828 - .../optional-improvements.md | 218 - .../001-fiber-middleware-integration/plan.md | 386 - .../quickstart.md | 925 - .../research.md | 679 - .../001-fiber-middleware-integration/spec.md | 282 - .../001-fiber-middleware-integration/tasks.md | 510 - .../checklists/requirements.md | 41 - .../contracts/api.yaml | 733 - specs/002-gorm-postgres-asynq/data-model.md | 644 - specs/002-gorm-postgres-asynq/plan.md | 195 - specs/002-gorm-postgres-asynq/quickstart.md | 829 - specs/002-gorm-postgres-asynq/research.md | 901 - specs/002-gorm-postgres-asynq/spec.md | 194 - specs/002-gorm-postgres-asynq/tasks.md | 393 - .../checklists/requirements.md | 42 - .../contracts/error-responses.yaml | 489 - specs/003-error-handling/data-model.md | 389 - specs/003-error-handling/plan.md | 364 - specs/003-error-handling/quickstart.md | 541 - specs/003-error-handling/research.md | 376 - specs/003-error-handling/spec.md | 178 - specs/003-error-handling/tasks.md | 265 - .../checklists/requirements.md | 56 - .../contracts/README.md | 263 - .../contracts/account-api.yaml | 616 - .../contracts/api.yaml | 1480 - .../contracts/permission-api.yaml | 482 - .../contracts/role-api.yaml | 588 - specs/004-rbac-data-permission/data-model.md | 508 - specs/004-rbac-data-permission/plan.md | 268 - specs/004-rbac-data-permission/quickstart.md | 602 - specs/004-rbac-data-permission/research.md | 498 - specs/004-rbac-data-permission/spec.md | 226 - specs/004-rbac-data-permission/tasks.md | 439 - tests/agent_open_api/README.md | 61 - tests/agent_open_api/main.go | 473 - 1900 files changed, 1552 insertions(+), 348365 deletions(-) delete mode 100644 .agents/rules/ponytail.md delete mode 100644 .agents/skills/ask-matt/SKILL.md delete mode 100644 .agents/skills/ask-matt/agents/openai.yaml delete mode 100644 .agents/skills/caveman/SKILL.md delete mode 100644 .agents/skills/code-review/SKILL.md delete mode 100644 .agents/skills/code-review/agents/openai.yaml delete mode 100644 .agents/skills/codebase-design/DEEPENING.md delete mode 100644 .agents/skills/codebase-design/DESIGN-IT-TWICE.md delete mode 100644 .agents/skills/codebase-design/SKILL.md delete mode 100644 .agents/skills/codebase-design/agents/openai.yaml delete mode 100644 .agents/skills/diagnose/SKILL.md delete mode 100644 .agents/skills/diagnose/scripts/hitl-loop.template.sh delete mode 100644 .agents/skills/diagnosing-bugs/SKILL.md delete mode 100644 .agents/skills/diagnosing-bugs/agents/openai.yaml delete mode 100644 .agents/skills/diagnosing-bugs/scripts/hitl-loop.template.sh delete mode 100644 .agents/skills/domain-modeling/ADR-FORMAT.md delete mode 100644 .agents/skills/domain-modeling/CONTEXT-FORMAT.md delete mode 100644 .agents/skills/domain-modeling/SKILL.md delete mode 100644 .agents/skills/domain-modeling/agents/openai.yaml delete mode 100644 .agents/skills/grill-me/SKILL.md delete mode 100644 .agents/skills/grill-me/agents/openai.yaml delete mode 100644 .agents/skills/grill-with-docs/SKILL.md delete mode 100644 .agents/skills/grill-with-docs/agents/openai.yaml delete mode 100644 .agents/skills/grilling/SKILL.md delete mode 100644 .agents/skills/grilling/agents/openai.yaml delete mode 100644 .agents/skills/handoff/SKILL.md delete mode 100644 .agents/skills/handoff/agents/openai.yaml delete mode 100644 .agents/skills/implement/SKILL.md delete mode 100644 .agents/skills/implement/agents/openai.yaml delete mode 100644 .agents/skills/improve-codebase-architecture/HTML-REPORT.md delete mode 100644 .agents/skills/improve-codebase-architecture/SKILL.md delete mode 100644 .agents/skills/improve-codebase-architecture/agents/openai.yaml delete mode 100644 .agents/skills/prototype/LOGIC.md delete mode 100644 .agents/skills/prototype/SKILL.md delete mode 100644 .agents/skills/prototype/UI.md delete mode 100644 .agents/skills/prototype/agents/openai.yaml delete mode 100644 .agents/skills/research/SKILL.md delete mode 100644 .agents/skills/research/agents/openai.yaml delete mode 100644 .agents/skills/resolving-merge-conflicts/SKILL.md delete mode 100644 .agents/skills/resolving-merge-conflicts/agents/openai.yaml delete mode 100644 .agents/skills/setup-matt-pocock-skills/SKILL.md delete mode 100644 .agents/skills/setup-matt-pocock-skills/agents/openai.yaml delete mode 100644 .agents/skills/setup-matt-pocock-skills/domain.md delete mode 100644 .agents/skills/setup-matt-pocock-skills/issue-tracker-github.md delete mode 100644 .agents/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md delete mode 100644 .agents/skills/setup-matt-pocock-skills/issue-tracker-local.md delete mode 100644 .agents/skills/setup-matt-pocock-skills/triage-labels.md delete mode 100644 .agents/skills/tdd/SKILL.md delete mode 100644 .agents/skills/tdd/agents/openai.yaml delete mode 100644 .agents/skills/tdd/mocking.md delete mode 100644 .agents/skills/tdd/tests.md delete mode 100644 .agents/skills/teach/GLOSSARY-FORMAT.md delete mode 100644 .agents/skills/teach/LEARNING-RECORD-FORMAT.md delete mode 100644 .agents/skills/teach/MISSION-FORMAT.md delete mode 100644 .agents/skills/teach/RESOURCES-FORMAT.md delete mode 100644 .agents/skills/teach/SKILL.md delete mode 100644 .agents/skills/teach/agents/openai.yaml delete mode 100644 .agents/skills/to-issues/SKILL.md delete mode 100644 .agents/skills/to-prd/SKILL.md delete mode 100644 .agents/skills/to-spec/SKILL.md delete mode 100644 .agents/skills/to-spec/agents/openai.yaml delete mode 100644 .agents/skills/to-tickets/SKILL.md delete mode 100644 .agents/skills/to-tickets/agents/openai.yaml delete mode 100644 .agents/skills/triage/AGENT-BRIEF.md delete mode 100644 .agents/skills/triage/OUT-OF-SCOPE.md delete mode 100644 .agents/skills/triage/SKILL.md delete mode 100644 .agents/skills/triage/agents/openai.yaml delete mode 100644 .agents/skills/wayfinder/SKILL.md delete mode 100644 .agents/skills/wayfinder/agents/openai.yaml delete mode 100644 .agents/skills/write-a-skill/SKILL.md delete mode 100644 .agents/skills/writing-great-skills/GLOSSARY.md delete mode 100644 .agents/skills/writing-great-skills/SKILL.md delete mode 100644 .agents/skills/writing-great-skills/agents/openai.yaml delete mode 100644 .agents/skills/zoom-out/SKILL.md delete mode 100644 .claude/settings.json delete mode 100644 .claude/skills/api-routing/SKILL.md delete mode 120000 .claude/skills/ask-matt delete mode 120000 .claude/skills/caveman delete mode 120000 .claude/skills/code-review delete mode 120000 .claude/skills/codebase-design delete mode 100644 .claude/skills/comment-standards/SKILL.md delete mode 100644 .claude/skills/db-migration/SKILL.md delete mode 100644 .claude/skills/db-validation/SKILL.md delete mode 120000 .claude/skills/diagnose delete mode 120000 .claude/skills/diagnosing-bugs delete mode 100644 .claude/skills/doc-management/SKILL.md delete mode 120000 .claude/skills/domain-modeling delete mode 100644 .claude/skills/dto-standards/SKILL.md delete mode 120000 .claude/skills/grill-me delete mode 120000 .claude/skills/grill-with-docs delete mode 120000 .claude/skills/grilling delete mode 120000 .claude/skills/handoff delete mode 100644 .claude/skills/hurl-test/SKILL.md delete mode 120000 .claude/skills/implement delete mode 120000 .claude/skills/improve-codebase-architecture delete mode 100644 .claude/skills/model-standards/SKILL.md delete mode 100644 .claude/skills/openspec-api-contract/SKILL.md delete mode 100644 .claude/skills/openspec-lock-consensus/SKILL.md delete mode 120000 .claude/skills/prototype delete mode 120000 .claude/skills/research delete mode 120000 .claude/skills/resolving-merge-conflicts delete mode 120000 .claude/skills/setup-matt-pocock-skills delete mode 120000 .claude/skills/tdd delete mode 120000 .claude/skills/teach delete mode 120000 .claude/skills/to-issues delete mode 120000 .claude/skills/to-prd delete mode 120000 .claude/skills/to-spec delete mode 120000 .claude/skills/to-tickets delete mode 120000 .claude/skills/triage delete mode 120000 .claude/skills/wayfinder delete mode 120000 .claude/skills/write-a-skill delete mode 120000 .claude/skills/writing-great-skills delete mode 120000 .claude/skills/zoom-out delete mode 100644 .codex/prompts/opsx-apply.md delete mode 100644 .codex/prompts/opsx-archive.md delete mode 100644 .codex/prompts/opsx-bulk-archive.md delete mode 100644 .codex/prompts/opsx-continue.md delete mode 100644 .codex/prompts/opsx-explore.md delete mode 100644 .codex/prompts/opsx-ff.md delete mode 100644 .codex/prompts/opsx-new.md delete mode 100644 .codex/prompts/opsx-onboard.md delete mode 100644 .codex/prompts/opsx-sync.md delete mode 100644 .codex/prompts/opsx-verify.md delete mode 100644 .codex/skills/export-datasource/SKILL.md delete mode 100644 .codex/skills/export-datasource/agents/openai.yaml delete mode 100644 .codex/skills/export-datasource/references/export-scene-template.md delete mode 100644 .codex/skills/openspec-apply-change/SKILL.md delete mode 100644 .codex/skills/openspec-archive-change/SKILL.md delete mode 100644 .codex/skills/openspec-explore/SKILL.md delete mode 100644 .codex/skills/openspec-propose/SKILL.md delete mode 100644 .codex/skills/openspec-sync-specs/SKILL.md delete mode 100644 .codex/skills/openspec-update-change/SKILL.md delete mode 100644 .planning/PROJECT.md delete mode 100644 .planning/REQUIREMENTS.md delete mode 100644 .planning/ROADMAP.md delete mode 100644 .planning/STATE.md delete mode 100644 .planning/codebase/ARCHITECTURE.md delete mode 100644 .planning/codebase/CONCERNS.md delete mode 100644 .planning/codebase/CONVENTIONS.md delete mode 100644 .planning/codebase/INTEGRATIONS.md delete mode 100644 .planning/codebase/STACK.md delete mode 100644 .planning/codebase/STRUCTURE.md delete mode 100644 .planning/codebase/TESTING.md delete mode 100644 .planning/config.json delete mode 100644 .planning/phases/01-p0/01-01-PLAN.md delete mode 100644 .planning/phases/01-p0/01-01-SUMMARY.md delete mode 100644 .planning/phases/01-p0/01-02-PLAN.md delete mode 100644 .planning/phases/01-p0/01-02-SUMMARY.md delete mode 100644 .planning/phases/01-p0/01-03-PLAN.md delete mode 100644 .planning/phases/01-p0/01-03-SUMMARY.md delete mode 100644 .planning/phases/01-p0/01-04-PLAN.md delete mode 100644 .planning/phases/01-p0/01-04-SUMMARY.md delete mode 100644 .planning/phases/01-p0/01-05-PLAN.md delete mode 100644 .planning/phases/01-p0/01-05-SUMMARY.md delete mode 100644 .planning/phases/01-p0/01-CONTEXT.md delete mode 100644 .planning/phases/01-p0/01-DISCUSSION-LOG.md delete mode 100644 .planning/phases/01-p0/01-VERIFICATION.md delete mode 100644 .planning/phases/02-perm-fin-realname-poll/02-01-PLAN.md delete mode 100644 .planning/phases/02-perm-fin-realname-poll/02-01-SUMMARY.md delete mode 100644 .planning/phases/02-perm-fin-realname-poll/02-02-PLAN.md delete mode 100644 .planning/phases/02-perm-fin-realname-poll/02-02-SUMMARY.md delete mode 100644 .planning/phases/02-perm-fin-realname-poll/02-CONTEXT.md delete mode 100644 .planning/phases/02-perm-fin-realname-poll/02-DISCUSSION-LOG.md delete mode 100644 .planning/phases/02-perm-fin-realname-poll/02-VERIFICATION.md delete mode 100644 .planning/phases/03-device-system/03-01-PLAN.md delete mode 100644 .planning/phases/03-device-system/03-01-SUMMARY.md delete mode 100644 .planning/phases/03-device-system/03-02-PLAN.md delete mode 100644 .planning/phases/03-device-system/03-02-SUMMARY.md delete mode 100644 .planning/phases/03-device-system/03-CONTEXT.md delete mode 100644 .planning/phases/03-device-system/03-DISCUSSION-LOG.md delete mode 100644 .planning/phases/03-device-system/03-VERIFICATION.md delete mode 100644 .planning/phases/03.1-sync-info-phase-3-dto/03.1-01-PLAN.md delete mode 100644 .planning/phases/03.1-sync-info-phase-3-dto/03.1-01-SUMMARY.md delete mode 100644 .planning/phases/03.1-sync-info-phase-3-dto/03.1-CONTEXT.md delete mode 100644 .planning/phases/03.1-sync-info-phase-3-dto/03.1-DISCUSSION-LOG.md delete mode 100644 .planning/phases/03.1-sync-info-phase-3-dto/03.1-VERIFICATION.md delete mode 100644 .planning/phases/04-refund-pay-ops/04-CONTEXT.md delete mode 100644 .planning/phases/04-refund-pay-ops/04-DISCUSSION-LOG.md delete mode 100644 .planning/research/ARCHITECTURE.md delete mode 100644 .planning/research/FEATURES.md delete mode 100644 .planning/research/PITFALLS.md delete mode 100644 .planning/research/STACK.md delete mode 100644 .planning/research/SUMMARY.md delete mode 100644 .scratch/customer-binding-architecture/PRD.md delete mode 100644 .scratch/customer-binding-architecture/issues/01-customer-binding-module-refactor.md delete mode 100644 .scratch/customer-binding-architecture/issues/02-no-virtual-no-card-cend-flow.md delete mode 100644 .scratch/customer-binding-architecture/issues/03-exchange-binding-migration-fix.md delete mode 100644 .scratch/enterprise-auth-and-asset-enhancements/PRD.md delete mode 100644 .scratch/enterprise-auth-and-asset-enhancements/issues/01-card-enterprise-auth-unique-constraint.md delete mode 100644 .scratch/enterprise-auth-and-asset-enhancements/issues/02-standalone-card-network-status-filter.md delete mode 100644 .scratch/enterprise-auth-and-asset-enhancements/issues/03-asset-exchange-status-fields.md delete mode 100644 .scratch/enterprise-auth-and-asset-enhancements/issues/04-main-wallet-asset-identifier-filter.md delete mode 100644 .scratch/enterprise-auth-and-asset-enhancements/issues/05-refund-asset-identifier-filter.md delete mode 100644 .scratch/enterprise-auth-and-asset-enhancements/issues/06-standalone-card-list-enterprise-filter.md delete mode 100644 .scratch/enterprise-auth-and-asset-enhancements/issues/07-device-list-enterprise-filter.md delete mode 100644 .scratch/enterprise-auth-and-asset-enhancements/issues/08-enterprise-card-auth-multi-mode.md delete mode 100644 .scratch/enterprise-auth-and-asset-enhancements/issues/09-enterprise-device-auth-multi-mode.md delete mode 100644 .scratch/iot-risk-import-voucher-remark/PRD.md delete mode 100644 .scratch/iot-risk-import-voucher-remark/issues/01-risk-resume-block.md delete mode 100644 .scratch/iot-risk-import-voucher-remark/issues/02-polling-auto-stop-risk-card.md delete mode 100644 .scratch/iot-risk-import-voucher-remark/issues/03-import-task-creator-name.md delete mode 100644 .scratch/iot-risk-import-voucher-remark/issues/04-batch-invalidate-package-task.md delete mode 100644 .scratch/iot-risk-import-voucher-remark/issues/05-voucher-multi-migration.md delete mode 100644 .scratch/iot-risk-import-voucher-remark/issues/06-order-voucher-multi.md delete mode 100644 .scratch/iot-risk-import-voucher-remark/issues/07-refund-voucher-multi.md delete mode 100644 .scratch/iot-risk-import-voucher-remark/issues/08-agent-recharge-voucher-remark.md delete mode 100644 .scratch/tech-global-audit/PRD.md delete mode 100644 .scratch/tech-global-audit/issues/00-full-audit-surface-inventory.md delete mode 100644 .scratch/tech-global-audit/issues/01-audit-event-write-loop.md delete mode 100644 .scratch/tech-global-audit/issues/02-integration-log-attempt-loop.md delete mode 100644 .scratch/tech-global-audit/issues/03-access-log-route-hardening.md delete mode 100644 .scratch/tech-global-audit/issues/04-account-role-permission-audit-migration.md delete mode 100644 .scratch/tech-global-audit/issues/05-card-asset-lifecycle-audit-migration.md delete mode 100644 .scratch/tech-global-audit/issues/06-device-import-audit-migration.md delete mode 100644 .scratch/tech-global-audit/issues/07-shop-package-config-audit-migration.md delete mode 100644 .scratch/tech-global-audit/issues/08-finance-order-audit-migration.md delete mode 100644 .scratch/tech-global-audit/issues/09-manual-polling-task-integration-cutover.md delete mode 100644 .scratch/tech-global-audit/issues/10-legacy-audit-read-projection.md delete mode 100644 .scratch/tech-global-audit/issues/11-global-event-resource-query.md delete mode 100644 .scratch/tech-global-audit/issues/12-actor-risk-query.md delete mode 100644 .scratch/tech-global-audit/issues/13-request-correlation-integration-timeline.md delete mode 100644 .scratch/tech-global-audit/issues/14-finance-audit-timeline.md delete mode 100644 .scratch/tech-global-audit/issues/15-sensitive-read-self-audit.md delete mode 100644 .scratch/tech-global-audit/issues/16-audit-export-permission-snapshot.md delete mode 100644 .scratch/tech-global-audit/issues/17-retention-cleanup-observability.md delete mode 100644 .scratch/tech-global-audit/issues/18-frontend-contract-acceptance-pack.md delete mode 100644 .scratch/tech-global-audit/issues/19-one-time-audit-cutover-gate.md delete mode 100644 .scratch/tech-global-audit/issues/20-system-config-audit-adapter.md delete mode 100644 .scratch/tech-global-audit/issues/21-outbox-recovery-audit-adapter.md delete mode 100644 .scratch/tech-global-audit/审计覆盖基线.md delete mode 100644 .scratch/tech-global-audit/审计覆盖清单.json delete mode 100644 .scratch/tech-inapp-notifications/PRD.md delete mode 100644 .scratch/tech-inapp-notifications/issues/01-admin-direct-recipient-notification-loop.md delete mode 100644 .scratch/tech-inapp-notifications/issues/02-admin-notification-filter-summary-read-all.md delete mode 100644 .scratch/tech-inapp-notifications/issues/03-personal-customer-notification-loop.md delete mode 100644 .scratch/tech-inapp-notifications/issues/04-dynamic-recipient-resolution.md delete mode 100644 .scratch/tech-inapp-notifications/issues/05-controlled-notification-target-resolution.md delete mode 100644 .scratch/tech-inapp-notifications/issues/06-notification-retention-observability.md delete mode 100644 .scratch/tech-inapp-notifications/issues/07-frontend-contract-acceptance-pack.md delete mode 100644 .scratch/tech-inapp-notifications/issues/08-notification-release-gate.md delete mode 100644 .scratch/tech-public-foundation/PRD.md delete mode 100644 .scratch/tech-public-foundation/issues/01-public-migration-ownership-and-gates.md delete mode 100644 .scratch/tech-public-foundation/issues/02-transactional-public-outbox-write.md delete mode 100644 .scratch/tech-public-foundation/issues/03-outbox-at-least-once-delivery.md delete mode 100644 .scratch/tech-public-foundation/issues/04-outbox-observability-and-recovery.md delete mode 100644 .scratch/tech-public-foundation/issues/05-command-idempotency-contract.md delete mode 100644 .scratch/tech-public-foundation/issues/06-unified-async-task-contract.md delete mode 100644 .scratch/tech-public-foundation/issues/07-controlled-system-config-read.md delete mode 100644 .scratch/tech-public-foundation/issues/08-controlled-system-config-update.md delete mode 100644 .scratch/tech-public-foundation/issues/09-access-log-recursive-redaction.md delete mode 100644 .scratch/tech-public-foundation/issues/10-sensitive-route-safe-summaries.md delete mode 100644 .scratch/tech-public-foundation/issues/11-public-migration-and-rollback-validation.md delete mode 100644 .scratch/tech-public-foundation/issues/12-foundation-release-gate-and-integration-contract.md delete mode 100644 .scratch/ur33-package-expiry-reminder/PRD.md delete mode 100644 .scratch/ur34-agent-recharge/PRD.md delete mode 100644 .scratch/ur35-refund-wecom-approval/PRD.md delete mode 100644 .scratch/ur36-bulk-package-purchase/PRD.md delete mode 100644 .scratch/ur36-bulk-package-purchase/issues/01-batch-unique-asset-resolution.md delete mode 100644 .scratch/ur36-bulk-package-purchase/issues/02-controlled-upload-object-ownership.md delete mode 100644 .scratch/ur36-bulk-package-purchase/issues/03-real-dependency-integration-harness.md delete mode 100644 .scratch/ur36-bulk-package-purchase/issues/04-unified-admin-package-purchasability.md delete mode 100644 .scratch/ur36-bulk-package-purchase/issues/05-single-asset-package-purchase-command.md delete mode 100644 .scratch/ur36-bulk-package-purchase/issues/06-idempotent-bulk-purchase-creation.md delete mode 100644 .scratch/ur36-bulk-package-purchase/issues/07-validate-csv-persist-items.md delete mode 100644 .scratch/ur36-bulk-package-purchase/issues/08-offline-bulk-row-purchase.md delete mode 100644 .scratch/ur36-bulk-package-purchase/issues/09-wallet-bulk-row-purchase-recovery.md delete mode 100644 .scratch/ur36-bulk-package-purchase/issues/10-bulk-purchase-task-queries.md delete mode 100644 .scratch/ur36-bulk-package-purchase/issues/11-real-chain-release-gate.md delete mode 100644 .scratch/ur37-wecom-approval-foundation/PRD.md delete mode 100644 .scratch/ur37-wecom-approval-foundation/issues/01-wecom-connection-status-and-adapter.md delete mode 100644 .scratch/ur37-wecom-approval-foundation/issues/02-self-service-wecom-account-binding.md delete mode 100644 .scratch/ur37-wecom-approval-foundation/issues/03-approval-scene-first-template-publish.md delete mode 100644 .scratch/ur37-wecom-approval-foundation/issues/04-approval-creation-prerequisite-and-transaction-port.md delete mode 100644 .scratch/ur37-wecom-approval-foundation/issues/05-attachment-upload-and-approval-submission.md delete mode 100644 .scratch/ur37-wecom-approval-foundation/issues/06-scene-pause-template-switch-and-validation.md delete mode 100644 .scratch/ur37-wecom-approval-foundation/issues/07-encrypted-callback-and-authoritative-sync.md delete mode 100644 .scratch/ur37-wecom-approval-foundation/issues/08-polling-compensation-and-terminal-event.md delete mode 100644 .scratch/ur37-wecom-approval-foundation/issues/09-approval-operations-query-and-projection.md delete mode 100644 .scratch/ur37-wecom-approval-foundation/issues/10-unknown-submission-recovery.md delete mode 100644 .scratch/ur37-wecom-approval-foundation/issues/11-approval-result-inapp-notification.md delete mode 100644 .scratch/ur37-wecom-approval-foundation/issues/12-legacy-approval-migration-contract.md delete mode 100644 .scratch/ur37-wecom-approval-foundation/issues/13-wecom-ui-contract-acceptance-pack.md delete mode 100644 .scratch/ur37-wecom-approval-foundation/issues/14-refund-first-real-wecom-release-gate.md delete mode 100644 .scratch/ur38-agent-main-wallet-credit/PRD.md delete mode 100644 .scratch/ur38-agent-main-wallet-credit/issues/01-agent-main-wallet-credit-foundation.md delete mode 100644 .scratch/ur38-agent-main-wallet-credit/issues/02-role-default-credit-template.md delete mode 100644 .scratch/ur38-agent-main-wallet-credit/issues/03-atomic-shop-credit-snapshot.md delete mode 100644 .scratch/ur38-agent-main-wallet-credit/issues/04-manage-shop-credit-limit.md delete mode 100644 .scratch/ur38-agent-main-wallet-credit/issues/05-unified-agent-wallet-debit.md delete mode 100644 .scratch/ur38-agent-main-wallet-credit/issues/06-unified-agent-wallet-reservation.md delete mode 100644 .scratch/ur38-agent-main-wallet-credit/issues/07-unified-agent-wallet-credit-posting.md delete mode 100644 .scratch/ur38-agent-main-wallet-credit/issues/08-unified-agent-wallet-refund.md delete mode 100644 .scratch/ur38-agent-main-wallet-credit/issues/09-fund-summary-credit-query.md delete mode 100644 .scratch/ur38-agent-main-wallet-credit/issues/10-credit-wallet-cutover-gate.md delete mode 100644 .scratch/ur40-off-shelf-package-renewal/PRD.md delete mode 100644 .scratch/ur40-off-shelf-package-renewal/issues/01-unified-package-purchasability-and-history-eligibility.md delete mode 100644 .scratch/ur40-off-shelf-package-renewal/issues/02-normal-package-marketplace-projection.md delete mode 100644 .scratch/ur40-off-shelf-package-renewal/issues/03-current-package-renewal-projection.md delete mode 100644 .scratch/ur40-off-shelf-package-renewal/issues/04-package-history-renewal-projection.md delete mode 100644 .scratch/ur40-off-shelf-package-renewal/issues/05-client-order-renew-only-write-validation.md delete mode 100644 .scratch/ur40-off-shelf-package-renewal/issues/06-non-personal-entrypoint-shelf-enforcement.md delete mode 100644 .scratch/ur40-off-shelf-package-renewal/issues/07-renew-only-audit-events.md delete mode 100644 .scratch/ur40-off-shelf-package-renewal/issues/08-contract-release-and-entrypoint-acceptance.md delete mode 100644 .scratch/ur42-unified-export-field-permissions/PRD.md delete mode 100644 .scratch/ur43-series-package-bulk-authorization/PRD.md delete mode 100644 .scratch/ur43-series-package-bulk-authorization/issues/01-initial-bulk-authorization.md delete mode 100644 .scratch/ur43-series-package-bulk-authorization/issues/02-atomic-package-commands.md delete mode 100644 .scratch/ur43-series-package-bulk-authorization/issues/03-management-ui-and-release.md delete mode 100644 .scratch/ur44-list-submitter-approval-summary/PRD.md delete mode 100644 .scratch/ur45-exchange-asset-search/PRD.md delete mode 100644 .scratch/ur45-exchange-asset-search/issues/01-unify-exchange-asset-snapshots.md delete mode 100644 .scratch/ur45-exchange-asset-search/issues/02-independent-old-new-asset-search.md delete mode 100644 .scratch/ur46-estimated-final-expiry/PRD.md delete mode 100644 .scratch/ur46-estimated-final-expiry/issues/01-admin-asset-detail-estimated-final-expiry.md delete mode 100644 .scratch/ur46-estimated-final-expiry/issues/02-iot-card-list-estimated-final-expiry.md delete mode 100644 .scratch/ur46-estimated-final-expiry/issues/03-device-list-estimated-final-expiry.md delete mode 100644 .scratch/ur46-estimated-final-expiry/issues/04-client-asset-estimated-final-expiry.md delete mode 100644 .scratch/ur47-manual-card-speed-limit/PRD.md delete mode 100644 .scratch/ur47-manual-card-speed-limit/issues/01-保障设备当前绑卡唯一性.md delete mode 100644 .scratch/ur47-manual-card-speed-limit/issues/02-建立限速gateway渠道适配与受控映射.md delete mode 100644 .scratch/ur47-manual-card-speed-limit/issues/03-提供统一资产手动限速接口与审计.md delete mode 100644 .scratch/ur47-manual-card-speed-limit/issues/04-提供资产详情限速能力展示契约.md delete mode 100644 .scratch/ur48-asset-payment-methods/PRD.md delete mode 100644 .scratch/ur48-asset-payment-methods/issues/01-payment-config-asset-contract.md delete mode 100644 .scratch/ur48-asset-payment-methods/issues/02-asset-wallet-recharge-payment-policy.md delete mode 100644 .scratch/ur48-asset-payment-methods/issues/03-order-payment-method-snapshot-and-force-recharge.md delete mode 100644 .scratch/ur48-asset-payment-methods/issues/04-order-snapshot-pay-and-cancel.md delete mode 100644 .scratch/ur48-asset-payment-methods/issues/05-payment-method-release-gate.md delete mode 100644 .scratch/ur48-asset-payment-methods/系统配置调研.md delete mode 100644 .scratch/ur49-device-batch-allocation-csv/PRD.md delete mode 100644 .scratch/ur49-device-batch-allocation-csv/issues/01-device-batch-allocation-foundation.md delete mode 100644 .scratch/ur49-device-batch-allocation-csv/issues/02-csv-batch-assign-shop.md delete mode 100644 .scratch/ur49-device-batch-allocation-csv/issues/03-csv-batch-assign-series.md delete mode 100644 .scratch/ur49-device-batch-allocation-csv/issues/04-frontend-api-contract-and-release-acceptance.md delete mode 100644 .scratch/ur49-device-batch-allocation-csv/issues/05-real-chain-release-gate.md delete mode 100644 .scratch/ur53-asset-realname-filter/PRD.md delete mode 100644 .scratch/ur55-package-expiry-base/PRD.md delete mode 100644 .scratch/ur55-package-expiry-base/issues/01-create-allocation-expiry-base-override.md delete mode 100644 .scratch/ur55-package-expiry-base/issues/02-update-allocation-expiry-base-override.md delete mode 100644 .scratch/ur55-package-expiry-base/issues/03-snapshot-synchronous-package-purchases.md delete mode 100644 .scratch/ur55-package-expiry-base/issues/04-snapshot-auto-purchase-package-usages.md delete mode 100644 .scratch/ur55-package-expiry-base/issues/05-activate-and-queue-from-package-snapshots.md delete mode 100644 .scratch/ur57-block-exchange-active-refund/PRD.md delete mode 100644 .scratch/ur60-shop-phone-search/PRD.md delete mode 100644 .scratch/ur60-shop-phone-search/issues/01-修复店铺列表参数校验与默认分页.md delete mode 100644 .scratch/ur60-shop-phone-search/issues/02-交付联系电话精确查询与数据库索引.md delete mode 100644 .scratch/ur60-shop-phone-search/issues/03-禁止企业账号访问核心店铺管理路由.md delete mode 100644 .scratch/ur62-h5-realname-order/PRD.md delete mode 100644 .scratch/ur73-resume-realname-policy/PRD.md delete mode 100644 .scratch/ur86-asset-exchange-trace/PRD.md delete mode 100644 .scratch/ur86-asset-exchange-trace/issues/01-asset-previous-exchange-trace.md delete mode 100644 .scratch/ur86-asset-exchange-trace/issues/02-asset-next-exchange-trace.md delete mode 100644 .scratch/ur94-card-state-events-callbacks/PRD.md delete mode 100644 .scratch/ur94-card-state-events-callbacks/issues/01-callback-iccid-uniqueness-gate.md delete mode 100644 .scratch/ur94-card-state-events-callbacks/issues/02-realname-observation-write-loop.md delete mode 100644 .scratch/ur94-card-state-events-callbacks/issues/03-traffic-observation-write-loop.md delete mode 100644 .scratch/ur94-card-state-events-callbacks/issues/04-network-observation-write-loop.md delete mode 100644 .scratch/ur94-card-state-events-callbacks/issues/05-polling-observation-cutover.md delete mode 100644 .scratch/ur94-card-state-events-callbacks/issues/06-observation-series-loop.md delete mode 100644 .scratch/ur94-card-state-events-callbacks/issues/07-read-and-realname-trigger-integration.md delete mode 100644 .scratch/ur94-card-state-events-callbacks/issues/08-stop-resume-and-package-trigger-integration.md delete mode 100644 .scratch/ur94-card-state-events-callbacks/issues/09-device-control-trigger-integration.md delete mode 100644 .scratch/ur94-card-state-events-callbacks/issues/10-ctcc-realname-callback.md delete mode 100644 .scratch/ur94-card-state-events-callbacks/issues/11-cmcc-realname-callback.md delete mode 100644 .scratch/ur94-card-state-events-callbacks/issues/12-cucc-realname-removal-callback.md delete mode 100644 .scratch/ur94-card-state-events-callbacks/issues/13-ur94-release-gate.md delete mode 100644 .scratch/ur96-shop-business-owner/PRD.md delete mode 100644 .scratch/ur96-shop-business-owner/issues/01-shop-business-owner-persistence.md delete mode 100644 .scratch/ur96-shop-business-owner/issues/02-platform-create-shop-business-owner.md delete mode 100644 .scratch/ur96-shop-business-owner/issues/03-agent-inherit-shop-business-owner.md delete mode 100644 .scratch/ur96-shop-business-owner/issues/04-update-and-audit-shop-business-owner.md delete mode 100644 .scratch/ur96-shop-business-owner/issues/05-query-shop-business-owner.md delete mode 100644 .scratch/ur96-shop-business-owner/issues/06-business-owner-recipient-resolution-and-release.md delete mode 100644 .scratch/ur97-wallet-low-balance-alert/PRD.md delete mode 100644 .scratch/ur98-exchange-inherit-shop/PRD.md delete mode 100644 .scratch/ur98-exchange-inherit-shop/issues/01-exchange-allocation-and-ownership-foundation.md delete mode 100644 .scratch/ur98-exchange-inherit-shop/issues/02-atomic-exchange-completion-with-shop-inheritance.md delete mode 100644 .scratch/ur98-exchange-inherit-shop/issues/03-exchange-inherited-shop-api-projection.md delete mode 100644 .scratch/ur98-exchange-inherit-shop/issues/04-exchange-inheritance-contract-release-acceptance.md delete mode 100644 .sisyphus/drafts/add-gateway-admin-api.md delete mode 100644 .sisyphus/drafts/gateway-integration-plan.md delete mode 100644 .sisyphus/drafts/gateway-integration.md delete mode 100644 .sisyphus/notepads/add-gateway-admin-api/FINAL_REPORT.md delete mode 100644 .sisyphus/notepads/add-gateway-admin-api/ORCHESTRATION_COMPLETE.md delete mode 100644 .sisyphus/notepads/add-gateway-admin-api/completion.md delete mode 100644 .sisyphus/notepads/add-gateway-admin-api/context.md delete mode 100644 .sisyphus/notepads/add-gateway-admin-api/learnings.md delete mode 100644 .sisyphus/notepads/add-gateway-admin-api/status.md delete mode 100644 .sisyphus/notepads/realname-trigger-priority-enhancement/decisions.md delete mode 100644 .sisyphus/notepads/realname-trigger-priority-enhancement/issues.md delete mode 100644 .sisyphus/notepads/realname-trigger-priority-enhancement/learnings.md delete mode 100644 .sisyphus/notepads/tech-debt-cleanup/decisions.md delete mode 100644 .sisyphus/notepads/tech-debt-cleanup/issues.md delete mode 100644 .sisyphus/notepads/tech-debt-cleanup/learnings.md delete mode 100644 .sisyphus/plans/add-force-recharge-system.md delete mode 100644 .sisyphus/plans/add-gateway-admin-api.md delete mode 100644 .sisyphus/plans/gateway-integration-execution-plan.md delete mode 100644 .sisyphus/plans/gateway-integration.md delete mode 100644 .sisyphus/plans/realname-trigger-priority-enhancement.md delete mode 100644 .sisyphus/plans/tech-debt-cleanup.md delete mode 100644 .sisyphus/plans/修正业务-完整方案.md create mode 100644 ARCHITECTURE.md delete mode 100644 CONTEXT.md delete mode 100644 CONTEXT_RESET_PLAN.md delete mode 100644 docs/002-gorm-postgres-asynq/使用指南.md delete mode 100644 docs/002-gorm-postgres-asynq/功能总结.md delete mode 100644 docs/002-gorm-postgres-asynq/架构说明.md delete mode 100644 docs/003-error-handling/使用指南.md delete mode 100644 docs/003-error-handling/功能总结.md delete mode 100644 docs/003-error-handling/架构说明.md delete mode 100644 docs/004-rbac-data-permission/使用指南.md delete mode 100644 docs/004-rbac-data-permission/功能总结.md delete mode 100644 docs/004-rbac-data-permission/架构说明.md delete mode 100644 docs/7月迭代/7月迭代前后端任务工时表.md delete mode 100644 docs/7月迭代/7月迭代技术方案-标准评审稿.md delete mode 100644 docs/7月迭代/7月迭代禅道研发需求拆分表.md delete mode 100644 docs/7月迭代/7月迭代禅道研发需求逐条录入稿.md delete mode 100644 docs/7月迭代/README.md delete mode 100644 docs/7月迭代/七月迭代-AI实施与验收操作手册.md delete mode 100644 docs/7月迭代/七月迭代人工验收清单.md delete mode 100644 docs/7月迭代/七月迭代实现与接口对接说明.md delete mode 100644 docs/7月迭代/七月迭代测试与业务交付手册.md delete mode 100644 docs/7月迭代/七月迭代联调交付说明.md delete mode 100644 docs/7月迭代/七月迭代需求范围确认表.md delete mode 100644 docs/7月迭代/企业微信审批官方接口调研.md delete mode 100644 docs/7月迭代/来源材料/realname.go delete mode 100644 docs/7月迭代/来源材料/业务需求.md delete mode 100644 docs/7月迭代/来源材料/新需求.md delete mode 100644 docs/7月迭代/物联网卡管系统-需求.csv delete mode 100644 docs/7月迭代/独立方案/历史方案/前端共性方案-历史稿.md delete mode 100644 docs/7月迭代/独立方案/历史方案/本地通用审批流-已废弃方案.md delete mode 100644 docs/7月迭代/独立方案/历史方案/站内消息-初版.md delete mode 100644 docs/7月迭代/独立方案/原需求/需求01-复机实名规则.md delete mode 100644 docs/7月迭代/独立方案/原需求/需求02-H5流程配置.md delete mode 100644 docs/7月迭代/独立方案/原需求/需求03-07-11-12-13-简单改动.md delete mode 100644 docs/7月迭代/独立方案/原需求/需求04-06-退款拦截与最后到期时间.md delete mode 100644 docs/7月迭代/独立方案/原需求/需求05-套餐分配生效条件.md delete mode 100644 docs/7月迭代/独立方案/原需求/需求08-设备批量分配Excel.md delete mode 100644 docs/7月迭代/独立方案/原需求/需求09-C端支付限制配置化.md delete mode 100644 docs/7月迭代/独立方案/原需求/需求10-限速规则.md delete mode 100644 docs/7月迭代/独立方案/原需求/需求14-导出功能.md delete mode 100644 docs/7月迭代/独立方案/原需求/需求15-16-18-19-20-21-复杂需求.md delete mode 100644 docs/7月迭代/独立方案/原需求/需求17-信用额度.md delete mode 100644 docs/7月迭代/独立方案/原需求/需求22-套餐临期提醒.md delete mode 100644 docs/7月迭代/独立方案/基础规范/DDD规范.md delete mode 100644 docs/7月迭代/独立方案/基础规范/系统配置.md delete mode 100644 docs/7月迭代/独立方案/新增需求/01-数据同步触发与轮询优化.md delete mode 100644 docs/7月迭代/独立方案/新增需求/02-企业微信审批接入.md delete mode 100644 docs/7月迭代/独立方案/新增需求/03-站内通知详细方案.md delete mode 100644 docs/7月迭代/独立方案/新增需求/04-全局多视角审计方案.md delete mode 100644 docs/7月迭代/独立方案/新增需求/05-代理钱包扫码充值.md delete mode 100644 docs/7月迭代/独立方案/新增需求/06-换货归属与资产换货标识.md delete mode 100644 docs/7月迭代/独立方案/新增需求/07-店铺业务员与钱包余额预警.md delete mode 100644 docs/7月迭代/独立方案/新增需求/08-代理系列套餐批量授权.md delete mode 100644 docs/COMMISSION_DOCS_INDEX.md delete mode 100644 docs/DEPLOYMENT_TROUBLESHOOTING.md delete mode 100644 docs/ORDER_STATUS_INDEX.md delete mode 100644 docs/PACKAGE_DOCS_INDEX.md delete mode 100644 docs/PROJECT-COMPLETION-SUMMARY.md delete mode 100644 docs/account-management-refactor/API文档.md delete mode 100644 docs/account-management-refactor/功能总结.md delete mode 100644 docs/account-management-refactor/迁移指南.md delete mode 100644 docs/add-asset-operation-audit-log/功能总结.md delete mode 100644 docs/add-asset-operation-audit-log/手工验收脚本.sql delete mode 100644 docs/add-asset-operation-audit-log/接口回放示例.md delete mode 100644 docs/add-asset-operation-audit-log/操作内容字段说明.md delete mode 100644 docs/add-default-admin-init/功能说明.md delete mode 100644 docs/add-force-recharge-system/功能总结.md delete mode 100644 docs/add-user-organization-model/提案完成总结.md delete mode 100644 docs/add-user-organization-model/测试总结.md delete mode 100644 docs/add-user-organization-model/用户体系设计文档.md delete mode 100644 docs/add-wallet-transfer-tag-models/字段说明.md delete mode 100644 docs/add-wallet-transfer-tag-models/数据模型设计.md delete mode 100644 docs/add-wallet-transfer-tag-models/迁移验证报告.md delete mode 100644 docs/admin-openapi.yaml delete mode 100644 docs/admin-openapi.yaml.old delete mode 100644 docs/agent-open-api/功能总结.md delete mode 100644 docs/agent-recharge/功能总结.md delete mode 100644 docs/agents/domain.md delete mode 100644 docs/agents/issue-tracker.md delete mode 100644 docs/agents/triage-labels.md delete mode 100644 docs/ai-dto-guidelines-update.md delete mode 100644 docs/alipay-integration/前端对接说明.md delete mode 100644 docs/api-doc-update-summary.md delete mode 100644 docs/api-documentation-guide.md delete mode 100644 docs/api/auth.md delete mode 100644 docs/architecture_diagram.md delete mode 100644 docs/asset-detail-refactor-api-changes.md delete mode 100644 docs/asset-package-batch-order/功能总结.md delete mode 100644 docs/auth-architecture.md delete mode 100644 docs/auth-usage-guide.md delete mode 100644 docs/business-data-export/功能总结.md delete mode 100644 docs/client-api-data-model-fixes/功能总结.md delete mode 100644 docs/client-api-requirements/需求说明.md delete mode 100644 docs/client-asset-renewal-price/功能总结.md delete mode 100644 docs/client-auth-system/功能总结.md delete mode 100644 docs/client-core-business-api/功能总结.md delete mode 100644 docs/client-exchange-system/功能总结.md delete mode 100644 docs/client-wechat-appid/功能总结.md delete mode 100644 docs/code-review-checklist.md delete mode 100644 docs/commission-flow-diagram.md delete mode 100644 docs/commission-package-model.md delete mode 100644 docs/commission-quick-reference.md delete mode 100644 docs/commission-search-result.md delete mode 100644 docs/commission/accumulated-trigger-logic.md delete mode 100644 docs/database-migration-summary.md delete mode 100644 docs/deployment/deployment-guide.md delete mode 100644 docs/deployment/gitea-secrets-setup.md delete mode 100644 docs/deployment/生产数据库手工上线流程.md delete mode 100644 docs/device-batch-allocation/功能总结.md delete mode 100644 docs/device-imei-search/功能总结.md delete mode 100644 docs/device-status-split/功能总结.md delete mode 100644 docs/discussion/资产详情重构讨论纪要.md delete mode 100644 docs/dto-improvement-summary.md create mode 100644 docs/engineering/工程约束.md delete mode 100644 docs/enterprise-device-authorization/implementation-summary.md delete mode 100644 docs/enum-status-standards.md delete mode 100644 docs/environment-variables.md delete mode 100644 docs/excel-import-frontend-guide.md delete mode 100644 docs/feature-001-order-operator-and-chain-commission-semantics/兼容映射清单.md delete mode 100644 docs/feature-001-order-operator-and-chain-commission-semantics/功能总结.md delete mode 100644 docs/feature-001-order-operator-and-chain-commission-semantics/手工验收清单.md delete mode 100644 docs/feature-034-agent-wallet-qr-recharge/代理钱包扫码充值接口对接说明.md delete mode 100644 docs/feature-034-agent-wallet-qr-recharge/功能总结.md delete mode 100644 docs/feature-034-agent-wallet-qr-recharge/微信扫码支付产品边界核对.md delete mode 100644 docs/feature-504-multi-view-audit-center/主体资源活动接口.md delete mode 100644 docs/feature-504-multi-view-audit-center/外部集成调查接口.md delete mode 100644 docs/feature-504-multi-view-audit-center/多视角审计中心功能总结.md delete mode 100644 docs/feature-504-multi-view-audit-center/平台基础审计调查接口.md delete mode 100644 docs/feature-504-multi-view-audit-center/归档灰度操作手册.md delete mode 100644 docs/feature-504-multi-view-audit-center/跨视角调查与前端导航契约.md delete mode 100644 docs/feature-505-package-activation-recovery/功能总结.md delete mode 100644 docs/fix-agent-wallet-order-creation/功能总结.md delete mode 100644 docs/fix-agent-wallet-order-creation/部署指南.md delete mode 100644 docs/fix-order-activation-idempotency/功能总结.md delete mode 100644 docs/gateway-api-reference.md delete mode 100644 docs/gateway-client-usage.md create mode 100644 docs/integrations/alipay/README.md create mode 100644 docs/integrations/fuiou/README.md create mode 100644 docs/integrations/gateway/README.md create mode 100644 docs/integrations/object-storage/README.md create mode 100644 docs/integrations/sms/README.md create mode 100644 docs/integrations/wechat/README.md create mode 100644 docs/integrations/wecom/README.md delete mode 100644 docs/iot-card-speed-tier/功能总结.md delete mode 100644 docs/iot-sim-management/分佣系统说明.md delete mode 100644 docs/iot-sim-management/实施总结.md delete mode 100644 docs/iot-sim-management/数据模型总结.md delete mode 100644 docs/iot-sim-management/表结构详细说明.md delete mode 100644 docs/iot-sim-management/轮询机制说明.md delete mode 100644 docs/login-menu-button-response/使用指南.md delete mode 100644 docs/object-storage/使用指南.md delete mode 100644 docs/object-storage/前端接入指南.md delete mode 100644 docs/openapi-enhancement-summary.md delete mode 100644 docs/order-expiration/功能总结.md delete mode 100644 docs/order-payment/功能总结.md delete mode 100644 docs/order_status_commission_analysis.md delete mode 100644 docs/order_status_quick_reference.md delete mode 100644 docs/order_status_search_summary.md delete mode 100644 docs/package-price-fallback-and-platform-gift-policy/功能总结.md delete mode 100644 docs/package-price-fallback-and-platform-gift-policy/最终验收清单.md delete mode 100644 docs/package-system-upgrade/API文档.md delete mode 100644 docs/package-system-upgrade/使用指南.md delete mode 100644 docs/package-system-upgrade/功能总结.md delete mode 100644 docs/package-system-upgrade/运维指南.md delete mode 100644 docs/package_architecture_diagram.md delete mode 100644 docs/package_quick_navigation.md delete mode 100644 docs/package_structure_summary.md delete mode 100644 docs/performance-benchmark-report.md delete mode 100644 docs/permission-check-usage.md delete mode 100644 docs/polling-system/README.md delete mode 100644 docs/polling-system/deployment.md delete mode 100644 docs/polling-system/manual-trigger-analysis.md delete mode 100644 docs/polling-system/manual-trigger-summary.md delete mode 100644 docs/polling-system/manual-trigger-vs-alternatives.md delete mode 100644 docs/polling-system/operations.md delete mode 100644 docs/polling-system/performance-tuning.md delete mode 100644 docs/polling-system/轮询配置二维条件重构计划.md delete mode 100644 docs/proposals/单卡授权企业功能设计.md delete mode 100644 docs/quality-gate-report.md delete mode 100644 docs/quick_navigation.md delete mode 100644 docs/rate-limiting.md delete mode 100644 docs/refactor-commission-package-model/前端接口迁移指南.md delete mode 100644 docs/refactor-iot-model-location/重构总结.md delete mode 100644 docs/remove-legacy-rbac-cleanup/清理总结.md delete mode 100644 docs/security-audit-report.md delete mode 100644 docs/series-binding-bulk-selection/功能总结.md delete mode 100644 docs/shop-management/API文档.md delete mode 100644 docs/shop-management/使用指南.md delete mode 100644 docs/shop-role-inheritance/功能总结.md delete mode 100644 docs/system-audit-report.md delete mode 100644 docs/tech-approval-core/功能总结.md delete mode 100644 docs/tech-global-audit/当前实现进度.md delete mode 100644 docs/tech-inapp-notifications/前端联调与验收契约.md delete mode 100644 docs/tech-inapp-notifications/功能总结.md delete mode 100644 docs/tech-inapp-notifications/发布与下游接入清单.md delete mode 100644 docs/tech-public-foundation/创建命令幂等契约.md delete mode 100644 docs/tech-public-foundation/前端即时接口交接.md delete mode 100644 docs/tech-public-foundation/功能总结.md delete mode 100644 docs/tech-public-foundation/数据库对象所有权与发布门禁.md delete mode 100644 docs/tech-public-foundation/统一异步任务与前端轮询契约.md delete mode 100644 docs/tech-public-foundation/迁移发布与数据安全回滚.md delete mode 100644 docs/testing/test-connection-guide.md delete mode 100644 docs/traffic-model-unification/字段替换矩阵.md delete mode 100644 docs/traffic-model-unification/手工验收脚本.sql delete mode 100644 docs/traffic-model-unification/接口回放样例.md delete mode 100644 docs/traffic-model-unification/流量模型统一改造方案.md delete mode 100644 docs/unified-export-task-system/功能总结.md delete mode 100644 docs/unified-export-task-system/手工验证清单.md delete mode 100644 docs/unified-export-task-system/验收记录.md delete mode 100644 docs/unified-export-task-system/验收记录模板.md delete mode 100644 docs/unified-export-task-system/验证数据样本.md delete mode 100644 docs/ur33-package-expiry-reminder/功能总结.md delete mode 100644 docs/ur38-agent-main-wallet-credit/功能总结.md delete mode 100644 docs/ur43-series-package-bulk-authorization/功能总结.md delete mode 100644 docs/ur45-exchange-asset-search/功能总结.md delete mode 100644 docs/ur46-estimated-final-expiry/功能总结.md delete mode 100644 docs/ur55-package-expiry-base/功能总结.md delete mode 100644 docs/ur60-shop-phone-search/功能总结.md delete mode 100644 docs/ur86-asset-exchange-trace/功能总结.md delete mode 100644 docs/ur94-card-state-events-callbacks/功能总结.md delete mode 100644 docs/ur96-shop-business-owner/功能总结.md delete mode 100644 docs/wechat-config-management/功能总结.md delete mode 100644 docs/wechat-integration/API文档.md delete mode 100644 docs/wechat-integration/使用指南.md delete mode 100644 docs/wechat-integration/验证指南.md delete mode 100644 docs/wecom-application-connection/功能总结.md delete mode 100644 docs/wecom-application-connection/存量审批切换清单.md delete mode 100644 docs/workflow-optimization/方案总览.md delete mode 100644 docs/优化说明/产品套餐汇总表11.10.xlsx delete mode 100644 docs/优化说明/企业客户管理.md delete mode 100644 docs/优化说明/分佣正确逻辑.md delete mode 100644 docs/优化说明/分佣正确逻辑补充.md delete mode 100644 docs/优化说明/分佣表结构设计.md delete mode 100644 docs/优化说明/分佣需要确认逻辑.md delete mode 100644 docs/优化说明/模块.md delete mode 100644 docs/前端建设/C端H5页面接口矩阵.md delete mode 100644 docs/前端建设/README.md delete mode 100644 docs/前端建设/前端选型与代码组织.md delete mode 100644 docs/前端建设/权限矩阵与接口联调契约.md delete mode 100644 docs/前端建设/管理端页面接口矩阵.md delete mode 100644 docs/副本IoT卡导入模板-Chc9eI72.csv delete mode 100644 docs/副本设备导入模板-B8BDRTVm.csv delete mode 100644 docs/待沟通/2025-12-23T17:39:57沟通.md delete mode 100644 docs/待沟通/一次性佣金出现两个套餐的情况.excalidraw delete mode 100644 docs/待沟通/全局业务架构流程.md delete mode 100644 docs/待沟通/关于分佣.md delete mode 100644 docs/待沟通/关于分佣.pdf delete mode 100644 docs/待沟通/号卡流程.md delete mode 100644 docs/批量回收设备脚本/功能总结.md delete mode 100644 docs/批量套餐失效订单生成脚本/功能总结.md delete mode 100644 docs/批量套餐过期时间修改脚本/功能总结.md delete mode 100644 docs/批量换货脚本/功能总结.md delete mode 100644 docs/批量购买套餐脚本/功能总结.md delete mode 100644 docs/技术方案评审规范.md delete mode 100644 docs/接入openapi.md delete mode 100644 docs/改造方向.md delete mode 100644 docs/第三方文档/SMS_HTTP_1.6.md delete mode 100644 docs/第三方文档/gateway设备详情同步接口.md delete mode 100644 docs/系统流程图/0.代理佣金体系设计流程.md delete mode 100644 docs/系统流程图/0.佣金提现配置流程.md delete mode 100644 docs/系统流程图/0.套餐设计流程(包含佣金设计).md delete mode 100644 docs/系统流程图/0.微信配置流程.md delete mode 100644 docs/系统流程图/0.权限设置流程.md delete mode 100644 docs/系统流程图/0.资产导入流程.md delete mode 100644 docs/系统流程图/0.超级密码设置流程.md delete mode 100644 docs/系统流程图/10.退款流程.md delete mode 100644 docs/系统流程图/11.后台订单流程.md delete mode 100644 docs/系统流程图/12.C端订单流程.md delete mode 100644 docs/系统流程图/13.换货流程.md delete mode 100644 docs/系统流程图/14.资产日常管控流程.md delete mode 100644 docs/系统流程图/15.企业客户入驻流程.md delete mode 100644 docs/系统流程图/2.平台人员账号创建流程.md delete mode 100644 docs/系统流程图/3.代理入驻(店铺新建)流程.md delete mode 100644 docs/系统流程图/4.为资产预设套餐系列流程.md delete mode 100644 docs/系统流程图/4.资产分配流程.md delete mode 100644 docs/系统流程图/5.套餐分配流程.md delete mode 100644 docs/系统流程图/6.购买套餐流程.md delete mode 100644 docs/系统流程图/7.佣金产生细节说明.md delete mode 100644 docs/系统流程图/8.代理佣金提现以及审批流程.md delete mode 100644 docs/系统流程图/9.代理充值流程.md delete mode 100644 docs/脚本/奇成数据迁移方案.md delete mode 100644 docs/脚本/清理代理预充值.sql delete mode 100644 docs/表设计/整合.md delete mode 100644 docs/需求规划/账号与佣金管理模块需求规划.md delete mode 100644 internal/application/outbox/recovery_integration_test.go delete mode 100644 internal/application/systemconfig/update_integration_test.go delete mode 100644 internal/domain/package/terms_test.go delete mode 100644 internal/governance/auditcoverage/coverage_test.go delete mode 100644 internal/handler/admin/exchange_test.go delete mode 100644 internal/handler/admin/shop_package_expiry_base_integration_test.go delete mode 100644 internal/infrastructure/asynctask/store_integration_test.go delete mode 100644 internal/infrastructure/audit/security_test.go delete mode 100644 internal/infrastructure/integrationlog/repository_integration_test.go delete mode 100644 internal/infrastructure/messaging/outbox/relay_integration_test.go delete mode 100644 internal/infrastructure/messaging/outbox/repository_integration_test.go delete mode 100644 internal/infrastructure/releasegate/checker_test.go delete mode 100644 internal/infrastructure/releasegate/migration_integration_test.go delete mode 100644 internal/infrastructure/systemconfig/reader_integration_test.go delete mode 100644 internal/infrastructure/systemconfig/registry_test.go delete mode 100644 internal/model/dto/shop_dto_test.go delete mode 100644 internal/query/asset/exchange_trace_test.go delete mode 100644 internal/query/exchange/list_test.go delete mode 100644 internal/query/outbox/metrics_integration_test.go delete mode 100644 internal/query/packageexpiry/query_test.go delete mode 100644 internal/routes/asset_exchange_trace_integration_test.go delete mode 100644 internal/routes/shop_integration_test.go delete mode 100644 internal/routes/system_config_integration_test.go delete mode 100644 internal/service/asset/usage_summary_test.go delete mode 100644 internal/service/customer_binding/service_test.go delete mode 100644 internal/service/exchange/asset_snapshot_test.go delete mode 100644 internal/service/iot_card/stop_resume_service_test.go delete mode 100644 internal/service/order/asset_wallet_reservation_integration_test.go delete mode 100644 internal/service/order/package_terms_integration_test.go delete mode 100644 internal/service/package/activation_terms_integration_test.go delete mode 100644 internal/service/package/terms_test.go delete mode 100644 internal/service/package/usage_terms_test.go delete mode 100644 internal/store/postgres/package_terms_snapshot_integration_test.go delete mode 100644 internal/task/auto_purchase_terms_integration_test.go delete mode 100644 internal/task/polling_cardstatus_handler_test.go delete mode 100644 internal/testutil/database.go delete mode 100644 internal/testutil/outbox.go delete mode 100644 internal/testutil/system_config.go delete mode 100644 m.csv delete mode 100644 openspec/changes/add-direct-exchange-flow/.openspec.yaml delete mode 100644 openspec/changes/add-direct-exchange-flow/design.md delete mode 100644 openspec/changes/add-direct-exchange-flow/proposal.md delete mode 100644 openspec/changes/add-direct-exchange-flow/specs/asset-generation/spec.md delete mode 100644 openspec/changes/add-direct-exchange-flow/specs/asset-historical-orders/spec.md delete mode 100644 openspec/changes/add-direct-exchange-flow/specs/asset-lifecycle-status/spec.md delete mode 100644 openspec/changes/add-direct-exchange-flow/specs/device/spec.md delete mode 100644 openspec/changes/add-direct-exchange-flow/specs/exchange-admin-management/spec.md delete mode 100644 openspec/changes/add-direct-exchange-flow/specs/exchange-client-notification/spec.md delete mode 100644 openspec/changes/add-direct-exchange-flow/specs/exchange-data-migration/spec.md delete mode 100644 openspec/changes/add-direct-exchange-flow/specs/exchange-order-model/spec.md delete mode 100644 openspec/changes/add-direct-exchange-flow/specs/iot-card/spec.md delete mode 100644 openspec/changes/add-direct-exchange-flow/specs/personal-customer/spec.md delete mode 100644 openspec/changes/add-direct-exchange-flow/tasks.md delete mode 100644 openspec/changes/add-open-api-device-endpoints/.openspec.yaml delete mode 100644 openspec/changes/add-open-api-device-endpoints/design.md delete mode 100644 openspec/changes/add-open-api-device-endpoints/proposal.md delete mode 100644 openspec/changes/add-open-api-device-endpoints/specs/open-api-device-operations/spec.md delete mode 100644 openspec/changes/add-open-api-device-endpoints/specs/open-api-device-traffic/spec.md delete mode 100644 openspec/changes/add-open-api-device-endpoints/tasks.md delete mode 100644 openspec/changes/archive/2025-04-11-fix-commission-status-constants/.openspec.yaml delete mode 100644 openspec/changes/archive/2025-04-11-fix-commission-status-constants/design.md delete mode 100644 openspec/changes/archive/2025-04-11-fix-commission-status-constants/proposal.md delete mode 100644 openspec/changes/archive/2025-04-11-fix-commission-status-constants/specs/commission-record-query/spec.md delete mode 100644 openspec/changes/archive/2025-04-11-fix-commission-status-constants/tasks.md delete mode 100644 openspec/changes/archive/2025-07-27-implement-order-expiration/.openspec.yaml delete mode 100644 openspec/changes/archive/2025-07-27-implement-order-expiration/design.md delete mode 100644 openspec/changes/archive/2025-07-27-implement-order-expiration/proposal.md delete mode 100644 openspec/changes/archive/2025-07-27-implement-order-expiration/specs/iot-order/spec.md delete mode 100644 openspec/changes/archive/2025-07-27-implement-order-expiration/specs/order-expiration/spec.md delete mode 100644 openspec/changes/archive/2025-07-27-implement-order-expiration/specs/order-payment/spec.md delete mode 100644 openspec/changes/archive/2025-07-27-implement-order-expiration/tasks.md delete mode 100644 openspec/changes/archive/2026-01-09-add-user-organization-model/design.md delete mode 100644 openspec/changes/archive/2026-01-09-add-user-organization-model/proposal.md delete mode 100644 openspec/changes/archive/2026-01-09-add-user-organization-model/specs/user-organization/spec.md delete mode 100644 openspec/changes/archive/2026-01-09-add-user-organization-model/tasks.md delete mode 100644 openspec/changes/archive/2026-01-09-auto-generate-openapi-docs/IMPLEMENTATION.md delete mode 100644 openspec/changes/archive/2026-01-09-auto-generate-openapi-docs/README.md delete mode 100644 openspec/changes/archive/2026-01-09-auto-generate-openapi-docs/proposal.md delete mode 100644 openspec/changes/archive/2026-01-09-auto-generate-openapi-docs/specs/openapi-generation/spec.md delete mode 100644 openspec/changes/archive/2026-01-09-auto-generate-openapi-docs/tasks.md delete mode 100644 openspec/changes/archive/2026-01-09-refactor-framework-cleanup/design.md delete mode 100644 openspec/changes/archive/2026-01-09-refactor-framework-cleanup/proposal.md delete mode 100644 openspec/changes/archive/2026-01-09-refactor-framework-cleanup/specs/auth/spec.md delete mode 100644 openspec/changes/archive/2026-01-09-refactor-framework-cleanup/specs/data-permission/spec.md delete mode 100644 openspec/changes/archive/2026-01-09-refactor-framework-cleanup/specs/dependency-injection/spec.md delete mode 100644 openspec/changes/archive/2026-01-09-refactor-framework-cleanup/specs/error-handling/spec.md delete mode 100644 openspec/changes/archive/2026-01-09-refactor-framework-cleanup/tasks.md delete mode 100644 openspec/changes/archive/2026-01-10-add-personal-customer-wechat/proposal.md delete mode 100644 openspec/changes/archive/2026-01-10-add-personal-customer-wechat/specs/personal-customer/spec.md delete mode 100644 openspec/changes/archive/2026-01-10-add-personal-customer-wechat/tasks.md delete mode 100644 openspec/changes/archive/2026-01-10-add-role-permission-system/design.md delete mode 100644 openspec/changes/archive/2026-01-10-add-role-permission-system/proposal.md delete mode 100644 openspec/changes/archive/2026-01-10-add-role-permission-system/specs/role-permission/spec.md delete mode 100644 openspec/changes/archive/2026-01-10-add-role-permission-system/tasks.md delete mode 100644 openspec/changes/archive/2026-01-10-remove-legacy-rbac-cleanup/proposal.md delete mode 100644 openspec/changes/archive/2026-01-10-remove-legacy-rbac-cleanup/specs/legacy-cleanup/spec.md delete mode 100644 openspec/changes/archive/2026-01-10-remove-legacy-rbac-cleanup/tasks.md delete mode 100644 openspec/changes/archive/2026-01-12-fix-iot-models-violations/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-12-fix-iot-models-violations/design.md delete mode 100644 openspec/changes/archive/2026-01-12-fix-iot-models-violations/proposal.md delete mode 100644 openspec/changes/archive/2026-01-12-fix-iot-models-violations/specs/model-organization/spec.md delete mode 100644 openspec/changes/archive/2026-01-12-fix-iot-models-violations/tasks.md delete mode 100644 openspec/changes/archive/2026-01-12-iot-sim-management/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-12-iot-sim-management/design.md delete mode 100644 openspec/changes/archive/2026-01-12-iot-sim-management/proposal.md delete mode 100644 openspec/changes/archive/2026-01-12-iot-sim-management/specs/iot-agent-commission/spec.md delete mode 100644 openspec/changes/archive/2026-01-12-iot-sim-management/specs/iot-card/spec.md delete mode 100644 openspec/changes/archive/2026-01-12-iot-sim-management/specs/iot-device/spec.md delete mode 100644 openspec/changes/archive/2026-01-12-iot-sim-management/specs/iot-number-card/spec.md delete mode 100644 openspec/changes/archive/2026-01-12-iot-sim-management/specs/iot-order/spec.md delete mode 100644 openspec/changes/archive/2026-01-12-iot-sim-management/specs/iot-package/spec.md delete mode 100644 openspec/changes/archive/2026-01-12-iot-sim-management/tasks.md delete mode 100644 openspec/changes/archive/2026-01-12-refactor-iot-model-location/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-12-refactor-iot-model-location/README.md delete mode 100644 openspec/changes/archive/2026-01-12-refactor-iot-model-location/design.md delete mode 100644 openspec/changes/archive/2026-01-12-refactor-iot-model-location/proposal.md delete mode 100644 openspec/changes/archive/2026-01-12-refactor-iot-model-location/specs/model-organization/spec.md delete mode 100644 openspec/changes/archive/2026-01-12-refactor-iot-model-location/tasks.md delete mode 100644 openspec/changes/archive/2026-01-13-add-wallet-transfer-tag-models/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-13-add-wallet-transfer-tag-models/README.md delete mode 100644 openspec/changes/archive/2026-01-13-add-wallet-transfer-tag-models/proposal.md delete mode 100644 openspec/changes/archive/2026-01-13-add-wallet-transfer-tag-models/specs/card-replacement/spec.md delete mode 100644 openspec/changes/archive/2026-01-13-add-wallet-transfer-tag-models/specs/carrier/spec.md delete mode 100644 openspec/changes/archive/2026-01-13-add-wallet-transfer-tag-models/specs/iot-order/spec.md delete mode 100644 openspec/changes/archive/2026-01-13-add-wallet-transfer-tag-models/specs/tag/spec.md delete mode 100644 openspec/changes/archive/2026-01-13-add-wallet-transfer-tag-models/specs/wallet/spec.md delete mode 100644 openspec/changes/archive/2026-01-13-add-wallet-transfer-tag-models/tasks.md delete mode 100644 openspec/changes/archive/2026-01-13-fix-wallet-tag-multi-tenant/COMPLETION_SUMMARY.md delete mode 100644 openspec/changes/archive/2026-01-13-fix-wallet-tag-multi-tenant/design.md delete mode 100644 openspec/changes/archive/2026-01-13-fix-wallet-tag-multi-tenant/proposal.md delete mode 100644 openspec/changes/archive/2026-01-13-fix-wallet-tag-multi-tenant/specs/tag/spec.md delete mode 100644 openspec/changes/archive/2026-01-13-fix-wallet-tag-multi-tenant/specs/wallet/spec.md delete mode 100644 openspec/changes/archive/2026-01-13-fix-wallet-tag-multi-tenant/tasks.md delete mode 100644 openspec/changes/archive/2026-01-14-add-default-admin-init/proposal.md delete mode 100644 openspec/changes/archive/2026-01-14-add-default-admin-init/specs/auth/spec.md delete mode 100644 openspec/changes/archive/2026-01-14-add-default-admin-init/tasks.md delete mode 100644 openspec/changes/archive/2026-01-14-add-platform-account-management/README.md delete mode 100644 openspec/changes/archive/2026-01-14-add-platform-account-management/proposal.md delete mode 100644 openspec/changes/archive/2026-01-14-add-platform-account-management/specs/role-permission/spec.md delete mode 100644 openspec/changes/archive/2026-01-14-add-platform-account-management/specs/user-organization/spec.md delete mode 100644 openspec/changes/archive/2026-01-14-add-platform-account-management/tasks.md delete mode 100644 openspec/changes/archive/2026-01-14-add-platform-role-management/proposal.md delete mode 100644 openspec/changes/archive/2026-01-14-add-platform-role-management/specs/role-permission/spec.md delete mode 100644 openspec/changes/archive/2026-01-14-add-platform-role-management/tasks.md delete mode 100644 openspec/changes/archive/2026-01-15-add-shop-account-management/proposal.md delete mode 100644 openspec/changes/archive/2026-01-15-add-shop-account-management/specs/shop-account-management/spec.md delete mode 100644 openspec/changes/archive/2026-01-15-add-shop-account-management/specs/shop-management/spec.md delete mode 100644 openspec/changes/archive/2026-01-15-add-shop-account-management/tasks.md delete mode 100644 openspec/changes/archive/2026-01-15-implement-b-end-auth-system/design.md delete mode 100644 openspec/changes/archive/2026-01-15-implement-b-end-auth-system/proposal.md delete mode 100644 openspec/changes/archive/2026-01-15-implement-b-end-auth-system/specs/b-end-auth/spec.md delete mode 100644 openspec/changes/archive/2026-01-15-implement-b-end-auth-system/tasks.md delete mode 100644 openspec/changes/archive/2026-01-16-implement-permission-check/design.md delete mode 100644 openspec/changes/archive/2026-01-16-implement-permission-check/proposal.md delete mode 100644 openspec/changes/archive/2026-01-16-implement-permission-check/specs/permission-check/spec.md delete mode 100644 openspec/changes/archive/2026-01-16-implement-permission-check/tasks.md delete mode 100644 openspec/changes/archive/2026-01-21-add-commission-model-changes/proposal.md delete mode 100644 openspec/changes/archive/2026-01-21-add-commission-model-changes/specs/commission-model/spec.md delete mode 100644 openspec/changes/archive/2026-01-21-add-commission-model-changes/tasks.md delete mode 100644 openspec/changes/archive/2026-01-21-add-commission-withdrawal-approval/proposal.md delete mode 100644 openspec/changes/archive/2026-01-21-add-commission-withdrawal-approval/specs/commission-withdrawal-approval/spec.md delete mode 100644 openspec/changes/archive/2026-01-21-add-commission-withdrawal-approval/tasks.md delete mode 100644 openspec/changes/archive/2026-01-21-add-commission-withdrawal-settings/proposal.md delete mode 100644 openspec/changes/archive/2026-01-21-add-commission-withdrawal-settings/specs/commission-withdrawal-settings/spec.md delete mode 100644 openspec/changes/archive/2026-01-21-add-commission-withdrawal-settings/tasks.md delete mode 100644 openspec/changes/archive/2026-01-21-add-customer-account-management/proposal.md delete mode 100644 openspec/changes/archive/2026-01-21-add-customer-account-management/specs/customer-account-management/spec.md delete mode 100644 openspec/changes/archive/2026-01-21-add-customer-account-management/tasks.md delete mode 100644 openspec/changes/archive/2026-01-21-add-enterprise-card-authorization/proposal.md delete mode 100644 openspec/changes/archive/2026-01-21-add-enterprise-card-authorization/specs/enterprise-card-authorization/spec.md delete mode 100644 openspec/changes/archive/2026-01-21-add-enterprise-card-authorization/tasks.md delete mode 100644 openspec/changes/archive/2026-01-21-add-enterprise-management/proposal.md delete mode 100644 openspec/changes/archive/2026-01-21-add-enterprise-management/specs/enterprise-management/spec.md delete mode 100644 openspec/changes/archive/2026-01-21-add-enterprise-management/tasks.md delete mode 100644 openspec/changes/archive/2026-01-21-add-my-commission/proposal.md delete mode 100644 openspec/changes/archive/2026-01-21-add-my-commission/specs/my-commission/spec.md delete mode 100644 openspec/changes/archive/2026-01-21-add-my-commission/tasks.md delete mode 100644 openspec/changes/archive/2026-01-21-add-shop-commission-query/proposal.md delete mode 100644 openspec/changes/archive/2026-01-21-add-shop-commission-query/specs/shop-commission-query/spec.md delete mode 100644 openspec/changes/archive/2026-01-21-add-shop-commission-query/tasks.md delete mode 100644 openspec/changes/archive/2026-01-22-optimize-test-db-connection/design.md delete mode 100644 openspec/changes/archive/2026-01-22-optimize-test-db-connection/proposal.md delete mode 100644 openspec/changes/archive/2026-01-22-optimize-test-db-connection/specs/testing-standards/spec.md delete mode 100644 openspec/changes/archive/2026-01-22-optimize-test-db-connection/tasks.md delete mode 100644 openspec/changes/archive/2026-01-22-unify-error-message-source/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-22-unify-error-message-source/design.md delete mode 100644 openspec/changes/archive/2026-01-22-unify-error-message-source/proposal.md delete mode 100644 openspec/changes/archive/2026-01-22-unify-error-message-source/specs/error-code-validation/spec.md delete mode 100644 openspec/changes/archive/2026-01-22-unify-error-message-source/tasks.md delete mode 100644 openspec/changes/archive/2026-01-23-iot-card-standalone-management/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-23-iot-card-standalone-management/proposal.md delete mode 100644 openspec/changes/archive/2026-01-23-iot-card-standalone-management/specs/iot-card-import-task/spec.md delete mode 100644 openspec/changes/archive/2026-01-23-iot-card-standalone-management/specs/iot-card/spec.md delete mode 100644 openspec/changes/archive/2026-01-23-iot-card-standalone-management/specs/iot-device/spec.md delete mode 100644 openspec/changes/archive/2026-01-23-iot-card-standalone-management/tasks.md delete mode 100644 openspec/changes/archive/2026-01-24-add-object-storage/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-24-add-object-storage/design.md delete mode 100644 openspec/changes/archive/2026-01-24-add-object-storage/proposal.md delete mode 100644 openspec/changes/archive/2026-01-24-add-object-storage/specs/object-storage/spec.md delete mode 100644 openspec/changes/archive/2026-01-24-add-object-storage/tasks.md delete mode 100644 openspec/changes/archive/2026-01-24-add-openapi-markdown-description/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-24-add-openapi-markdown-description/design.md delete mode 100644 openspec/changes/archive/2026-01-24-add-openapi-markdown-description/proposal.md delete mode 100644 openspec/changes/archive/2026-01-24-add-openapi-markdown-description/specs/openapi-markdown-description/spec.md delete mode 100644 openspec/changes/archive/2026-01-24-add-openapi-markdown-description/tasks.md delete mode 100644 openspec/changes/archive/2026-01-24-add-standalone-card-allocation/proposal.md delete mode 100644 openspec/changes/archive/2026-01-24-add-standalone-card-allocation/specs/asset-allocation-record/spec.md delete mode 100644 openspec/changes/archive/2026-01-24-add-standalone-card-allocation/specs/iot-card/spec.md delete mode 100644 openspec/changes/archive/2026-01-24-add-standalone-card-allocation/tasks.md delete mode 100644 openspec/changes/archive/2026-01-24-fix-iccid-import-csv-format/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-24-fix-iccid-import-csv-format/proposal.md delete mode 100644 openspec/changes/archive/2026-01-24-fix-iccid-import-csv-format/specs/iot-card-import-task/spec.md delete mode 100644 openspec/changes/archive/2026-01-24-fix-iccid-import-csv-format/tasks.md delete mode 100644 openspec/changes/archive/2026-01-26-add-authorization-record-management/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-26-add-authorization-record-management/design.md delete mode 100644 openspec/changes/archive/2026-01-26-add-authorization-record-management/proposal.md delete mode 100644 openspec/changes/archive/2026-01-26-add-authorization-record-management/specs/authorization-record/spec.md delete mode 100644 openspec/changes/archive/2026-01-26-add-authorization-record-management/specs/data-permission/spec.md delete mode 100644 openspec/changes/archive/2026-01-26-add-authorization-record-management/tasks.md delete mode 100644 openspec/changes/archive/2026-01-26-deployment-self-init/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-26-deployment-self-init/design.md delete mode 100644 openspec/changes/archive/2026-01-26-deployment-self-init/proposal.md delete mode 100644 openspec/changes/archive/2026-01-26-deployment-self-init/specs/bootstrap-init/spec.md delete mode 100644 openspec/changes/archive/2026-01-26-deployment-self-init/specs/embedded-config/spec.md delete mode 100644 openspec/changes/archive/2026-01-26-deployment-self-init/tasks.md delete mode 100644 openspec/changes/archive/2026-01-26-enterprise-card-authorization/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-26-enterprise-card-authorization/design.md delete mode 100644 openspec/changes/archive/2026-01-26-enterprise-card-authorization/proposal.md delete mode 100644 openspec/changes/archive/2026-01-26-enterprise-card-authorization/specs/enterprise-card-authorization/spec.md delete mode 100644 openspec/changes/archive/2026-01-26-enterprise-card-authorization/specs/iot-card/spec.md delete mode 100644 openspec/changes/archive/2026-01-26-enterprise-card-authorization/tasks.md delete mode 100644 openspec/changes/archive/2026-01-27-add-device-management/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-27-add-device-management/design.md delete mode 100644 openspec/changes/archive/2026-01-27-add-device-management/proposal.md delete mode 100644 openspec/changes/archive/2026-01-27-add-device-management/specs/asset-allocation-record/spec.md delete mode 100644 openspec/changes/archive/2026-01-27-add-device-management/specs/device-import/spec.md delete mode 100644 openspec/changes/archive/2026-01-27-add-device-management/specs/device/spec.md delete mode 100644 openspec/changes/archive/2026-01-27-add-device-management/tasks.md delete mode 100644 openspec/changes/archive/2026-01-27-add-package-module/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-27-add-package-module/design.md delete mode 100644 openspec/changes/archive/2026-01-27-add-package-module/proposal.md delete mode 100644 openspec/changes/archive/2026-01-27-add-package-module/specs/package-management/spec.md delete mode 100644 openspec/changes/archive/2026-01-27-add-package-module/specs/package-series-management/spec.md delete mode 100644 openspec/changes/archive/2026-01-27-add-package-module/tasks.md delete mode 100644 openspec/changes/archive/2026-01-27-carrier-module-refactor/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-27-carrier-module-refactor/design.md delete mode 100644 openspec/changes/archive/2026-01-27-carrier-module-refactor/proposal.md delete mode 100644 openspec/changes/archive/2026-01-27-carrier-module-refactor/specs/carrier-management/spec.md delete mode 100644 openspec/changes/archive/2026-01-27-carrier-module-refactor/specs/iot-card-import/spec.md delete mode 100644 openspec/changes/archive/2026-01-27-carrier-module-refactor/specs/iot-card-query/spec.md delete mode 100644 openspec/changes/archive/2026-01-27-carrier-module-refactor/tasks.md delete mode 100644 openspec/changes/archive/2026-01-27-fix-device-sim-binding-issues/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-27-fix-device-sim-binding-issues/design.md delete mode 100644 openspec/changes/archive/2026-01-27-fix-device-sim-binding-issues/proposal.md delete mode 100644 openspec/changes/archive/2026-01-27-fix-device-sim-binding-issues/specs/iot-device/spec.md delete mode 100644 openspec/changes/archive/2026-01-27-fix-device-sim-binding-issues/tasks.md delete mode 100644 openspec/changes/archive/2026-01-28-add-card-device-series-bindng/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-28-add-card-device-series-bindng/design.md delete mode 100644 openspec/changes/archive/2026-01-28-add-card-device-series-bindng/proposal.md delete mode 100644 openspec/changes/archive/2026-01-28-add-card-device-series-bindng/specs/card-series-bindng/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-add-card-device-series-bindng/specs/device-series-bindng/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-add-card-device-series-bindng/tasks.md delete mode 100644 openspec/changes/archive/2026-01-28-add-card-device-series-bindng/任务完成报告.md delete mode 100644 openspec/changes/archive/2026-01-28-add-card-device-series-bindng/测试完成总结.md delete mode 100644 openspec/changes/archive/2026-01-28-add-order-payment/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-28-add-order-payment/design.md delete mode 100644 openspec/changes/archive/2026-01-28-add-order-payment/proposal.md delete mode 100644 openspec/changes/archive/2026-01-28-add-order-payment/specs/order-management/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-add-order-payment/specs/order-payment/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-add-order-payment/specs/package-purchase-validation/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-add-order-payment/tasks.md delete mode 100644 openspec/changes/archive/2026-01-28-add-shop-package-allocation/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-28-add-shop-package-allocation/design.md delete mode 100644 openspec/changes/archive/2026-01-28-add-shop-package-allocation/proposal.md delete mode 100644 openspec/changes/archive/2026-01-28-add-shop-package-allocation/specs/agent-available-packages/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-add-shop-package-allocation/specs/shop-commission-tier/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-add-shop-package-allocation/specs/shop-package-allocation/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-add-shop-package-allocation/specs/shop-series-allocation/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-add-shop-package-allocation/tasks.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/COMPLETION_STATUS.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/FINAL_COMPLETION_REPORT.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/completion-summary.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/design.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/proposal.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/specs/agent-available-packages/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/specs/allocation-config-versioning/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/specs/allocation-price-history/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/specs/commission-stats-caching/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/specs/shop-commission-tier/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/specs/shop-package-batch-allocation/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/specs/shop-package-batch-pricing/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/specs/shop-series-allocation/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/tasks.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/test-migration-summary.md delete mode 100644 openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/tier-crud-removal-summary.md delete mode 100644 openspec/changes/archive/2026-01-28-unify-test-infrastructure/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-28-unify-test-infrastructure/design.md delete mode 100644 openspec/changes/archive/2026-01-28-unify-test-infrastructure/proposal.md delete mode 100644 openspec/changes/archive/2026-01-28-unify-test-infrastructure/specs/test-infrastructure/spec.md delete mode 100644 openspec/changes/archive/2026-01-28-unify-test-infrastructure/tasks.md delete mode 100644 openspec/changes/archive/2026-01-29-add-enterprise-device-authorization/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-29-add-enterprise-device-authorization/design.md delete mode 100644 openspec/changes/archive/2026-01-29-add-enterprise-device-authorization/proposal.md delete mode 100644 openspec/changes/archive/2026-01-29-add-enterprise-device-authorization/specs/enterprise-card-authorization/spec.md delete mode 100644 openspec/changes/archive/2026-01-29-add-enterprise-device-authorization/specs/enterprise-device-authorization/spec.md delete mode 100644 openspec/changes/archive/2026-01-29-add-enterprise-device-authorization/tasks.md delete mode 100644 openspec/changes/archive/2026-01-29-add-one-time-commission/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-29-add-one-time-commission/design.md delete mode 100644 openspec/changes/archive/2026-01-29-add-one-time-commission/proposal.md delete mode 100644 openspec/changes/archive/2026-01-29-add-one-time-commission/specs/commission-calculation/spec.md delete mode 100644 openspec/changes/archive/2026-01-29-add-one-time-commission/specs/commission-record-query/spec.md delete mode 100644 openspec/changes/archive/2026-01-29-add-one-time-commission/specs/one-time-commission-trigger/spec.md delete mode 100644 openspec/changes/archive/2026-01-29-add-one-time-commission/tasks.md delete mode 100644 openspec/changes/archive/2026-01-29-add-role-handler-validation/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-29-add-role-handler-validation/design.md delete mode 100644 openspec/changes/archive/2026-01-29-add-role-handler-validation/proposal.md delete mode 100644 openspec/changes/archive/2026-01-29-add-role-handler-validation/specs/role-request-validation/spec.md delete mode 100644 openspec/changes/archive/2026-01-29-add-role-handler-validation/tasks.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-authorization-remark-permission/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-29-fix-authorization-remark-permission/design.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-authorization-remark-permission/proposal.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-authorization-remark-permission/specs/enterprise-card-authorization/spec.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-authorization-remark-permission/tasks.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-commission-calculation-trigger-and-snapshot/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-29-fix-commission-calculation-trigger-and-snapshot/design.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-commission-calculation-trigger-and-snapshot/proposal.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-commission-calculation-trigger-and-snapshot/specs/commission-trigger/spec.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-commission-calculation-trigger-and-snapshot/specs/order-commission-snapshot/spec.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-commission-calculation-trigger-and-snapshot/tasks.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-one-time-commission-config-and-accumulation/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-29-fix-one-time-commission-config-and-accumulation/design.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-one-time-commission-config-and-accumulation/proposal.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-one-time-commission-config-and-accumulation/specs/commission-calculation/spec.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-one-time-commission-config-and-accumulation/specs/one-time-commission-trigger/spec.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-one-time-commission-config-and-accumulation/tasks.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-order-activation-idempotency/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-29-fix-order-activation-idempotency/design.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-order-activation-idempotency/proposal.md delete mode 100644 openspec/changes/archive/2026-01-29-fix-order-activation-idempotency/tasks.md delete mode 100644 openspec/changes/archive/2026-01-29-service-error-unify-core/proposal.md delete mode 100644 openspec/changes/archive/2026-01-29-service-error-unify-core/tasks.md delete mode 100644 openspec/changes/archive/2026-01-29-service-error-unify-support/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-29-service-error-unify-support/design.md delete mode 100644 openspec/changes/archive/2026-01-29-service-error-unify-support/proposal.md delete mode 100644 openspec/changes/archive/2026-01-29-service-error-unify-support/specs/error-handling/spec.md delete mode 100644 openspec/changes/archive/2026-01-29-service-error-unify-support/tasks.md delete mode 100644 openspec/changes/archive/2026-01-30-code-cleanup-docs-update/design.md delete mode 100644 openspec/changes/archive/2026-01-30-code-cleanup-docs-update/proposal.md delete mode 100644 openspec/changes/archive/2026-01-30-code-cleanup-docs-update/specs/ci-checks.md delete mode 100644 openspec/changes/archive/2026-01-30-code-cleanup-docs-update/specs/error-handling-updates.md delete mode 100644 openspec/changes/archive/2026-01-30-code-cleanup-docs-update/tasks.md delete mode 100644 openspec/changes/archive/2026-01-30-handler-validation-security/design.md delete mode 100644 openspec/changes/archive/2026-01-30-handler-validation-security/proposal.md delete mode 100644 openspec/changes/archive/2026-01-30-handler-validation-security/tasks.md delete mode 100644 openspec/changes/archive/2026-01-30-login-response-menus-buttons/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-30-login-response-menus-buttons/design.md delete mode 100644 openspec/changes/archive/2026-01-30-login-response-menus-buttons/proposal.md delete mode 100644 openspec/changes/archive/2026-01-30-login-response-menus-buttons/specs/login-menu-button-response/spec.md delete mode 100644 openspec/changes/archive/2026-01-30-login-response-menus-buttons/tasks.md delete mode 100644 openspec/changes/archive/2026-01-30-openapi-contract-alignment/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-30-openapi-contract-alignment/design.md delete mode 100644 openspec/changes/archive/2026-01-30-openapi-contract-alignment/proposal.md delete mode 100644 openspec/changes/archive/2026-01-30-openapi-contract-alignment/specs/openapi-generation/spec.md delete mode 100644 openspec/changes/archive/2026-01-30-openapi-contract-alignment/specs/personal-customer/spec.md delete mode 100644 openspec/changes/archive/2026-01-30-openapi-contract-alignment/tasks.md delete mode 100644 openspec/changes/archive/2026-01-30-remove-tier-commission-redundancy/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-30-remove-tier-commission-redundancy/design.md delete mode 100644 openspec/changes/archive/2026-01-30-remove-tier-commission-redundancy/proposal.md delete mode 100644 openspec/changes/archive/2026-01-30-remove-tier-commission-redundancy/specs/commission-calculation/spec.md delete mode 100644 openspec/changes/archive/2026-01-30-remove-tier-commission-redundancy/specs/commission-record-query/spec.md delete mode 100644 openspec/changes/archive/2026-01-30-remove-tier-commission-redundancy/specs/shop-commission-tier/spec.md delete mode 100644 openspec/changes/archive/2026-01-30-remove-tier-commission-redundancy/specs/shop-series-allocation/spec.md delete mode 100644 openspec/changes/archive/2026-01-30-remove-tier-commission-redundancy/tasks.md delete mode 100644 openspec/changes/archive/2026-01-30-wechat-official-account-payment-integration/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-30-wechat-official-account-payment-integration/design.md delete mode 100644 openspec/changes/archive/2026-01-30-wechat-official-account-payment-integration/proposal.md delete mode 100644 openspec/changes/archive/2026-01-30-wechat-official-account-payment-integration/specs/wechat-official-account/spec.md delete mode 100644 openspec/changes/archive/2026-01-30-wechat-official-account-payment-integration/specs/wechat-payment/spec.md delete mode 100644 openspec/changes/archive/2026-01-30-wechat-official-account-payment-integration/status.yaml delete mode 100644 openspec/changes/archive/2026-01-30-wechat-official-account-payment-integration/tasks.md delete mode 100644 openspec/changes/archive/2026-01-31-add-force-recharge-system/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-31-add-force-recharge-system/design.md delete mode 100644 openspec/changes/archive/2026-01-31-add-force-recharge-system/proposal.md delete mode 100644 openspec/changes/archive/2026-01-31-add-force-recharge-system/specs/commission-calculation/spec.md delete mode 100644 openspec/changes/archive/2026-01-31-add-force-recharge-system/specs/force-recharge-check/spec.md delete mode 100644 openspec/changes/archive/2026-01-31-add-force-recharge-system/specs/order-management/spec.md delete mode 100644 openspec/changes/archive/2026-01-31-add-force-recharge-system/specs/order-payment/spec.md delete mode 100644 openspec/changes/archive/2026-01-31-add-force-recharge-system/specs/purchase-on-behalf/spec.md delete mode 100644 openspec/changes/archive/2026-01-31-add-force-recharge-system/specs/shop-series-allocation/spec.md delete mode 100644 openspec/changes/archive/2026-01-31-add-force-recharge-system/specs/wallet-recharge/spec.md delete mode 100644 openspec/changes/archive/2026-01-31-add-force-recharge-system/tasks.md delete mode 100644 openspec/changes/archive/2026-01-31-fix-force-recharge-missing-interfaces/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-31-fix-force-recharge-missing-interfaces/design.md delete mode 100644 openspec/changes/archive/2026-01-31-fix-force-recharge-missing-interfaces/proposal.md delete mode 100644 openspec/changes/archive/2026-01-31-fix-force-recharge-missing-interfaces/specs/order-management/spec.md delete mode 100644 openspec/changes/archive/2026-01-31-fix-force-recharge-missing-interfaces/specs/shop-series-allocation/spec.md delete mode 100644 openspec/changes/archive/2026-01-31-fix-force-recharge-missing-interfaces/tasks.md delete mode 100644 openspec/changes/archive/2026-01-31-gateway-integration/design.md delete mode 100644 openspec/changes/archive/2026-01-31-gateway-integration/proposal.md delete mode 100644 openspec/changes/archive/2026-01-31-gateway-integration/specs/gateway-client/spec.md delete mode 100644 openspec/changes/archive/2026-01-31-gateway-integration/specs/gateway-config/spec.md delete mode 100644 openspec/changes/archive/2026-01-31-gateway-integration/specs/gateway-crypto/spec.md delete mode 100644 openspec/changes/archive/2026-01-31-gateway-integration/tasks.md delete mode 100644 openspec/changes/archive/2026-01-31-replace-csv-with-excel/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-01-31-replace-csv-with-excel/design.md delete mode 100644 openspec/changes/archive/2026-01-31-replace-csv-with-excel/proposal.md delete mode 100644 openspec/changes/archive/2026-01-31-replace-csv-with-excel/specs/device-import/spec.md delete mode 100644 openspec/changes/archive/2026-01-31-replace-csv-with-excel/specs/iot-card-import-task/spec.md delete mode 100644 openspec/changes/archive/2026-01-31-replace-csv-with-excel/tasks.md delete mode 100644 openspec/changes/archive/2026-02-02-refactor-series-binding-to-series-id/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-02-02-refactor-series-binding-to-series-id/design.md delete mode 100644 openspec/changes/archive/2026-02-02-refactor-series-binding-to-series-id/proposal.md delete mode 100644 openspec/changes/archive/2026-02-02-refactor-series-binding-to-series-id/specs/card-series-bindng/spec.md delete mode 100644 openspec/changes/archive/2026-02-02-refactor-series-binding-to-series-id/specs/device-series-bindng/spec.md delete mode 100644 openspec/changes/archive/2026-02-02-refactor-series-binding-to-series-id/tasks.md delete mode 100644 openspec/changes/archive/2026-02-02-restrict-iot-card-import-task-to-platform/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-02-02-restrict-iot-card-import-task-to-platform/design.md delete mode 100644 openspec/changes/archive/2026-02-02-restrict-iot-card-import-task-to-platform/proposal.md delete mode 100644 openspec/changes/archive/2026-02-02-restrict-iot-card-import-task-to-platform/specs/iot-card-import-task/spec.md delete mode 100644 openspec/changes/archive/2026-02-02-restrict-iot-card-import-task-to-platform/tasks.md delete mode 100644 openspec/changes/archive/2026-02-02-unify-account-management-api/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-02-02-unify-account-management-api/design.md delete mode 100644 openspec/changes/archive/2026-02-02-unify-account-management-api/proposal.md delete mode 100644 openspec/changes/archive/2026-02-02-unify-account-management-api/specs/account-management/spec.md delete mode 100644 openspec/changes/archive/2026-02-02-unify-account-management-api/specs/account-operation-audit/spec.md delete mode 100644 openspec/changes/archive/2026-02-02-unify-account-management-api/specs/account-permission-check/spec.md delete mode 100644 openspec/changes/archive/2026-02-02-unify-account-management-api/specs/unified-auth-api/spec.md delete mode 100644 openspec/changes/archive/2026-02-02-unify-account-management-api/tasks.md delete mode 100644 openspec/changes/archive/2026-02-03-shop-role-inheritance/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-02-03-shop-role-inheritance/design.md delete mode 100644 openspec/changes/archive/2026-02-03-shop-role-inheritance/proposal.md delete mode 100644 openspec/changes/archive/2026-02-03-shop-role-inheritance/specs/permission-check/spec.md delete mode 100644 openspec/changes/archive/2026-02-03-shop-role-inheritance/specs/shop-role-management/spec.md delete mode 100644 openspec/changes/archive/2026-02-03-shop-role-inheritance/tasks.md delete mode 100644 openspec/changes/archive/2026-02-04-fix-commission-calculation-handler-registration/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-02-04-fix-commission-calculation-handler-registration/design.md delete mode 100644 openspec/changes/archive/2026-02-04-fix-commission-calculation-handler-registration/proposal.md delete mode 100644 openspec/changes/archive/2026-02-04-fix-commission-calculation-handler-registration/specs/commission-trigger/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-fix-commission-calculation-handler-registration/tasks.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/design.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/proposal.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/specs/accumulated-recharge-tracking/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/specs/agent-available-packages/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/specs/commission-calculation/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/specs/commission-chain-distribution/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/specs/force-recharge-check/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/specs/one-time-commission-trigger/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/specs/one-time-commission-validity/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/specs/package-management/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/specs/package-series-management/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/specs/package-virtual-data/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/specs/shop-commission-tier/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/specs/shop-series-allocation/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-commission-package-model/tasks.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-one-time-commission-allocation/consensus.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-one-time-commission-allocation/design.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-one-time-commission-allocation/proposal.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-one-time-commission-allocation/specs/commission-calculation/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-one-time-commission-allocation/specs/commission-trigger/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-one-time-commission-allocation/specs/shop-series-allocation/spec.md delete mode 100644 openspec/changes/archive/2026-02-04-refactor-one-time-commission-allocation/tasks.md delete mode 100644 openspec/changes/archive/2026-02-10-polling-system-implementation/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-02-10-polling-system-implementation/design.md delete mode 100644 openspec/changes/archive/2026-02-10-polling-system-implementation/proposal.md delete mode 100644 openspec/changes/archive/2026-02-10-polling-system-implementation/specs/data-cleanup/spec.md delete mode 100644 openspec/changes/archive/2026-02-10-polling-system-implementation/specs/iot-card/spec.md delete mode 100644 openspec/changes/archive/2026-02-10-polling-system-implementation/specs/polling-alert/spec.md delete mode 100644 openspec/changes/archive/2026-02-10-polling-system-implementation/specs/polling-carddata-check/spec.md delete mode 100644 openspec/changes/archive/2026-02-10-polling-system-implementation/specs/polling-concurrency-control/spec.md delete mode 100644 openspec/changes/archive/2026-02-10-polling-system-implementation/specs/polling-configuration/spec.md delete mode 100644 openspec/changes/archive/2026-02-10-polling-system-implementation/specs/polling-manual-trigger/spec.md delete mode 100644 openspec/changes/archive/2026-02-10-polling-system-implementation/specs/polling-monitoring/spec.md delete mode 100644 openspec/changes/archive/2026-02-10-polling-system-implementation/specs/polling-package-check/spec.md delete mode 100644 openspec/changes/archive/2026-02-10-polling-system-implementation/specs/polling-realname-check/spec.md delete mode 100644 openspec/changes/archive/2026-02-10-polling-system-implementation/specs/polling-scheduler/spec.md delete mode 100644 openspec/changes/archive/2026-02-10-polling-system-implementation/tasks.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/consensus.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/design.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/proposal.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/specs/addon-package-lifecycle/spec.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/specs/auto-stop-resume/spec.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/specs/iot-card/spec.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/specs/order-management/spec.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/specs/package-calendar-type/spec.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/specs/package-data-reset/spec.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/specs/package-management/spec.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/specs/package-queue-activation/spec.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/specs/package-realname-activation/spec.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/specs/package-usage-customer-view/spec.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/specs/package-usage-daily-record/spec.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/specs/package-usage-priority/spec.md delete mode 100644 openspec/changes/archive/2026-02-12-package-system-upgrade/tasks.md delete mode 100644 openspec/changes/archive/2026-02-25-separate-agent-card-wallets/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-02-25-separate-agent-card-wallets/design.md delete mode 100644 openspec/changes/archive/2026-02-25-separate-agent-card-wallets/proposal.md delete mode 100644 openspec/changes/archive/2026-02-25-separate-agent-card-wallets/specs/agent-wallet/spec.md delete mode 100644 openspec/changes/archive/2026-02-25-separate-agent-card-wallets/specs/card-wallet/spec.md delete mode 100644 openspec/changes/archive/2026-02-25-separate-agent-card-wallets/specs/wallet/spec.md delete mode 100644 openspec/changes/archive/2026-02-25-separate-agent-card-wallets/tasks.md delete mode 100644 openspec/changes/archive/2026-02-26-refactor-data-permission-filter/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-02-26-refactor-data-permission-filter/design.md delete mode 100644 openspec/changes/archive/2026-02-26-refactor-data-permission-filter/proposal.md delete mode 100644 openspec/changes/archive/2026-02-26-refactor-data-permission-filter/specs/data-permission/spec.md delete mode 100644 openspec/changes/archive/2026-02-26-refactor-data-permission-filter/specs/data-scope-middleware/spec.md delete mode 100644 openspec/changes/archive/2026-02-26-refactor-data-permission-filter/tasks.md delete mode 100644 openspec/changes/archive/2026-02-28-fix-agent-wallet-order-creation/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-02-28-fix-agent-wallet-order-creation/design.md delete mode 100644 openspec/changes/archive/2026-02-28-fix-agent-wallet-order-creation/proposal.md delete mode 100644 openspec/changes/archive/2026-02-28-fix-agent-wallet-order-creation/specs/admin-order-creation/spec.md delete mode 100644 openspec/changes/archive/2026-02-28-fix-agent-wallet-order-creation/specs/order-payment/spec.md delete mode 100644 openspec/changes/archive/2026-02-28-fix-agent-wallet-order-creation/tasks.md delete mode 100644 openspec/changes/archive/2026-03-02-agent-allocation-shelf-status/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-02-agent-allocation-shelf-status/design.md delete mode 100644 openspec/changes/archive/2026-03-02-agent-allocation-shelf-status/proposal.md delete mode 100644 openspec/changes/archive/2026-03-02-agent-allocation-shelf-status/specs/agent-available-packages/spec.md delete mode 100644 openspec/changes/archive/2026-03-02-agent-allocation-shelf-status/specs/allocation-shelf-status/spec.md delete mode 100644 openspec/changes/archive/2026-03-02-agent-allocation-shelf-status/specs/package-management/spec.md delete mode 100644 openspec/changes/archive/2026-03-02-agent-allocation-shelf-status/specs/package-purchase-validation/spec.md delete mode 100644 openspec/changes/archive/2026-03-02-agent-allocation-shelf-status/tasks.md delete mode 100644 openspec/changes/archive/2026-03-04-refactor-agent-series-grant/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-04-refactor-agent-series-grant/design.md delete mode 100644 openspec/changes/archive/2026-03-04-refactor-agent-series-grant/proposal.md delete mode 100644 openspec/changes/archive/2026-03-04-refactor-agent-series-grant/specs/agent-series-grant/spec.md delete mode 100644 openspec/changes/archive/2026-03-04-refactor-agent-series-grant/specs/force-recharge-check/spec.md delete mode 100644 openspec/changes/archive/2026-03-04-refactor-agent-series-grant/specs/shop-series-allocation/spec.md delete mode 100644 openspec/changes/archive/2026-03-04-refactor-agent-series-grant/tasks.md delete mode 100644 openspec/changes/archive/2026-03-05-fix-tiered-commission-tier-fields/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-05-fix-tiered-commission-tier-fields/design.md delete mode 100644 openspec/changes/archive/2026-03-05-fix-tiered-commission-tier-fields/proposal.md delete mode 100644 openspec/changes/archive/2026-03-05-fix-tiered-commission-tier-fields/specs/agent-series-grant/spec.md delete mode 100644 openspec/changes/archive/2026-03-05-fix-tiered-commission-tier-fields/specs/package-series-management/spec.md delete mode 100644 openspec/changes/archive/2026-03-05-fix-tiered-commission-tier-fields/tasks.md delete mode 100644 openspec/changes/archive/2026-03-09-refactor-gateway-client/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-09-refactor-gateway-client/design.md delete mode 100644 openspec/changes/archive/2026-03-09-refactor-gateway-client/proposal.md delete mode 100644 openspec/changes/archive/2026-03-09-refactor-gateway-client/specs/gateway-client/spec.md delete mode 100644 openspec/changes/archive/2026-03-09-refactor-gateway-client/specs/gateway-request-logging/spec.md delete mode 100644 openspec/changes/archive/2026-03-09-refactor-gateway-client/specs/gateway-retry/spec.md delete mode 100644 openspec/changes/archive/2026-03-09-refactor-gateway-client/specs/iot-card/spec.md delete mode 100644 openspec/changes/archive/2026-03-09-refactor-gateway-client/specs/iot-device/spec.md delete mode 100644 openspec/changes/archive/2026-03-09-refactor-gateway-client/tasks.md delete mode 100644 openspec/changes/archive/2026-03-14-asset-detail-refactor/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-14-asset-detail-refactor/design.md delete mode 100644 openspec/changes/archive/2026-03-14-asset-detail-refactor/proposal.md delete mode 100644 openspec/changes/archive/2026-03-14-asset-detail-refactor/specs/asset-queries/spec.md delete mode 100644 openspec/changes/archive/2026-03-14-asset-detail-refactor/specs/asset-resolve/spec.md delete mode 100644 openspec/changes/archive/2026-03-14-asset-detail-refactor/specs/asset-suspend-resume/spec.md delete mode 100644 openspec/changes/archive/2026-03-14-asset-detail-refactor/specs/device/spec.md delete mode 100644 openspec/changes/archive/2026-03-14-asset-detail-refactor/specs/iot-card-import-task/spec.md delete mode 100644 openspec/changes/archive/2026-03-14-asset-detail-refactor/specs/iot-card/spec.md delete mode 100644 openspec/changes/archive/2026-03-14-asset-detail-refactor/specs/iot-package/spec.md delete mode 100644 openspec/changes/archive/2026-03-14-asset-detail-refactor/specs/polling-protect-consistency/spec.md delete mode 100644 openspec/changes/archive/2026-03-14-asset-detail-refactor/tasks.md delete mode 100644 openspec/changes/archive/2026-03-16-asset-wallet-interface/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-16-asset-wallet-interface/design.md delete mode 100644 openspec/changes/archive/2026-03-16-asset-wallet-interface/proposal.md delete mode 100644 openspec/changes/archive/2026-03-16-asset-wallet-interface/specs/asset-wallet-query/spec.md delete mode 100644 openspec/changes/archive/2026-03-16-asset-wallet-interface/specs/card-wallet/spec.md delete mode 100644 openspec/changes/archive/2026-03-16-asset-wallet-interface/tasks.md delete mode 100644 openspec/changes/archive/2026-03-17-add-payment-config-management/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-17-add-payment-config-management/design.md delete mode 100644 openspec/changes/archive/2026-03-17-add-payment-config-management/proposal.md delete mode 100644 openspec/changes/archive/2026-03-17-add-payment-config-management/specs/agent-recharge/spec.md delete mode 100644 openspec/changes/archive/2026-03-17-add-payment-config-management/specs/asset-recharge-adaptation/spec.md delete mode 100644 openspec/changes/archive/2026-03-17-add-payment-config-management/specs/fuiou-payment/spec.md delete mode 100644 openspec/changes/archive/2026-03-17-add-payment-config-management/specs/order-payment/spec.md delete mode 100644 openspec/changes/archive/2026-03-17-add-payment-config-management/specs/wechat-config-management/spec.md delete mode 100644 openspec/changes/archive/2026-03-17-add-payment-config-management/specs/wechat-payment/spec.md delete mode 100644 openspec/changes/archive/2026-03-17-add-payment-config-management/tasks.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/design.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/proposal.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/specs/agent-retail-price/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/specs/asset-generation/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/specs/asset-lifecycle-status/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/specs/asset-recharge-adaptation/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/specs/carrier-realname-config/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/specs/device/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/specs/h5-legacy-cleanup/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/specs/iot-card/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/specs/iot-order/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/specs/one-time-commission-trigger/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/specs/package-purchase-validation/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/specs/personal-customer/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/specs/wallet-recharge/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-api-data-model-fixes/tasks.md delete mode 100644 openspec/changes/archive/2026-03-19-client-auth-system/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-19-client-auth-system/design.md delete mode 100644 openspec/changes/archive/2026-03-19-client-auth-system/proposal.md delete mode 100644 openspec/changes/archive/2026-03-19-client-auth-system/specs/client-asset-token/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-auth-system/specs/client-phone-binding/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-auth-system/specs/client-token-management/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-auth-system/specs/client-wechat-login/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-auth-system/specs/personal-customer-openid/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-auth-system/specs/personal-customer/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-auth-system/specs/wechat-official-account/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-auth-system/tasks.md delete mode 100644 openspec/changes/archive/2026-03-19-client-core-business-api/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-19-client-core-business-api/design.md delete mode 100644 openspec/changes/archive/2026-03-19-client-core-business-api/proposal.md delete mode 100644 openspec/changes/archive/2026-03-19-client-core-business-api/specs/client-asset-info/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-core-business-api/specs/client-device-capability/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-core-business-api/specs/client-order-purchase/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-core-business-api/specs/client-realname-link/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-core-business-api/specs/client-wallet-recharge/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-core-business-api/specs/force-recharge-check/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-core-business-api/specs/wallet-recharge/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-core-business-api/tasks.md delete mode 100644 openspec/changes/archive/2026-03-19-client-exchange-system/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-19-client-exchange-system/design.md delete mode 100644 openspec/changes/archive/2026-03-19-client-exchange-system/proposal.md delete mode 100644 openspec/changes/archive/2026-03-19-client-exchange-system/specs/card-replacement/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-exchange-system/specs/device/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-exchange-system/specs/exchange-admin-management/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-exchange-system/specs/exchange-client-notification/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-exchange-system/specs/exchange-data-migration/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-exchange-system/specs/exchange-order-model/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-exchange-system/specs/iot-card/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-exchange-system/specs/personal-customer/spec.md delete mode 100644 openspec/changes/archive/2026-03-19-client-exchange-system/tasks.md delete mode 100644 openspec/changes/archive/2026-03-28-add-refund-system/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-28-add-refund-system/design.md delete mode 100644 openspec/changes/archive/2026-03-28-add-refund-system/proposal.md delete mode 100644 openspec/changes/archive/2026-03-28-add-refund-system/specs/refund-api/spec.md delete mode 100644 openspec/changes/archive/2026-03-28-add-refund-system/specs/refund-asset-reset/spec.md delete mode 100644 openspec/changes/archive/2026-03-28-add-refund-system/specs/refund-commission-deduct/spec.md delete mode 100644 openspec/changes/archive/2026-03-28-add-refund-system/specs/refund-request/spec.md delete mode 100644 openspec/changes/archive/2026-03-28-add-refund-system/tasks.md delete mode 100644 openspec/changes/archive/2026-03-28-fix-business-completion/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-28-fix-business-completion/design.md delete mode 100644 openspec/changes/archive/2026-03-28-fix-business-completion/proposal.md delete mode 100644 openspec/changes/archive/2026-03-28-fix-business-completion/specs/admin-order-creation/spec.md delete mode 100644 openspec/changes/archive/2026-03-28-fix-business-completion/specs/asset-lifecycle-status/spec.md delete mode 100644 openspec/changes/archive/2026-03-28-fix-business-completion/specs/client-order-purchase/spec.md delete mode 100644 openspec/changes/archive/2026-03-28-fix-business-completion/specs/commission-pending-review/spec.md delete mode 100644 openspec/changes/archive/2026-03-28-fix-business-completion/specs/fuiou-payment/spec.md delete mode 100644 openspec/changes/archive/2026-03-28-fix-business-completion/tasks.md delete mode 100644 openspec/changes/archive/2026-03-28-fix-code-quality-cleanup/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-28-fix-code-quality-cleanup/design.md delete mode 100644 openspec/changes/archive/2026-03-28-fix-code-quality-cleanup/proposal.md delete mode 100644 openspec/changes/archive/2026-03-28-fix-code-quality-cleanup/specs/admin-order-creation/spec.md delete mode 100644 openspec/changes/archive/2026-03-28-fix-code-quality-cleanup/specs/asset-queries/spec.md delete mode 100644 openspec/changes/archive/2026-03-28-fix-code-quality-cleanup/specs/asset-suspend-resume/spec.md delete mode 100644 openspec/changes/archive/2026-03-28-fix-code-quality-cleanup/specs/client-order-purchase/spec.md delete mode 100644 openspec/changes/archive/2026-03-28-fix-code-quality-cleanup/tasks.md delete mode 100644 openspec/changes/archive/2026-03-30-refactor-traffic-system/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-30-refactor-traffic-system/design.md delete mode 100644 openspec/changes/archive/2026-03-30-refactor-traffic-system/proposal.md delete mode 100644 openspec/changes/archive/2026-03-30-refactor-traffic-system/specs/carrier/spec.md delete mode 100644 openspec/changes/archive/2026-03-30-refactor-traffic-system/specs/iot-card/spec.md delete mode 100644 openspec/changes/archive/2026-03-30-refactor-traffic-system/specs/package-usage-daily-record/spec.md delete mode 100644 openspec/changes/archive/2026-03-30-refactor-traffic-system/specs/traffic-daily-buffer/spec.md delete mode 100644 openspec/changes/archive/2026-03-30-refactor-traffic-system/specs/traffic-query-service/spec.md delete mode 100644 openspec/changes/archive/2026-03-30-refactor-traffic-system/tasks.md delete mode 100644 openspec/changes/archive/2026-03-31-fix-stop-resume-lifecycle-engine/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-03-31-fix-stop-resume-lifecycle-engine/design.md delete mode 100644 openspec/changes/archive/2026-03-31-fix-stop-resume-lifecycle-engine/proposal.md delete mode 100644 openspec/changes/archive/2026-03-31-fix-stop-resume-lifecycle-engine/specs/auto-resume-on-purchase/spec.md delete mode 100644 openspec/changes/archive/2026-03-31-fix-stop-resume-lifecycle-engine/specs/auto-resume-on-reset/spec.md delete mode 100644 openspec/changes/archive/2026-03-31-fix-stop-resume-lifecycle-engine/specs/auto-stop-resume/spec.md delete mode 100644 openspec/changes/archive/2026-03-31-fix-stop-resume-lifecycle-engine/specs/package-queue-activation/spec.md delete mode 100644 openspec/changes/archive/2026-03-31-fix-stop-resume-lifecycle-engine/tasks.md delete mode 100644 openspec/changes/archive/2026-04-02-fix-polling-coverage-gaps/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-02-fix-polling-coverage-gaps/design.md delete mode 100644 openspec/changes/archive/2026-04-02-fix-polling-coverage-gaps/proposal.md delete mode 100644 openspec/changes/archive/2026-04-02-fix-polling-coverage-gaps/specs/auto-stop-resume/spec.md delete mode 100644 openspec/changes/archive/2026-04-02-fix-polling-coverage-gaps/specs/device-package-exhausted-stop/spec.md delete mode 100644 openspec/changes/archive/2026-04-02-fix-polling-coverage-gaps/specs/polling-protect-consistency/spec.md delete mode 100644 openspec/changes/archive/2026-04-02-fix-polling-coverage-gaps/tasks.md delete mode 100644 openspec/changes/archive/2026-04-07-asset-historical-orders/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-07-asset-historical-orders/design.md delete mode 100644 openspec/changes/archive/2026-04-07-asset-historical-orders/proposal.md delete mode 100644 openspec/changes/archive/2026-04-07-asset-historical-orders/specs/asset-historical-orders/spec.md delete mode 100644 openspec/changes/archive/2026-04-07-asset-historical-orders/tasks.md delete mode 100644 openspec/changes/archive/2026-04-07-asset-identifier-standardization/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-07-asset-identifier-standardization/design.md delete mode 100644 openspec/changes/archive/2026-04-07-asset-identifier-standardization/proposal.md delete mode 100644 openspec/changes/archive/2026-04-07-asset-identifier-standardization/specs/asset-identifier-registry/spec.md delete mode 100644 openspec/changes/archive/2026-04-07-asset-identifier-standardization/specs/asset-identifier-routes/spec.md delete mode 100644 openspec/changes/archive/2026-04-07-asset-identifier-standardization/specs/asset-resolve/spec.md delete mode 100644 openspec/changes/archive/2026-04-07-asset-identifier-standardization/specs/client-order-purchase/spec.md delete mode 100644 openspec/changes/archive/2026-04-07-asset-identifier-standardization/specs/order-management/spec.md delete mode 100644 openspec/changes/archive/2026-04-07-asset-identifier-standardization/specs/package-purchase-validation/spec.md delete mode 100644 openspec/changes/archive/2026-04-07-asset-identifier-standardization/tasks.md delete mode 100644 openspec/changes/archive/2026-04-07-import-mandatory-virtual-no/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-07-import-mandatory-virtual-no/design.md delete mode 100644 openspec/changes/archive/2026-04-07-import-mandatory-virtual-no/proposal.md delete mode 100644 openspec/changes/archive/2026-04-07-import-mandatory-virtual-no/specs/device-import/spec.md delete mode 100644 openspec/changes/archive/2026-04-07-import-mandatory-virtual-no/specs/iot-card-import-task/spec.md delete mode 100644 openspec/changes/archive/2026-04-07-import-mandatory-virtual-no/tasks.md delete mode 100644 openspec/changes/archive/2026-04-07-polling-system-refactor/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-07-polling-system-refactor/design.md delete mode 100644 openspec/changes/archive/2026-04-07-polling-system-refactor/proposal.md delete mode 100644 openspec/changes/archive/2026-04-07-polling-system-refactor/specs/polling-config-manager/spec.md delete mode 100644 openspec/changes/archive/2026-04-07-polling-system-refactor/specs/polling-queue-manager/spec.md delete mode 100644 openspec/changes/archive/2026-04-07-polling-system-refactor/specs/polling-stop-resume-logic/spec.md delete mode 100644 openspec/changes/archive/2026-04-07-polling-system-refactor/specs/polling-task-handlers/spec.md delete mode 100644 openspec/changes/archive/2026-04-07-polling-system-refactor/tasks.md delete mode 100644 openspec/changes/archive/2026-04-09-add-asset-realname-time/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-09-add-asset-realname-time/design.md delete mode 100644 openspec/changes/archive/2026-04-09-add-asset-realname-time/proposal.md delete mode 100644 openspec/changes/archive/2026-04-09-add-asset-realname-time/specs/asset-resolve/spec.md delete mode 100644 openspec/changes/archive/2026-04-09-add-asset-realname-time/tasks.md delete mode 100644 openspec/changes/archive/2026-04-09-agent-fund-visibility/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-09-agent-fund-visibility/design.md delete mode 100644 openspec/changes/archive/2026-04-09-agent-fund-visibility/proposal.md delete mode 100644 openspec/changes/archive/2026-04-09-agent-fund-visibility/specs/agent-fund-summary/spec.md delete mode 100644 openspec/changes/archive/2026-04-09-agent-fund-visibility/specs/agent-wallet/spec.md delete mode 100644 openspec/changes/archive/2026-04-09-agent-fund-visibility/specs/commission-record-query/spec.md delete mode 100644 openspec/changes/archive/2026-04-09-agent-fund-visibility/specs/main-wallet-transactions/spec.md delete mode 100644 openspec/changes/archive/2026-04-09-agent-fund-visibility/tasks.md delete mode 100644 openspec/changes/archive/2026-04-09-excel-import-refactor/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-09-excel-import-refactor/design.md delete mode 100644 openspec/changes/archive/2026-04-09-excel-import-refactor/proposal.md delete mode 100644 openspec/changes/archive/2026-04-09-excel-import-refactor/specs/device-import/spec.md delete mode 100644 openspec/changes/archive/2026-04-09-excel-import-refactor/specs/iot-card-import-task/spec.md delete mode 100644 openspec/changes/archive/2026-04-09-excel-import-refactor/tasks.md delete mode 100644 openspec/changes/archive/2026-04-09-feat-iot-card-device-virtual-no/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-09-feat-iot-card-device-virtual-no/design.md delete mode 100644 openspec/changes/archive/2026-04-09-feat-iot-card-device-virtual-no/proposal.md delete mode 100644 openspec/changes/archive/2026-04-09-feat-iot-card-device-virtual-no/specs/iot-card-device-snapshot/spec.md delete mode 100644 openspec/changes/archive/2026-04-09-feat-iot-card-device-virtual-no/tasks.md delete mode 100644 openspec/changes/archive/2026-04-10-order-buyer-snapshot/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-10-order-buyer-snapshot/design.md delete mode 100644 openspec/changes/archive/2026-04-10-order-buyer-snapshot/proposal.md delete mode 100644 openspec/changes/archive/2026-04-10-order-buyer-snapshot/specs/client-order-purchase/spec.md delete mode 100644 openspec/changes/archive/2026-04-10-order-buyer-snapshot/specs/iot-order/spec.md delete mode 100644 openspec/changes/archive/2026-04-10-order-buyer-snapshot/specs/order-management/spec.md delete mode 100644 openspec/changes/archive/2026-04-10-order-buyer-snapshot/tasks.md delete mode 100644 openspec/changes/archive/2026-04-11-fix-status-convention-comments/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-11-fix-status-convention-comments/design.md delete mode 100644 openspec/changes/archive/2026-04-11-fix-status-convention-comments/proposal.md delete mode 100644 openspec/changes/archive/2026-04-11-fix-status-convention-comments/specs/status-convention/spec.md delete mode 100644 openspec/changes/archive/2026-04-11-fix-status-convention-comments/tasks.md delete mode 100644 openspec/changes/archive/2026-04-13-realname-trigger-priority-enhancement/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-13-realname-trigger-priority-enhancement/design.md delete mode 100644 openspec/changes/archive/2026-04-13-realname-trigger-priority-enhancement/proposal.md delete mode 100644 openspec/changes/archive/2026-04-13-realname-trigger-priority-enhancement/specs/client-realname-auto-trigger/spec.md delete mode 100644 openspec/changes/archive/2026-04-13-realname-trigger-priority-enhancement/specs/polling-manual-trigger/spec.md delete mode 100644 openspec/changes/archive/2026-04-13-realname-trigger-priority-enhancement/tasks.md delete mode 100644 openspec/changes/archive/2026-04-14-tech-debt-cleanup/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-14-tech-debt-cleanup/design.md delete mode 100644 openspec/changes/archive/2026-04-14-tech-debt-cleanup/proposal.md delete mode 100644 openspec/changes/archive/2026-04-14-tech-debt-cleanup/specs/api-doc-coverage/spec.md delete mode 100644 openspec/changes/archive/2026-04-14-tech-debt-cleanup/specs/dto-name-fields/spec.md delete mode 100644 openspec/changes/archive/2026-04-14-tech-debt-cleanup/specs/payment-dynamic-config/spec.md delete mode 100644 openspec/changes/archive/2026-04-14-tech-debt-cleanup/specs/polling-status-constants/spec.md delete mode 100644 openspec/changes/archive/2026-04-14-tech-debt-cleanup/tasks.md delete mode 100644 openspec/changes/archive/2026-04-15-add-polling-card-status-with-verbose-log/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-15-add-polling-card-status-with-verbose-log/design.md delete mode 100644 openspec/changes/archive/2026-04-15-add-polling-card-status-with-verbose-log/proposal.md delete mode 100644 openspec/changes/archive/2026-04-15-add-polling-card-status-with-verbose-log/specs/polling-card-status-task/spec.md delete mode 100644 openspec/changes/archive/2026-04-15-add-polling-card-status-with-verbose-log/specs/polling-task-handlers/spec.md delete mode 100644 openspec/changes/archive/2026-04-15-add-polling-card-status-with-verbose-log/tasks.md delete mode 100644 openspec/changes/archive/2026-04-15-refactor-order-payment-module/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-15-refactor-order-payment-module/design.md delete mode 100644 openspec/changes/archive/2026-04-15-refactor-order-payment-module/proposal.md delete mode 100644 openspec/changes/archive/2026-04-15-refactor-order-payment-module/specs/asset-recharge-adaptation/spec.md delete mode 100644 openspec/changes/archive/2026-04-15-refactor-order-payment-module/specs/client-order-purchase/spec.md delete mode 100644 openspec/changes/archive/2026-04-15-refactor-order-payment-module/specs/force-recharge-check/spec.md delete mode 100644 openspec/changes/archive/2026-04-15-refactor-order-payment-module/specs/order-payment/spec.md delete mode 100644 openspec/changes/archive/2026-04-15-refactor-order-payment-module/specs/payment-record/spec.md delete mode 100644 openspec/changes/archive/2026-04-15-refactor-order-payment-module/specs/recharge-order/spec.md delete mode 100644 openspec/changes/archive/2026-04-15-refactor-order-payment-module/specs/wallet-recharge/spec.md delete mode 100644 openspec/changes/archive/2026-04-15-refactor-order-payment-module/tasks.md delete mode 100644 openspec/changes/archive/2026-04-16-fix-package-activation-and-time-fields/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-16-fix-package-activation-and-time-fields/design.md delete mode 100644 openspec/changes/archive/2026-04-16-fix-package-activation-and-time-fields/proposal.md delete mode 100644 openspec/changes/archive/2026-04-16-fix-package-activation-and-time-fields/specs/package-queue-activation/spec.md delete mode 100644 openspec/changes/archive/2026-04-16-fix-package-activation-and-time-fields/specs/time-field-nullable-fix/spec.md delete mode 100644 openspec/changes/archive/2026-04-16-fix-package-activation-and-time-fields/tasks.md delete mode 100644 openspec/changes/archive/2026-04-16-fix-polling-config-multi-match/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-16-fix-polling-config-multi-match/design.md delete mode 100644 openspec/changes/archive/2026-04-16-fix-polling-config-multi-match/proposal.md delete mode 100644 openspec/changes/archive/2026-04-16-fix-polling-config-multi-match/tasks.md delete mode 100644 openspec/changes/archive/2026-04-17-agent-recharges-payment-voucher/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-17-agent-recharges-payment-voucher/design.md delete mode 100644 openspec/changes/archive/2026-04-17-agent-recharges-payment-voucher/proposal.md delete mode 100644 openspec/changes/archive/2026-04-17-agent-recharges-payment-voucher/specs/agent-recharge-payment-voucher/spec.md delete mode 100644 openspec/changes/archive/2026-04-17-agent-recharges-payment-voucher/tasks.md delete mode 100644 openspec/changes/archive/2026-04-17-asset-realname-policy/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-17-asset-realname-policy/design.md delete mode 100644 openspec/changes/archive/2026-04-17-asset-realname-policy/proposal.md delete mode 100644 openspec/changes/archive/2026-04-17-asset-realname-policy/specs/asset-realname-policy/spec.md delete mode 100644 openspec/changes/archive/2026-04-17-asset-realname-policy/specs/client-order-purchase/spec.md delete mode 100644 openspec/changes/archive/2026-04-17-asset-realname-policy/specs/client-realname-link/spec.md delete mode 100644 openspec/changes/archive/2026-04-17-asset-realname-policy/specs/client-wallet-recharge/spec.md delete mode 100644 openspec/changes/archive/2026-04-17-asset-realname-policy/specs/device-import/spec.md delete mode 100644 openspec/changes/archive/2026-04-17-asset-realname-policy/specs/iot-card-import-task/spec.md delete mode 100644 openspec/changes/archive/2026-04-17-asset-realname-policy/tasks.md delete mode 100644 openspec/changes/archive/2026-04-17-fix-fund-summary-primary-account/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-17-fix-fund-summary-primary-account/design.md delete mode 100644 openspec/changes/archive/2026-04-17-fix-fund-summary-primary-account/proposal.md delete mode 100644 openspec/changes/archive/2026-04-17-fix-fund-summary-primary-account/specs/fund-summary-primary-account/spec.md delete mode 100644 openspec/changes/archive/2026-04-17-fix-fund-summary-primary-account/tasks.md delete mode 100644 openspec/changes/archive/2026-04-18-add-paid-amount-snapshot-to-package-usage/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-18-add-paid-amount-snapshot-to-package-usage/design.md delete mode 100644 openspec/changes/archive/2026-04-18-add-paid-amount-snapshot-to-package-usage/proposal.md delete mode 100644 openspec/changes/archive/2026-04-18-add-paid-amount-snapshot-to-package-usage/specs/asset-queries/spec.md delete mode 100644 openspec/changes/archive/2026-04-18-add-paid-amount-snapshot-to-package-usage/specs/package-usage-paid-amount-snapshot/spec.md delete mode 100644 openspec/changes/archive/2026-04-18-add-paid-amount-snapshot-to-package-usage/tasks.md delete mode 100644 openspec/changes/archive/2026-04-18-fix-realname-activation-logic/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-18-fix-realname-activation-logic/design.md delete mode 100644 openspec/changes/archive/2026-04-18-fix-realname-activation-logic/proposal.md delete mode 100644 openspec/changes/archive/2026-04-18-fix-realname-activation-logic/specs/package-realname-activation/spec.md delete mode 100644 openspec/changes/archive/2026-04-18-fix-realname-activation-logic/specs/polling-task-handlers/spec.md delete mode 100644 openspec/changes/archive/2026-04-18-fix-realname-activation-logic/tasks.md delete mode 100644 openspec/changes/archive/2026-04-18-super-admin-operation-password/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-18-super-admin-operation-password/design.md delete mode 100644 openspec/changes/archive/2026-04-18-super-admin-operation-password/proposal.md delete mode 100644 openspec/changes/archive/2026-04-18-super-admin-operation-password/specs/global-operation-password/spec.md delete mode 100644 openspec/changes/archive/2026-04-18-super-admin-operation-password/tasks.md delete mode 100644 openspec/changes/archive/2026-04-22-fix-traffic-deduction-on-device-card/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-22-fix-traffic-deduction-on-device-card/baseline-evidence.md delete mode 100644 openspec/changes/archive/2026-04-22-fix-traffic-deduction-on-device-card/design.md delete mode 100644 openspec/changes/archive/2026-04-22-fix-traffic-deduction-on-device-card/proposal.md delete mode 100644 openspec/changes/archive/2026-04-22-fix-traffic-deduction-on-device-card/specs/asset-queries/spec.md delete mode 100644 openspec/changes/archive/2026-04-22-fix-traffic-deduction-on-device-card/specs/package-usage-priority/spec.md delete mode 100644 openspec/changes/archive/2026-04-22-fix-traffic-deduction-on-device-card/specs/polling-task-handlers/spec.md delete mode 100644 openspec/changes/archive/2026-04-22-fix-traffic-deduction-on-device-card/tasks.md delete mode 100644 openspec/changes/archive/2026-04-30-add-asset-operation-audit-log/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-30-add-asset-operation-audit-log/design.md delete mode 100644 openspec/changes/archive/2026-04-30-add-asset-operation-audit-log/proposal.md delete mode 100644 openspec/changes/archive/2026-04-30-add-asset-operation-audit-log/specs/asset-operation-audit/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-add-asset-operation-audit-log/specs/auto-stop-resume/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-add-asset-operation-audit-log/specs/iot-device/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-add-asset-operation-audit-log/tasks.md delete mode 100644 openspec/changes/archive/2026-04-30-add-asset-operation-audit-log/验收准备.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-device-import-slot-mapping/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-30-fix-device-import-slot-mapping/design.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-device-import-slot-mapping/proposal.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-device-import-slot-mapping/specs/device-import/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-device-import-slot-mapping/tasks.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-device-import-slot-mapping/手工验收样例.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-order-operator-and-chain-commission-semantics/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-30-fix-order-operator-and-chain-commission-semantics/design.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-order-operator-and-chain-commission-semantics/proposal.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-order-operator-and-chain-commission-semantics/specs/agent-order-role-tracking/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-order-operator-and-chain-commission-semantics/specs/commission-calculation/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-order-operator-and-chain-commission-semantics/specs/commission-trigger/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-order-operator-and-chain-commission-semantics/specs/order-management/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-order-operator-and-chain-commission-semantics/specs/purchase-on-behalf/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-order-operator-and-chain-commission-semantics/tasks.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-polling-stop-logic/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-30-fix-polling-stop-logic/design.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-polling-stop-logic/proposal.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-polling-stop-logic/specs/polling-stop-resume-logic/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-polling-stop-logic/specs/polling-task-handlers/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-fix-polling-stop-logic/tasks.md delete mode 100644 openspec/changes/archive/2026-04-30-iccid-dual-column-lookup/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-30-iccid-dual-column-lookup/design.md delete mode 100644 openspec/changes/archive/2026-04-30-iccid-dual-column-lookup/proposal.md delete mode 100644 openspec/changes/archive/2026-04-30-iccid-dual-column-lookup/specs/iot-card-import-task/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-iccid-dual-column-lookup/specs/iot-card/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-iccid-dual-column-lookup/tasks.md delete mode 100644 openspec/changes/archive/2026-04-30-improve-audit-log-readability-and-signal-summary/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-30-improve-audit-log-readability-and-signal-summary/design.md delete mode 100644 openspec/changes/archive/2026-04-30-improve-audit-log-readability-and-signal-summary/proposal.md delete mode 100644 openspec/changes/archive/2026-04-30-improve-audit-log-readability-and-signal-summary/specs/asset-audit-readable-content/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-improve-audit-log-readability-and-signal-summary/specs/device-signal-summary/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-improve-audit-log-readability-and-signal-summary/tasks.md delete mode 100644 openspec/changes/archive/2026-04-30-package-price-fallback-and-platform-gift-policy/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-30-package-price-fallback-and-platform-gift-policy/design.md delete mode 100644 openspec/changes/archive/2026-04-30-package-price-fallback-and-platform-gift-policy/proposal.md delete mode 100644 openspec/changes/archive/2026-04-30-package-price-fallback-and-platform-gift-policy/specs/agent-series-grant/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-package-price-fallback-and-platform-gift-policy/specs/client-asset-info/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-package-price-fallback-and-platform-gift-policy/specs/client-order-purchase/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-package-price-fallback-and-platform-gift-policy/specs/gift-package-policy/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-package-price-fallback-and-platform-gift-policy/specs/package-management/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-package-price-fallback-and-platform-gift-policy/specs/package-price-policy/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-package-price-fallback-and-platform-gift-policy/specs/package-purchase-validation/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-package-price-fallback-and-platform-gift-policy/tasks.md delete mode 100644 openspec/changes/archive/2026-04-30-package-price-fallback-and-platform-gift-policy/实施基线与手工验证清单.md delete mode 100644 openspec/changes/archive/2026-04-30-refactor-traffic-model-semantics/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-30-refactor-traffic-model-semantics/design.md delete mode 100644 openspec/changes/archive/2026-04-30-refactor-traffic-model-semantics/proposal.md delete mode 100644 openspec/changes/archive/2026-04-30-refactor-traffic-model-semantics/specs/asset-queries/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-refactor-traffic-model-semantics/specs/asset-resolve/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-refactor-traffic-model-semantics/specs/auto-stop-resume/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-refactor-traffic-model-semantics/specs/client-asset-info/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-refactor-traffic-model-semantics/specs/iot-package/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-refactor-traffic-model-semantics/specs/package-usage-priority/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-refactor-traffic-model-semantics/specs/traffic-model-semantics/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-refactor-traffic-model-semantics/tasks.md delete mode 100644 openspec/changes/archive/2026-04-30-unified-export-task-system/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-04-30-unified-export-task-system/design.md delete mode 100644 openspec/changes/archive/2026-04-30-unified-export-task-system/proposal.md delete mode 100644 openspec/changes/archive/2026-04-30-unified-export-task-system/specs/unified-export-task-system/spec.md delete mode 100644 openspec/changes/archive/2026-04-30-unified-export-task-system/tasks.md delete mode 100644 openspec/changes/archive/2026-05-06-split-worker-roles/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-05-06-split-worker-roles/design.md delete mode 100644 openspec/changes/archive/2026-05-06-split-worker-roles/proposal.md delete mode 100644 openspec/changes/archive/2026-05-06-split-worker-roles/specs/embedded-config/spec.md delete mode 100644 openspec/changes/archive/2026-05-06-split-worker-roles/specs/worker-role-management/spec.md delete mode 100644 openspec/changes/archive/2026-05-06-split-worker-roles/tasks.md delete mode 100644 openspec/changes/archive/2026-05-11-add-agent-open-api/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-05-11-add-agent-open-api/design.md delete mode 100644 openspec/changes/archive/2026-05-11-add-agent-open-api/proposal.md delete mode 100644 openspec/changes/archive/2026-05-11-add-agent-open-api/specs/agent-open-api/spec.md delete mode 100644 openspec/changes/archive/2026-05-11-add-agent-open-api/tasks.md delete mode 100644 openspec/changes/archive/2026-07-27-add-agent-wallet-qr-recharge/.openspec.yaml delete mode 100644 openspec/changes/archive/2026-07-27-add-agent-wallet-qr-recharge/design.md delete mode 100644 openspec/changes/archive/2026-07-27-add-agent-wallet-qr-recharge/proposal.md delete mode 100644 openspec/changes/archive/2026-07-27-add-agent-wallet-qr-recharge/specs/agent-recharge/spec.md delete mode 100644 openspec/changes/archive/2026-07-27-add-agent-wallet-qr-recharge/tasks.md delete mode 100644 openspec/changes/archive/fix-global-business-consistency-emergency-fixes/ARCHIVED.md delete mode 100644 openspec/changes/archive/fix-global-business-consistency-emergency-fixes/NEXT_STEPS.md delete mode 100644 openspec/changes/archive/fix-global-business-consistency-emergency-fixes/PROGRESS.md delete mode 100644 openspec/changes/archive/fix-global-business-consistency-emergency-fixes/design.md delete mode 100644 openspec/changes/archive/fix-global-business-consistency-emergency-fixes/proposal.md delete mode 100644 openspec/changes/archive/fix-global-business-consistency-emergency-fixes/specs/error-handling/spec.md delete mode 100644 openspec/changes/archive/fix-global-business-consistency-emergency-fixes/specs/openapi-generation/spec.md delete mode 100644 openspec/changes/archive/fix-global-business-consistency-emergency-fixes/tasks.md delete mode 100644 openspec/changes/build-multi-view-audit-center/.openspec.yaml delete mode 100644 openspec/changes/build-multi-view-audit-center/design.md delete mode 100644 openspec/changes/build-multi-view-audit-center/proposal.md delete mode 100644 openspec/changes/build-multi-view-audit-center/specs/account-operation-audit/spec.md delete mode 100644 openspec/changes/build-multi-view-audit-center/specs/asset-audit-readable-content/spec.md delete mode 100644 openspec/changes/build-multi-view-audit-center/specs/audit-event-recording/spec.md delete mode 100644 openspec/changes/build-multi-view-audit-center/specs/audit-governance-cutover/spec.md delete mode 100644 openspec/changes/build-multi-view-audit-center/specs/audit-investigation-queries/spec.md delete mode 100644 openspec/changes/build-multi-view-audit-center/specs/audit-log-retention/spec.md delete mode 100644 openspec/changes/build-multi-view-audit-center/specs/integration-log-investigation/spec.md delete mode 100644 openspec/changes/build-multi-view-audit-center/specs/scoped-resource-activity/spec.md delete mode 100644 openspec/changes/build-multi-view-audit-center/tasks.md delete mode 100644 openspec/changes/complete-july-iteration-test-release/.openspec.yaml delete mode 100644 openspec/changes/complete-july-iteration-test-release/design.md delete mode 100644 openspec/changes/complete-july-iteration-test-release/proposal.md delete mode 100644 openspec/changes/complete-july-iteration-test-release/specs/july-iteration-delivery-contract/spec.md delete mode 100644 openspec/changes/complete-july-iteration-test-release/specs/july-iteration-master-ledger/spec.md delete mode 100644 openspec/changes/complete-july-iteration-test-release/specs/july-iteration-test-release-gate/spec.md delete mode 100644 openspec/changes/complete-july-iteration-test-release/tasks.md delete mode 100644 openspec/changes/correct-service-unavailable-error-semantics/.openspec.yaml delete mode 100644 openspec/changes/correct-service-unavailable-error-semantics/design.md delete mode 100644 openspec/changes/correct-service-unavailable-error-semantics/proposal.md delete mode 100644 openspec/changes/correct-service-unavailable-error-semantics/specs/error-code-validation/spec.md delete mode 100644 openspec/changes/correct-service-unavailable-error-semantics/specs/error-handling/spec.md delete mode 100644 openspec/changes/correct-service-unavailable-error-semantics/tasks.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/.openspec.yaml delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/design.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/proposal.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/agent-recharge/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/agent-wallet/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/asset-package-batch-order/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/asset-queries/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/asset-realname-policy/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/asset-speed-tier-management/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/business-data-export/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/card-replacement/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/device/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/exchange-admin-management/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/exchange-client-notification/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/order-management/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/package-expiration-reminder/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/package-management/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/payment-dynamic-config/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/refund-api/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/shop-client-login-control/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/specs/wecom-approval-integration/spec.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/tasks.md delete mode 100644 openspec/changes/deliver-july-iteration-confirmed-scope/实施证据.md delete mode 100644 openspec/changes/fix-order-price-semantics/.openspec.yaml delete mode 100644 openspec/changes/fix-order-price-semantics/design.md delete mode 100644 openspec/changes/fix-order-price-semantics/proposal.md delete mode 100644 openspec/changes/fix-order-price-semantics/specs/admin-order-creation/spec.md delete mode 100644 openspec/changes/fix-order-price-semantics/specs/client-order-purchase/spec.md delete mode 100644 openspec/changes/fix-order-price-semantics/specs/package-usage-paid-amount-snapshot/spec.md delete mode 100644 openspec/changes/fix-order-price-semantics/tasks.md delete mode 100644 openspec/changes/fix-package-activation-starvation/.openspec.yaml delete mode 100644 openspec/changes/fix-package-activation-starvation/design.md delete mode 100644 openspec/changes/fix-package-activation-starvation/proposal.md delete mode 100644 openspec/changes/fix-package-activation-starvation/specs/package-queue-activation/spec.md delete mode 100644 openspec/changes/fix-package-activation-starvation/tasks.md delete mode 100644 openspec/changes/refactor-export-datasource/.openspec.yaml delete mode 100644 openspec/changes/refactor-export-datasource/design.md delete mode 100644 openspec/changes/refactor-export-datasource/proposal.md delete mode 100644 openspec/changes/refactor-export-datasource/specs/export-datasource/spec.md delete mode 100644 openspec/changes/refactor-export-datasource/specs/export-query-params/spec.md delete mode 100644 openspec/changes/refactor-export-datasource/specs/unified-export-task-system/spec.md delete mode 100644 openspec/changes/refactor-export-datasource/tasks.md delete mode 100644 openspec/changes/refactor-migration-ownership-package-flow/.openspec.yaml delete mode 100644 openspec/changes/refactor-migration-ownership-package-flow/design.md delete mode 100644 openspec/changes/refactor-migration-ownership-package-flow/proposal.md delete mode 100644 openspec/changes/refactor-migration-ownership-package-flow/specs/qicheng-migration-control/spec.md delete mode 100644 openspec/changes/refactor-migration-ownership-package-flow/tasks.md delete mode 100644 openspec/specs/account-management/spec.md delete mode 100644 openspec/specs/account-operation-audit/spec.md delete mode 100644 openspec/specs/account-permission-check/spec.md delete mode 100644 openspec/specs/addon-package-lifecycle/spec.md delete mode 100644 openspec/specs/admin-order-creation/spec.md delete mode 100644 openspec/specs/agent-available-packages/spec.md delete mode 100644 openspec/specs/agent-fund-summary/spec.md create mode 100644 openspec/specs/agent-funds-commission/spec.md delete mode 100644 openspec/specs/agent-order-role-tracking/spec.md delete mode 100644 openspec/specs/agent-recharge-payment-voucher/spec.md delete mode 100644 openspec/specs/agent-recharge/spec.md delete mode 100644 openspec/specs/agent-retail-price/spec.md delete mode 100644 openspec/specs/agent-series-grant/spec.md delete mode 100644 openspec/specs/agent-wallet/spec.md delete mode 100644 openspec/specs/allocation-config-versioning/spec.md delete mode 100644 openspec/specs/allocation-price-history/spec.md delete mode 100644 openspec/specs/allocation-shelf-status/spec.md delete mode 100644 openspec/specs/api-doc-coverage/spec.md delete mode 100644 openspec/specs/asset-allocation-record/spec.md delete mode 100644 openspec/specs/asset-audit-readable-content/spec.md create mode 100644 openspec/specs/asset-device/spec.md delete mode 100644 openspec/specs/asset-generation/spec.md delete mode 100644 openspec/specs/asset-historical-orders/spec.md delete mode 100644 openspec/specs/asset-identifier-registry/spec.md delete mode 100644 openspec/specs/asset-identifier-routes/spec.md delete mode 100644 openspec/specs/asset-lifecycle-status/spec.md delete mode 100644 openspec/specs/asset-queries/spec.md delete mode 100644 openspec/specs/asset-realname-policy/spec.md delete mode 100644 openspec/specs/asset-recharge-adaptation/spec.md delete mode 100644 openspec/specs/asset-resolve/spec.md delete mode 100644 openspec/specs/asset-suspend-resume/spec.md delete mode 100644 openspec/specs/asset-wallet-query/spec.md delete mode 100644 openspec/specs/auth/spec.md delete mode 100644 openspec/specs/authorization-record/spec.md delete mode 100644 openspec/specs/auto-resume-on-purchase/spec.md delete mode 100644 openspec/specs/auto-resume-on-reset/spec.md delete mode 100644 openspec/specs/auto-stop-resume/spec.md delete mode 100644 openspec/specs/b-end-auth/spec.md delete mode 100644 openspec/specs/bootstrap-init/spec.md delete mode 100644 openspec/specs/card-replacement/spec.md delete mode 100644 openspec/specs/card-series-bindng/spec.md delete mode 100644 openspec/specs/card-wallet/spec.md delete mode 100644 openspec/specs/carrier-realname-config/spec.md delete mode 100644 openspec/specs/carrier/spec.md delete mode 100644 openspec/specs/client-asset-info/spec.md delete mode 100644 openspec/specs/client-asset-token/spec.md delete mode 100644 openspec/specs/client-device-capability/spec.md delete mode 100644 openspec/specs/client-order-purchase/spec.md delete mode 100644 openspec/specs/client-phone-binding/spec.md delete mode 100644 openspec/specs/client-realname-auto-trigger/spec.md delete mode 100644 openspec/specs/client-realname-link/spec.md delete mode 100644 openspec/specs/client-token-management/spec.md delete mode 100644 openspec/specs/client-wallet-recharge/spec.md delete mode 100644 openspec/specs/client-wechat-login/spec.md delete mode 100644 openspec/specs/commission-calculation/spec.md delete mode 100644 openspec/specs/commission-record-query/spec.md delete mode 100644 openspec/specs/commission-stats-caching/spec.md delete mode 100644 openspec/specs/commission-trigger/spec.md delete mode 100644 openspec/specs/data-permission/spec.md delete mode 100644 openspec/specs/data-scope-middleware/spec.md delete mode 100644 openspec/specs/dependency-injection/spec.md delete mode 100644 openspec/specs/device-import/spec.md delete mode 100644 openspec/specs/device-package-exhausted-stop/spec.md delete mode 100644 openspec/specs/device-series-bindng/spec.md delete mode 100644 openspec/specs/device-signal-summary/spec.md delete mode 100644 openspec/specs/device/spec.md delete mode 100644 openspec/specs/dto-name-fields/spec.md delete mode 100644 openspec/specs/embedded-config/spec.md delete mode 100644 openspec/specs/enterprise-card-authorization/spec.md delete mode 100644 openspec/specs/enterprise-device-authorization/spec.md delete mode 100644 openspec/specs/error-code-validation/spec.md delete mode 100644 openspec/specs/error-handling/spec.md delete mode 100644 openspec/specs/exchange-admin-management/spec.md delete mode 100644 openspec/specs/exchange-client-notification/spec.md delete mode 100644 openspec/specs/exchange-data-migration/spec.md delete mode 100644 openspec/specs/exchange-order-model/spec.md create mode 100644 openspec/specs/export-task/spec.md create mode 100644 openspec/specs/external-integration/spec.md delete mode 100644 openspec/specs/force-recharge-check/spec.md delete mode 100644 openspec/specs/fuiou-payment/spec.md delete mode 100644 openspec/specs/fund-summary-primary-account/spec.md delete mode 100644 openspec/specs/gateway-client/spec.md delete mode 100644 openspec/specs/gateway-config/spec.md delete mode 100644 openspec/specs/gateway-crypto/spec.md delete mode 100644 openspec/specs/gateway-request-logging/spec.md delete mode 100644 openspec/specs/gateway-retry/spec.md delete mode 100644 openspec/specs/global-operation-password/spec.md delete mode 100644 openspec/specs/h5-legacy-cleanup/spec.md create mode 100644 openspec/specs/identity-access/spec.md delete mode 100644 openspec/specs/iot-agent-commission/spec.md delete mode 100644 openspec/specs/iot-card-device-snapshot/spec.md delete mode 100644 openspec/specs/iot-card-import-task/spec.md delete mode 100644 openspec/specs/iot-card/spec.md delete mode 100644 openspec/specs/iot-device/spec.md delete mode 100644 openspec/specs/iot-number-card/spec.md delete mode 100644 openspec/specs/iot-order/spec.md delete mode 100644 openspec/specs/iot-package/spec.md delete mode 100644 openspec/specs/legacy-cleanup/spec.md delete mode 100644 openspec/specs/login-menu-button-response/spec.md delete mode 100644 openspec/specs/main-wallet-transactions/spec.md delete mode 100644 openspec/specs/model-organization/spec.md create mode 100644 openspec/specs/notification-delivery/spec.md delete mode 100644 openspec/specs/object-storage/spec.md delete mode 100644 openspec/specs/one-time-commission-trigger/spec.md delete mode 100644 openspec/specs/openapi-generation/spec.md delete mode 100644 openspec/specs/openapi-markdown-description/spec.md create mode 100644 openspec/specs/operations-audit/spec.md delete mode 100644 openspec/specs/order-commission-snapshot/spec.md delete mode 100644 openspec/specs/order-expiration/spec.md delete mode 100644 openspec/specs/order-management/spec.md create mode 100644 openspec/specs/order-payment-wallet/spec.md delete mode 100644 openspec/specs/order-payment/spec.md create mode 100644 openspec/specs/order-refund-exchange/spec.md delete mode 100644 openspec/specs/package-calendar-type/spec.md delete mode 100644 openspec/specs/package-data-reset/spec.md create mode 100644 openspec/specs/package-lifecycle/spec.md delete mode 100644 openspec/specs/package-management/spec.md delete mode 100644 openspec/specs/package-purchase-validation/spec.md delete mode 100644 openspec/specs/package-queue-activation/spec.md delete mode 100644 openspec/specs/package-realname-activation/spec.md delete mode 100644 openspec/specs/package-series-management/spec.md delete mode 100644 openspec/specs/package-usage-customer-view/spec.md delete mode 100644 openspec/specs/package-usage-daily-record/spec.md delete mode 100644 openspec/specs/package-usage-paid-amount-snapshot/spec.md delete mode 100644 openspec/specs/package-usage-priority/spec.md delete mode 100644 openspec/specs/payment-dynamic-config/spec.md delete mode 100644 openspec/specs/permission-check/spec.md delete mode 100644 openspec/specs/personal-customer-openid/spec.md delete mode 100644 openspec/specs/polling-card-status-task/spec.md delete mode 100644 openspec/specs/polling-config-manager/spec.md delete mode 100644 openspec/specs/polling-manual-trigger/spec.md create mode 100644 openspec/specs/polling-operations/spec.md delete mode 100644 openspec/specs/polling-protect-consistency/spec.md delete mode 100644 openspec/specs/polling-queue-manager/spec.md delete mode 100644 openspec/specs/polling-status-constants/spec.md delete mode 100644 openspec/specs/polling-stop-resume-logic/spec.md delete mode 100644 openspec/specs/polling-task-handlers/spec.md delete mode 100644 openspec/specs/purchase-on-behalf/spec.md delete mode 100644 openspec/specs/refund-api/spec.md delete mode 100644 openspec/specs/refund-asset-reset/spec.md delete mode 100644 openspec/specs/refund-commission-deduct/spec.md delete mode 100644 openspec/specs/refund-request/spec.md delete mode 100644 openspec/specs/role-permission/spec.md delete mode 100644 openspec/specs/shop-account-management/spec.md delete mode 100644 openspec/specs/shop-commission-tier/spec.md delete mode 100644 openspec/specs/shop-management/spec.md delete mode 100644 openspec/specs/shop-package-batch-allocation/spec.md delete mode 100644 openspec/specs/shop-package-batch-pricing/spec.md delete mode 100644 openspec/specs/shop-role-management/spec.md delete mode 100644 openspec/specs/shop-series-allocation/spec.md delete mode 100644 openspec/specs/status-convention/spec.md create mode 100644 openspec/specs/system-operations/spec.md delete mode 100644 openspec/specs/tag/spec.md delete mode 100644 openspec/specs/testing-standards/spec.md delete mode 100644 openspec/specs/traffic-daily-buffer/spec.md delete mode 100644 openspec/specs/traffic-query-service/spec.md delete mode 100644 openspec/specs/unified-auth-api/spec.md delete mode 100644 openspec/specs/user-organization/spec.md delete mode 100644 openspec/specs/wallet-recharge/spec.md delete mode 100644 openspec/specs/wallet/spec.md delete mode 100644 openspec/specs/wechat-config-management/spec.md delete mode 100644 openspec/specs/wechat-official-account/spec.md delete mode 100644 openspec/specs/wechat-payment/spec.md delete mode 100644 openspec/specs/worker-role-management/spec.md delete mode 100644 pkg/asynctask/contract_test.go delete mode 100644 pkg/idempotency/fingerprint_test.go delete mode 100644 pkg/idempotency/postgres_integration_test.go delete mode 100644 pkg/logger/middleware_test.go delete mode 100644 pkg/queue/client_test.go delete mode 100644 scripts/batch_device_recall/__pycache__/test_batch_device_recall.cpython-313.pyc delete mode 100644 scripts/batch_device_recall/test_batch_device_recall.py delete mode 100644 scripts/batch_exchange/test_batch_exchange.py delete mode 100644 scripts/batch_package_purchase/test_batch_update_package_expiry.py delete mode 100644 scripts/benchmark/README.md delete mode 100644 scripts/benchmark/generate_cards.go delete mode 100644 scripts/benchmark/init_config.go delete mode 100644 scripts/benchmark/mock_gateway.go delete mode 100755 scripts/benchmark/monitor.sh delete mode 100755 scripts/benchmark/start_redis.sh create mode 100755 scripts/context-health.sh delete mode 100755 scripts/test-tech-public-foundation.sh delete mode 100644 specs/001-fiber-middleware-integration/checklists/requirements.md delete mode 100644 specs/001-fiber-middleware-integration/contracts/api.yaml delete mode 100644 specs/001-fiber-middleware-integration/data-model.md delete mode 100644 specs/001-fiber-middleware-integration/optional-improvements.md delete mode 100644 specs/001-fiber-middleware-integration/plan.md delete mode 100644 specs/001-fiber-middleware-integration/quickstart.md delete mode 100644 specs/001-fiber-middleware-integration/research.md delete mode 100644 specs/001-fiber-middleware-integration/spec.md delete mode 100644 specs/001-fiber-middleware-integration/tasks.md delete mode 100644 specs/002-gorm-postgres-asynq/checklists/requirements.md delete mode 100644 specs/002-gorm-postgres-asynq/contracts/api.yaml delete mode 100644 specs/002-gorm-postgres-asynq/data-model.md delete mode 100644 specs/002-gorm-postgres-asynq/plan.md delete mode 100644 specs/002-gorm-postgres-asynq/quickstart.md delete mode 100644 specs/002-gorm-postgres-asynq/research.md delete mode 100644 specs/002-gorm-postgres-asynq/spec.md delete mode 100644 specs/002-gorm-postgres-asynq/tasks.md delete mode 100644 specs/003-error-handling/checklists/requirements.md delete mode 100644 specs/003-error-handling/contracts/error-responses.yaml delete mode 100644 specs/003-error-handling/data-model.md delete mode 100644 specs/003-error-handling/plan.md delete mode 100644 specs/003-error-handling/quickstart.md delete mode 100644 specs/003-error-handling/research.md delete mode 100644 specs/003-error-handling/spec.md delete mode 100644 specs/003-error-handling/tasks.md delete mode 100644 specs/004-rbac-data-permission/checklists/requirements.md delete mode 100644 specs/004-rbac-data-permission/contracts/README.md delete mode 100644 specs/004-rbac-data-permission/contracts/account-api.yaml delete mode 100644 specs/004-rbac-data-permission/contracts/api.yaml delete mode 100644 specs/004-rbac-data-permission/contracts/permission-api.yaml delete mode 100644 specs/004-rbac-data-permission/contracts/role-api.yaml delete mode 100644 specs/004-rbac-data-permission/data-model.md delete mode 100644 specs/004-rbac-data-permission/plan.md delete mode 100644 specs/004-rbac-data-permission/quickstart.md delete mode 100644 specs/004-rbac-data-permission/research.md delete mode 100644 specs/004-rbac-data-permission/spec.md delete mode 100644 specs/004-rbac-data-permission/tasks.md delete mode 100644 tests/agent_open_api/README.md delete mode 100644 tests/agent_open_api/main.go diff --git a/.agents/rules/ponytail.md b/.agents/rules/ponytail.md deleted file mode 100644 index 84d7ccc..0000000 --- a/.agents/rules/ponytail.md +++ /dev/null @@ -1,30 +0,0 @@ -# Ponytail, lazy senior dev mode - -You are a lazy senior developer. Lazy means efficient, not careless. The best code is the code never written. - -Before writing any code, stop at the first rung that holds: - -1. Does this need to be built at all? (YAGNI) -2. Does it already exist in this codebase? Reuse the helper, util, or pattern that's already here, don't re-write it. -3. Does the standard library already do this? Use it. -4. Does a native platform feature cover it? Use it. -5. Does an already-installed dependency solve it? Use it. -6. Can this be one line? Make it one line. -7. Only then: write the minimum code that works. - -The ladder runs after you understand the problem, not instead of it: read the task and the code it touches, trace the real flow end to end, then climb. - -Bug fix = root cause, not symptom: a report names a symptom. Grep every caller of the function you touch and fix the shared function once — one guard there is a smaller diff than one per caller, and patching only the path the ticket names leaves a sibling caller still broken. - -Rules: - -- No abstractions that weren't explicitly requested. -- No new dependency if it can be avoided. -- No boilerplate nobody asked for. -- Deletion over addition. Boring over clever. Fewest files possible. -- Shortest working diff wins, but only once you understand the problem. The smallest change in the wrong place isn't lazy, it's a second bug. -- Question complex requests: "Do you actually need X, or does Y cover it?" -- Pick the edge-case-correct option when two stdlib approaches are the same size, lazy means less code, not the flimsier algorithm. -- Mark intentional simplifications with a `ponytail:` comment. If the shortcut has a known ceiling (global lock, O(n²) scan, naive heuristic), the comment names the ceiling and the upgrade path. - -Not lazy about: understanding the problem (read it fully and trace the real flow before picking a rung, a small diff you don't understand is just laziness dressed up as efficiency), input validation at trust boundaries, error handling that prevents data loss, security, accessibility, the calibration real hardware needs (the platform is never the spec ideal, a clock drifts, a sensor reads off), anything explicitly requested. Lazy code without its check is unfinished: non-trivial logic leaves ONE runnable check behind, the smallest thing that fails if the logic breaks (an assert-based demo/self-check or one small test file; no frameworks, no fixtures). Trivial one-liners need no test. diff --git a/.agents/skills/ask-matt/SKILL.md b/.agents/skills/ask-matt/SKILL.md deleted file mode 100644 index 70b807b..0000000 --- a/.agents/skills/ask-matt/SKILL.md +++ /dev/null @@ -1,78 +0,0 @@ ---- -name: ask-matt -description: Ask which skill or flow fits your situation. A router over the skills in this repo. -disable-model-invocation: true ---- - -# Ask Matt - -You don't remember every skill, so ask. - -A **flow** is a path through the skills. Most paths run along one **main flow**, and two **on-ramps** merge onto it. Everything else is standalone, or a vocabulary layer that runs underneath. - -## The main flow: idea → ship - -The route most work travels. You have an idea and want it built. - -1. **`/grill-with-docs`** — sharpen the idea by interview. Start here when you **have a codebase**: it's stateful, retaining what it learns in `CONTEXT.md` and ADRs. (No codebase? Use `/grill-me` — see Standalone. Both run the same `/grilling` primitive; `grill-with-docs` is the one that leaves a paper trail.) -2. **Branch — can you settle every question in conversation?** If a question needs a runnable answer (state, business logic, a UI you have to see), detour through a prototype, bridged by **`/handoff`** in both directions (see Crossing sessions): - - **`/handoff`** out, then open a fresh session against that file, - - **`/prototype`** to answer the question with throwaway code, - - **`/handoff`** back what you learned, and reference it from the original idea thread. -3. **Branch — is this a multi-session build?** - - **Yes** → **`/to-spec`** (turn the thread into a spec), then **`/to-tickets`** to split it into tracer-bullet tickets, each declaring its **blocking edges**. On a local tracker that's one file per ticket under `.scratch//issues/`, worked blockers-first by hand; on a real tracker the edges become native blocking links, so any ticket whose blockers are done can be grabbed — kick off **`/implement`** per ticket, **clearing context between each one**. - - **No** → **`/implement`** right here, in the same context window. - - Either way, **`/implement`** builds each issue by driving **`/tdd`** internally — one red-green slice at a time — then closes out by running **`/code-review`**, a two-axis review (Standards + Spec) of the diff, before committing. Reach for **`/tdd`** on its own when you just want to build a concrete behaviour test-first without a full spec, and **`/code-review`** on its own whenever you want to review a branch or PR against a fixed point. - -### Context hygiene - -Keep steps 1–3 in **one unbroken context window** — don't compact or clear until after `/to-tickets` — so the grilling, spec, and tickets all build on the same thinking. Each `/implement` then starts fresh, working from the ticket. - -The limit on this is the **[smart zone](https://www.aihero.dev/ai-coding-dictionary/smart-zone)**: the window (~120k tokens on state-of-the-art models) within which the model still reasons sharply. If a session approaches it before `/to-tickets`, don't push on degraded — `/handoff` and continue in a fresh thread. - -## On-ramps - -A starting situation that generates work, then merges onto the main flow. - -- **Bugs and requests piling up** → **`/triage`**. It moves issues through triage roles and produces agent-ready issues, which **`/implement`** later picks up. - - Triage is only for issues **you didn't create** — bug reports, incoming feature requests, anything that arrives raw. Tickets that `/to-tickets` produced are already agent-ready, so **don't triage them**. - -- **Something's broken** → **`/diagnosing-bugs`**. For the hard ones: the bug that resists a first glance, the intermittent flake, the regression that crept in between two known-good states. It refuses to theorise until it has a **tight feedback loop** — one command that already goes red on *this* bug — then fixes with a regression test. Its post-mortem hands off to **`/improve-codebase-architecture`** when the real finding is that there's no good seam to lock the bug down. - -- **A huge, foggy effort — a greenfield project or a huge feature build, too big for one session** → **`/wayfinder`**, the most cognitively demanding flow here. When the way from here to the destination isn't visible yet, it charts a **shared map** of **decision tickets** on the issue tracker and resolves them one at a time — producing **decisions, not deliverables** — until the fog is pushed back and the way is clear. Where **`/grill-with-docs`** sharpens an idea you can hold in one session, wayfinder is for the idea you can't — and it's slower and denser, so save it for exactly that, never a well-scoped feature. - - When the map clears, **it hands off, it doesn't build**: merge onto the main flow at **`/to-spec`**, which collapses the map's linked decisions into a buildable plan, then `/to-tickets` and `/implement` as usual. Looping the map straight into `/implement` skips that collapse and throws the linked detail away — go straight to `/implement` only when the effort turned out genuinely small. - -## Codebase health - -Not feature work — upkeep. - -- **`/improve-codebase-architecture`** — run whenever you have a spare moment to keep the codebase good for agents to operate in. It surfaces **deepening opportunities**; picking one _generates an idea_ you can take into the main flow at `/grill-with-docs`. It's the survey that finds the candidates; **`/codebase-design`** (below) is the bench you design the chosen one on. - -## Vocabulary underneath - -Two model-invoked references that run *beneath* the other skills — each the single source of truth for its vocabulary. Reach for them directly when the **words**, not the process, are the problem; or let the skills above pull them in. - -- **`/domain-modeling`** — sharpen the project's *domain* language: challenge a fuzzy term, resolve an overloaded word ("account" doing three jobs), record a hard-to-reverse decision as an ADR. It's the active discipline `/grill-with-docs` drives to keep `CONTEXT.md` a clean glossary. -- **`/codebase-design`** — the deep-module vocabulary (module, interface, depth, seam, adapter, leverage, locality) for designing a module's *shape*: a lot of behaviour behind a small interface at a clean seam. `/tdd` and `/improve-codebase-architecture` both speak it. - -## Crossing sessions - -- **`/handoff`** — when a thread is full or you need to branch off (e.g. into a `/prototype` session), this compacts the conversation into a markdown file. You don't continue in place — you **open a new session and reference that file** to carry the context across. It's the bridge between context windows, in either direction. Use it when you want a **fresh session** but need the **current conversation preserved**. -- **`/compact`** (built-in) — stay in the **same conversation**, letting the earlier turns be summarized. Use it at **intentional breaks between phases**, when you don't mind losing the verbatim history. Don't compact mid-phase — the agent can lose its way. `/handoff` forks; `/compact` continues. - -## Standalone - -Off the main flow entirely. - -- **`/grill-me`** — the same relentless interview as `/grill-with-docs`, but for when you have **no codebase**. Stateless: it saves nothing locally, builds no `CONTEXT.md`. Reach for it to sharpen any plan or design that doesn't live in a repo. -- **`/prototype`** — a small, throwaway program that answers one design question: does this state model feel right, or what should this UI look like. Throwaway from day one — keep the answer, delete the code. It's the detour in step 2 of the main flow, but reach for it any time a design question is hard to settle on paper. -- **`/research`** — delegate reading legwork to a **background agent**: it investigates a question against **primary sources**, then leaves a cited Markdown file in the repo. Keep working while it reads. The file it produces is something to take *into* the main flow at `/grill-with-docs` — research feeds the thinking, it doesn't replace it. -- **`/teach`** — learn a concept over multiple sessions, using the current directory as a stateful workspace. -- **`/writing-great-skills`** — reference for writing and editing skills well. - -## Precondition - -**`/setup-matt-pocock-skills`** — run before your first engineering flow to configure the issue tracker, triage labels, and doc layout the other skills assume. Custom issue trackers also work. diff --git a/.agents/skills/ask-matt/agents/openai.yaml b/.agents/skills/ask-matt/agents/openai.yaml deleted file mode 100644 index 5c60d51..0000000 --- a/.agents/skills/ask-matt/agents/openai.yaml +++ /dev/null @@ -1,5 +0,0 @@ -interface: - display_name: "Ask Matt" - short_description: "Find the right skill or workflow" -policy: - allow_implicit_invocation: false diff --git a/.agents/skills/caveman/SKILL.md b/.agents/skills/caveman/SKILL.md deleted file mode 100644 index 85770a3..0000000 --- a/.agents/skills/caveman/SKILL.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -name: caveman -description: > - Ultra-compressed communication mode. Cuts token usage ~75% by dropping - filler, articles, and pleasantries while keeping full technical accuracy. - Use when user says "caveman mode", "talk like caveman", "use caveman", - "less tokens", "be brief", or invokes /caveman. ---- - -Respond terse like smart caveman. All technical substance stay. Only fluff die. - -## Persistence - -ACTIVE EVERY RESPONSE once triggered. No revert after many turns. No filler drift. Still active if unsure. Off only when user says "stop caveman" or "normal mode". - -## Rules - -Drop: articles (a/an/the), filler (just/really/basically/actually/simply), pleasantries (sure/certainly/of course/happy to), hedging. Fragments OK. Short synonyms (big not extensive, fix not "implement a solution for"). Abbreviate common terms (DB/auth/config/req/res/fn/impl). Strip conjunctions. Use arrows for causality (X -> Y). One word when one word enough. - -Technical terms stay exact. Code blocks unchanged. Errors quoted exact. - -Pattern: `[thing] [action] [reason]. [next step].` - -Not: "Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by..." -Yes: "Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:" - -### Examples - -**"Why React component re-render?"** - -> Inline obj prop -> new ref -> re-render. `useMemo`. - -**"Explain database connection pooling."** - -> Pool = reuse DB conn. Skip handshake -> fast under load. - -## Auto-Clarity Exception - -Drop caveman temporarily for: security warnings, irreversible action confirmations, multi-step sequences where fragment order risks misread, user asks to clarify or repeats question. Resume caveman after clear part done. - -Example -- destructive op: - -> **Warning:** This will permanently delete all rows in the `users` table and cannot be undone. -> -> ```sql -> DROP TABLE users; -> ``` -> -> Caveman resume. Verify backup exist first. diff --git a/.agents/skills/code-review/SKILL.md b/.agents/skills/code-review/SKILL.md deleted file mode 100644 index 2a0b524..0000000 --- a/.agents/skills/code-review/SKILL.md +++ /dev/null @@ -1,89 +0,0 @@ ---- -name: code-review -description: Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X". ---- - -Two-axis review of the diff between `HEAD` and a fixed point the user supplies: - -- **Standards** — does the code conform to this repo's documented coding standards? -- **Spec** — does the code faithfully implement the originating issue / PRD / spec? - -Both axes run as **parallel sub-agents** so they don't pollute each other's context, then this skill aggregates their findings. - -The issue tracker should have been provided to you — run `/setup-matt-pocock-skills` if `docs/agents/issue-tracker.md` is missing. - -## Process - -### 1. Pin the fixed point - -Whatever the user said is the fixed point — a commit SHA, branch name, tag, `main`, `HEAD~5`, etc. If they didn't specify one, ask for it. - -Capture the diff command once: `git diff ...HEAD` (three-dot, so the comparison is against the merge-base). Also note the list of commits via `git log ..HEAD --oneline`. - -Before going further, confirm the fixed point resolves (`git rev-parse `) and the diff is non-empty. A bad ref or empty diff should fail here — not inside two parallel sub-agents. - -### 2. Identify the spec source - -Look for the originating spec, in this order: - -1. Issue references in the commit messages (`#123`, `Closes #45`, GitLab `!67`, etc.) — fetch via the workflow in `docs/agents/issue-tracker.md`. -2. A path the user passed as an argument. -3. A PRD/spec file under `docs/`, `specs/`, or `.scratch/` matching the branch name or feature. -4. If nothing is found, ask the user where the spec is. If they say there isn't one, the **Spec** sub-agent will skip and report "no spec available". - -### 3. Identify the standards sources - -Anything in the repo that documents how code should be written, such as `CODING_STANDARDS.md` or `CONTRIBUTING.md`. - -On top of whatever the repo documents, the Standards axis always carries the **smell baseline** below — a fixed set of Fowler code smells (_Refactoring_, ch.3) that applies even when a repo documents nothing. Two rules bind it: - -- **The repo overrides.** A documented repo standard always wins; where it endorses something the baseline would flag, suppress the smell. -- **Always a judgement call.** Each smell is a labelled heuristic ("possible Feature Envy"), never a hard violation — and, like any standard here, skip anything tooling already enforces. - -Each smell reads *what it is* → *how to fix*; match it against the diff: - -- **Mysterious Name** — a function, variable, or type whose name doesn't reveal what it does or holds. → rename it; if no honest name comes, the design's murky. -- **Duplicated Code** — the same logic shape appears in more than one hunk or file in the change. → extract the shared shape, call it from both. -- **Feature Envy** — a method that reaches into another object's data more than its own. → move the method onto the data it envies. -- **Data Clumps** — the same few fields or params keep travelling together (a type wanting to be born). → bundle them into one type, pass that. -- **Primitive Obsession** — a primitive or string standing in for a domain concept that deserves its own type. → give the concept its own small type. -- **Repeated Switches** — the same `switch`/`if`-cascade on the same type recurs across the change. → replace with polymorphism, or one map both sites share. -- **Shotgun Surgery** — one logical change forces scattered edits across many files in the diff. → gather what changes together into one module. -- **Divergent Change** — one file or module is edited for several unrelated reasons. → split so each module changes for one reason. -- **Speculative Generality** — abstraction, parameters, or hooks added for needs the spec doesn't have. → delete it; inline back until a real need shows. -- **Message Chains** — long `a.b().c().d()` navigation the caller shouldn't depend on. → hide the walk behind one method on the first object. -- **Middle Man** — a class or function that mostly just delegates onward. → cut it, call the real target direct. -- **Refused Bequest** — a subclass or implementer that ignores or overrides most of what it inherits. → drop the inheritance, use composition. - -### 4. Spawn both sub-agents in parallel - -Send a single message with two `Agent` tool calls. Use the `general-purpose` subagent for both. - -**Standards sub-agent prompt** — include: - -- The full diff command and commit list. -- The list of standards-source files you found in step 3, **plus the smell baseline from step 3** pasted in full — the sub-agent has no other access to it. -- The brief: "Report — per file/hunk where relevant — (a) every place the diff violates a documented standard: cite the standard (file + the rule); and (b) any baseline smell you spot: name it and quote the hunk. Distinguish hard violations from judgement calls — documented-standard breaches can be hard, but baseline smells are always judgement calls, and a documented repo standard overrides the baseline. Skip anything tooling enforces. Under 400 words." - -**Spec sub-agent prompt** — include: - -- The diff command and commit list. -- The path or fetched contents of the spec. -- The brief: "Report: (a) requirements the spec asked for that are missing or partial; (b) behaviour in the diff that wasn't asked for (scope creep); (c) requirements that look implemented but where the implementation looks wrong. Quote the spec line for each finding. Under 400 words." - -If the spec is missing, skip the Spec sub-agent and note this in the final report. - -### 5. Aggregate - -Present the two reports under `## Standards` and `## Spec` headings, verbatim or lightly cleaned. Do **not** merge or rerank findings — the two axes are deliberately separate (see _Why two axes_). - -End with a one-line summary: total findings per axis, and the worst issue _within each axis_ (if any). Don't pick a single winner across axes — that's the reranking the separation exists to prevent. - -## Why two axes - -A change can pass one axis and fail the other: - -- Code that follows every standard but implements the wrong thing → **Standards pass, Spec fail.** -- Code that does exactly what the issue asked but breaks the project's conventions → **Spec pass, Standards fail.** - -Reporting them separately stops one axis from masking the other. diff --git a/.agents/skills/code-review/agents/openai.yaml b/.agents/skills/code-review/agents/openai.yaml deleted file mode 100644 index 9076774..0000000 --- a/.agents/skills/code-review/agents/openai.yaml +++ /dev/null @@ -1,3 +0,0 @@ -interface: - display_name: "Code Review" - short_description: "Review a diff on standards and spec" diff --git a/.agents/skills/codebase-design/DEEPENING.md b/.agents/skills/codebase-design/DEEPENING.md deleted file mode 100644 index 3938457..0000000 --- a/.agents/skills/codebase-design/DEEPENING.md +++ /dev/null @@ -1,37 +0,0 @@ -# Deepening - -How to deepen a cluster of shallow modules safely, given its dependencies. Assumes the vocabulary in [SKILL.md](SKILL.md) — **module**, **interface**, **seam**, **adapter**. - -## Dependency categories - -When assessing a candidate for deepening, classify its dependencies. The category determines how the deepened module is tested across its seam. - -### 1. In-process - -Pure computation, in-memory state, no I/O. Always deepenable — merge the modules and test through the new interface directly. No adapter needed. - -### 2. Local-substitutable - -Dependencies that have local test stand-ins (PGLite for Postgres, in-memory filesystem). Deepenable if the stand-in exists. The deepened module is tested with the stand-in running in the test suite. The seam is internal; no port at the module's external interface. - -### 3. Remote but owned (Ports & Adapters) - -Your own services across a network boundary (microservices, internal APIs). Define a **port** (interface) at the seam. The deep module owns the logic; the transport is injected as an **adapter**. Tests use an in-memory adapter. Production uses an HTTP/gRPC/queue adapter. - -Recommendation shape: *"Define a port at the seam, implement an HTTP adapter for production and an in-memory adapter for testing, so the logic sits in one deep module even though it's deployed across a network."* - -### 4. True external (Mock) - -Third-party services (Stripe, Twilio, etc.) you don't control. The deepened module takes the external dependency as an injected port; tests provide a mock adapter. - -## Seam discipline - -- **One adapter means a hypothetical seam. Two adapters means a real one.** Don't introduce a port unless at least two adapters are justified (typically production + test). A single-adapter seam is just indirection. -- **Internal seams vs external seams.** A deep module can have internal seams (private to its implementation, used by its own tests) as well as the external seam at its interface. Don't expose internal seams through the interface just because tests use them. - -## Testing strategy: replace, don't layer - -- Old unit tests on shallow modules become waste once tests at the deepened module's interface exist — delete them. -- Write new tests at the deepened module's interface. The **interface is the test surface**. -- Tests assert on observable outcomes through the interface, not internal state. -- Tests should survive internal refactors — they describe behaviour, not implementation. If a test has to change when the implementation changes, it's testing past the interface. diff --git a/.agents/skills/codebase-design/DESIGN-IT-TWICE.md b/.agents/skills/codebase-design/DESIGN-IT-TWICE.md deleted file mode 100644 index 49a7c42..0000000 --- a/.agents/skills/codebase-design/DESIGN-IT-TWICE.md +++ /dev/null @@ -1,44 +0,0 @@ -# Design It Twice - -When the user wants to explore alternative interfaces for a chosen deepening candidate, use this parallel sub-agent pattern. Based on "Design It Twice" (Ousterhout) — your first idea is unlikely to be the best. - -Uses the vocabulary in [SKILL.md](SKILL.md) — **module**, **interface**, **seam**, **adapter**, **leverage**. - -## Process - -### 1. Frame the problem space - -Before spawning sub-agents, write a user-facing explanation of the problem space for the chosen candidate: - -- The constraints any new interface would need to satisfy -- The dependencies it would rely on, and which category they fall into (see [DEEPENING.md](DEEPENING.md)) -- A rough illustrative code sketch to ground the constraints — not a proposal, just a way to make the constraints concrete - -Show this to the user, then immediately proceed to Step 2. The user reads and thinks while the sub-agents work in parallel. - -### 2. Spawn sub-agents - -Spawn 3+ sub-agents in parallel using the Agent tool. Each must produce a **radically different** interface for the deepened module. - -Prompt each sub-agent with a separate technical brief (file paths, coupling details, dependency category from [DEEPENING.md](DEEPENING.md), what sits behind the seam). The brief is independent of the user-facing problem-space explanation in Step 1. Give each agent a different design constraint: - -- Agent 1: "Minimize the interface — aim for 1–3 entry points max. Maximise leverage per entry point." -- Agent 2: "Maximise flexibility — support many use cases and extension." -- Agent 3: "Optimise for the most common caller — make the default case trivial." -- Agent 4 (if applicable): "Design around ports & adapters for cross-seam dependencies." - -Include both [SKILL.md](SKILL.md) vocabulary and CONTEXT.md vocabulary in the brief so each sub-agent names things consistently with the architecture language and the project's domain language. - -Each sub-agent outputs: - -1. Interface (types, methods, params — plus invariants, ordering, error modes) -2. Usage example showing how callers use it -3. What the implementation hides behind the seam -4. Dependency strategy and adapters (see [DEEPENING.md](DEEPENING.md)) -5. Trade-offs — where leverage is high, where it's thin - -### 3. Present and compare - -Present designs sequentially so the user can absorb each one, then compare them in prose. Contrast by **depth** (leverage at the interface), **locality** (where change concentrates), and **seam placement**. - -After comparing, give your own recommendation: which design you think is strongest and why. If elements from different designs would combine well, propose a hybrid. Be opinionated — the user wants a strong read, not a menu. diff --git a/.agents/skills/codebase-design/SKILL.md b/.agents/skills/codebase-design/SKILL.md deleted file mode 100644 index 16620c2..0000000 --- a/.agents/skills/codebase-design/SKILL.md +++ /dev/null @@ -1,114 +0,0 @@ ---- -name: codebase-design -description: Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary. ---- - -# Codebase Design - -Design **deep modules**: a lot of behaviour behind a small interface, placed at a clean seam, testable through that interface. Use this language and these principles wherever code is being designed or restructured. The aim is leverage for callers, locality for maintainers, and testability for everyone. - -## Glossary - -Use these terms exactly — don't substitute "component," "service," "API," or "boundary." Consistent language is the whole point. - -**Module** — anything with an interface and an implementation. Deliberately scale-agnostic: a function, class, package, or tier-spanning slice. _Avoid_: unit, component, service. - -**Interface** — everything a caller must know to use the module correctly: the type signature, but also invariants, ordering constraints, error modes, required configuration, and performance characteristics. _Avoid_: API, signature (too narrow — they refer only to the type-level surface). - -**Implementation** — what's inside a module, its body of code. Distinct from **Adapter**: a thing can be a small adapter with a large implementation (a Postgres repo) or a large adapter with a small implementation (an in-memory fake). Reach for "adapter" when the seam is the topic; "implementation" otherwise. - -**Depth** — leverage at the interface: the amount of behaviour a caller (or test) can exercise per unit of interface they have to learn. A module is **deep** when a large amount of behaviour sits behind a small interface, **shallow** when the interface is nearly as complex as the implementation. - -**Seam** _(Michael Feathers)_ — a place where you can alter behaviour without editing in that place; the *location* at which a module's interface lives. Where to put the seam is its own design decision, distinct from what goes behind it. _Avoid_: boundary (overloaded with DDD's bounded context). - -**Adapter** — a concrete thing that satisfies an interface at a seam. Describes *role* (what slot it fills), not substance (what's inside). - -**Leverage** — what callers get from depth: more capability per unit of interface they learn. One implementation pays back across N call sites and M tests. - -**Locality** — what maintainers get from depth: change, bugs, knowledge, and verification concentrate in one place rather than spreading across callers. Fix once, fixed everywhere. - -## Deep vs shallow - -**Deep module** = small interface + lots of implementation: - -``` -┌─────────────────────┐ -│ Small Interface │ ← Few methods, simple params -├─────────────────────┤ -│ │ -│ Deep Implementation│ ← Complex logic hidden -│ │ -└─────────────────────┘ -``` - -**Shallow module** = large interface + little implementation (avoid): - -``` -┌─────────────────────────────────┐ -│ Large Interface │ ← Many methods, complex params -├─────────────────────────────────┤ -│ Thin Implementation │ ← Just passes through -└─────────────────────────────────┘ -``` - -When designing an interface, ask: - -- Can I reduce the number of methods? -- Can I simplify the parameters? -- Can I hide more complexity inside? - -## Principles - -- **Depth is a property of the interface, not the implementation.** A deep module can be internally composed of small, mockable, swappable parts — they just aren't part of the interface. A module can have **internal seams** (private to its implementation, used by its own tests) as well as the **external seam** at its interface. -- **The deletion test.** Imagine deleting the module. If complexity vanishes, it was a pass-through. If complexity reappears across N callers, it was earning its keep. -- **The interface is the test surface.** Callers and tests cross the same seam. If you want to test *past* the interface, the module is probably the wrong shape. -- **One adapter means a hypothetical seam. Two adapters means a real one.** Don't introduce a seam unless something actually varies across it. - -## Designing for testability - -Good interfaces make testing natural: - -1. **Accept dependencies, don't create them.** - - ```typescript - // Testable - function processOrder(order, paymentGateway) {} - - // Hard to test - function processOrder(order) { - const gateway = new StripeGateway(); - } - ``` - -2. **Return results, don't produce side effects.** - - ```typescript - // Testable - function calculateDiscount(cart): Discount {} - - // Hard to test - function applyDiscount(cart): void { - cart.total -= discount; - } - ``` - -3. **Small surface area.** Fewer methods = fewer tests needed. Fewer params = simpler test setup. - -## Relationships - -- A **Module** has exactly one **Interface** (the surface it presents to callers and tests). -- **Depth** is a property of a **Module**, measured against its **Interface**. -- A **Seam** is where a **Module**'s **Interface** lives. -- An **Adapter** sits at a **Seam** and satisfies the **Interface**. -- **Depth** produces **Leverage** for callers and **Locality** for maintainers. - -## Rejected framings - -- **Depth as ratio of implementation-lines to interface-lines** (Ousterhout): rewards padding the implementation. We use depth-as-leverage instead. -- **"Interface" as the TypeScript `interface` keyword or a class's public methods**: too narrow — interface here includes every fact a caller must know. -- **"Boundary"**: overloaded with DDD's bounded context. Say **seam** or **interface**. - -## Going deeper - -- **Deepening a cluster given its dependencies** — see [DEEPENING.md](DEEPENING.md): dependency categories, seam discipline, and replace-don't-layer testing. -- **Exploring alternative interfaces** — see [DESIGN-IT-TWICE.md](DESIGN-IT-TWICE.md): spin up parallel sub-agents to design the interface several radically different ways, then compare on depth, locality, and seam placement. diff --git a/.agents/skills/codebase-design/agents/openai.yaml b/.agents/skills/codebase-design/agents/openai.yaml deleted file mode 100644 index 3180715..0000000 --- a/.agents/skills/codebase-design/agents/openai.yaml +++ /dev/null @@ -1,3 +0,0 @@ -interface: - display_name: "Codebase Design" - short_description: "Vocabulary for deep-module design" diff --git a/.agents/skills/diagnose/SKILL.md b/.agents/skills/diagnose/SKILL.md deleted file mode 100644 index ed55bda..0000000 --- a/.agents/skills/diagnose/SKILL.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -name: diagnose -description: Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression. ---- - -# Diagnose - -A discipline for hard bugs. Skip phases only when explicitly justified. - -When exploring the codebase, use the project's domain glossary to get a clear mental model of the relevant modules, and check ADRs in the area you're touching. - -## Phase 1 — Build a feedback loop - -**This is the skill.** Everything else is mechanical. If you have a fast, deterministic, agent-runnable pass/fail signal for the bug, you will find the cause — bisection, hypothesis-testing, and instrumentation all just consume that signal. If you don't have one, no amount of staring at code will save you. - -Spend disproportionate effort here. **Be aggressive. Be creative. Refuse to give up.** - -### Ways to construct one — try them in roughly this order - -1. **Failing test** at whatever seam reaches the bug — unit, integration, e2e. -2. **Curl / HTTP script** against a running dev server. -3. **CLI invocation** with a fixture input, diffing stdout against a known-good snapshot. -4. **Headless browser script** (Playwright / Puppeteer) — drives the UI, asserts on DOM/console/network. -5. **Replay a captured trace.** Save a real network request / payload / event log to disk; replay it through the code path in isolation. -6. **Throwaway harness.** Spin up a minimal subset of the system (one service, mocked deps) that exercises the bug code path with a single function call. -7. **Property / fuzz loop.** If the bug is "sometimes wrong output", run 1000 random inputs and look for the failure mode. -8. **Bisection harness.** If the bug appeared between two known states (commit, dataset, version), automate "boot at state X, check, repeat" so you can `git bisect run` it. -9. **Differential loop.** Run the same input through old-version vs new-version (or two configs) and diff outputs. -10. **HITL bash script.** Last resort. If a human must click, drive _them_ with `scripts/hitl-loop.template.sh` so the loop is still structured. Captured output feeds back to you. - -Build the right feedback loop, and the bug is 90% fixed. - -### Iterate on the loop itself - -Treat the loop as a product. Once you have _a_ loop, ask: - -- Can I make it faster? (Cache setup, skip unrelated init, narrow the test scope.) -- Can I make the signal sharper? (Assert on the specific symptom, not "didn't crash".) -- Can I make it more deterministic? (Pin time, seed RNG, isolate filesystem, freeze network.) - -A 30-second flaky loop is barely better than no loop. A 2-second deterministic loop is a debugging superpower. - -### Non-deterministic bugs - -The goal is not a clean repro but a **higher reproduction rate**. Loop the trigger 100×, parallelise, add stress, narrow timing windows, inject sleeps. A 50%-flake bug is debuggable; 1% is not — keep raising the rate until it's debuggable. - -### When you genuinely cannot build a loop - -Stop and say so explicitly. List what you tried. Ask the user for: (a) access to whatever environment reproduces it, (b) a captured artifact (HAR file, log dump, core dump, screen recording with timestamps), or (c) permission to add temporary production instrumentation. Do **not** proceed to hypothesise without a loop. - -Do not proceed to Phase 2 until you have a loop you believe in. - -## Phase 2 — Reproduce - -Run the loop. Watch the bug appear. - -Confirm: - -- [ ] The loop produces the failure mode the **user** described — not a different failure that happens to be nearby. Wrong bug = wrong fix. -- [ ] The failure is reproducible across multiple runs (or, for non-deterministic bugs, reproducible at a high enough rate to debug against). -- [ ] You have captured the exact symptom (error message, wrong output, slow timing) so later phases can verify the fix actually addresses it. - -Do not proceed until you reproduce the bug. - -## Phase 3 — Hypothesise - -Generate **3–5 ranked hypotheses** before testing any of them. Single-hypothesis generation anchors on the first plausible idea. - -Each hypothesis must be **falsifiable**: state the prediction it makes. - -> Format: "If is the cause, then will make the bug disappear / will make it worse." - -If you cannot state the prediction, the hypothesis is a vibe — discard or sharpen it. - -**Show the ranked list to the user before testing.** They often have domain knowledge that re-ranks instantly ("we just deployed a change to #3"), or know hypotheses they've already ruled out. Cheap checkpoint, big time saver. Don't block on it — proceed with your ranking if the user is AFK. - -## Phase 4 — Instrument - -Each probe must map to a specific prediction from Phase 3. **Change one variable at a time.** - -Tool preference: - -1. **Debugger / REPL inspection** if the env supports it. One breakpoint beats ten logs. -2. **Targeted logs** at the boundaries that distinguish hypotheses. -3. Never "log everything and grep". - -**Tag every debug log** with a unique prefix, e.g. `[DEBUG-a4f2]`. Cleanup at the end becomes a single grep. Untagged logs survive; tagged logs die. - -**Perf branch.** For performance regressions, logs are usually wrong. Instead: establish a baseline measurement (timing harness, `performance.now()`, profiler, query plan), then bisect. Measure first, fix second. - -## Phase 5 — Fix + regression test - -Write the regression test **before the fix** — but only if there is a **correct seam** for it. - -A correct seam is one where the test exercises the **real bug pattern** as it occurs at the call site. If the only available seam is too shallow (single-caller test when the bug needs multiple callers, unit test that can't replicate the chain that triggered the bug), a regression test there gives false confidence. - -**If no correct seam exists, that itself is the finding.** Note it. The codebase architecture is preventing the bug from being locked down. Flag this for the next phase. - -If a correct seam exists: - -1. Turn the minimised repro into a failing test at that seam. -2. Watch it fail. -3. Apply the fix. -4. Watch it pass. -5. Re-run the Phase 1 feedback loop against the original (un-minimised) scenario. - -## Phase 6 — Cleanup + post-mortem - -Required before declaring done: - -- [ ] Original repro no longer reproduces (re-run the Phase 1 loop) -- [ ] Regression test passes (or absence of seam is documented) -- [ ] All `[DEBUG-...]` instrumentation removed (`grep` the prefix) -- [ ] Throwaway prototypes deleted (or moved to a clearly-marked debug location) -- [ ] The hypothesis that turned out correct is stated in the commit / PR message — so the next debugger learns - -**Then ask: what would have prevented this bug?** If the answer involves architectural change (no good test seam, tangled callers, hidden coupling) hand off to the `/improve-codebase-architecture` skill with the specifics. Make the recommendation **after** the fix is in, not before — you have more information now than when you started. diff --git a/.agents/skills/diagnose/scripts/hitl-loop.template.sh b/.agents/skills/diagnose/scripts/hitl-loop.template.sh deleted file mode 100644 index 40afc46..0000000 --- a/.agents/skills/diagnose/scripts/hitl-loop.template.sh +++ /dev/null @@ -1,41 +0,0 @@ -#!/usr/bin/env bash -# Human-in-the-loop reproduction loop. -# Copy this file, edit the steps below, and run it. -# The agent runs the script; the user follows prompts in their terminal. -# -# Usage: -# bash hitl-loop.template.sh -# -# Two helpers: -# step "" → show instruction, wait for Enter -# capture VAR "" → show question, read response into VAR -# -# At the end, captured values are printed as KEY=VALUE for the agent to parse. - -set -euo pipefail - -step() { - printf '\n>>> %s\n' "$1" - read -r -p " [Enter when done] " _ -} - -capture() { - local var="$1" question="$2" answer - printf '\n>>> %s\n' "$question" - read -r -p " > " answer - printf -v "$var" '%s' "$answer" -} - -# --- edit below --------------------------------------------------------- - -step "Open the app at http://localhost:3000 and sign in." - -capture ERRORED "Click the 'Export' button. Did it throw an error? (y/n)" - -capture ERROR_MSG "Paste the error message (or 'none'):" - -# --- edit above --------------------------------------------------------- - -printf '\n--- Captured ---\n' -printf 'ERRORED=%s\n' "$ERRORED" -printf 'ERROR_MSG=%s\n' "$ERROR_MSG" diff --git a/.agents/skills/diagnosing-bugs/SKILL.md b/.agents/skills/diagnosing-bugs/SKILL.md deleted file mode 100644 index f400de7..0000000 --- a/.agents/skills/diagnosing-bugs/SKILL.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -name: diagnosing-bugs -description: Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow. ---- - -# Diagnosing Bugs - -A discipline for hard bugs. Skip phases only when explicitly justified. - -When exploring the codebase, read `CONTEXT.md` (if it exists) to get a clear mental model of the relevant modules, and check ADRs in the area you're touching. - -## Phase 1 — Build a feedback loop - -**This is the skill.** Everything else is mechanical. If you have a **tight** pass/fail signal for the bug — one that goes red on _this_ bug — you will find the cause; bisection, hypothesis-testing, and instrumentation all just consume it. If you don't have one, no amount of staring at code will save you. - -Spend disproportionate effort here. **Be aggressive. Be creative. Refuse to give up.** - -### Ways to construct one — try them in roughly this order - -1. **Failing test** at whatever seam reaches the bug — unit, integration, e2e. -2. **Curl / HTTP script** against a running dev server. -3. **CLI invocation** with a fixture input, diffing stdout against a known-good snapshot. -4. **Headless browser script** (Playwright / Puppeteer) — drives the UI, asserts on DOM/console/network. -5. **Replay a captured trace.** Save a real network request / payload / event log to disk; replay it through the code path in isolation. -6. **Throwaway harness.** Spin up a minimal subset of the system (one service, mocked deps) that exercises the bug code path with a single function call. -7. **Property / fuzz loop.** If the bug is "sometimes wrong output", run 1000 random inputs and look for the failure mode. -8. **Bisection harness.** If the bug appeared between two known states (commit, dataset, version), automate "boot at state X, check, repeat" so you can `git bisect run` it. -9. **Differential loop.** Run the same input through old-version vs new-version (or two configs) and diff outputs. -10. **HITL bash script.** Last resort. If a human must click, drive _them_ with `scripts/hitl-loop.template.sh` so the loop is still structured. Captured output feeds back to you. - -Build the right feedback loop, and the bug is 90% fixed. - -### Tighten the loop - -Treat the loop as a product. Once you have _a_ loop, **tighten** it: - -- Can I make it faster? (Cache setup, skip unrelated init, narrow the test scope.) -- Can I make the signal sharper? (Assert on the specific symptom, not "didn't crash".) -- Can I make it more deterministic? (Pin time, seed RNG, isolate filesystem, freeze network.) - -A 30-second flaky loop is barely better than no loop; a 2-second deterministic one is tight — a debugging superpower. - -### Non-deterministic bugs - -The goal is not a clean repro but a **higher reproduction rate**. Loop the trigger 100×, parallelise, add stress, narrow timing windows, inject sleeps. A 50%-flake bug is debuggable; 1% is not — keep raising the rate until it's debuggable. - -### When you genuinely cannot build a loop - -Stop and say so explicitly. List what you tried. Ask the user for: (a) access to whatever environment reproduces it, (b) a captured artifact (HAR file, log dump, core dump, screen recording with timestamps), or (c) permission to add temporary production instrumentation. Do **not** proceed to hypothesise without a loop. - -### Completion criterion — a tight loop that goes red - -Phase 1 is done when the loop is **tight** and **red-capable**: you can name **one command** — a script path, a test invocation, a curl — that you have **already run at least once** (paste the invocation and its output), and that is: - -- [ ] **Red-capable** — it drives the actual bug code path and asserts the **user's exact symptom**, so it can go red on this bug and green once fixed. Not "runs without erroring" — it must be able to _catch this specific bug_. -- [ ] **Deterministic** — same verdict every run (flaky bugs: a pinned, high reproduction rate, per above). -- [ ] **Fast** — seconds, not minutes. -- [ ] **Agent-runnable** — you can run it unattended; a human in the loop only via `scripts/hitl-loop.template.sh`. - -If you catch yourself reading code to build a theory before this command exists, **stop — jumping straight to a hypothesis is the exact failure this skill prevents.** No red-capable command, no Phase 2. - -## Phase 2 — Reproduce + minimise - -Run the loop. Watch it go red — the bug appears. - -Confirm: - -- [ ] The loop produces the failure mode the **user** described — not a different failure that happens to be nearby. Wrong bug = wrong fix. -- [ ] The failure is reproducible across multiple runs (or, for non-deterministic bugs, reproducible at a high enough rate to debug against). -- [ ] You have captured the exact symptom (error message, wrong output, slow timing) so later phases can verify the fix actually addresses it. - -### Minimise - -Once it's red, shrink the repro to the **smallest scenario that still goes red**. Cut inputs, callers, config, data, and steps **one at a time**, re-running the loop after each cut — keep only what's load-bearing for the failure. - -Why bother: a minimal repro shrinks the hypothesis space in Phase 3 (fewer moving parts left to suspect) and becomes the clean regression test in Phase 5. - -Done when **every remaining element is load-bearing** — removing any one of them makes the loop go green. - -Do not proceed until you have reproduced **and** minimised. - -## Phase 3 — Hypothesise - -Generate **3–5 ranked hypotheses** before testing any of them. Single-hypothesis generation anchors on the first plausible idea. - -Each hypothesis must be **falsifiable**: state the prediction it makes. - -> Format: "If is the cause, then will make the bug disappear / will make it worse." - -If you cannot state the prediction, the hypothesis is a vibe — discard or sharpen it. - -**Show the ranked list to the user before testing.** They often have domain knowledge that re-ranks instantly ("we just deployed a change to #3"), or know hypotheses they've already ruled out. Cheap checkpoint, big time saver. Don't block on it — proceed with your ranking if the user is AFK. - -## Phase 4 — Instrument - -Each probe must map to a specific prediction from Phase 3. **Change one variable at a time.** - -Tool preference: - -1. **Debugger / REPL inspection** if the env supports it. One breakpoint beats ten logs. -2. **Targeted logs** at the boundaries that distinguish hypotheses. -3. Never "log everything and grep". - -**Tag every debug log** with a unique prefix, e.g. `[DEBUG-a4f2]`. Cleanup at the end becomes a single grep. Untagged logs survive; tagged logs die. - -**Perf branch.** For performance regressions, logs are usually wrong. Instead: establish a baseline measurement (timing harness, `performance.now()`, profiler, query plan), then bisect. Measure first, fix second. - -## Phase 5 — Fix + regression test - -Write the regression test **before the fix** — but only if there is a **correct seam** for it. - -A correct seam is one where the test exercises the **real bug pattern** as it occurs at the call site. If the only available seam is too shallow (single-caller test when the bug needs multiple callers, unit test that can't replicate the chain that triggered the bug), a regression test there gives false confidence. - -**If no correct seam exists, that itself is the finding.** Note it. The codebase architecture is preventing the bug from being locked down. Flag this for the next phase. - -If a correct seam exists: - -1. Turn the minimised repro into a failing test at that seam. -2. Watch it fail. -3. Apply the fix. -4. Watch it pass. -5. Re-run the Phase 1 feedback loop against the original (un-minimised) scenario. - -## Phase 6 — Cleanup + post-mortem - -Required before declaring done: - -- [ ] Original repro no longer reproduces (re-run the Phase 1 loop) -- [ ] Regression test passes (or absence of seam is documented) -- [ ] All `[DEBUG-...]` instrumentation removed (`grep` the prefix) -- [ ] Throwaway prototypes deleted (or moved to a clearly-marked debug location) -- [ ] The hypothesis that turned out correct is stated in the commit / PR message — so the next debugger learns - -**Then ask: what would have prevented this bug?** If the answer involves architectural change (no good test seam, tangled callers, hidden coupling) hand off to the `/improve-codebase-architecture` skill with the specifics. Make the recommendation **after** the fix is in, not before — you have more information now than when you started. diff --git a/.agents/skills/diagnosing-bugs/agents/openai.yaml b/.agents/skills/diagnosing-bugs/agents/openai.yaml deleted file mode 100644 index a13a755..0000000 --- a/.agents/skills/diagnosing-bugs/agents/openai.yaml +++ /dev/null @@ -1,3 +0,0 @@ -interface: - display_name: "Diagnosing Bugs" - short_description: "Diagnose hard bugs and regressions" diff --git a/.agents/skills/diagnosing-bugs/scripts/hitl-loop.template.sh b/.agents/skills/diagnosing-bugs/scripts/hitl-loop.template.sh deleted file mode 100644 index 40afc46..0000000 --- a/.agents/skills/diagnosing-bugs/scripts/hitl-loop.template.sh +++ /dev/null @@ -1,41 +0,0 @@ -#!/usr/bin/env bash -# Human-in-the-loop reproduction loop. -# Copy this file, edit the steps below, and run it. -# The agent runs the script; the user follows prompts in their terminal. -# -# Usage: -# bash hitl-loop.template.sh -# -# Two helpers: -# step "" → show instruction, wait for Enter -# capture VAR "" → show question, read response into VAR -# -# At the end, captured values are printed as KEY=VALUE for the agent to parse. - -set -euo pipefail - -step() { - printf '\n>>> %s\n' "$1" - read -r -p " [Enter when done] " _ -} - -capture() { - local var="$1" question="$2" answer - printf '\n>>> %s\n' "$question" - read -r -p " > " answer - printf -v "$var" '%s' "$answer" -} - -# --- edit below --------------------------------------------------------- - -step "Open the app at http://localhost:3000 and sign in." - -capture ERRORED "Click the 'Export' button. Did it throw an error? (y/n)" - -capture ERROR_MSG "Paste the error message (or 'none'):" - -# --- edit above --------------------------------------------------------- - -printf '\n--- Captured ---\n' -printf 'ERRORED=%s\n' "$ERRORED" -printf 'ERROR_MSG=%s\n' "$ERROR_MSG" diff --git a/.agents/skills/domain-modeling/ADR-FORMAT.md b/.agents/skills/domain-modeling/ADR-FORMAT.md deleted file mode 100644 index da7e78e..0000000 --- a/.agents/skills/domain-modeling/ADR-FORMAT.md +++ /dev/null @@ -1,47 +0,0 @@ -# ADR Format - -ADRs live in `docs/adr/` and use sequential numbering: `0001-slug.md`, `0002-slug.md`, etc. - -Create the `docs/adr/` directory lazily — only when the first ADR is needed. - -## Template - -```md -# {Short title of the decision} - -{1-3 sentences: what's the context, what did we decide, and why.} -``` - -That's it. An ADR can be a single paragraph. The value is in recording *that* a decision was made and *why* — not in filling out sections. - -## Optional sections - -Only include these when they add genuine value. Most ADRs won't need them. - -- **Status** frontmatter (`proposed | accepted | deprecated | superseded by ADR-NNNN`) — useful when decisions are revisited -- **Considered Options** — only when the rejected alternatives are worth remembering -- **Consequences** — only when non-obvious downstream effects need to be called out - -## Numbering - -Scan `docs/adr/` for the highest existing number and increment by one. - -## When to offer an ADR - -All three of these must be true: - -1. **Hard to reverse** — the cost of changing your mind later is meaningful -2. **Surprising without context** — a future reader will look at the code and wonder "why on earth did they do it this way?" -3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons - -If a decision is easy to reverse, skip it — you'll just reverse it. If it's not surprising, nobody will wonder why. If there was no real alternative, there's nothing to record beyond "we did the obvious thing." - -### What qualifies - -- **Architectural shape.** "We're using a monorepo." "The write model is event-sourced, the read model is projected into Postgres." -- **Integration patterns between contexts.** "Ordering and Billing communicate via domain events, not synchronous HTTP." -- **Technology choices that carry lock-in.** Database, message bus, auth provider, deployment target. Not every library — just the ones that would take a quarter to swap out. -- **Boundary and scope decisions.** "Customer data is owned by the Customer context; other contexts reference it by ID only." The explicit no-s are as valuable as the yes-s. -- **Deliberate deviations from the obvious path.** "We're using manual SQL instead of an ORM because X." Anything where a reasonable reader would assume the opposite. These stop the next engineer from "fixing" something that was deliberate. -- **Constraints not visible in the code.** "We can't use AWS because of compliance requirements." "Response times must be under 200ms because of the partner API contract." -- **Rejected alternatives when the rejection is non-obvious.** If you considered GraphQL and picked REST for subtle reasons, record it — otherwise someone will suggest GraphQL again in six months. diff --git a/.agents/skills/domain-modeling/CONTEXT-FORMAT.md b/.agents/skills/domain-modeling/CONTEXT-FORMAT.md deleted file mode 100644 index eaf2a18..0000000 --- a/.agents/skills/domain-modeling/CONTEXT-FORMAT.md +++ /dev/null @@ -1,60 +0,0 @@ -# CONTEXT.md Format - -## Structure - -```md -# {Context Name} - -{One or two sentence description of what this context is and why it exists.} - -## Language - -**Order**: -{A one or two sentence description of the term} -_Avoid_: Purchase, transaction - -**Invoice**: -A request for payment sent to a customer after delivery. -_Avoid_: Bill, payment request - -**Customer**: -A person or organization that places orders. -_Avoid_: Client, buyer, account -``` - -## Rules - -- **Be opinionated.** When multiple words exist for the same concept, pick the best one and list the others under `_Avoid_`. -- **Keep definitions tight.** One or two sentences max. Define what it IS, not what it does. -- **Only include terms specific to this project's context.** General programming concepts (timeouts, error types, utility patterns) don't belong even if the project uses them extensively. Before adding a term, ask: is this a concept unique to this context, or a general programming concept? Only the former belongs. -- **Group terms under subheadings** when natural clusters emerge. If all terms belong to a single cohesive area, a flat list is fine. - -## Single vs multi-context repos - -**Single context (most repos):** One `CONTEXT.md` at the repo root. - -**Multiple contexts:** A `CONTEXT-MAP.md` at the repo root lists the contexts, where they live, and how they relate to each other: - -```md -# Context Map - -## Contexts - -- [Ordering](./src/ordering/CONTEXT.md) — receives and tracks customer orders -- [Billing](./src/billing/CONTEXT.md) — generates invoices and processes payments -- [Fulfillment](./src/fulfillment/CONTEXT.md) — manages warehouse picking and shipping - -## Relationships - -- **Ordering → Fulfillment**: Ordering emits `OrderPlaced` events; Fulfillment consumes them to start picking -- **Fulfillment → Billing**: Fulfillment emits `ShipmentDispatched` events; Billing consumes them to generate invoices -- **Ordering ↔ Billing**: Shared types for `CustomerId` and `Money` -``` - -The skill infers which structure applies: - -- If `CONTEXT-MAP.md` exists, read it to find contexts -- If only a root `CONTEXT.md` exists, single context -- If neither exists, create a root `CONTEXT.md` lazily when the first term is resolved - -When multiple contexts exist, infer which one the current topic relates to. If unclear, ask. diff --git a/.agents/skills/domain-modeling/SKILL.md b/.agents/skills/domain-modeling/SKILL.md deleted file mode 100644 index d0f7e1a..0000000 --- a/.agents/skills/domain-modeling/SKILL.md +++ /dev/null @@ -1,74 +0,0 @@ ---- -name: domain-modeling -description: Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model. ---- - -# Domain Modeling - -Actively build and sharpen the project's domain model as you design. This is the *active* discipline — challenging terms, inventing edge-case scenarios, and writing the glossary and decisions down the moment they crystallise. (Merely *reading* `CONTEXT.md` for vocabulary is not this skill — that's a one-line habit any skill can do. This skill is for when you're changing the model, not just consuming it.) - -## File structure - -Most repos have a single context: - -``` -/ -├── CONTEXT.md -├── docs/ -│ └── adr/ -│ ├── 0001-event-sourced-orders.md -│ └── 0002-postgres-for-write-model.md -└── src/ -``` - -If a `CONTEXT-MAP.md` exists at the root, the repo has multiple contexts. The map points to where each one lives: - -``` -/ -├── CONTEXT-MAP.md -├── docs/ -│ └── adr/ ← system-wide decisions -├── src/ -│ ├── ordering/ -│ │ ├── CONTEXT.md -│ │ └── docs/adr/ ← context-specific decisions -│ └── billing/ -│ ├── CONTEXT.md -│ └── docs/adr/ -``` - -Create files lazily — only when you have something to write. If no `CONTEXT.md` exists, create one when the first term is resolved. If no `docs/adr/` exists, create it when the first ADR is needed. - -## During the session - -### Challenge against the glossary - -When the user uses a term that conflicts with the existing language in `CONTEXT.md`, call it out immediately. "Your glossary defines 'cancellation' as X, but you seem to mean Y — which is it?" - -### Sharpen fuzzy language - -When the user uses vague or overloaded terms, propose a precise canonical term. "You're saying 'account' — do you mean the Customer or the User? Those are different things." - -### Discuss concrete scenarios - -When domain relationships are being discussed, stress-test them with specific scenarios. Invent scenarios that probe edge cases and force the user to be precise about the boundaries between concepts. - -### Cross-reference with code - -When the user states how something works, check whether the code agrees. If you find a contradiction, surface it: "Your code cancels entire Orders, but you just said partial cancellation is possible — which is right?" - -### Update CONTEXT.md inline - -When a term is resolved, update `CONTEXT.md` right there. Don't batch these up — capture them as they happen. Use the format in [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md). - -`CONTEXT.md` should be totally devoid of implementation details. Do not treat `CONTEXT.md` as a spec, a scratch pad, or a repository for implementation decisions. It is a glossary and nothing else. - -### Offer ADRs sparingly - -Only offer to create an ADR when all three are true: - -1. **Hard to reverse** — the cost of changing your mind later is meaningful -2. **Surprising without context** — a future reader will wonder "why did they do it this way?" -3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons - -If any of the three is missing, skip the ADR. Use the format in [ADR-FORMAT.md](./ADR-FORMAT.md). diff --git a/.agents/skills/domain-modeling/agents/openai.yaml b/.agents/skills/domain-modeling/agents/openai.yaml deleted file mode 100644 index 7f1522d..0000000 --- a/.agents/skills/domain-modeling/agents/openai.yaml +++ /dev/null @@ -1,3 +0,0 @@ -interface: - display_name: "Domain Modeling" - short_description: "Build and sharpen a domain model" diff --git a/.agents/skills/grill-me/SKILL.md b/.agents/skills/grill-me/SKILL.md deleted file mode 100644 index 9470cfc..0000000 --- a/.agents/skills/grill-me/SKILL.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -name: grill-me -description: A relentless interview to sharpen a plan or design. -disable-model-invocation: true ---- - -Run a `/grilling` session. diff --git a/.agents/skills/grill-me/agents/openai.yaml b/.agents/skills/grill-me/agents/openai.yaml deleted file mode 100644 index 4d6fb0c..0000000 --- a/.agents/skills/grill-me/agents/openai.yaml +++ /dev/null @@ -1,5 +0,0 @@ -interface: - display_name: "Grill Me" - short_description: "Sharpen a plan through interview" -policy: - allow_implicit_invocation: false diff --git a/.agents/skills/grill-with-docs/SKILL.md b/.agents/skills/grill-with-docs/SKILL.md deleted file mode 100644 index bed05d2..0000000 --- a/.agents/skills/grill-with-docs/SKILL.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -name: grill-with-docs -description: A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go. -disable-model-invocation: true ---- - -Run a `/grilling` session, using the `/domain-modeling` skill. diff --git a/.agents/skills/grill-with-docs/agents/openai.yaml b/.agents/skills/grill-with-docs/agents/openai.yaml deleted file mode 100644 index 5dbe278..0000000 --- a/.agents/skills/grill-with-docs/agents/openai.yaml +++ /dev/null @@ -1,5 +0,0 @@ -interface: - display_name: "Grill with Docs" - short_description: "Grill a design and write its docs" -policy: - allow_implicit_invocation: false diff --git a/.agents/skills/grilling/SKILL.md b/.agents/skills/grilling/SKILL.md deleted file mode 100644 index 52d8eb3..0000000 --- a/.agents/skills/grilling/SKILL.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -name: grilling -description: Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases. ---- - -Interview me relentlessly about every aspect of this until we reach a shared understanding. Walk down each branch of the decision tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer. - -Ask the questions one at a time, waiting for feedback on each question before continuing. Asking multiple questions at once is bewildering. - -If a *fact* can be found by exploring the environment (filesystem, tools, etc.), look it up rather than asking me. The *decisions*, though, are mine — put each one to me and wait for my answer. - -Do not act on it until I confirm we have reached a shared understanding. diff --git a/.agents/skills/grilling/agents/openai.yaml b/.agents/skills/grilling/agents/openai.yaml deleted file mode 100644 index 85b1260..0000000 --- a/.agents/skills/grilling/agents/openai.yaml +++ /dev/null @@ -1,3 +0,0 @@ -interface: - display_name: "Grilling" - short_description: "Stress-test thinking one question at a time" diff --git a/.agents/skills/handoff/SKILL.md b/.agents/skills/handoff/SKILL.md deleted file mode 100644 index 043d9e1..0000000 --- a/.agents/skills/handoff/SKILL.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -name: handoff -description: Compact the current conversation into a handoff document for another agent to pick up. -argument-hint: "What will the next session be used for?" -disable-model-invocation: true ---- - -Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save to the temporary directory of the user's OS - not the current workspace. - -Include a "suggested skills" section in the document, which suggests skills that the agent should invoke. - -Do not duplicate content already captured in other artifacts (specs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead. - -Redact any sensitive information, such as API keys, passwords, or personally identifiable information. - -If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly. diff --git a/.agents/skills/handoff/agents/openai.yaml b/.agents/skills/handoff/agents/openai.yaml deleted file mode 100644 index 6e1d8da..0000000 --- a/.agents/skills/handoff/agents/openai.yaml +++ /dev/null @@ -1,5 +0,0 @@ -interface: - display_name: "Handoff" - short_description: "Compact a conversation into a handoff" -policy: - allow_implicit_invocation: false diff --git a/.agents/skills/implement/SKILL.md b/.agents/skills/implement/SKILL.md deleted file mode 100644 index 7a0b11f..0000000 --- a/.agents/skills/implement/SKILL.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -name: implement -description: "Implement a piece of work based on a spec or set of tickets." -disable-model-invocation: true ---- - -Implement the work described by the user in the spec or tickets. - -Use /tdd where possible, at pre-agreed seams. - -Run typechecking regularly, single test files regularly, and the full test suite once at the end. - -Once done, use /code-review to review the work. - -Commit your work to the current branch. diff --git a/.agents/skills/implement/agents/openai.yaml b/.agents/skills/implement/agents/openai.yaml deleted file mode 100644 index f8794dc..0000000 --- a/.agents/skills/implement/agents/openai.yaml +++ /dev/null @@ -1,5 +0,0 @@ -interface: - display_name: "Implement" - short_description: "Build work from a spec or tickets" -policy: - allow_implicit_invocation: false diff --git a/.agents/skills/improve-codebase-architecture/HTML-REPORT.md b/.agents/skills/improve-codebase-architecture/HTML-REPORT.md deleted file mode 100644 index 17f6d2c..0000000 --- a/.agents/skills/improve-codebase-architecture/HTML-REPORT.md +++ /dev/null @@ -1,123 +0,0 @@ -# HTML Report Format - -The architectural review is rendered as a single self-contained HTML file in the OS temp directory. Tailwind and Mermaid both come from CDNs. Mermaid handles graph-shaped diagrams reliably; hand-built divs and inline SVG handle the more editorial visuals (mass diagrams, cross-sections). Mix the two — don't lean on Mermaid for everything, it'll start to look generic. - -## Scaffold - -```html - - - - - Architecture review — {{repo name}} - - - - - -
-
...
-
...
-
...
-
- - -``` - -## Header - -Repo name, date, and a compact legend: solid box = module, dashed line = seam, red arrow = leakage, thick dark box = deep module. No introduction paragraph — straight into the candidates. - -## Candidate card - -The diagrams carry the weight. Prose is sparse, plain, and uses the glossary terms (from the `/codebase-design` skill) without ceremony. - -Each candidate is one `
`: - -- **Title** — short, names the deepening (e.g. "Collapse the Order intake pipeline"). -- **Badge row** — recommendation strength (`Strong` = emerald, `Worth exploring` = amber, `Speculative` = slate), plus a tag for the dependency category (`in-process`, `local-substitutable`, `ports & adapters`, `mock`). -- **Files** — monospaced list, `font-mono text-sm`. -- **Before / After diagram** — the centrepiece. Two columns, side by side. See patterns below. -- **Problem** — one sentence. What hurts. -- **Solution** — one sentence. What changes. -- **Wins** — bullets, ≤6 words each. e.g. "Tests hit one interface", "Pricing logic stops leaking", "Delete 4 shallow wrappers". -- **ADR callout** (if applicable) — one line in an amber-tinted box. - -No paragraphs of explanation. If the diagram needs a paragraph to be understood, redraw the diagram. - -## Diagram patterns - -Pick the pattern that fits the candidate. Mix them. Don't make every diagram look the same — variety is part of the point. - -### Mermaid graph (the workhorse for dependencies / call flow) - -Use a Mermaid `flowchart` or `graph` when the point is "X calls Y calls Z, and look at the mess." Wrap it in a Tailwind-styled card so it doesn't feel parachuted in. Style with classDef to colour leakage edges red and the deep module dark. Sequence diagrams work well for "before: 6 round-trips; after: 1." - -```html -
- 
-    flowchart LR
-      A[OrderHandler] --> B[OrderValidator]
-      B --> C[OrderRepo]
-      C -.leak.-> D[PricingClient]
-      classDef leak stroke:#dc2626,stroke-width:2px;
-      class C,D leak
-
-
-``` - -### Hand-built boxes-and-arrows (when Mermaid's layout fights you) - -Modules as `
`s with borders and labels. Arrows as inline SVG `` or `` elements positioned absolutely over a relative container. Reach for this when you want the "after" diagram to feel like one thick-bordered deep module with greyed-out internals — Mermaid won't render that with the right weight. - -### Cross-section (good for layered shallowness) - -Stack horizontal bands (`h-12 border-l-4`) to show layers a call passes through. Before: 6 thin layers each doing nothing. After: 1 thick band labelled with the consolidated responsibility. - -### Mass diagram (good for "interface as wide as implementation") - -Two rectangles per module — one for interface surface area, one for implementation. Before: interface rectangle is nearly as tall as the implementation rectangle (shallow). After: interface rectangle is short, implementation rectangle is tall (deep). - -### Call-graph collapse - -Before: a tree of function calls rendered as nested boxes. After: the same tree collapsed into one box, with the now-internal calls shown faded inside it. - -## Style guidance - -- Lean editorial, not corporate-dashboard. Generous whitespace. Serif optional for headings (`font-serif` works well with stone/slate). -- Colour sparingly: one accent (emerald or indigo) plus red for leakage and amber for warnings. -- Keep diagrams ~320px tall so before/after sits comfortably side by side without scrolling. -- Use `text-xs uppercase tracking-wider` for module labels inside diagrams — they should read as schematic, not as UI. -- The only scripts are the Tailwind CDN and the Mermaid ESM import. The report is otherwise static — no app code, no interactivity beyond Mermaid's own rendering. - -## Top recommendation section - -One larger card. Candidate name, one sentence on why, anchor link to its card. That's it. - -## Tone - -Plain English, concise — but the architectural nouns and verbs come straight from the `/codebase-design` skill. Concision is not an excuse to drift. - -**Use exactly:** module, interface, implementation, depth, deep, shallow, seam, adapter, leverage, locality. - -**Never substitute:** component, service, unit (for module) · API, signature (for interface) · boundary (for seam) · layer, wrapper (for module, when you mean module). - -**Phrasings that fit the style:** - -- "Order intake module is shallow — interface nearly matches the implementation." -- "Pricing leaks across the seam." -- "Deepen: one interface, one place to test." -- "Two adapters justify the seam: HTTP in prod, in-memory in tests." - -**Wins bullets** name the gain in glossary terms: *"locality: bugs concentrate in one module"*, *"leverage: one interface, N call sites"*, *"interface shrinks; implementation absorbs the wrappers"*. Don't write *"easier to maintain"* or *"cleaner code"* — those terms aren't in the glossary and don't earn their place. - -No hedging, no throat-clearing, no "it's worth noting that…". If a sentence could be a bullet, make it a bullet. If a bullet could be cut, cut it. If a term isn't in the `/codebase-design` glossary, reach for one that is before inventing a new one. diff --git a/.agents/skills/improve-codebase-architecture/SKILL.md b/.agents/skills/improve-codebase-architecture/SKILL.md deleted file mode 100644 index b56969e..0000000 --- a/.agents/skills/improve-codebase-architecture/SKILL.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -name: improve-codebase-architecture -description: Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick. -disable-model-invocation: true ---- - -# Improve Codebase Architecture - -Surface architectural friction and propose **deepening opportunities** — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability. - -This command is _informed_ by the project's domain model and built on a shared design vocabulary: - -- Run the `/codebase-design` skill for the architecture vocabulary (**module**, **interface**, **depth**, **seam**, **adapter**, **leverage**, **locality**) and its principles (the deletion test, "the interface is the test surface", "one adapter = hypothetical seam, two = real"). Use these terms exactly in every suggestion — don't drift into "component," "service," "API," or "boundary." -- The domain language in `CONTEXT.md` gives names to good seams; ADRs in `docs/adr/` record decisions this command should not re-litigate. - -## Process - -### 1. Explore - -**Scope before you scan — YAGNI.** Deepening a module pays off by making future changes to it easier, so put extra weight on the parts of the codebase that have recently changed. Decide *where* to look before you look: - -- If the user named a direction — a module, a subsystem, a pain point — take it, and skip the inference below. -- Otherwise, walk back a good stretch of the commit history (`git log --oneline`) to find the codebase's hot spots — the files and areas that keep coming up — and let those paths pull your attention first. If the changes are scattered with no clear hot spot, widen the net. - -Read the project's domain glossary (`CONTEXT.md`) and any ADRs in the area you're touching first. - -Then use the Agent tool with `subagent_type=Explore` to walk the codebase. Don't follow rigid heuristics — explore organically and note where you experience friction: - -- Where does understanding one concept require bouncing between many small modules? -- Where are modules **shallow** — interface nearly as complex as the implementation? -- Where have pure functions been extracted just for testability, but the real bugs hide in how they're called (no **locality**)? -- Where do tightly-coupled modules leak across their seams? -- Which parts of the codebase are untested, or hard to test through their current interface? - -Apply the **deletion test** to anything you suspect is shallow: would deleting it concentrate complexity, or just move it? A "yes, concentrates" is the signal you want. - -### 2. Present candidates as an HTML report - -Write a self-contained HTML file to the OS temp directory so nothing lands in the repo. Resolve the temp dir from `$TMPDIR`, falling back to `/tmp` (or `%TEMP%` on Windows), and write to `/architecture-review-.html` so each run gets a fresh file. Open it for the user — `xdg-open ` on Linux, `open ` on macOS, `start ` on Windows — and tell them the absolute path. - -The report uses **Tailwind via CDN** for layout and styling, and **Mermaid via CDN** for diagrams where a graph/flow/sequence reliably communicates the structure. Mix Mermaid with hand-crafted CSS/SVG visuals — use Mermaid when relationships are graph-shaped (call graphs, dependencies, sequences), and hand-built divs/SVG when you want something more editorial (mass diagrams, cross-sections, collapse animations). Each candidate gets a **before/after visualisation**. Be visual. - -For each candidate, render a card with: - -- **Files** — which files/modules are involved -- **Problem** — why the current architecture is causing friction -- **Solution** — plain English description of what would change -- **Benefits** — explained in terms of locality and leverage, and how tests would improve -- **Before / After diagram** — side-by-side, custom-drawn, illustrating the shallowness and the deepening -- **Recommendation strength** — one of `Strong`, `Worth exploring`, `Speculative`, rendered as a badge - -End the report with a **Top recommendation** section: which candidate you'd tackle first and why. - -**Use CONTEXT.md vocabulary for the domain, and the `/codebase-design` vocabulary for the architecture.** If `CONTEXT.md` defines "Order," talk about "the Order intake module" — not "the FooBarHandler," and not "the Order service." - -**ADR conflicts**: if a candidate contradicts an existing ADR, only surface it when the friction is real enough to warrant revisiting the ADR. Mark it clearly in the card (e.g. a warning callout: _"contradicts ADR-0007 — but worth reopening because…"_). Don't list every theoretical refactor an ADR forbids. - -See [HTML-REPORT.md](HTML-REPORT.md) for the full HTML scaffold, diagram patterns, and styling guidance. - -Do NOT propose interfaces yet. After the file is written, ask the user: "Which of these would you like to explore?" - -### 3. Grilling loop - -Once the user picks a candidate, run the `/grilling` skill to walk the decision tree with them — constraints, dependencies, the shape of the deepened module, what sits behind the seam, what tests survive. - -Side effects happen inline as decisions crystallize — run the `/domain-modeling` skill to keep the domain model current as you go: - -- **Naming a deepened module after a concept not in `CONTEXT.md`?** Add the term to `CONTEXT.md`. Create the file lazily if it doesn't exist. -- **Sharpening a fuzzy term during the conversation?** Update `CONTEXT.md` right there. -- **User rejects the candidate with a load-bearing reason?** Offer an ADR, framed as: _"Want me to record this as an ADR so future architecture reviews don't re-suggest it?"_ Only offer when the reason would actually be needed by a future explorer to avoid re-suggesting the same thing — skip ephemeral reasons ("not worth it right now") and self-evident ones. -- **Want to explore alternative interfaces for the deepened module?** Run the `/codebase-design` skill and use its design-it-twice parallel sub-agent pattern. diff --git a/.agents/skills/improve-codebase-architecture/agents/openai.yaml b/.agents/skills/improve-codebase-architecture/agents/openai.yaml deleted file mode 100644 index 706fdca..0000000 --- a/.agents/skills/improve-codebase-architecture/agents/openai.yaml +++ /dev/null @@ -1,5 +0,0 @@ -interface: - display_name: "Improve Codebase Architecture" - short_description: "Find and grill architecture improvements" -policy: - allow_implicit_invocation: false diff --git a/.agents/skills/prototype/LOGIC.md b/.agents/skills/prototype/LOGIC.md deleted file mode 100644 index fe9a2c2..0000000 --- a/.agents/skills/prototype/LOGIC.md +++ /dev/null @@ -1,79 +0,0 @@ -# Logic Prototype - -A tiny interactive terminal app that lets the user drive a state model by hand. Use this when the question is about **business logic, state transitions, or data shape** — the kind of thing that looks reasonable on paper but only feels wrong once you push it through real cases. - -## When this is the right shape - -- "I'm not sure if this state machine handles the edge case where X then Y." -- "Does this data model actually let me represent the case where..." -- "I want to feel out what the API should look like before writing it." -- Anything where the user wants to **press buttons and watch state change**. - -If the question is "what should this look like" — wrong branch. Use [UI.md](UI.md). - -## Process - -### 1. State the question - -Before writing code, write down what state model and what question you're prototyping. One paragraph, in the prototype's README or a comment at the top of the file. A logic prototype that answers the wrong question is pure waste — make the question explicit so it can be checked later, whether the user is watching now or returning to it AFK. - -### 2. Pick the language - -Use whatever the host project uses. If the project has no obvious runtime (e.g. a docs repo), ask. - -Match the project's existing conventions for tooling — don't add a new package manager or runtime just for the prototype. - -### 3. Isolate the logic in a portable module - -Put the actual logic — the bit that's answering the question — behind a small, pure interface that could be lifted out and dropped into the real codebase later. The TUI around it is throwaway; the logic module shouldn't be. - -The right shape depends on the question: - -- **A pure reducer** — `(state, action) => state`. Good when actions are discrete events and state is a single value. -- **A state machine** — explicit states and transitions. Good when "which actions are even legal right now" is part of the question. -- **A small set of pure functions** over a plain data type. Good when there's no implicit current state — just transformations. -- **A class or module with a clear method surface** when the logic genuinely owns ongoing internal state. - -Pick whichever shape best fits the question being asked, *not* whichever is easiest to wire to a TUI. Keep it pure: no I/O, no terminal code, no `console.log` for control flow. The TUI imports it and calls into it; nothing flows the other direction. - -This is what makes the prototype useful past its own lifetime: when the question's been answered, the validated reducer / machine / function set can be lifted into the real module on its own. - -### 4. Build the smallest TUI that exposes the state - -Build it as a **lightweight TUI** — on every tick, clear the screen (`console.clear()` / `print("\033[2J\033[H")` / equivalent) and re-render the whole frame. The user should always see one stable view, not an ever-growing scrollback. - -Each frame has two parts, in this order: - -1. **Current state**, pretty-printed and diff-friendly (one field per line, or formatted JSON). Use **bold** for field names or section headers and **dim** for less important context (timestamps, IDs, derived values). Native ANSI escape codes are fine — `\x1b[1m` bold, `\x1b[2m` dim, `\x1b[0m` reset. No need to pull in a styling library unless one is already in the project. -2. **Keyboard shortcuts**, listed at the bottom: `[a] add user [d] delete user [t] tick clock [q] quit`. Bold the key, dim the description, or vice-versa — whatever reads cleanly. - -Behaviour: - -1. **Initialise state** — a single in-memory object/struct. Render the first frame on start. -2. **Read one keystroke (or one line)** at a time, dispatch to a handler that mutates state. -3. **Re-render** the full frame after every action — don't append, replace. -4. **Loop until quit.** - -The whole frame should fit on one screen. - -### 5. Make it runnable in one command - -Add a script to the project's existing task runner (`package.json` scripts, `Makefile`, `justfile`, `pyproject.toml`). The user should run `pnpm run ` or equivalent — never need to remember a path. - -If the host project has no task runner, just put the command at the top of the prototype's README. - -### 6. Hand it over - -Give the user the run command. They'll drive it themselves; the interesting moments are when they say "wait, that shouldn't be possible" or "huh, I assumed X would be different" — those are the bugs in the _idea_, which is the whole point. If they want new actions added, add them. Prototypes evolve. - -### 7. Capture the answer and the prototype - -Once the prototype has answered its question, capture the answer, then capture the prototype the way the [SKILL](SKILL.md) describes. The logic-specific mapping: the validated reducer / machine / function set lifts into the real module (the decision, absorbed); the TUI shell rides along to the throwaway branch that keeps the prototype as a primary source. - -## Anti-patterns - -- **Don't add tests.** A prototype that needs tests is no longer a prototype. -- **Don't wire it to the real database.** Use an in-memory store unless the question is specifically about persistence. -- **Don't generalise.** No "what if we wanted to support X later." The prototype answers one question. -- **Don't blur the logic and the TUI together.** If the reducer / state machine references `console.log`, prompts, or terminal escape codes, it's no longer portable. Keep the TUI as a thin shell over a pure module. -- **Don't ship the TUI shell into production.** The shell is optimised for being driven by hand from a terminal. The logic module behind it is the bit worth keeping. diff --git a/.agents/skills/prototype/SKILL.md b/.agents/skills/prototype/SKILL.md deleted file mode 100644 index e75d533..0000000 --- a/.agents/skills/prototype/SKILL.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -name: prototype -description: Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like. ---- - -# Prototype - -A prototype is **throwaway code that answers a question**. The question decides the shape. - -## Pick a branch - -Identify which question is being answered — from the user's prompt, the surrounding code, or by asking if the user is around: - -- **"Does this logic / state model feel right?"** → [LOGIC.md](LOGIC.md). Build a tiny interactive terminal app that pushes the state machine through cases that are hard to reason about on paper. -- **"What should this look like?"** → [UI.md](UI.md). Generate several radically different UI variations on a single route, switchable via a URL search param and a floating bottom bar. - -The two branches produce very different artifacts — getting this wrong wastes the whole prototype. If the question is genuinely ambiguous and the user isn't reachable, default to whichever branch better matches the surrounding code (a backend module → logic; a page or component → UI) and state the assumption at the top of the prototype. - -## Rules that apply to both - -1. **Throwaway from day one, and clearly marked as such.** Locate the prototype code close to where it will actually be used (next to the module or page it's prototyping for) so context is obvious — but name it so a casual reader can see it's a prototype, not production. For throwaway UI routes, obey whatever routing convention the project already uses; don't invent a new top-level structure. -2. **One command to run.** Whatever the project's existing task runner supports — `pnpm `, `python `, `bun `, etc. The user must be able to start it without thinking. -3. **No persistence by default.** State lives in memory. Persistence is the thing the prototype is _checking_, not something it should depend on. If the question explicitly involves a database, hit a scratch DB or a local file with a clear "PROTOTYPE — wipe me" name. -4. **Skip the polish.** No tests, no error handling beyond what makes the prototype _runnable_, no abstractions. The point is to learn something fast. -5. **Surface the state.** After every action (logic) or on every variant switch (UI), print or render the full relevant state so the user can see what changed. -6. **Capture it when done.** Fold any validated decision into the real code, then capture the prototype itself as a **primary source**: commit it to a throwaway branch, out of main, and leave a context pointer to that branch on the implementation issue. Capture the answer too — the verdict and the question it settled — in the issue or a commit. The main branch keeps only the validated decision. diff --git a/.agents/skills/prototype/UI.md b/.agents/skills/prototype/UI.md deleted file mode 100644 index 76c0f60..0000000 --- a/.agents/skills/prototype/UI.md +++ /dev/null @@ -1,112 +0,0 @@ -# UI Prototype - -Generate **several radically different UI variations** on a single route, switchable from a floating bottom bar. The user flips between variants in the browser, picks one (or steals bits from each), then throws the rest away. - -If the question is about logic/state rather than what something looks like — wrong branch. Use [LOGIC.md](LOGIC.md). - -## When this is the right shape - -- "What should this page look like?" -- "I want to see a few options for this dashboard before committing." -- "Try a different layout for the settings screen." -- Any time the user would otherwise spend a day picking between three vague mockups in their head. - -## Two sub-shapes — strongly prefer sub-shape A - -A UI prototype is much easier to judge when it's **butting up against the rest of the app** — real header, real sidebar, real data, real density. A throwaway route on its own is a vacuum: every variant looks fine in isolation. Default to sub-shape A whenever there's a plausible existing page to host the variants. Only reach for sub-shape B if the prototype genuinely has no nearby home. - -### Sub-shape A — adjustment to an existing page (preferred) - -The route already exists. Variants are rendered **on the same route**, gated by a `?variant=` URL search param. The existing data fetching, params, and auth all stay — only the rendering swaps. This is the default; pick it unless there's a specific reason not to. - -If the prototype is for something that doesn't yet have a page but *would naturally live inside one* (a new section of the dashboard, a new card on the settings screen, a new step in an existing flow) — that's still sub-shape A. Mount the variants inside the host page. - -### Sub-shape B — a new page (last resort) - -Only use this when the thing being prototyped genuinely has no existing page to live inside — e.g. an entirely new top-level surface, or a flow that can't be embedded anywhere sensible. - -Create a **throwaway route** following whatever routing convention the project already uses — don't invent a new top-level structure. Name it so it's obviously a prototype (e.g. include the word `prototype` in the path or filename). Same `?variant=` pattern. - -Before committing to sub-shape B, sanity-check: is there really no existing page this could be embedded in? An empty route hides design problems that a populated one would expose. - -In both sub-shapes the floating bottom bar is identical. - -## Process - -### 1. State the question and pick N - -Default to **3 variants**. More than 5 stops being radically different and starts being noise — cap there. - -Write down the plan in one line, in the prototype's location or a top-of-file comment: - -> "Three variants of the settings page, switchable via `?variant=`, on the existing `/settings` route." - -This works whether the user is here to push back or not. - -### 2. Generate radically different variants - -Draft each variant. Hold each one to: - -- The page's purpose and the data it has access to. -- The project's component library / styling system (TailwindCSS, shadcn, MUI, plain CSS, whatever). -- A clear exported component name, e.g. `VariantA`, `VariantB`, `VariantC`. - -Variants must be **structurally different** — different layout, different information hierarchy, different primary affordance, not just different colours. Three slightly-tweaked card grids isn't a UI prototype, it's wallpaper. If two drafts come out too similar, redo one with explicit "do not use a card grid" guidance. - -### 3. Wire them together - -Create a single switcher component on the route: - -```tsx -// pseudo-code — adapt to the project's framework -const variant = searchParams.get('variant') ?? 'A'; -return ( - <> - {variant === 'A' && } - {variant === 'B' && } - {variant === 'C' && } - - -); -``` - -For sub-shape A (existing page): keep all the existing data fetching above the switcher; only the rendered subtree changes per variant. - -For sub-shape B (new page): the throwaway route under `/prototype/` mounts the same switcher. - -### 4. Build the floating switcher - -A small fixed-position bar at the bottom-centre of the screen with three pieces: - -- **Left arrow** — cycles to the previous variant (wraps around). -- **Variant label** — shows the current variant key and, if the variant exports a name, that name too. e.g. `B — Sidebar layout`. -- **Right arrow** — cycles forward (wraps around). - -Behaviour: - -- Clicking an arrow updates the URL search param (use the framework's router — `router.replace` on Next, `navigate` on React Router, etc) so the variant is shareable and reload-stable. -- Keyboard: `←` and `→` arrow keys also cycle. Don't intercept arrow keys when an ``, `