@cleocode/core 2026.10.27 → 2026.11.1-canary.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -0
- package/binaries/README.md +30 -10
- package/dist/.source-stamp.json +4 -0
- package/dist/audit/reconstruct.d.ts.map +1 -1
- package/dist/audit/reconstruct.js +3 -13
- package/dist/audit/reconstruct.js.map +1 -1
- package/dist/build-provenance.json +2 -2
- package/dist/cloud/nexus-cloud.d.ts.map +1 -1
- package/dist/cloud/nexus-cloud.js +3 -3
- package/dist/cloud/nexus-cloud.js.map +1 -1
- package/dist/cloud/nexus-device.d.ts +1 -1
- package/dist/cloud/nexus-link.d.ts +18 -2
- package/dist/cloud/nexus-link.d.ts.map +1 -1
- package/dist/cloud/nexus-link.js +26 -6
- package/dist/cloud/nexus-link.js.map +1 -1
- package/dist/cloud/nexus-vault.d.ts.map +1 -1
- package/dist/cloud/nexus-vault.js +3 -9
- package/dist/cloud/nexus-vault.js.map +1 -1
- package/dist/decide/sites/registry.d.ts +40 -0
- package/dist/decide/sites/registry.d.ts.map +1 -1
- package/dist/decide/sites/registry.js +38 -0
- package/dist/decide/sites/registry.js.map +1 -1
- package/dist/docs/adr-allocator.d.ts +3 -3
- package/dist/docs/adr-allocator.d.ts.map +1 -1
- package/dist/docs/adr-allocator.js +8 -5
- package/dist/docs/adr-allocator.js.map +1 -1
- package/dist/docs/blob-consolidation.d.ts.map +1 -1
- package/dist/docs/blob-consolidation.js +3 -2
- package/dist/docs/blob-consolidation.js.map +1 -1
- package/dist/docs/derive-links.d.ts +12 -0
- package/dist/docs/derive-links.d.ts.map +1 -1
- package/dist/docs/derive-links.js +19 -0
- package/dist/docs/derive-links.js.map +1 -1
- package/dist/docs/doc-name-rule.d.ts +105 -0
- package/dist/docs/doc-name-rule.d.ts.map +1 -0
- package/dist/docs/doc-name-rule.js +212 -0
- package/dist/docs/doc-name-rule.js.map +1 -0
- package/dist/docs/docs-inconsistency-detector.d.ts.map +1 -1
- package/dist/docs/docs-inconsistency-detector.js +4 -3
- package/dist/docs/docs-inconsistency-detector.js.map +1 -1
- package/dist/docs/docs-ops.d.ts +27 -5
- package/dist/docs/docs-ops.d.ts.map +1 -1
- package/dist/docs/docs-ops.js +149 -17
- package/dist/docs/docs-ops.js.map +1 -1
- package/dist/docs/docs-read-model.d.ts +45 -15
- package/dist/docs/docs-read-model.d.ts.map +1 -1
- package/dist/docs/docs-read-model.js +22 -102
- package/dist/docs/docs-read-model.js.map +1 -1
- package/dist/docs/docs-update.d.ts.map +1 -1
- package/dist/docs/docs-update.js +8 -2
- package/dist/docs/docs-update.js.map +1 -1
- package/dist/docs/doctor.d.ts +71 -4
- package/dist/docs/doctor.d.ts.map +1 -1
- package/dist/docs/doctor.js +324 -23
- package/dist/docs/doctor.js.map +1 -1
- package/dist/docs/duplicate-check.d.ts +138 -0
- package/dist/docs/duplicate-check.d.ts.map +1 -0
- package/dist/docs/duplicate-check.js +286 -0
- package/dist/docs/duplicate-check.js.map +1 -0
- package/dist/docs/fetch-result.d.ts.map +1 -1
- package/dist/docs/fetch-result.js +27 -0
- package/dist/docs/fetch-result.js.map +1 -1
- package/dist/docs/import/scanner.d.ts +2 -0
- package/dist/docs/import/scanner.d.ts.map +1 -1
- package/dist/docs/import/scanner.js +3 -1
- package/dist/docs/import/scanner.js.map +1 -1
- package/dist/docs/lineage.d.ts +66 -0
- package/dist/docs/lineage.d.ts.map +1 -0
- package/dist/docs/lineage.js +190 -0
- package/dist/docs/lineage.js.map +1 -0
- package/dist/docs/modernize/apply.d.ts +139 -0
- package/dist/docs/modernize/apply.d.ts.map +1 -0
- package/dist/docs/modernize/apply.js +760 -0
- package/dist/docs/modernize/apply.js.map +1 -0
- package/dist/docs/modernize/guard.d.ts +92 -0
- package/dist/docs/modernize/guard.d.ts.map +1 -0
- package/dist/docs/modernize/guard.js +214 -0
- package/dist/docs/modernize/guard.js.map +1 -0
- package/dist/docs/modernize/index.d.ts +68 -0
- package/dist/docs/modernize/index.d.ts.map +1 -0
- package/dist/docs/modernize/index.js +97 -0
- package/dist/docs/modernize/index.js.map +1 -0
- package/dist/docs/modernize/judge.d.ts +85 -0
- package/dist/docs/modernize/judge.d.ts.map +1 -0
- package/dist/docs/modernize/judge.js +186 -0
- package/dist/docs/modernize/judge.js.map +1 -0
- package/dist/docs/modernize/plan.d.ts +77 -0
- package/dist/docs/modernize/plan.d.ts.map +1 -0
- package/dist/docs/modernize/plan.js +510 -0
- package/dist/docs/modernize/plan.js.map +1 -0
- package/dist/docs/modernize/restore.d.ts +41 -0
- package/dist/docs/modernize/restore.d.ts.map +1 -0
- package/dist/docs/modernize/restore.js +103 -0
- package/dist/docs/modernize/restore.js.map +1 -0
- package/dist/docs/modernize/rules.d.ts +197 -0
- package/dist/docs/modernize/rules.d.ts.map +1 -0
- package/dist/docs/modernize/rules.js +510 -0
- package/dist/docs/modernize/rules.js.map +1 -0
- package/dist/docs/modernize/store.d.ts +64 -0
- package/dist/docs/modernize/store.d.ts.map +1 -0
- package/dist/docs/modernize/store.js +390 -0
- package/dist/docs/modernize/store.js.map +1 -0
- package/dist/docs/publications-store.d.ts +16 -2
- package/dist/docs/publications-store.d.ts.map +1 -1
- package/dist/docs/publications-store.js +23 -2
- package/dist/docs/publications-store.js.map +1 -1
- package/dist/docs/publish-pr.d.ts.map +1 -1
- package/dist/docs/publish-pr.js +12 -1
- package/dist/docs/publish-pr.js.map +1 -1
- package/dist/docs/rot.d.ts +94 -0
- package/dist/docs/rot.d.ts.map +1 -0
- package/dist/docs/rot.js +298 -0
- package/dist/docs/rot.js.map +1 -0
- package/dist/docs/similarity-check.d.ts +2 -0
- package/dist/docs/similarity-check.d.ts.map +1 -1
- package/dist/docs/similarity-check.js +6 -49
- package/dist/docs/similarity-check.js.map +1 -1
- package/dist/docs/slug-rename.d.ts +84 -0
- package/dist/docs/slug-rename.d.ts.map +1 -0
- package/dist/docs/slug-rename.js +166 -0
- package/dist/docs/slug-rename.js.map +1 -0
- package/dist/docs/slug-similarity.d.ts +24 -0
- package/dist/docs/slug-similarity.d.ts.map +1 -0
- package/dist/docs/slug-similarity.js +63 -0
- package/dist/docs/slug-similarity.js.map +1 -0
- package/dist/docs/wikilinks.d.ts +20 -4
- package/dist/docs/wikilinks.d.ts.map +1 -1
- package/dist/docs/wikilinks.js +52 -7
- package/dist/docs/wikilinks.js.map +1 -1
- package/dist/docs/writer-registry.d.ts.map +1 -1
- package/dist/docs/writer-registry.js +33 -0
- package/dist/docs/writer-registry.js.map +1 -1
- package/dist/doctor/type-matrix-repair.d.ts +194 -0
- package/dist/doctor/type-matrix-repair.d.ts.map +1 -0
- package/dist/doctor/type-matrix-repair.js +662 -0
- package/dist/doctor/type-matrix-repair.js.map +1 -0
- package/dist/gateway-client/generated/index.d.ts +2 -2
- package/dist/gateway-client/generated/index.d.ts.map +1 -1
- package/dist/gateway-client/generated/index.js +1 -1
- package/dist/gateway-client/generated/index.js.map +1 -1
- package/dist/gateway-client/generated/namespaces.gen.d.ts +5 -0
- package/dist/gateway-client/generated/namespaces.gen.d.ts.map +1 -1
- package/dist/gateway-client/generated/namespaces.gen.js +6 -1
- package/dist/gateway-client/generated/namespaces.gen.js.map +1 -1
- package/dist/gateway-client/generated/sdk.gen.d.ts +21 -1
- package/dist/gateway-client/generated/sdk.gen.d.ts.map +1 -1
- package/dist/gateway-client/generated/sdk.gen.js +55 -0
- package/dist/gateway-client/generated/sdk.gen.js.map +1 -1
- package/dist/gateway-client/generated/types.gen.d.ts +222 -0
- package/dist/gateway-client/generated/types.gen.d.ts.map +1 -1
- package/dist/gc/gc-subsystem.d.ts +4 -0
- package/dist/gc/gc-subsystem.d.ts.map +1 -1
- package/dist/gc/gc-subsystem.js +16 -0
- package/dist/gc/gc-subsystem.js.map +1 -1
- package/dist/git/work-tree.d.ts +48 -0
- package/dist/git/work-tree.d.ts.map +1 -1
- package/dist/git/work-tree.js +63 -1
- package/dist/git/work-tree.js.map +1 -1
- package/dist/hooks/handlers/session-hooks.d.ts +5 -4
- package/dist/hooks/handlers/session-hooks.d.ts.map +1 -1
- package/dist/hooks/handlers/session-hooks.js +5 -21
- package/dist/hooks/handlers/session-hooks.js.map +1 -1
- package/dist/internal.d.ts +5 -1
- package/dist/internal.d.ts.map +1 -1
- package/dist/internal.js +5 -1
- package/dist/internal.js.map +1 -1
- package/dist/memory/brain-doctor.d.ts.map +1 -1
- package/dist/memory/brain-doctor.js +6 -1
- package/dist/memory/brain-doctor.js.map +1 -1
- package/dist/memory/engine-compat.d.ts.map +1 -1
- package/dist/memory/engine-compat.js +6 -0
- package/dist/memory/engine-compat.js.map +1 -1
- package/dist/nexus/analyze-orchestrator.d.ts +24 -0
- package/dist/nexus/analyze-orchestrator.d.ts.map +1 -1
- package/dist/nexus/analyze-orchestrator.js +43 -5
- package/dist/nexus/analyze-orchestrator.js.map +1 -1
- package/dist/nexus/user-profile.d.ts +2 -1
- package/dist/nexus/user-profile.d.ts.map +1 -1
- package/dist/nexus/user-profile.js +13 -5
- package/dist/nexus/user-profile.js.map +1 -1
- package/dist/orchestrate/admission.d.ts +8 -0
- package/dist/orchestrate/admission.d.ts.map +1 -1
- package/dist/orchestrate/admission.js +3 -1
- package/dist/orchestrate/admission.js.map +1 -1
- package/dist/orchestrate/query-ops.d.ts.map +1 -1
- package/dist/orchestrate/query-ops.js +15 -4
- package/dist/orchestrate/query-ops.js.map +1 -1
- package/dist/orchestrate/spawn-ops.d.ts.map +1 -1
- package/dist/orchestrate/spawn-ops.js +43 -2
- package/dist/orchestrate/spawn-ops.js.map +1 -1
- package/dist/orchestration/index.d.ts +6 -0
- package/dist/orchestration/index.d.ts.map +1 -1
- package/dist/orchestration/index.js +3 -0
- package/dist/orchestration/index.js.map +1 -1
- package/dist/orchestration/spawn-prompt.d.ts.map +1 -1
- package/dist/orchestration/spawn-prompt.js +3 -1
- package/dist/orchestration/spawn-prompt.js.map +1 -1
- package/dist/paths.d.ts +43 -1
- package/dist/paths.d.ts.map +1 -1
- package/dist/paths.js +51 -1
- package/dist/paths.js.map +1 -1
- package/dist/project-lifecycle.d.ts.map +1 -1
- package/dist/project-lifecycle.js +31 -0
- package/dist/project-lifecycle.js.map +1 -1
- package/dist/release/authorization.d.ts +156 -0
- package/dist/release/authorization.d.ts.map +1 -0
- package/dist/release/authorization.js +460 -0
- package/dist/release/authorization.js.map +1 -0
- package/dist/release/ci-evidence.d.ts +55 -4
- package/dist/release/ci-evidence.d.ts.map +1 -1
- package/dist/release/ci-evidence.js +251 -22
- package/dist/release/ci-evidence.js.map +1 -1
- package/dist/release/ci-run-evidence.d.ts +107 -0
- package/dist/release/ci-run-evidence.d.ts.map +1 -0
- package/dist/release/ci-run-evidence.js +234 -0
- package/dist/release/ci-run-evidence.js.map +1 -0
- package/dist/release/cut.d.ts +231 -0
- package/dist/release/cut.d.ts.map +1 -0
- package/dist/release/cut.js +775 -0
- package/dist/release/cut.js.map +1 -0
- package/dist/release/deploy-evidence.d.ts +173 -0
- package/dist/release/deploy-evidence.d.ts.map +1 -0
- package/dist/release/deploy-evidence.js +381 -0
- package/dist/release/deploy-evidence.js.map +1 -0
- package/dist/release/engine-ops.d.ts.map +1 -1
- package/dist/release/engine-ops.js +10 -4
- package/dist/release/engine-ops.js.map +1 -1
- package/dist/release/index.d.ts +3 -0
- package/dist/release/index.d.ts.map +1 -1
- package/dist/release/index.js +2 -0
- package/dist/release/index.js.map +1 -1
- package/dist/release/invariants/archive-reason-invariant.d.ts.map +1 -1
- package/dist/release/invariants/archive-reason-invariant.js +4 -1
- package/dist/release/invariants/archive-reason-invariant.js.map +1 -1
- package/dist/release/open.d.ts.map +1 -1
- package/dist/release/open.js +2 -6
- package/dist/release/open.js.map +1 -1
- package/dist/release/plan.d.ts +34 -2
- package/dist/release/plan.d.ts.map +1 -1
- package/dist/release/plan.js +30 -6
- package/dist/release/plan.js.map +1 -1
- package/dist/release/preflight-skip.d.ts +4 -19
- package/dist/release/preflight-skip.d.ts.map +1 -1
- package/dist/release/preflight-skip.js +5 -110
- package/dist/release/preflight-skip.js.map +1 -1
- package/dist/release/reconcile-latest.d.ts +29 -0
- package/dist/release/reconcile-latest.d.ts.map +1 -0
- package/dist/release/reconcile-latest.js +71 -0
- package/dist/release/reconcile-latest.js.map +1 -0
- package/dist/release/reconcile.d.ts +3 -1
- package/dist/release/reconcile.d.ts.map +1 -1
- package/dist/release/reconcile.js +18 -6
- package/dist/release/reconcile.js.map +1 -1
- package/dist/release/release-published.d.ts +27 -0
- package/dist/release/release-published.d.ts.map +1 -0
- package/dist/release/release-published.js +35 -0
- package/dist/release/release-published.js.map +1 -0
- package/dist/release/tty-confirm.d.ts +23 -0
- package/dist/release/tty-confirm.d.ts.map +1 -0
- package/dist/release/tty-confirm.js +50 -0
- package/dist/release/tty-confirm.js.map +1 -0
- package/dist/remote/index.js +1 -1
- package/dist/remote/index.js.map +1 -1
- package/dist/resources/admission-ledger.d.ts +103 -1
- package/dist/resources/admission-ledger.d.ts.map +1 -1
- package/dist/resources/admission-ledger.js +200 -17
- package/dist/resources/admission-ledger.js.map +1 -1
- package/dist/resources/agent-lease.d.ts +82 -0
- package/dist/resources/agent-lease.d.ts.map +1 -0
- package/dist/resources/agent-lease.js +167 -0
- package/dist/resources/agent-lease.js.map +1 -0
- package/dist/resources/governor.d.ts +27 -1
- package/dist/resources/governor.d.ts.map +1 -1
- package/dist/resources/governor.js +88 -4
- package/dist/resources/governor.js.map +1 -1
- package/dist/resources/hook-footprint.d.ts +13 -1
- package/dist/resources/hook-footprint.d.ts.map +1 -1
- package/dist/resources/hook-footprint.js +33 -7
- package/dist/resources/hook-footprint.js.map +1 -1
- package/dist/resources/run-governed.d.ts +25 -0
- package/dist/resources/run-governed.d.ts.map +1 -1
- package/dist/resources/run-governed.js +44 -3
- package/dist/resources/run-governed.js.map +1 -1
- package/dist/sagas/reconcile.d.ts.map +1 -1
- package/dist/sagas/reconcile.js +11 -0
- package/dist/sagas/reconcile.js.map +1 -1
- package/dist/scaffold/ensure-dirs.d.ts.map +1 -1
- package/dist/scaffold/ensure-dirs.js +8 -6
- package/dist/scaffold/ensure-dirs.js.map +1 -1
- package/dist/security/override-cap-setting.d.ts +132 -0
- package/dist/security/override-cap-setting.d.ts.map +1 -1
- package/dist/security/override-cap-setting.js +88 -10
- package/dist/security/override-cap-setting.js.map +1 -1
- package/dist/security/owner-override-authority.d.ts.map +1 -1
- package/dist/security/owner-override-authority.js +5 -1
- package/dist/security/owner-override-authority.js.map +1 -1
- package/dist/selfimprove/draft-pr.d.ts.map +1 -1
- package/dist/selfimprove/draft-pr.js +4 -1
- package/dist/selfimprove/draft-pr.js.map +1 -1
- package/dist/session/engine-ops.d.ts.map +1 -1
- package/dist/session/engine-ops.js +4 -16
- package/dist/session/engine-ops.js.map +1 -1
- package/dist/sessions/briefing.d.ts +6 -0
- package/dist/sessions/briefing.d.ts.map +1 -1
- package/dist/sessions/briefing.js +34 -0
- package/dist/sessions/briefing.js.map +1 -1
- package/dist/sessions/session-end-snapshot-entry.js +2 -2
- package/dist/sessions/session-end-snapshot-entry.js.map +1 -1
- package/dist/sessions/session-end-snapshot.js +4 -4
- package/dist/sessions/session-end-snapshot.js.map +1 -1
- package/dist/skills/injection/token.d.ts.map +1 -1
- package/dist/skills/injection/token.js +3 -6
- package/dist/skills/injection/token.js.map +1 -1
- package/dist/skills/orchestrator/spawn.d.ts.map +1 -1
- package/dist/skills/orchestrator/spawn.js +3 -4
- package/dist/skills/orchestrator/spawn.js.map +1 -1
- package/dist/skills/propose-patch.d.ts.map +1 -1
- package/dist/skills/propose-patch.js +4 -1
- package/dist/skills/propose-patch.js.map +1 -1
- package/dist/spawn/branch-integration.d.ts.map +1 -1
- package/dist/spawn/branch-integration.js +5 -2
- package/dist/spawn/branch-integration.js.map +1 -1
- package/dist/store/attachment-repair.d.ts.map +1 -1
- package/dist/store/attachment-repair.js +5 -4
- package/dist/store/attachment-repair.js.map +1 -1
- package/dist/store/attachment-store.d.ts +6 -0
- package/dist/store/attachment-store.d.ts.map +1 -1
- package/dist/store/attachment-store.js +19 -2
- package/dist/store/attachment-store.js.map +1 -1
- package/dist/store/blob-ops.d.ts +1 -1
- package/dist/store/blob-ops.d.ts.map +1 -1
- package/dist/store/blob-ops.js +7 -3
- package/dist/store/blob-ops.js.map +1 -1
- package/dist/store/conduit-doc-history.d.ts +15 -1
- package/dist/store/conduit-doc-history.d.ts.map +1 -1
- package/dist/store/conduit-doc-history.js +16 -10
- package/dist/store/conduit-doc-history.js.map +1 -1
- package/dist/store/db-helpers.d.ts +29 -0
- package/dist/store/db-helpers.d.ts.map +1 -1
- package/dist/store/db-helpers.js +89 -1
- package/dist/store/db-helpers.js.map +1 -1
- package/dist/store/decision-adr-links.d.ts.map +1 -1
- package/dist/store/decision-adr-links.js +5 -2
- package/dist/store/decision-adr-links.js.map +1 -1
- package/dist/store/git-checkpoint.d.ts +11 -1
- package/dist/store/git-checkpoint.d.ts.map +1 -1
- package/dist/store/git-checkpoint.js +14 -3
- package/dist/store/git-checkpoint.js.map +1 -1
- package/dist/store/llmtxt-blob-adapter.d.ts.map +1 -1
- package/dist/store/llmtxt-blob-adapter.js +4 -1
- package/dist/store/llmtxt-blob-adapter.js.map +1 -1
- package/dist/store/schema/attachments.d.ts +7 -5
- package/dist/store/schema/attachments.d.ts.map +1 -1
- package/dist/store/schema/attachments.js +5 -2
- package/dist/store/schema/attachments.js.map +1 -1
- package/dist/store/session-store.d.ts.map +1 -1
- package/dist/store/session-store.js +6 -0
- package/dist/store/session-store.js.map +1 -1
- package/dist/store/sqlite-backup.d.ts +6 -1
- package/dist/store/sqlite-backup.d.ts.map +1 -1
- package/dist/store/sqlite-backup.js +9 -5
- package/dist/store/sqlite-backup.js.map +1 -1
- package/dist/store/sqlite-data-accessor.d.ts.map +1 -1
- package/dist/store/sqlite-data-accessor.js +63 -36
- package/dist/store/sqlite-data-accessor.js.map +1 -1
- package/dist/system/backup.d.ts +29 -0
- package/dist/system/backup.d.ts.map +1 -1
- package/dist/system/backup.js +240 -37
- package/dist/system/backup.js.map +1 -1
- package/dist/system/dependencies.d.ts +22 -0
- package/dist/system/dependencies.d.ts.map +1 -1
- package/dist/system/dependencies.js +49 -2
- package/dist/system/dependencies.js.map +1 -1
- package/dist/system/health.d.ts.map +1 -1
- package/dist/system/health.js +23 -1
- package/dist/system/health.js.map +1 -1
- package/dist/task-work/claims.d.ts.map +1 -1
- package/dist/task-work/claims.js +14 -0
- package/dist/task-work/claims.js.map +1 -1
- package/dist/task-work/index.d.ts.map +1 -1
- package/dist/task-work/index.js +22 -0
- package/dist/task-work/index.js.map +1 -1
- package/dist/tasks/ac-coverage-gate.d.ts +27 -0
- package/dist/tasks/ac-coverage-gate.d.ts.map +1 -1
- package/dist/tasks/ac-coverage-gate.js +63 -28
- package/dist/tasks/ac-coverage-gate.js.map +1 -1
- package/dist/tasks/affected-packages.d.ts +26 -30
- package/dist/tasks/affected-packages.d.ts.map +1 -1
- package/dist/tasks/affected-packages.js +27 -50
- package/dist/tasks/affected-packages.js.map +1 -1
- package/dist/tasks/affected-scope.d.ts +13 -3
- package/dist/tasks/affected-scope.d.ts.map +1 -1
- package/dist/tasks/affected-scope.js +29 -11
- package/dist/tasks/affected-scope.js.map +1 -1
- package/dist/tasks/change-set.d.ts.map +1 -1
- package/dist/tasks/change-set.js +39 -20
- package/dist/tasks/change-set.js.map +1 -1
- package/dist/tasks/command-gate-cmd.d.ts +33 -0
- package/dist/tasks/command-gate-cmd.d.ts.map +1 -0
- package/dist/tasks/command-gate-cmd.js +45 -0
- package/dist/tasks/command-gate-cmd.js.map +1 -0
- package/dist/tasks/complete-ci.d.ts +9 -0
- package/dist/tasks/complete-ci.d.ts.map +1 -1
- package/dist/tasks/complete-ci.js +21 -4
- package/dist/tasks/complete-ci.js.map +1 -1
- package/dist/tasks/complete.d.ts.map +1 -1
- package/dist/tasks/complete.js +14 -0
- package/dist/tasks/complete.js.map +1 -1
- package/dist/tasks/component-pr.d.ts +37 -0
- package/dist/tasks/component-pr.d.ts.map +1 -1
- package/dist/tasks/component-pr.js +106 -14
- package/dist/tasks/component-pr.js.map +1 -1
- package/dist/tasks/done-plan.d.ts +14 -1
- package/dist/tasks/done-plan.d.ts.map +1 -1
- package/dist/tasks/done-plan.js +125 -15
- package/dist/tasks/done-plan.js.map +1 -1
- package/dist/tasks/done-record.d.ts.map +1 -1
- package/dist/tasks/done-record.js +4 -0
- package/dist/tasks/done-record.js.map +1 -1
- package/dist/tasks/engine-converters.d.ts.map +1 -1
- package/dist/tasks/engine-converters.js +2 -0
- package/dist/tasks/engine-converters.js.map +1 -1
- package/dist/tasks/evidence-tree.d.ts +28 -1
- package/dist/tasks/evidence-tree.d.ts.map +1 -1
- package/dist/tasks/evidence-tree.js +66 -2
- package/dist/tasks/evidence-tree.js.map +1 -1
- package/dist/tasks/evidence.d.ts +39 -27
- package/dist/tasks/evidence.d.ts.map +1 -1
- package/dist/tasks/evidence.js +382 -188
- package/dist/tasks/evidence.js.map +1 -1
- package/dist/tasks/gate-notes.d.ts +17 -0
- package/dist/tasks/gate-notes.d.ts.map +1 -1
- package/dist/tasks/gate-notes.js.map +1 -1
- package/dist/tasks/gate-preview.d.ts +7 -1
- package/dist/tasks/gate-preview.d.ts.map +1 -1
- package/dist/tasks/gate-preview.js +30 -4
- package/dist/tasks/gate-preview.js.map +1 -1
- package/dist/tasks/gate-runner.d.ts +42 -0
- package/dist/tasks/gate-runner.d.ts.map +1 -1
- package/dist/tasks/gate-runner.js +234 -94
- package/dist/tasks/gate-runner.js.map +1 -1
- package/dist/tasks/manifest-scope.d.ts +115 -0
- package/dist/tasks/manifest-scope.d.ts.map +1 -0
- package/dist/tasks/manifest-scope.js +352 -0
- package/dist/tasks/manifest-scope.js.map +1 -0
- package/dist/tasks/merge-close.d.ts +376 -0
- package/dist/tasks/merge-close.d.ts.map +1 -0
- package/dist/tasks/merge-close.js +1497 -0
- package/dist/tasks/merge-close.js.map +1 -0
- package/dist/tasks/qa-run-binding.d.ts +5 -0
- package/dist/tasks/qa-run-binding.d.ts.map +1 -1
- package/dist/tasks/qa-run-binding.js +6 -1
- package/dist/tasks/qa-run-binding.js.map +1 -1
- package/dist/tasks/req.d.ts.map +1 -1
- package/dist/tasks/req.js +29 -1
- package/dist/tasks/req.js.map +1 -1
- package/dist/tasks/review-verdict.d.ts +159 -0
- package/dist/tasks/review-verdict.d.ts.map +1 -0
- package/dist/tasks/review-verdict.js +442 -0
- package/dist/tasks/review-verdict.js.map +1 -0
- package/dist/tasks/task-reparent.d.ts.map +1 -1
- package/dist/tasks/task-reparent.js +22 -3
- package/dist/tasks/task-reparent.js.map +1 -1
- package/dist/tasks/test-report-counts.d.ts +274 -0
- package/dist/tasks/test-report-counts.d.ts.map +1 -0
- package/dist/tasks/test-report-counts.js +746 -0
- package/dist/tasks/test-report-counts.js.map +1 -0
- package/dist/tasks/test-run-binding.d.ts +20 -45
- package/dist/tasks/test-run-binding.d.ts.map +1 -1
- package/dist/tasks/test-run-binding.js +34 -119
- package/dist/tasks/test-run-binding.js.map +1 -1
- package/dist/tasks/update.d.ts.map +1 -1
- package/dist/tasks/update.js +42 -0
- package/dist/tasks/update.js.map +1 -1
- package/dist/tasks/verification-policy.d.ts +12 -0
- package/dist/tasks/verification-policy.d.ts.map +1 -1
- package/dist/tasks/verification-policy.js +13 -0
- package/dist/tasks/verification-policy.js.map +1 -1
- package/dist/tasks/workspace-resolution.d.ts +225 -0
- package/dist/tasks/workspace-resolution.d.ts.map +1 -0
- package/dist/tasks/workspace-resolution.js +497 -0
- package/dist/tasks/workspace-resolution.js.map +1 -0
- package/dist/validation/doctor/checks.d.ts +20 -0
- package/dist/validation/doctor/checks.d.ts.map +1 -1
- package/dist/validation/doctor/checks.js +112 -0
- package/dist/validation/doctor/checks.js.map +1 -1
- package/dist/validation/engine-ops.d.ts.map +1 -1
- package/dist/validation/engine-ops.js +37 -3
- package/dist/validation/engine-ops.js.map +1 -1
- package/dist/validation/validate-ops.d.ts +4 -0
- package/dist/validation/validate-ops.d.ts.map +1 -1
- package/dist/validation/validate-ops.js +79 -2
- package/dist/validation/validate-ops.js.map +1 -1
- package/dist/worktree/list.d.ts +4 -21
- package/dist/worktree/list.d.ts.map +1 -1
- package/dist/worktree/list.js +14 -44
- package/dist/worktree/list.js.map +1 -1
- package/dist/worktree/merged-cleanup.d.ts +63 -0
- package/dist/worktree/merged-cleanup.d.ts.map +1 -0
- package/dist/worktree/merged-cleanup.js +571 -0
- package/dist/worktree/merged-cleanup.js.map +1 -0
- package/dist/worktree/prune.d.ts +64 -2
- package/dist/worktree/prune.d.ts.map +1 -1
- package/dist/worktree/prune.js +151 -6
- package/dist/worktree/prune.js.map +1 -1
- package/dist/worktree/sentinel-index.d.ts +14 -0
- package/dist/worktree/sentinel-index.d.ts.map +1 -1
- package/dist/worktree/sentinel-index.js +17 -0
- package/dist/worktree/sentinel-index.js.map +1 -1
- package/dist/worktree/worktree-adopt.d.ts +1 -13
- package/dist/worktree/worktree-adopt.d.ts.map +1 -1
- package/dist/worktree/worktree-adopt.js +2 -17
- package/dist/worktree/worktree-adopt.js.map +1 -1
- package/package.json +12 -12
- package/schemas/project-context.schema.json +33 -0
- package/templates/CLEO-INJECTION.md +6 -16
- package/templates/CLEO-REFERENCE.md +27 -4
- package/templates/git-hooks/legacy-hashes.json +2 -1
- package/templates/git-hooks/pre-commit +43 -11
- package/templates/workflows/release-prepare.yml.tmpl +9 -88
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Exact store restores for `cleo docs modernize --rollback` (T14113).
|
|
3
|
+
*
|
|
4
|
+
* Apply records the values a step replaced (`DocsModernizeOpPrior`); these
|
|
5
|
+
* helpers read those values before a step and put them back afterwards, so a
|
|
6
|
+
* rollback restores the registry rows as they were rather than writing a new
|
|
7
|
+
* version on top.
|
|
8
|
+
*
|
|
9
|
+
* @task T14113
|
|
10
|
+
* @epic T14106
|
|
11
|
+
*/
|
|
12
|
+
import { and, eq } from 'drizzle-orm';
|
|
13
|
+
import { createAttachmentStore } from '../../store/attachment-store.js';
|
|
14
|
+
import { getDb } from '../../store/sqlite.js';
|
|
15
|
+
import { ATTACHMENT_LIFECYCLE_STATUSES, attachments, } from '../../store/tasks-schema.js';
|
|
16
|
+
/** Narrow a stored string to a lifecycle status, defaulting to `draft`. */
|
|
17
|
+
function asStatus(value) {
|
|
18
|
+
return ATTACHMENT_LIFECYCLE_STATUSES.find((s) => s === value) ?? 'draft';
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* The supersession pointers a `supersedeDoc(old, new)` will replace.
|
|
22
|
+
*
|
|
23
|
+
* @param projectRoot - Project root.
|
|
24
|
+
* @param oldSlug - Doc about to be superseded.
|
|
25
|
+
* @param newSlug - Doc about to supersede it.
|
|
26
|
+
* @returns The prior values, or null when either slug is unknown.
|
|
27
|
+
*/
|
|
28
|
+
export async function readSupersessionPrior(projectRoot, oldSlug, newSlug) {
|
|
29
|
+
const db = await getDb(projectRoot);
|
|
30
|
+
const older = await db.select().from(attachments).where(eq(attachments.slug, oldSlug)).get();
|
|
31
|
+
const newer = await db.select().from(attachments).where(eq(attachments.slug, newSlug)).get();
|
|
32
|
+
if (!older || !newer)
|
|
33
|
+
return null;
|
|
34
|
+
return {
|
|
35
|
+
lifecycleStatus: older.lifecycleStatus,
|
|
36
|
+
supersededBy: older.supersededBy ?? null,
|
|
37
|
+
supersedes: newer.supersedes ?? null,
|
|
38
|
+
};
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Put back the pointers and status a supersede replaced.
|
|
42
|
+
*
|
|
43
|
+
* @param projectRoot - Project root.
|
|
44
|
+
* @param oldSlug - The superseded doc.
|
|
45
|
+
* @param newSlug - The superseding doc.
|
|
46
|
+
* @param prior - Values recorded by {@link readSupersessionPrior}.
|
|
47
|
+
*/
|
|
48
|
+
export async function restoreSupersession(projectRoot, oldSlug, newSlug, prior) {
|
|
49
|
+
const db = await getDb(projectRoot);
|
|
50
|
+
const older = await db.select().from(attachments).where(eq(attachments.slug, oldSlug)).get();
|
|
51
|
+
const newer = await db.select().from(attachments).where(eq(attachments.slug, newSlug)).get();
|
|
52
|
+
db.transaction((tx) => {
|
|
53
|
+
if (older) {
|
|
54
|
+
tx.update(attachments)
|
|
55
|
+
.set({
|
|
56
|
+
supersededBy: prior.supersededBy ?? null,
|
|
57
|
+
lifecycleStatus: asStatus(prior.lifecycleStatus),
|
|
58
|
+
})
|
|
59
|
+
.where(eq(attachments.id, older.id))
|
|
60
|
+
.run();
|
|
61
|
+
}
|
|
62
|
+
if (newer) {
|
|
63
|
+
tx.update(attachments)
|
|
64
|
+
.set({ supersedes: prior.supersedes ?? null })
|
|
65
|
+
.where(eq(attachments.id, newer.id))
|
|
66
|
+
.run();
|
|
67
|
+
}
|
|
68
|
+
});
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Undo a `docs update` of `slug`: give the slug back to the row that held it
|
|
72
|
+
* and drop the refs the update copied onto the new row (the new row is purged
|
|
73
|
+
* when none remain). The new row must have been created by that update.
|
|
74
|
+
*
|
|
75
|
+
* @param projectRoot - Project root.
|
|
76
|
+
* @param slug - The updated slug.
|
|
77
|
+
* @param prior - `previousAttachmentId` and `newAttachmentId` from the merge op.
|
|
78
|
+
*/
|
|
79
|
+
export async function revertDocUpdate(projectRoot, slug, prior) {
|
|
80
|
+
const previous = prior.previousAttachmentId;
|
|
81
|
+
const created = prior.newAttachmentId;
|
|
82
|
+
if (!previous || !created)
|
|
83
|
+
return;
|
|
84
|
+
const store = createAttachmentStore();
|
|
85
|
+
const refs = await store.listRefs(previous, projectRoot);
|
|
86
|
+
const db = await getDb(projectRoot);
|
|
87
|
+
db.transaction((tx) => {
|
|
88
|
+
tx.update(attachments)
|
|
89
|
+
.set({ slug: null })
|
|
90
|
+
.where(and(eq(attachments.id, created), eq(attachments.slug, slug)))
|
|
91
|
+
.run();
|
|
92
|
+
tx.update(attachments).set({ slug }).where(eq(attachments.id, previous)).run();
|
|
93
|
+
});
|
|
94
|
+
for (const ref of refs)
|
|
95
|
+
await store.deref(created, ref.ownerType, ref.ownerId, projectRoot);
|
|
96
|
+
// The update re-derived the slug's body links from the merged text; put
|
|
97
|
+
// back the edges the old body had.
|
|
98
|
+
if (prior.linkTargets) {
|
|
99
|
+
const { syncDocBodyWikilinks } = await import('../wikilinks.js');
|
|
100
|
+
await syncDocBodyWikilinks(slug, prior.linkTargets, { projectRoot });
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
//# sourceMappingURL=restore.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../../src/docs/modernize/restore.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pure rules for `cleo docs modernize` (T14113): classify a file into a
|
|
3
|
+
* taxonomy kind, derive its stable slug, measure how alike two docs are, and
|
|
4
|
+
* rewrite links to wikilinks.
|
|
5
|
+
*
|
|
6
|
+
* No I/O here. The planner (`plan.ts`) feeds these rules the scanned files and
|
|
7
|
+
* asks System One (`judge.ts`) only where a rule is unsure.
|
|
8
|
+
*
|
|
9
|
+
* @task T14113
|
|
10
|
+
* @epic T14106
|
|
11
|
+
*/
|
|
12
|
+
import type { DocKindMetadata, DocsModernizePlanRow } from '@cleocode/contracts';
|
|
13
|
+
/** Confidence at or above which a classify rule acts without asking System One. */
|
|
14
|
+
export declare const MODERNIZE_CLASSIFY_FLOOR = 0.75;
|
|
15
|
+
/** Similarity at or above which two docs merge without asking System One. */
|
|
16
|
+
export declare const MODERNIZE_MERGE_SURE = 0.8;
|
|
17
|
+
/** Similarity below which two docs are kept apart without asking System One. */
|
|
18
|
+
export declare const MODERNIZE_MERGE_APART = 0.4;
|
|
19
|
+
/** Longest slug modernize proposes, in characters. */
|
|
20
|
+
export declare const MODERNIZE_SLUG_MAX = 64;
|
|
21
|
+
/** A rule's classification of one file. */
|
|
22
|
+
export interface ModernizeClassification {
|
|
23
|
+
/** Proposed kind. */
|
|
24
|
+
readonly kind: string;
|
|
25
|
+
/** 0..1; below {@link MODERNIZE_CLASSIFY_FLOOR} the call is ambiguous. */
|
|
26
|
+
readonly confidence: number;
|
|
27
|
+
/** One line explaining the rule that fired. */
|
|
28
|
+
readonly reason: string;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* Read a front-matter scalar (`key: value`) from a markdown file.
|
|
32
|
+
*
|
|
33
|
+
* @param content - File text.
|
|
34
|
+
* @param key - Front-matter key.
|
|
35
|
+
* @returns The trimmed, unquoted value, or null.
|
|
36
|
+
*/
|
|
37
|
+
export declare function readFrontMatterValue(content: string, key: string): string | null;
|
|
38
|
+
/**
|
|
39
|
+
* The first H1 of a markdown file, or null.
|
|
40
|
+
*
|
|
41
|
+
* @param content - File text.
|
|
42
|
+
* @returns The heading text without the `#`.
|
|
43
|
+
*/
|
|
44
|
+
export declare function readTitle(content: string): string | null;
|
|
45
|
+
/**
|
|
46
|
+
* The kind a folder name stands for (its own name or a T14107 alias).
|
|
47
|
+
*
|
|
48
|
+
* @param folder - One folder name.
|
|
49
|
+
* @param kinds - The registry's kinds.
|
|
50
|
+
* @returns The kind, or null.
|
|
51
|
+
*/
|
|
52
|
+
export declare function folderKind(folder: string, kinds: readonly DocKindMetadata[]): string | null;
|
|
53
|
+
/**
|
|
54
|
+
* Classify one file by rules: front matter, folder, filename, then body shape.
|
|
55
|
+
*
|
|
56
|
+
* @param relPath - Path relative to the modernize root.
|
|
57
|
+
* @param content - File text.
|
|
58
|
+
* @param kinds - The registry's kinds.
|
|
59
|
+
* @returns The classification; `note` at low confidence when nothing fires.
|
|
60
|
+
*/
|
|
61
|
+
export declare function classifyDocByRules(relPath: string, content: string, kinds: readonly DocKindMetadata[]): ModernizeClassification;
|
|
62
|
+
/**
|
|
63
|
+
* The stable slug for a file, under the T14107 naming rule:
|
|
64
|
+
*
|
|
65
|
+
* - a file name that already passes {@link docNameViolation} for its kind is
|
|
66
|
+
* kept unchanged (a release note's `v2026.10.28`, a clean `adr-001-store`);
|
|
67
|
+
* - otherwise the slug is {@link subjectSlug} of the name, or of the title
|
|
68
|
+
* when the name has too few words left (two; one after an ADR number);
|
|
69
|
+
* - an ADR keeps its number as an `adr-NNN-` prefix.
|
|
70
|
+
*
|
|
71
|
+
* @param relPath - Path relative to the modernize root.
|
|
72
|
+
* @param content - File text.
|
|
73
|
+
* @param kind - The file's kind.
|
|
74
|
+
* @returns A slug that passes the naming rule.
|
|
75
|
+
*/
|
|
76
|
+
export declare function stableSlugFor(relPath: string, content: string, kind: string): string;
|
|
77
|
+
/**
|
|
78
|
+
* The version a filename claims (`-v2` → 2), or 0.
|
|
79
|
+
*
|
|
80
|
+
* @param relPath - Path relative to the root.
|
|
81
|
+
* @returns The version number.
|
|
82
|
+
*/
|
|
83
|
+
export declare function versionOf(relPath: string): number;
|
|
84
|
+
/**
|
|
85
|
+
* Jaccard similarity of two docs' normalised lines (0..1).
|
|
86
|
+
*
|
|
87
|
+
* @param a - First doc text.
|
|
88
|
+
* @param b - Second doc text.
|
|
89
|
+
* @returns 1 for the same lines, 0 for none shared.
|
|
90
|
+
*/
|
|
91
|
+
export declare function docSimilarity(a: string, b: string): number;
|
|
92
|
+
/**
|
|
93
|
+
* Fold a duplicate into its survivor without losing any of its content.
|
|
94
|
+
*
|
|
95
|
+
* - A `##` section whose heading the survivor lacks is appended as is.
|
|
96
|
+
* - A section whose heading the survivor has, but whose body differs, is
|
|
97
|
+
* appended under `<heading> (from [[slug]])`.
|
|
98
|
+
* - The preamble (everything before the first `##`, which is the whole doc
|
|
99
|
+
* when it has no `##` headings) is appended under `## From [[slug]]` unless
|
|
100
|
+
* the survivor already contains it; a lone `# Title` line equal to the
|
|
101
|
+
* survivor's title is dropped as the same title.
|
|
102
|
+
*
|
|
103
|
+
* Every non-blank line of the duplicate is therefore in the result, either
|
|
104
|
+
* because the survivor already had the block or because it was appended.
|
|
105
|
+
*
|
|
106
|
+
* @param survivor - The kept doc's text.
|
|
107
|
+
* @param duplicate - The merged doc's text.
|
|
108
|
+
* @param duplicateRef - How the merged doc is cited on what was appended: a
|
|
109
|
+
* resolvable slug, already formatted (`` `slug` `` or `[[slug]]`).
|
|
110
|
+
* @returns The merged text (the survivor unchanged when nothing is new).
|
|
111
|
+
*/
|
|
112
|
+
export declare function mergeDocBodies(survivor: string, duplicate: string, duplicateRef: string): string;
|
|
113
|
+
/**
|
|
114
|
+
* Re-point relative markdown links (and images) after a move, keeping them
|
|
115
|
+
* plain markdown so they still render on GitHub (T14185).
|
|
116
|
+
*
|
|
117
|
+
* A link's target is resolved from the file's OLD path. A target in the plan
|
|
118
|
+
* maps to its final path (a merged or deleted file maps to its survivor's),
|
|
119
|
+
* and any other target keeps its location; the href is then rewritten
|
|
120
|
+
* relative to the file's NEW path. Links that leave the root, URLs and
|
|
121
|
+
* anchors are left alone, and so is a link whose href would not change.
|
|
122
|
+
*
|
|
123
|
+
* @param content - Doc text.
|
|
124
|
+
* @param fromOld - The file's path before the move, relative to the root.
|
|
125
|
+
* @param toNew - The file's path after the move.
|
|
126
|
+
* @param finalPathOf - Root-relative old path → final path, for every planned file.
|
|
127
|
+
* @returns The text with every relative link pointing at the right place.
|
|
128
|
+
*/
|
|
129
|
+
export declare function repointMarkdownLinks(content: string, fromOld: string, toNew: string, finalPathOf: ReadonlyMap<string, string>): string;
|
|
130
|
+
/**
|
|
131
|
+
* The href edits a file that stays where it is needs because link targets
|
|
132
|
+
* move: the `link-fix` rows of a plan's kept files (T14185). Each distinct
|
|
133
|
+
* href is listed once.
|
|
134
|
+
*
|
|
135
|
+
* @param content - Doc text.
|
|
136
|
+
* @param path - The file's path, relative to the root (it does not move).
|
|
137
|
+
* @param finalPathOf - Root-relative old path → final path, for every planned file.
|
|
138
|
+
* @returns `{ href, newHref }` pairs, in order of first appearance.
|
|
139
|
+
*/
|
|
140
|
+
export declare function markdownLinkFixes(content: string, path: string, finalPathOf: ReadonlyMap<string, string>): {
|
|
141
|
+
href: string;
|
|
142
|
+
newHref: string;
|
|
143
|
+
}[];
|
|
144
|
+
/**
|
|
145
|
+
* Apply `link-fix` rows to a kept file: only the listed hrefs of markdown
|
|
146
|
+
* links change, every other byte stays as it was (T14185).
|
|
147
|
+
*
|
|
148
|
+
* @param content - Doc text.
|
|
149
|
+
* @param fixes - The plan's fixes for this file.
|
|
150
|
+
* @returns The text with exactly those hrefs replaced.
|
|
151
|
+
*/
|
|
152
|
+
export declare function applyLinkFixes(content: string, fixes: readonly {
|
|
153
|
+
readonly href: string;
|
|
154
|
+
readonly newHref: string;
|
|
155
|
+
}[]): string;
|
|
156
|
+
/**
|
|
157
|
+
* Where every planned file ends up: a survivor at its target, a merged or
|
|
158
|
+
* deleted file at its survivor's target (T14185).
|
|
159
|
+
*
|
|
160
|
+
* @param rows - The plan rows.
|
|
161
|
+
* @returns Root-relative old path → final path.
|
|
162
|
+
*/
|
|
163
|
+
export declare function finalPaths(rows: readonly DocsModernizePlanRow[]): Map<string, string>;
|
|
164
|
+
/**
|
|
165
|
+
* Turn relative markdown links to planned files into `[[slug]]` /
|
|
166
|
+
* `[[slug|label]]` wikilinks: the opt-in `--wikilinks` mode (T14185). Only a
|
|
167
|
+
* planned file's final slug is ever written, so every wikilink resolves.
|
|
168
|
+
*
|
|
169
|
+
* @param content - Doc text.
|
|
170
|
+
* @param fromPath - The doc's own path relative to the root (resolves `../x.md`).
|
|
171
|
+
* @param slugByPath - Every scanned file's path → its final slug.
|
|
172
|
+
* @returns The rewritten text; links to files outside the plan are left as they are.
|
|
173
|
+
*/
|
|
174
|
+
export declare function rewriteDocLinks(content: string, fromPath: string, slugByPath: ReadonlyMap<string, string>): string;
|
|
175
|
+
/**
|
|
176
|
+
* Re-point existing `[[old-name]]` wikilinks to the final slug of the file
|
|
177
|
+
* they named. Only names in `slugRename` change, and its values are planned
|
|
178
|
+
* slugs, so a rewritten wikilink always resolves (T14185).
|
|
179
|
+
*
|
|
180
|
+
* @param content - Doc text.
|
|
181
|
+
* @param slugRename - Old name → final slug.
|
|
182
|
+
* @returns The text with renamed wikilinks.
|
|
183
|
+
*/
|
|
184
|
+
export declare function renameWikilinks(content: string, slugRename: ReadonlyMap<string, string>): string;
|
|
185
|
+
/**
|
|
186
|
+
* The planned slugs a body links to: its `[[wikilinks]]` plus the final slug
|
|
187
|
+
* of every planned file its relative markdown links point at (resolved from
|
|
188
|
+
* the file's final path). Feeds the `links-to` graph edges in both link modes.
|
|
189
|
+
*
|
|
190
|
+
* @param content - The body as written.
|
|
191
|
+
* @param atPath - The file's final path, relative to the root.
|
|
192
|
+
* @param slugByFinalPath - Final path → slug, for every planned survivor.
|
|
193
|
+
* @param wikilinkTargets - The body's `[[wikilink]]` targets.
|
|
194
|
+
* @returns Linked slugs, unique, sorted.
|
|
195
|
+
*/
|
|
196
|
+
export declare function linkedSlugs(content: string, atPath: string, slugByFinalPath: ReadonlyMap<string, string>, wikilinkTargets: readonly string[]): string[];
|
|
197
|
+
//# sourceMappingURL=rules.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/docs/modernize/rules.ts"],"names":[],"mappings":"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"}
|