sneakoscope 7.1.0 → 7.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +9 -1
- package/config/architecture-budgets.v1.json +1 -8
- package/crates/sks-core/Cargo.lock +225 -1
- package/crates/sks-core/Cargo.toml +8 -1
- package/crates/sks-core/src/main.rs +7 -1
- package/crates/sks-core/src/search/files.rs +114 -0
- package/crates/sks-core/src/search/mod.rs +274 -0
- package/crates/sks-core/src/search/text.rs +175 -0
- package/dist/bin/sks-dispatch.js +4 -3
- package/dist/cli/command-manifest-lite.js +177 -6
- package/dist/cli/command-registry.js +42 -8
- package/dist/cli/help.js +30 -0
- package/dist/cli/install-helpers-codex-lb-config.js +9 -6
- package/dist/cli/install-helpers-codex-lb-selftest-chain.js +1 -1
- package/dist/cli/install-helpers-install-support.js +1 -1
- package/dist/cli/install-helpers.js +19 -9
- package/dist/cli/router.js +16 -3
- package/dist/commands/codex-app.js +40 -5
- package/dist/commands/doctor-profile.js +78 -0
- package/dist/commands/doctor.js +29 -69
- package/dist/commands/search.js +4 -0
- package/dist/config/skills-manifest.json +53 -60
- package/dist/core/agent-bridge/agent-manifest.js +22 -26
- package/dist/core/agent-bridge/host-capability-policy.js +109 -8
- package/dist/core/agent-bridge/host-capability-runtime.js +178 -50
- package/dist/core/agent-guidance/directive-registry.js +123 -0
- package/dist/core/agents/agent-effort-policy.js +45 -6
- package/dist/core/agents/agent-worker-pipeline.js +1 -3
- package/dist/core/agents/native-worker-backend-router.js +43 -19
- package/dist/core/auto-review.js +1 -3
- package/dist/core/code-structure.js +282 -19
- package/dist/core/codex/codex-config-guard.js +14 -4
- package/dist/core/codex/codex-config-toml.js +1 -3
- package/dist/core/codex-app/codex-agent-role-sync.js +1 -3
- package/dist/core/codex-app/codex-app-fast-ui-repair.js +14 -1
- package/dist/core/codex-app/codex-app-types.js +2 -3
- package/dist/core/codex-app/codex-desktop-routing-ownership.js +91 -0
- package/dist/core/codex-app/codex-hook-approval-probe.js +1 -3
- package/dist/core/codex-app/codex-hook-lifecycle.js +1 -3
- package/dist/core/codex-app/codex-init-deep.js +22 -10
- package/dist/core/codex-app/codex-model-catalog.js +384 -0
- package/dist/core/codex-app/codex-models-cache.js +160 -0
- package/dist/core/codex-app/desktop-routing-snapshot.js +233 -0
- package/dist/core/codex-app/glm-profile-installer.js +1 -3
- package/dist/core/codex-app/mcp-manager.js +1 -3
- package/dist/core/codex-app/menubar/constants.js +3 -0
- package/dist/core/codex-app/menubar/installer.js +11 -1
- package/dist/core/codex-app/multi-provider-router-support.js +202 -0
- package/dist/core/codex-app/multi-provider-router.js +379 -0
- package/dist/core/codex-app/openrouter-activate.js +189 -26
- package/dist/core/codex-app/openrouter-base-instructions.js +1 -0
- package/dist/core/codex-app/openrouter-model-catalog.js +217 -0
- package/dist/core/codex-app/role-model-catalog-priority.js +61 -0
- package/dist/core/codex-app.js +30 -6
- package/dist/core/codex-compat/codex-hook-semantic-validator.js +1 -3
- package/dist/core/codex-control/codex-app-server-v2-client.js +39 -2
- package/dist/core/codex-lb/codex-lb-env.js +1 -3
- package/dist/core/codex-lb/codex-lb-tool-catalog.js +6 -1
- package/dist/core/codex-native/codex-native-feature-broker.js +2 -6
- package/dist/core/codex-native/codex-native-interop-policy.js +1 -3
- package/dist/core/codex-native/codex-native-reference-cache.js +1 -3
- package/dist/core/codex-native/codex-native-reference-source.js +1 -3
- package/dist/core/codex-native/codex-native-repair-transaction.js +1 -3
- package/dist/core/codex-native/core-skill-manifest.js +3 -2
- package/dist/core/codex-native/native-capability-repair-matrix.js +1 -3
- package/dist/core/codex-plugins/codex-plugin-repair.js +1 -3
- package/dist/core/codex-runtime/codex-desktop-config-policy.js +4 -4
- package/dist/core/commands/agent-bridge-command.js +24 -3
- package/dist/core/commands/image-ux-review-command.js +5 -11
- package/dist/core/commands/menubar-command.js +1 -1
- package/dist/core/commands/naruto-command.js +40 -13
- package/dist/core/commands/pipeline-command.js +5 -2
- package/dist/core/commands/release-command.js +63 -1
- package/dist/core/commands/remote-command.js +18 -0
- package/dist/core/commands/search-command.js +151 -0
- package/dist/core/commands/telegram-command.js +251 -108
- package/dist/core/commands/uninstall-command.js +1 -1
- package/dist/core/config/secret-preservation.js +1 -3
- package/dist/core/context7-client.js +2 -1
- package/dist/core/db-review.js +704 -0
- package/dist/core/db-safety.js +17 -23
- package/dist/core/doctor/browser-use-repair.js +1 -3
- package/dist/core/doctor/codex-startup-config-repair.js +1 -3
- package/dist/core/doctor/computer-use-repair.js +1 -3
- package/dist/core/doctor/context7-mcp-repair.js +1 -3
- package/dist/core/doctor/current-project-guidance.js +1 -3
- package/dist/core/doctor/doctor-codex-startup-repair.js +1 -3
- package/dist/core/doctor/doctor-dirty-planner.js +2 -2
- package/dist/core/doctor/doctor-native-capability-repair.js +1 -3
- package/dist/core/doctor/doctor-transaction.js +1 -3
- package/dist/core/doctor/imagegen-repair.js +1 -3
- package/dist/core/doctor/legacy-global-hook-cleanup.js +1 -3
- package/dist/core/doctor/mcp-transport-collision-repair.js +1 -3
- package/dist/core/doctor/retired-managed-residue-private.js +1 -3
- package/dist/core/doctor/supabase-mcp-repair.js +1 -3
- package/dist/core/engineering-sanity-review.js +186 -0
- package/dist/core/errors/message.js +3 -0
- package/dist/core/evidence/evidence-schema.js +1 -3
- package/dist/core/feature-fixtures.js +1 -0
- package/dist/core/feature-registry.js +1 -3
- package/dist/core/fsx.js +13 -0
- package/dist/core/git-hygiene/shared-memory-publish.js +1 -3
- package/dist/core/git-hygiene/validators.js +1 -3
- package/dist/core/harness-guard.js +21 -3
- package/dist/core/hooks-runtime/hook-context.js +2 -2
- package/dist/core/image-ux-review/imagegen-adapter.js +52 -56
- package/dist/core/image-ux-review/real-callout-extractor.js +6 -1
- package/dist/core/image-ux-review.js +3 -5
- package/dist/core/imagegen/codex-lb-imagegen-target.js +70 -0
- package/dist/core/imagegen/imagegen-capability.js +11 -11
- package/dist/core/imagegen/imagegen-evidence.js +32 -0
- package/dist/core/init/skills.js +9 -11
- package/dist/core/init.js +4 -6
- package/dist/core/json/records.js +9 -0
- package/dist/core/json-schema-validator.js +1 -3
- package/dist/core/lean-engineering-policy.js +54 -0
- package/dist/core/loops/loop-continuation-enforcer.js +1 -3
- package/dist/core/mad-sks/sql-plane/mcp-executor.js +2 -1
- package/dist/core/mad-sks/sql-plane/policy.js +2 -1
- package/dist/core/managed-assets/managed-assets-manifest.js +4 -3
- package/dist/core/mcp-config/codex-cli-adapter.js +1 -3
- package/dist/core/mcp-config/config-reader.js +2 -3
- package/dist/core/mcp-config/guarded-patch.js +1 -1
- package/dist/core/mcp-config/health-check.js +2 -1
- package/dist/core/mcp-config/mutation.js +1 -1
- package/dist/core/mcp-config/restore.js +1 -1
- package/dist/core/mcp-config/secret-policy.js +1 -3
- package/dist/core/migration/migration-transaction-journal.js +3 -3
- package/dist/core/naruto/naruto-concurrency-governor.js +2 -2
- package/dist/core/perf/import-graph-budget.js +91 -1
- package/dist/core/pipeline/pipeline-plan-writer.js +1 -1
- package/dist/core/pipeline-internals/runtime-core.js +121 -23
- package/dist/core/pipeline-internals/runtime-gates.js +193 -4
- package/dist/core/pipeline.js +1 -1
- package/dist/core/ppt-review/slide-imagegen-review.js +7 -7
- package/dist/core/ppt.js +3 -3
- package/dist/core/product-design-app-server.js +2 -1
- package/dist/core/proof/fake-real-proof-policy.js +1 -3
- package/dist/core/proof/root-cause-policy.js +1 -3
- package/dist/core/proof/validation.js +1 -3
- package/dist/core/provider/model-router.js +4 -0
- package/dist/core/provider/provider-context.js +1 -3
- package/dist/core/providers/openrouter/openrouter-account.js +1 -3
- package/dist/core/quality/helper-dedup.js +0 -0
- package/dist/core/recallpulse.js +1 -1
- package/dist/core/release/file-ownership.js +26 -17
- package/dist/core/release/macos-menubar-proof.js +59 -1
- package/dist/core/release/main-push-guard.js +288 -24
- package/dist/core/release/main-push-receipt.js +10 -45
- package/dist/core/release/package-size-budget.js +1 -1
- package/dist/core/release/release-gate-contract.js +2 -0
- package/dist/core/release/release-pack-receipt.js +1 -1
- package/dist/core/release/release-proof-io.js +33 -0
- package/dist/core/release/release-upgrade-baseline.js +9 -0
- package/dist/core/release/runtime-script-pack-closure.js +153 -4
- package/dist/core/release/stage-publish.js +194 -0
- package/dist/core/remote/index.js +2 -0
- package/dist/core/remote/local-worker-client.js +35 -0
- package/dist/core/remote/machine-registry.js +18 -13
- package/dist/core/remote/owner-proof.js +1 -3
- package/dist/core/remote/protocol.js +1 -3
- package/dist/core/remote/readiness.js +1 -3
- package/dist/core/remote/session-binding.js +153 -0
- package/dist/core/remote/session-index.js +1 -3
- package/dist/core/remote/types.js +1 -0
- package/dist/core/remote/worker.js +228 -14
- package/dist/core/responses-stream.js +151 -0
- package/dist/core/routes/dollar-manifest-lite.js +1 -1
- package/dist/core/routes.js +8 -8
- package/dist/core/rust-accelerator.js +12 -2
- package/dist/core/safety/ssot-guard.js +1 -3
- package/dist/core/search/benchmark.js +358 -0
- package/dist/core/search/cache.js +65 -0
- package/dist/core/search/context.js +144 -0
- package/dist/core/search/doctor.js +74 -0
- package/dist/core/search/files.js +192 -0
- package/dist/core/search/index.js +5 -0
- package/dist/core/search/ipc.js +64 -0
- package/dist/core/search/provider.js +142 -0
- package/dist/core/search/rust-bridge.js +24 -0
- package/dist/core/search/structure.js +230 -0
- package/dist/core/search/symbol.js +272 -0
- package/dist/core/search/text.js +146 -0
- package/dist/core/search/types.js +22 -0
- package/dist/core/search/typescript-ls.js +215 -0
- package/dist/core/search-visibility/discovery.js +1 -3
- package/dist/core/skill-forge.js +1 -1
- package/dist/core/stop-gate/gate-evaluator.js +3 -3
- package/dist/core/stop-gate/stop-gate-check.js +1 -3
- package/dist/core/structured-output-adapter.js +62 -2
- package/dist/core/subagents/agent-catalog.js +56 -43
- package/dist/core/subagents/model-policy.js +17 -7
- package/dist/core/subagents/naruto-proof-projection.js +2 -6
- package/dist/core/subagents/official-subagent-config.js +1 -3
- package/dist/core/subagents/official-subagent-preparation.js +73 -10
- package/dist/core/subagents/official-subagent-prompt.js +85 -18
- package/dist/core/subagents/official-subagent-runner.js +10 -5
- package/dist/core/subagents/role-model-preferences.js +202 -44
- package/dist/core/subagents/subagent-evidence.js +1 -3
- package/dist/core/subagents/thread-budget.js +1 -1
- package/dist/core/subagents/triwiki-attention.js +1 -5
- package/dist/core/telegram/config.js +29 -12
- package/dist/core/telegram/hub.js +8 -2
- package/dist/core/telegram/index.js +2 -0
- package/dist/core/telegram/messages.js +8 -2
- package/dist/core/telegram/runtime-projection.js +8 -5
- package/dist/core/telegram/runtime.js +19 -9
- package/dist/core/telegram/service.js +181 -0
- package/dist/core/telegram/setup.js +220 -0
- package/dist/core/text/regex.js +3 -0
- package/dist/core/text/strings.js +6 -0
- package/dist/core/triwiki-wrongness/image-wrongness.js +1 -3
- package/dist/core/triwiki-wrongness/wrongness-ledger.js +1 -3
- package/dist/core/triwiki-wrongness/wrongness-proof-linker.js +1 -3
- package/dist/core/triwiki-wrongness/wrongness-retrieval.js +1 -3
- package/dist/core/triwiki-wrongness/wrongness-schema.js +1 -3
- package/dist/core/triwiki-wrongness/wrongness-trust-policy.js +1 -3
- package/dist/core/trust-kernel/completion-contract.js +1 -3
- package/dist/core/trust-kernel/route-contract.js +1 -3
- package/dist/core/update/update-migration-state.js +1 -3
- package/dist/core/update-check.js +20 -6
- package/dist/core/verification/diff-quality.js +3 -4
- package/dist/core/verification/impact-scan.js +36 -89
- package/dist/core/verification/mistake-rule-compiler.js +17 -4
- package/dist/core/version-manager.js +3 -20
- package/dist/core/version.js +1 -1
- package/dist/native/sks-menubar/Sources/ControlCenterWindowController.swift +23 -3
- package/dist/native/sks-menubar/Sources/ControlKit.swift +102 -0
- package/dist/native/sks-menubar/Sources/DiagnosticsViewController.swift +23 -11
- package/dist/native/sks-menubar/Sources/MCPServersViewController.swift +7 -3
- package/dist/native/sks-menubar/Sources/OperationCoordinator.swift +17 -1
- package/dist/native/sks-menubar/Sources/OverviewViewController.swift +22 -15
- package/dist/native/sks-menubar/Sources/ProcessClient.swift +15 -5
- package/dist/native/sks-menubar/Sources/ProvidersMultiProvider.swift +324 -0
- package/dist/native/sks-menubar/Sources/ProvidersOpenRouter.swift +154 -214
- package/dist/native/sks-menubar/Sources/ProvidersRoleModels.swift +252 -0
- package/dist/native/sks-menubar/Sources/ProvidersViewController.swift +77 -71
- package/dist/native/sks-menubar/Sources/RemoteTelegramViewController.swift +167 -51
- package/dist/native/sks-menubar/Sources/SettingsViewController.swift +14 -5
- package/dist/native/sks-menubar/Sources/SidebarItem.swift +15 -1
- package/dist/native/sks-menubar/Sources/StatusItemController.swift +2 -2
- package/dist/native/sks-menubar/Sources/UpdatesViewController.swift +16 -12
- package/dist/scripts/agent-guidance-dedup-check.js +23 -0
- package/dist/scripts/agent-message-bus-reader-check.js +1 -1
- package/dist/scripts/all-feature-deep-completion-check.js +1 -1
- package/dist/scripts/appshots-thread-attachment-discovery-check.js +1 -1
- package/dist/scripts/architecture-guard-check.js +1 -2
- package/dist/scripts/certificate-sla-check.js +1 -1
- package/dist/scripts/cli-output-consistency-check.js +1 -1
- package/dist/scripts/codex-0-134-runner-truth-check.js +1 -1
- package/dist/scripts/codex-0138-capability-artifact-check.js +1 -1
- package/dist/scripts/codex-0138-capability-check.js +1 -1
- package/dist/scripts/codex-0138-doctor-check.js +1 -1
- package/dist/scripts/codex-0138-feature-probes-check.js +1 -1
- package/dist/scripts/codex-0144-app-server-v2-check.js +1 -1
- package/dist/scripts/codex-0144-binary-identity-check.js +1 -1
- package/dist/scripts/codex-0144-capability-check.js +1 -1
- package/dist/scripts/codex-0144-core-real-probes-check.js +1 -1
- package/dist/scripts/codex-0144-manifest-check.js +1 -1
- package/dist/scripts/codex-0144-policy-check.js +1 -1
- package/dist/scripts/codex-0144-thread-store-check.js +1 -1
- package/dist/scripts/codex-agent-role-rich-content-check.js +2 -2
- package/dist/scripts/codex-agent-role-sync-check.js +2 -2
- package/dist/scripts/codex-agent-type-routing-check.js +2 -2
- package/dist/scripts/codex-app-execution-profile-check.js +2 -2
- package/dist/scripts/codex-app-handoff-check.js +1 -1
- package/dist/scripts/codex-app-handoff-launch-check.js +1 -1
- package/dist/scripts/codex-control-tool-output-continuity-audit-check.js +1 -1
- package/dist/scripts/codex-lb-fast-ui-preservation-check.js +1 -3
- package/dist/scripts/codex-native-feature-broker-blackbox.js +2 -2
- package/dist/scripts/codex-native-feature-broker-check.js +2 -2
- package/dist/scripts/{sks-3-1-6-directive-check-lib.js → codex-native-gate-lib.js} +5 -5
- package/dist/scripts/codex-native-harness-compat-check.js +2 -2
- package/dist/scripts/codex-native-hook-lifecycle-proof-check.js +2 -2
- package/dist/scripts/codex-plugin-app-template-policy-check.js +1 -1
- package/dist/scripts/codex-sdk-backend-router-check.js +1 -1
- package/dist/scripts/codex-sdk-capability-check.js +1 -1
- package/dist/scripts/context7-evidence-dedupe-check.js +1 -1
- package/dist/scripts/core-skill-card-schema-check.js +1 -1
- package/dist/scripts/core-skill-deployment-snapshot-check.js +1 -1
- package/dist/scripts/core-skill-heldout-validation-check.js +1 -1
- package/dist/scripts/core-skill-no-inference-optimizer-check.js +1 -1
- package/dist/scripts/core-skill-patch-check.js +1 -1
- package/dist/scripts/core-skill-route-runtime-integration-check.js +1 -1
- package/dist/scripts/current-command-surface-check.js +1 -1
- package/dist/scripts/current-surface-update-e2e-check.js +4 -1
- package/dist/scripts/current-upgrade-matrix-check.js +1 -1
- package/dist/scripts/dfix-fixture-check.js +1 -1
- package/dist/scripts/dfix-patch-handoff-check.js +1 -1
- package/dist/scripts/dfix-verification-check.js +1 -1
- package/dist/scripts/dfix-verification-recommendation-check.js +1 -1
- package/dist/scripts/docs-truthfulness-check.js +16 -3
- package/dist/scripts/doctor-codex-app-harness-check.js +2 -2
- package/dist/scripts/evidence-flagship-coverage-check.js +1 -1
- package/dist/scripts/{sks-1-18-gate-lib.js → gate-lib.js} +1 -1
- package/dist/scripts/gate-policy-audit-check.js +4 -1
- package/dist/scripts/git-worktree-checkpoint-check.js +1 -1
- package/dist/scripts/git-worktree-cross-rebase-check.js +1 -1
- package/dist/scripts/git-worktree-diff-envelope-check.js +1 -1
- package/dist/scripts/git-worktree-dirty-lock-check.js +1 -1
- package/dist/scripts/git-worktree-dirty-main-detection-check.js +1 -1
- package/dist/scripts/git-worktree-integration-primary-check.js +1 -1
- package/dist/scripts/git-worktree-manifest-append-check.js +1 -1
- package/dist/scripts/git-worktree-untracked-diff-check.js +1 -1
- package/dist/scripts/harness-benchmark-check.js +1 -1
- package/dist/scripts/helper-dedup-check.js +62 -0
- package/dist/scripts/hook-latency-budget-check.js +1 -1
- package/dist/scripts/image-artifact-path-contract-check.js +1 -1
- package/dist/scripts/imagegen-real-smoke-check.js +2 -5
- package/dist/scripts/installed-package-smoke-check.js +1 -1
- package/dist/scripts/legacy-gate-inventory-check.js +1 -1
- package/dist/scripts/legacy-gate-purge-check.js +1 -1
- package/dist/scripts/legacy-strong-inventory-check.js +1 -1
- package/dist/scripts/lib/codex-sdk-gate-lib.js +1 -1
- package/dist/scripts/mad-sks-launch-sql-plane-boundary-check.js +1 -1
- package/dist/scripts/mad-sks-sql-plane-capability-check.js +1 -1
- package/dist/scripts/mad-sks-sql-plane-lifecycle-hook-decision-check.js +1 -1
- package/dist/scripts/mad-sks-sql-plane-result-lifecycle-check.js +1 -1
- package/dist/scripts/managed-config-merge-check.js +1 -1
- package/dist/scripts/mcp-plugin-inventory-check.js +1 -1
- package/dist/scripts/model-call-concurrency-check.js +1 -1
- package/dist/scripts/mutation-callsite-coverage-check.js +1 -1
- package/dist/scripts/naruto-ssot-gate-aliases-check.js +1 -1
- package/dist/scripts/naruto-ssot-pipeline-default-check.js +1 -1
- package/dist/scripts/naruto-ssot-route-normalization-check.js +1 -1
- package/dist/scripts/naruto-ssot-routing-check.js +1 -1
- package/dist/scripts/naruto-worktree-coding-blackbox.js +1 -1
- package/dist/scripts/native-capability-repair-matrix-check.js +1 -1
- package/dist/scripts/native-image-generation-repair-check.js +1 -1
- package/dist/scripts/official-subagent-workflow-check.js +3 -3
- package/dist/scripts/package-published-contract-check.js +37 -4
- package/dist/scripts/packlist-performance-check.js +17 -1
- package/dist/scripts/pipeline-codex-native-doctor-mad-routing-real-blackbox.js +1 -3
- package/dist/scripts/ppt-real-export-adapter-check.js +1 -1
- package/dist/scripts/ppt-real-imagegen-wiring-check.js +1 -1
- package/dist/scripts/ppt-reexport-rereview-check.js +1 -1
- package/dist/scripts/prepublish-fast-check.js +1 -1
- package/dist/scripts/probe-memoization-check.js +2 -2
- package/dist/scripts/prompt-placeholder-guard-check.js +1 -1
- package/dist/scripts/qa-loop-app-handoff-capability-check.js +1 -1
- package/dist/scripts/qa-loop-app-handoff-check.js +1 -1
- package/dist/scripts/qa-loop-app-handoff-cli-check.js +1 -1
- package/dist/scripts/qa-loop-app-handoff-confirmation-check.js +1 -1
- package/dist/scripts/qa-loop-app-handoff-gate-lifecycle-check.js +1 -1
- package/dist/scripts/qa-loop-app-handoff-launch-check.js +1 -1
- package/dist/scripts/qa-loop-app-handoff-status-lifecycle-check.js +1 -1
- package/dist/scripts/qa-loop-budget-policy-check.js +1 -1
- package/dist/scripts/qa-loop-effort-escalation-check.js +1 -1
- package/dist/scripts/qa-loop-execution-profile-routing-check.js +2 -2
- package/dist/scripts/qa-loop-image-path-exposure-check.js +1 -1
- package/dist/scripts/qa-loop-image-path-prompt-injection-check.js +1 -1
- package/dist/scripts/{sks-1-12-real-execution-check-lib.js → real-execution-check-lib.js} +1 -1
- package/dist/scripts/release-affected-selector-check.js +1 -1
- package/dist/scripts/release-aggressive-resource-governor-check.js +1 -1
- package/dist/scripts/release-cache-glob-hashing-check.js +1 -1
- package/dist/scripts/release-cache-input-classifier-check.js +1 -1
- package/dist/scripts/release-cache-neutralization-report-check.js +1 -1
- package/dist/scripts/release-cache-version-neutral-fixture-check.js +1 -1
- package/dist/scripts/release-dynamic-presets-check.js +2 -2
- package/dist/scripts/release-full-parallelism-blackbox.js +1 -1
- package/dist/scripts/release-gate-batch-runner-check.js +1 -1
- package/dist/scripts/release-gate-budget-check.js +1 -1
- package/dist/scripts/release-gate-dag-runner-check.js +1 -1
- package/dist/scripts/release-latency-slo-check.js +1 -1
- package/dist/scripts/release-metadata-check.js +256 -2
- package/dist/scripts/release-parallel-speed-budget-check.js +1 -1
- package/dist/scripts/release-proof-truth-check.js +1 -1
- package/dist/scripts/release-provenance-check.js +4 -2
- package/dist/scripts/release-runtime-truth-matrix-check.js +1 -1
- package/dist/scripts/research-blueprint-densifier-check.js +1 -1
- package/dist/scripts/research-claim-builder-check.js +1 -1
- package/dist/scripts/research-complete-package-fixture-check.js +1 -1
- package/dist/scripts/research-execution-profile-routing-check.js +2 -2
- package/dist/scripts/research-final-reviewer-blackbox.js +1 -1
- package/dist/scripts/{sks-3-1-4-directive-check-lib.js → runtime-domain-gate-lib.js} +2 -2
- package/dist/scripts/runtime-proof-summary-check.js +1 -1
- package/dist/scripts/runtime-script-pack-closure-check.js +7 -1
- package/dist/scripts/scheduler-batch-dispatch-check.js +1 -1
- package/dist/scripts/scheduler-parallel-proof-consistency-check.js +1 -1
- package/dist/scripts/scheduler-utilization-integral-check.js +1 -1
- package/dist/scripts/search-visibility-gate-lib.js +1 -1
- package/dist/scripts/secret-preservation-check.js +1 -1
- package/dist/scripts/seo-geo-geo-disambiguation-check.js +1 -1
- package/dist/scripts/seo-geo-skill-rich-content-check.js +1 -1
- package/dist/scripts/side-effect-runtime-report-check.js +1 -1
- package/dist/scripts/{sks-3-1-8-check-lib.js → skill-fixture-check-lib.js} +1 -1
- package/dist/scripts/skill-name-canonicalizer-check.js +1 -1
- package/dist/scripts/skills-manifest-continuity-check.js +1 -1
- package/dist/scripts/sks-uninstall-regression-check.js +1 -1
- package/dist/scripts/sksd-daemon-check.js +1 -1
- package/dist/scripts/super-search-provider-interface-check.js +1 -1
- package/dist/scripts/triwiki-cache-key-check.js +1 -1
- package/dist/scripts/triwiki-proof-bank-blackbox.js +2 -2
- package/dist/scripts/triwiki-proof-bank-check.js +1 -1
- package/dist/scripts/triwiki-proof-card-check.js +1 -1
- package/dist/scripts/type-surface-codex-app-check.js +2 -2
- package/dist/scripts/{sks-3-1-5-directive-check-lib.js → typed-routing-gate-lib.js} +2 -2
- package/dist/scripts/ultra-router-auto-router-check.js +1 -1
- package/dist/scripts/ux-review-extract-wires-real-extractor-check.js +1 -1
- package/dist/scripts/ux-review-patch-diff-recheck-check.js +1 -1
- package/dist/scripts/ux-review-run-wires-imagegen-check.js +9 -2
- package/package.json +5 -7
- package/release-gates.v2.json +66 -11
- package/runtime-required-scripts.json +138 -14
- package/config/bench-baseline.json +0 -7
- package/dist/core/codex-app/sks-menubar.js +0 -1
- package/dist/core/release/release-closure-contract.js +0 -30
- package/dist/core/release/release-closure-helpers.js +0 -293
- package/dist/core/release/release-closure-validation.js +0 -284
- package/dist/core/release/release-closure.js +0 -163
- package/dist/scripts/build-dist.js +0 -124
- package/dist/scripts/build-once-runner-check.js +0 -6
- package/dist/scripts/canonical-test-runner.js +0 -234
- package/dist/scripts/changelog-check.js +0 -45
- package/dist/scripts/check-architecture.js +0 -295
- package/dist/scripts/check-cli-entrypoint.js +0 -41
- package/dist/scripts/check-command-module-budget.js +0 -77
- package/dist/scripts/check-feature-quality.js +0 -51
- package/dist/scripts/check-legacy-free.js +0 -64
- package/dist/scripts/check-pipeline-budget.js +0 -49
- package/dist/scripts/check-pipeline-runtime.js +0 -16
- package/dist/scripts/check-publish-tag.js +0 -56
- package/dist/scripts/check-route-modularity.js +0 -72
- package/dist/scripts/codex-0140-capability-check.js +0 -14
- package/dist/scripts/codex-0140-feature-probes-check.js +0 -23
- package/dist/scripts/codex-permission-profiles-check.js +0 -34
- package/dist/scripts/codex-project-config-policy-splitter-check.js +0 -49
- package/dist/scripts/competitor-scorecard-check.js +0 -24
- package/dist/scripts/core-skill-no-drift-check.js +0 -23
- package/dist/scripts/db-route-materialization-check.js +0 -32
- package/dist/scripts/doctor-context7-mcp-repair-blackbox.js +0 -15
- package/dist/scripts/doctor-fastpath-check.js +0 -25
- package/dist/scripts/doctor-fix-production-blackbox.js +0 -35
- package/dist/scripts/doctor-idempotence-check.js +0 -6
- package/dist/scripts/doctor-ops-semantics-check.js +0 -83
- package/dist/scripts/doctor-startup-config-repair-blackbox.js +0 -18
- package/dist/scripts/doctor-supabase-mcp-repair-blackbox.js +0 -13
- package/dist/scripts/ensure-bin-executable.js +0 -16
- package/dist/scripts/fsx-hotpath-check.js +0 -9
- package/dist/scripts/high-risk-contracts-check.js +0 -183
- package/dist/scripts/hook-latency-quantum-check.js +0 -120
- package/dist/scripts/import-graph-budget-check.js +0 -9
- package/dist/scripts/mcp-tool-naming-parity-check.js +0 -14
- package/dist/scripts/naruto-codex-e2e-check.js +0 -105
- package/dist/scripts/naruto-write-e2e-check.js +0 -31
- package/dist/scripts/native-capability-postcheck-check.js +0 -16
- package/dist/scripts/ops-diagnostics-bundle-check.js +0 -11
- package/dist/scripts/parallel-production-smoke-check.js +0 -20
- package/dist/scripts/perf-budget-check.js +0 -12
- package/dist/scripts/project-skill-dedupe-blackbox.js +0 -62
- package/dist/scripts/release-dag-full-coverage-check.js +0 -98
- package/dist/scripts/release-dist-freshness-check.js +0 -6
- package/dist/scripts/release-file-ownership-check.js +0 -35
- package/dist/scripts/release-gate-script-parity-check.js +0 -148
- package/dist/scripts/release-macos-menubar-proof.js +0 -167
- package/dist/scripts/release-main-push-guard.js +0 -37
- package/dist/scripts/release-main-push-receipt.js +0 -43
- package/dist/scripts/release-metadata-1-19-check.js +0 -257
- package/dist/scripts/release-version-truth-check.js +0 -138
- package/dist/scripts/retention-apply-smoke-check.js +0 -19
- package/dist/scripts/retention-budget-check.js +0 -6
- package/dist/scripts/retention-dry-run-check.js +0 -8
- package/dist/scripts/rollback-recovery-smoke-check.js +0 -70
- package/dist/scripts/route-intent-regression-check.js +0 -42
- package/dist/scripts/runtime-current-terminal-check.js +0 -108
- package/dist/scripts/runtime-dist-parity-check.js +0 -76
- package/dist/scripts/runtime-no-src-mjs-check.js +0 -30
- package/dist/scripts/runtime-ts-rust-boundary-check.js +0 -58
- package/dist/scripts/runtime-ts-source-of-truth-check.js +0 -53
- package/dist/scripts/secret-preservation-guard-check.js +0 -36
- package/dist/scripts/seo-marketing-truthfulness-check.js +0 -98
- package/dist/scripts/seo-metadata-sync-check.js +0 -60
- package/dist/scripts/sizecheck.js +0 -148
- package/dist/scripts/sks-menubar-install-check.js +0 -333
- package/dist/scripts/supabase-secret-preservation-blackbox.js +0 -28
- package/dist/scripts/super-search-live-smoke-check.js +0 -115
- package/dist/scripts/super-search-local-http-smoke-check.js +0 -16
- package/dist/scripts/super-search-offline-contract-check.js +0 -43
- package/dist/scripts/update-fastpath-check.js +0 -28
- package/dist/scripts/update-preserves-supabase-keys-blackbox.js +0 -26
- package/dist/scripts/upgrade-migration-matrix-check.js +0 -351
- package/dist/scripts/write-build-manifest.js +0 -70
- package/dist/scripts/zellij-capability-check.js +0 -13
- package/dist/scripts/zellij-developer-controls-check.js +0 -16
- package/dist/scripts/zellij-doctor-readiness-check.js +0 -49
- package/dist/scripts/zellij-dynamic-pane-lifecycle-check.js +0 -19
- package/dist/scripts/zellij-fake-adapter-check.js +0 -31
- package/dist/scripts/zellij-first-slot-down-stack-check.js +0 -20
- package/dist/scripts/zellij-first-slot-down-stack-real-check.js +0 -348
- package/dist/scripts/zellij-homebrew-policy-check.js +0 -3
- package/dist/scripts/zellij-initial-main-only-blackbox.js +0 -21
- package/dist/scripts/zellij-lane-renderer-check.js +0 -78
- package/dist/scripts/zellij-launch-command-truth-check.js +0 -62
- package/dist/scripts/zellij-layout-valid-check.js +0 -120
- package/dist/scripts/zellij-pane-creation-lock-metrics-check.js +0 -10
- package/dist/scripts/zellij-pane-lock-concurrency-blackbox.js +0 -78
- package/dist/scripts/zellij-pane-lock-does-not-block-worker-check.js +0 -12
- package/dist/scripts/zellij-pane-lock-open-worker-integration-blackbox.js +0 -134
- package/dist/scripts/zellij-qa-app-handoff-status-check.js +0 -7
- package/dist/scripts/zellij-right-column-geometry-proof.js +0 -158
- package/dist/scripts/zellij-right-column-headless-overflow-check.js +0 -20
- package/dist/scripts/zellij-right-column-manager-check.js +0 -24
- package/dist/scripts/zellij-self-heal-check.js +0 -3
- package/dist/scripts/zellij-self-heal-dry-run-check.js +0 -3
- package/dist/scripts/zellij-self-heal-status-contract-check.js +0 -3
- package/dist/scripts/zellij-self-heal-typed-blackbox.js +0 -3
- package/dist/scripts/zellij-slot-column-anchor-check.js +0 -65
- package/dist/scripts/zellij-slot-column-anchor-telemetry-check.js +0 -8
- package/dist/scripts/zellij-slot-only-ui-check.js +0 -29
- package/dist/scripts/zellij-slot-pane-renderer-check.js +0 -149
- package/dist/scripts/zellij-slot-pane-stale-detection-check.js +0 -65
- package/dist/scripts/zellij-slot-pane-telemetry-renderer-check.js +0 -11
- package/dist/scripts/zellij-slot-renderer-proof-semantics-check.js +0 -58
- package/dist/scripts/zellij-slot-telemetry-check.js +0 -38
- package/dist/scripts/zellij-slot-telemetry-incremental-check.js +0 -46
- package/dist/scripts/zellij-slot-telemetry-live-flush-check.js +0 -55
- package/dist/scripts/zellij-slot-telemetry-performance-check.js +0 -32
- package/dist/scripts/zellij-slot-telemetry-real-blackbox.js +0 -19
- package/dist/scripts/zellij-slot-telemetry-renderer-check.js +0 -11
- package/dist/scripts/zellij-slot-telemetry-runtime-check.js +0 -23
- package/dist/scripts/zellij-spawn-on-demand-layout-check.js +0 -45
- package/dist/scripts/zellij-stacked-capability-routing-check.js +0 -9
- package/dist/scripts/zellij-stacked-fallback-integration-blackbox.js +0 -78
- package/dist/scripts/zellij-stacked-version-matrix-check.js +0 -29
- package/dist/scripts/zellij-stacked-version-parser-check.js +0 -19
- package/dist/scripts/zellij-ui-design-check.js +0 -92
- package/dist/scripts/zellij-update-missing-self-heal-check.js +0 -3
- package/dist/scripts/zellij-update-prompt-matrix-check.js +0 -16
- package/dist/scripts/zellij-update-prompt-mode-check.js +0 -18
- package/dist/scripts/zellij-update-prompt-safety-check.js +0 -8
- package/dist/scripts/zellij-worker-pane-manager-check.js +0 -108
- package/dist/scripts/zellij-worker-pane-manager-single-owner-check.js +0 -47
- package/dist/scripts/zellij-worker-pane-real-ui-blackbox.js +0 -199
- /package/dist/scripts/{sks-1-11-gate-lib.js → sks-cli-gate-lib.js} +0 -0
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
import crypto from 'node:crypto';
|
|
2
|
+
import fsp from 'node:fs/promises';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { cacheGet, cacheSet, searchCacheKey } from './cache.js';
|
|
5
|
+
import { searchFilesJs } from './files.js';
|
|
6
|
+
import { searchTextJs } from './text.js';
|
|
7
|
+
import { compareMatches, defaultSearchLimits, emptySkipped, SEARCH_PROVIDER_SCHEMA, SEARCH_SCHEMA_VERSION } from './types.js';
|
|
8
|
+
export async function searchContext(req) {
|
|
9
|
+
const started = Date.now();
|
|
10
|
+
const limits = defaultSearchLimits(req.limits);
|
|
11
|
+
const root = path.resolve(req.root);
|
|
12
|
+
const query = (req.query || req.pattern || '').trim();
|
|
13
|
+
if (!query) {
|
|
14
|
+
return {
|
|
15
|
+
schemaVersion: SEARCH_SCHEMA_VERSION,
|
|
16
|
+
schema: SEARCH_PROVIDER_SCHEMA,
|
|
17
|
+
ok: false,
|
|
18
|
+
mode: 'context',
|
|
19
|
+
provider: 'triwiki',
|
|
20
|
+
engine: 'triwiki+codepack',
|
|
21
|
+
matches: [],
|
|
22
|
+
confidence: 'context_pack',
|
|
23
|
+
truncated: false,
|
|
24
|
+
timeout: false,
|
|
25
|
+
limits,
|
|
26
|
+
scanned: { files: 0, bytes: 0 },
|
|
27
|
+
skipped: emptySkipped(),
|
|
28
|
+
cacheHit: false,
|
|
29
|
+
warnings: [],
|
|
30
|
+
errors: ['missing_context_query'],
|
|
31
|
+
durationMs: Date.now() - started,
|
|
32
|
+
processSpawns: 0,
|
|
33
|
+
deterministicOrder: 'path_line_column'
|
|
34
|
+
};
|
|
35
|
+
}
|
|
36
|
+
const cacheKey = searchCacheKey('triwiki_codepack', { ...req, root, mode: 'context', query });
|
|
37
|
+
const cached = cacheGet(cacheKey);
|
|
38
|
+
if (cached)
|
|
39
|
+
return { ...cached, cacheHit: true, durationMs: Date.now() - started };
|
|
40
|
+
const packMeta = await readCodePackMeta(root);
|
|
41
|
+
const filesResp = await searchFilesJs({
|
|
42
|
+
...req,
|
|
43
|
+
mode: 'files',
|
|
44
|
+
query,
|
|
45
|
+
limits: { ...limits, maxMatches: Math.min(80, limits.maxMatches) }
|
|
46
|
+
});
|
|
47
|
+
const textResp = await searchTextJs({
|
|
48
|
+
...req,
|
|
49
|
+
mode: 'text',
|
|
50
|
+
pattern: escapeRegex(query),
|
|
51
|
+
caseSensitive: false,
|
|
52
|
+
limits: { ...limits, maxMatches: Math.min(120, limits.maxMatches) }
|
|
53
|
+
});
|
|
54
|
+
const matches = [];
|
|
55
|
+
for (const m of filesResp.matches) {
|
|
56
|
+
matches.push({
|
|
57
|
+
path: m.path,
|
|
58
|
+
confidence: 'context_pack',
|
|
59
|
+
meta: { channel: 'path_match' }
|
|
60
|
+
});
|
|
61
|
+
}
|
|
62
|
+
for (const m of textResp.matches) {
|
|
63
|
+
matches.push({
|
|
64
|
+
...m,
|
|
65
|
+
confidence: 'context_pack',
|
|
66
|
+
meta: { ...(m.meta || {}), channel: 'text_match', text_is_not_reference: true }
|
|
67
|
+
});
|
|
68
|
+
}
|
|
69
|
+
matches.sort(compareMatches);
|
|
70
|
+
const tokenBudgetOmissions = Math.max(0, textResp.matches.length + filesResp.matches.length - matches.length);
|
|
71
|
+
let fileHash = null;
|
|
72
|
+
if (matches[0]) {
|
|
73
|
+
try {
|
|
74
|
+
const buf = await fsp.readFile(path.join(root, matches[0].path));
|
|
75
|
+
fileHash = crypto.createHash('sha256').update(buf).digest('hex');
|
|
76
|
+
}
|
|
77
|
+
catch {
|
|
78
|
+
fileHash = null;
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
const response = {
|
|
82
|
+
schemaVersion: SEARCH_SCHEMA_VERSION,
|
|
83
|
+
schema: SEARCH_PROVIDER_SCHEMA,
|
|
84
|
+
ok: true,
|
|
85
|
+
mode: 'context',
|
|
86
|
+
provider: 'triwiki',
|
|
87
|
+
engine: 'triwiki+codepack+local-search',
|
|
88
|
+
matches: matches.slice(0, limits.maxMatches),
|
|
89
|
+
confidence: 'context_pack',
|
|
90
|
+
truncated: filesResp.truncated || textResp.truncated || matches.length > limits.maxMatches,
|
|
91
|
+
timeout: textResp.timeout,
|
|
92
|
+
limits,
|
|
93
|
+
scanned: {
|
|
94
|
+
files: filesResp.scanned.files + textResp.scanned.files,
|
|
95
|
+
bytes: textResp.scanned.bytes
|
|
96
|
+
},
|
|
97
|
+
skipped: textResp.skipped,
|
|
98
|
+
cacheHit: false,
|
|
99
|
+
warnings: packMeta.warnings,
|
|
100
|
+
errors: [],
|
|
101
|
+
durationMs: Date.now() - started,
|
|
102
|
+
processSpawns: filesResp.processSpawns + textResp.processSpawns,
|
|
103
|
+
context: {
|
|
104
|
+
whySearched: req.why || 'ai_context',
|
|
105
|
+
method: 'triwiki_codepack_local',
|
|
106
|
+
hydrated: Boolean(packMeta.present),
|
|
107
|
+
indexFreshness: packMeta.freshness,
|
|
108
|
+
fileHash,
|
|
109
|
+
truncation: filesResp.truncated || textResp.truncated,
|
|
110
|
+
excludedCount: textResp.skipped.files,
|
|
111
|
+
tokenBudgetOmissions
|
|
112
|
+
},
|
|
113
|
+
deterministicOrder: 'path_line_column'
|
|
114
|
+
};
|
|
115
|
+
cacheSet(cacheKey, response);
|
|
116
|
+
return response;
|
|
117
|
+
}
|
|
118
|
+
async function readCodePackMeta(root) {
|
|
119
|
+
const candidates = [
|
|
120
|
+
path.join(root, '.sneakoscope', 'wiki', 'code-pack.json'),
|
|
121
|
+
path.join(root, '.sneakoscope', 'wiki', 'context-pack.json')
|
|
122
|
+
];
|
|
123
|
+
for (const file of candidates) {
|
|
124
|
+
try {
|
|
125
|
+
const text = await fsp.readFile(file, 'utf8');
|
|
126
|
+
const json = JSON.parse(text);
|
|
127
|
+
return {
|
|
128
|
+
present: true,
|
|
129
|
+
freshness: json.generated_at || json.updated_at || json.head || null,
|
|
130
|
+
warnings: json.truncated ? ['code_pack_truncated'] : []
|
|
131
|
+
};
|
|
132
|
+
}
|
|
133
|
+
catch {
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
return {
|
|
137
|
+
present: false,
|
|
138
|
+
freshness: null,
|
|
139
|
+
warnings: ['code_pack_missing:run_sks_wiki_refresh_--code']
|
|
140
|
+
};
|
|
141
|
+
}
|
|
142
|
+
function escapeRegex(value) {
|
|
143
|
+
return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
|
144
|
+
}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import { projectRoot } from '../fsx.js';
|
|
2
|
+
import { searchCapabilities } from './provider.js';
|
|
3
|
+
import { search } from './provider.js';
|
|
4
|
+
import { SEARCH_SCHEMA_VERSION } from './types.js';
|
|
5
|
+
export async function buildSearchDoctorReport(args = []) {
|
|
6
|
+
const root = await projectRoot(process.cwd());
|
|
7
|
+
const capabilities = await searchCapabilities(root);
|
|
8
|
+
const smokeFiles = await search({
|
|
9
|
+
schemaVersion: SEARCH_SCHEMA_VERSION,
|
|
10
|
+
mode: 'files',
|
|
11
|
+
root,
|
|
12
|
+
query: 'package.json',
|
|
13
|
+
limits: { maxMatches: 5, timeoutMs: 10_000 }
|
|
14
|
+
});
|
|
15
|
+
const smokeText = await search({
|
|
16
|
+
schemaVersion: SEARCH_SCHEMA_VERSION,
|
|
17
|
+
mode: 'text',
|
|
18
|
+
root,
|
|
19
|
+
pattern: 'SearchProvider|sks\\.search-provider',
|
|
20
|
+
include: ['src/core/search/**'],
|
|
21
|
+
limits: { maxMatches: 20, timeoutMs: 15_000 }
|
|
22
|
+
});
|
|
23
|
+
const smokeStructure = await search({
|
|
24
|
+
schemaVersion: SEARCH_SCHEMA_VERSION,
|
|
25
|
+
mode: 'structure',
|
|
26
|
+
root,
|
|
27
|
+
pattern: 'function_declaration search',
|
|
28
|
+
language: 'typescript',
|
|
29
|
+
include: ['src/core/search/**'],
|
|
30
|
+
limits: { maxMatches: 20, timeoutMs: 15_000 }
|
|
31
|
+
});
|
|
32
|
+
const blockers = [];
|
|
33
|
+
if (!smokeFiles.ok)
|
|
34
|
+
blockers.push('files_engine_failed');
|
|
35
|
+
if (!smokeText.ok)
|
|
36
|
+
blockers.push('text_engine_failed');
|
|
37
|
+
if (!smokeStructure.ok)
|
|
38
|
+
blockers.push(...smokeStructure.errors.map((e) => `structure:${e}`));
|
|
39
|
+
if (capabilities.warnings.includes('sks_rs_search_unavailable')) {
|
|
40
|
+
}
|
|
41
|
+
const report = {
|
|
42
|
+
schema: 'sks.search-doctor.v1',
|
|
43
|
+
ok: blockers.length === 0,
|
|
44
|
+
root,
|
|
45
|
+
capabilities,
|
|
46
|
+
smoke: {
|
|
47
|
+
files: { ok: smokeFiles.ok, provider: smokeFiles.provider, matches: smokeFiles.matches.length, processSpawns: smokeFiles.processSpawns },
|
|
48
|
+
text: { ok: smokeText.ok, provider: smokeText.provider, matches: smokeText.matches.length, processSpawns: smokeText.processSpawns },
|
|
49
|
+
structure: { ok: smokeStructure.ok, provider: smokeStructure.provider, matches: smokeStructure.matches.length, errors: smokeStructure.errors }
|
|
50
|
+
},
|
|
51
|
+
external_binaries: {
|
|
52
|
+
rg_required: false,
|
|
53
|
+
ast_grep_required: false,
|
|
54
|
+
fd_required: false
|
|
55
|
+
},
|
|
56
|
+
blockers,
|
|
57
|
+
args
|
|
58
|
+
};
|
|
59
|
+
return report;
|
|
60
|
+
}
|
|
61
|
+
export function printSearchDoctorReport(report, json) {
|
|
62
|
+
if (json) {
|
|
63
|
+
console.log(JSON.stringify(report, null, 2));
|
|
64
|
+
return;
|
|
65
|
+
}
|
|
66
|
+
console.log(`Search doctor: ${report.ok ? 'ok' : 'blocked'}`);
|
|
67
|
+
console.log(`Root: ${report.root}`);
|
|
68
|
+
console.log(`Rust search: ${report.capabilities.rust.available ? report.capabilities.rust.version : 'js_fallback'}`);
|
|
69
|
+
console.log(`Files smoke: ${report.smoke.files.provider} matches=${report.smoke.files.matches} spawns=${report.smoke.files.processSpawns}`);
|
|
70
|
+
console.log(`Text smoke: ${report.smoke.text.provider} matches=${report.smoke.text.matches} spawns=${report.smoke.text.processSpawns}`);
|
|
71
|
+
console.log(`Structure smoke: ${report.smoke.structure.provider} matches=${report.smoke.structure.matches}`);
|
|
72
|
+
if (report.blockers.length)
|
|
73
|
+
console.log(`Blockers: ${report.blockers.join(', ')}`);
|
|
74
|
+
}
|
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import fsp from 'node:fs/promises';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { spawnSync } from 'node:child_process';
|
|
5
|
+
import { cacheGet, cacheSet, searchCacheKey } from './cache.js';
|
|
6
|
+
import { compareMatches, defaultSearchLimits, emptySkipped, SEARCH_PROVIDER_SCHEMA, SEARCH_SCHEMA_VERSION } from './types.js';
|
|
7
|
+
const DEFAULT_SKIP = new Set([
|
|
8
|
+
'.git',
|
|
9
|
+
'node_modules',
|
|
10
|
+
'dist',
|
|
11
|
+
'build',
|
|
12
|
+
'coverage',
|
|
13
|
+
'.sneakoscope/tmp',
|
|
14
|
+
'.sneakoscope/arenas',
|
|
15
|
+
'target'
|
|
16
|
+
]);
|
|
17
|
+
export async function searchFilesJs(req) {
|
|
18
|
+
const started = Date.now();
|
|
19
|
+
const limits = defaultSearchLimits(req.limits);
|
|
20
|
+
const root = path.resolve(req.root);
|
|
21
|
+
const cacheKey = searchCacheKey('dir_snapshot', { ...req, root, mode: 'files' });
|
|
22
|
+
const cached = cacheGet(cacheKey);
|
|
23
|
+
if (cached) {
|
|
24
|
+
return { ...cached, cacheHit: true, durationMs: Date.now() - started };
|
|
25
|
+
}
|
|
26
|
+
const skipped = emptySkipped();
|
|
27
|
+
let files = [];
|
|
28
|
+
const gitListed = listViaGit(root);
|
|
29
|
+
if (gitListed) {
|
|
30
|
+
files = gitListed;
|
|
31
|
+
}
|
|
32
|
+
else {
|
|
33
|
+
files = await walkIgnoreAware(root, limits.maxFiles, skipped);
|
|
34
|
+
}
|
|
35
|
+
const include = req.include || [];
|
|
36
|
+
const exclude = [...(req.exclude || []), ...(req.pattern ? [] : [])];
|
|
37
|
+
const query = (req.query || req.pattern || '').trim();
|
|
38
|
+
let filtered = files.filter((rel) => {
|
|
39
|
+
if (exclude.some((g) => globMatch(rel, g))) {
|
|
40
|
+
skipped.files += 1;
|
|
41
|
+
skipped.reasons.exclude = (skipped.reasons.exclude || 0) + 1;
|
|
42
|
+
return false;
|
|
43
|
+
}
|
|
44
|
+
if (include.length && !include.some((g) => globMatch(rel, g))) {
|
|
45
|
+
skipped.files += 1;
|
|
46
|
+
skipped.reasons.include = (skipped.reasons.include || 0) + 1;
|
|
47
|
+
return false;
|
|
48
|
+
}
|
|
49
|
+
if (query && !rel.toLowerCase().includes(query.toLowerCase()))
|
|
50
|
+
return false;
|
|
51
|
+
return true;
|
|
52
|
+
});
|
|
53
|
+
let truncated = false;
|
|
54
|
+
if (filtered.length > limits.maxMatches) {
|
|
55
|
+
filtered = filtered.slice(0, limits.maxMatches);
|
|
56
|
+
truncated = true;
|
|
57
|
+
}
|
|
58
|
+
const matches = filtered
|
|
59
|
+
.map((p) => ({ path: p, confidence: 'file_path' }))
|
|
60
|
+
.sort(compareMatches);
|
|
61
|
+
const response = {
|
|
62
|
+
schemaVersion: SEARCH_SCHEMA_VERSION,
|
|
63
|
+
schema: SEARCH_PROVIDER_SCHEMA,
|
|
64
|
+
ok: true,
|
|
65
|
+
mode: 'files',
|
|
66
|
+
provider: 'js',
|
|
67
|
+
engine: gitListed ? 'js+git-ls-files' : 'js-walk',
|
|
68
|
+
matches,
|
|
69
|
+
confidence: 'file_path',
|
|
70
|
+
truncated,
|
|
71
|
+
timeout: false,
|
|
72
|
+
limits,
|
|
73
|
+
scanned: { files: files.length, bytes: 0 },
|
|
74
|
+
skipped,
|
|
75
|
+
cacheHit: false,
|
|
76
|
+
warnings: gitListed ? [] : ['gitignore_partial:js_walk_without_full_ignore_crate'],
|
|
77
|
+
errors: [],
|
|
78
|
+
durationMs: Date.now() - started,
|
|
79
|
+
processSpawns: gitListed ? 1 : 0,
|
|
80
|
+
deterministicOrder: 'path_line_column'
|
|
81
|
+
};
|
|
82
|
+
cacheSet(cacheKey, response);
|
|
83
|
+
return response;
|
|
84
|
+
}
|
|
85
|
+
function listViaGit(root) {
|
|
86
|
+
try {
|
|
87
|
+
const r = spawnSync('git', ['ls-files', '-co', '--exclude-standard'], {
|
|
88
|
+
cwd: root,
|
|
89
|
+
encoding: 'utf8',
|
|
90
|
+
maxBuffer: 64 * 1024 * 1024
|
|
91
|
+
});
|
|
92
|
+
if (r.status !== 0 || r.error)
|
|
93
|
+
return null;
|
|
94
|
+
return String(r.stdout || '')
|
|
95
|
+
.split('\n')
|
|
96
|
+
.map((line) => line.trim().replace(/\\/g, '/'))
|
|
97
|
+
.filter(Boolean)
|
|
98
|
+
.sort((a, b) => a.localeCompare(b));
|
|
99
|
+
}
|
|
100
|
+
catch {
|
|
101
|
+
return null;
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
async function walkIgnoreAware(root, maxFiles, skipped) {
|
|
105
|
+
const out = [];
|
|
106
|
+
async function walk(abs, rel, depth) {
|
|
107
|
+
if (out.length >= maxFiles || depth > 40)
|
|
108
|
+
return;
|
|
109
|
+
let entries = [];
|
|
110
|
+
try {
|
|
111
|
+
entries = await fsp.readdir(abs, { withFileTypes: true });
|
|
112
|
+
}
|
|
113
|
+
catch {
|
|
114
|
+
skipped.files += 1;
|
|
115
|
+
skipped.reasons.readdir = (skipped.reasons.readdir || 0) + 1;
|
|
116
|
+
return;
|
|
117
|
+
}
|
|
118
|
+
for (const entry of entries) {
|
|
119
|
+
if (out.length >= maxFiles)
|
|
120
|
+
return;
|
|
121
|
+
const name = entry.name;
|
|
122
|
+
const childRel = rel ? `${rel}/${name}` : name;
|
|
123
|
+
const childAbs = path.join(abs, name);
|
|
124
|
+
if (DEFAULT_SKIP.has(name) || DEFAULT_SKIP.has(childRel.split('/')[0] || '')) {
|
|
125
|
+
skipped.files += 1;
|
|
126
|
+
skipped.reasons.default_skip = (skipped.reasons.default_skip || 0) + 1;
|
|
127
|
+
continue;
|
|
128
|
+
}
|
|
129
|
+
try {
|
|
130
|
+
if (entry.isSymbolicLink()) {
|
|
131
|
+
skipped.files += 1;
|
|
132
|
+
skipped.reasons.symlink = (skipped.reasons.symlink || 0) + 1;
|
|
133
|
+
continue;
|
|
134
|
+
}
|
|
135
|
+
if (entry.isDirectory()) {
|
|
136
|
+
await walk(childAbs, childRel, depth + 1);
|
|
137
|
+
}
|
|
138
|
+
else if (entry.isFile()) {
|
|
139
|
+
out.push(childRel.replace(/\\/g, '/'));
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
catch {
|
|
143
|
+
skipped.files += 1;
|
|
144
|
+
skipped.reasons.permission = (skipped.reasons.permission || 0) + 1;
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
await walk(root, '', 0);
|
|
149
|
+
return out.sort((a, b) => a.localeCompare(b));
|
|
150
|
+
}
|
|
151
|
+
function globMatch(rel, pattern) {
|
|
152
|
+
const p = pattern.replace(/\\/g, '/');
|
|
153
|
+
if (p.startsWith('!'))
|
|
154
|
+
return false;
|
|
155
|
+
const brace = p.match(/^(.*)\{([^}]+)\}(.*)$/);
|
|
156
|
+
if (brace) {
|
|
157
|
+
const [, pre, body, post] = brace;
|
|
158
|
+
return body.split(',').some((alt) => globMatch(rel, `${pre}${alt.trim()}${post}`));
|
|
159
|
+
}
|
|
160
|
+
if (p.startsWith('**/') && globMatch(rel, p.slice(3)))
|
|
161
|
+
return true;
|
|
162
|
+
return globToRegExp(p).test(rel);
|
|
163
|
+
}
|
|
164
|
+
function globToRegExp(pattern) {
|
|
165
|
+
let out = '^';
|
|
166
|
+
let i = 0;
|
|
167
|
+
while (i < pattern.length) {
|
|
168
|
+
if (pattern.startsWith('**/', i) || pattern.startsWith('**', i)) {
|
|
169
|
+
out += '.*';
|
|
170
|
+
i += pattern.startsWith('**/', i) ? 3 : 2;
|
|
171
|
+
continue;
|
|
172
|
+
}
|
|
173
|
+
const ch = pattern[i];
|
|
174
|
+
if (ch === '*') {
|
|
175
|
+
out += '[^/]*';
|
|
176
|
+
i += 1;
|
|
177
|
+
continue;
|
|
178
|
+
}
|
|
179
|
+
if (ch === '?') {
|
|
180
|
+
out += '[^/]';
|
|
181
|
+
i += 1;
|
|
182
|
+
continue;
|
|
183
|
+
}
|
|
184
|
+
out += escapeRegex(ch);
|
|
185
|
+
i += 1;
|
|
186
|
+
}
|
|
187
|
+
out += '$';
|
|
188
|
+
return new RegExp(out);
|
|
189
|
+
}
|
|
190
|
+
function escapeRegex(value) {
|
|
191
|
+
return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
|
192
|
+
}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { findRustAccelerator, rustAcceleratorProbeForSearch } from './rust-bridge.js';
|
|
2
|
+
import { runProcess } from '../fsx.js';
|
|
3
|
+
import { SEARCH_PROVIDER_SCHEMA, SEARCH_SCHEMA_VERSION } from './types.js';
|
|
4
|
+
export async function tryRustSearch(req) {
|
|
5
|
+
const probe = await rustAcceleratorProbeForSearch();
|
|
6
|
+
if (!probe.bin || !probe.compatible)
|
|
7
|
+
return null;
|
|
8
|
+
const result = await runProcess(probe.bin, ['search', req.mode, '--json'], {
|
|
9
|
+
cwd: req.root,
|
|
10
|
+
input: JSON.stringify(req),
|
|
11
|
+
timeoutMs: req.limits?.timeoutMs ?? 30_000,
|
|
12
|
+
maxOutputBytes: 8 * 1024 * 1024
|
|
13
|
+
}).catch((err) => ({ code: 1, stdout: '', stderr: err.message, timedOut: false, truncated: false }));
|
|
14
|
+
if (result.timedOut)
|
|
15
|
+
return null;
|
|
16
|
+
if (result.code !== 0 && !result.stdout.trim()) {
|
|
17
|
+
return null;
|
|
18
|
+
}
|
|
19
|
+
try {
|
|
20
|
+
const parsed = JSON.parse(result.stdout);
|
|
21
|
+
if (parsed?.schemaVersion !== SEARCH_SCHEMA_VERSION)
|
|
22
|
+
return null;
|
|
23
|
+
return {
|
|
24
|
+
...parsed,
|
|
25
|
+
provider: 'sks-rs',
|
|
26
|
+
processSpawns: 1,
|
|
27
|
+
schema: SEARCH_PROVIDER_SCHEMA
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
catch {
|
|
31
|
+
return null;
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
export async function tryRustSearchBatch(batch) {
|
|
35
|
+
const probe = await rustAcceleratorProbeForSearch();
|
|
36
|
+
if (!probe.bin || !probe.compatible)
|
|
37
|
+
return null;
|
|
38
|
+
const result = await runProcess(probe.bin, ['search', 'batch', '--json'], {
|
|
39
|
+
cwd: batch.root,
|
|
40
|
+
input: JSON.stringify(batch),
|
|
41
|
+
timeoutMs: 60_000,
|
|
42
|
+
maxOutputBytes: 16 * 1024 * 1024
|
|
43
|
+
}).catch((err) => ({ code: 1, stdout: '', stderr: err.message }));
|
|
44
|
+
if (result.code !== 0 && !String(result.stdout || '').trim())
|
|
45
|
+
return null;
|
|
46
|
+
try {
|
|
47
|
+
const parsed = JSON.parse(result.stdout);
|
|
48
|
+
if (parsed?.schemaVersion !== SEARCH_SCHEMA_VERSION)
|
|
49
|
+
return null;
|
|
50
|
+
return { ...parsed, provider: 'sks-rs', processSpawns: 1 };
|
|
51
|
+
}
|
|
52
|
+
catch {
|
|
53
|
+
return null;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
export async function rustSearchStatus() {
|
|
57
|
+
const probe = await rustAcceleratorProbeForSearch();
|
|
58
|
+
return {
|
|
59
|
+
available: Boolean(probe.bin && probe.compatible),
|
|
60
|
+
bin: probe.bin,
|
|
61
|
+
version: probe.version || null
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
export { findRustAccelerator };
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
import path from 'node:path';
|
|
2
|
+
import { searchContext } from './context.js';
|
|
3
|
+
import { searchFilesJs } from './files.js';
|
|
4
|
+
import { tryRustSearch, tryRustSearchBatch, rustSearchStatus } from './ipc.js';
|
|
5
|
+
import { rustSupportsSearchCommand } from './rust-bridge.js';
|
|
6
|
+
import { searchStructure } from './structure.js';
|
|
7
|
+
import { searchSymbol } from './symbol.js';
|
|
8
|
+
import { searchTextJs } from './text.js';
|
|
9
|
+
import { SEARCH_SCHEMA_VERSION } from './types.js';
|
|
10
|
+
export async function search(request) {
|
|
11
|
+
const req = {
|
|
12
|
+
...request,
|
|
13
|
+
schemaVersion: SEARCH_SCHEMA_VERSION,
|
|
14
|
+
root: path.resolve(request.root)
|
|
15
|
+
};
|
|
16
|
+
if (req.mode === 'files' || req.mode === 'text') {
|
|
17
|
+
if (await rustSupportsSearchCommand()) {
|
|
18
|
+
const rust = await tryRustSearch(req);
|
|
19
|
+
if (rust)
|
|
20
|
+
return rust;
|
|
21
|
+
}
|
|
22
|
+
return req.mode === 'files' ? searchFilesJs(req) : searchTextJs(req);
|
|
23
|
+
}
|
|
24
|
+
if (req.mode === 'structure')
|
|
25
|
+
return searchStructure(req);
|
|
26
|
+
if (req.mode === 'symbol')
|
|
27
|
+
return searchSymbol(req);
|
|
28
|
+
if (req.mode === 'context')
|
|
29
|
+
return searchContext(req);
|
|
30
|
+
return {
|
|
31
|
+
schemaVersion: SEARCH_SCHEMA_VERSION,
|
|
32
|
+
schema: 'sks.search-provider.v1',
|
|
33
|
+
ok: false,
|
|
34
|
+
mode: req.mode,
|
|
35
|
+
provider: 'js',
|
|
36
|
+
engine: 'none',
|
|
37
|
+
matches: [],
|
|
38
|
+
confidence: 'mixed',
|
|
39
|
+
truncated: false,
|
|
40
|
+
timeout: false,
|
|
41
|
+
limits: {
|
|
42
|
+
maxMatches: 0,
|
|
43
|
+
maxFiles: 0,
|
|
44
|
+
maxBytes: 0,
|
|
45
|
+
timeoutMs: 0
|
|
46
|
+
},
|
|
47
|
+
scanned: { files: 0, bytes: 0 },
|
|
48
|
+
skipped: { files: 0, reasons: {} },
|
|
49
|
+
cacheHit: false,
|
|
50
|
+
warnings: [],
|
|
51
|
+
errors: [`unsupported_mode:${String(req.mode)}`],
|
|
52
|
+
durationMs: 0,
|
|
53
|
+
processSpawns: 0,
|
|
54
|
+
deterministicOrder: 'path_line_column'
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
export async function searchBatch(batch) {
|
|
58
|
+
const started = Date.now();
|
|
59
|
+
const root = path.resolve(batch.root);
|
|
60
|
+
const normalized = {
|
|
61
|
+
schemaVersion: SEARCH_SCHEMA_VERSION,
|
|
62
|
+
root,
|
|
63
|
+
requests: batch.requests.map((r) => ({ ...r, schemaVersion: SEARCH_SCHEMA_VERSION, root }))
|
|
64
|
+
};
|
|
65
|
+
if (await rustSupportsSearchCommand()) {
|
|
66
|
+
const rust = await tryRustSearchBatch(normalized);
|
|
67
|
+
if (rust)
|
|
68
|
+
return rust;
|
|
69
|
+
}
|
|
70
|
+
const responses = [];
|
|
71
|
+
let spawns = 0;
|
|
72
|
+
for (const req of normalized.requests) {
|
|
73
|
+
const resp = await search(req);
|
|
74
|
+
responses.push(resp);
|
|
75
|
+
spawns += resp.processSpawns;
|
|
76
|
+
}
|
|
77
|
+
return {
|
|
78
|
+
schemaVersion: SEARCH_SCHEMA_VERSION,
|
|
79
|
+
schema: 'sks.search-batch.v1',
|
|
80
|
+
ok: responses.every((r) => r.ok),
|
|
81
|
+
provider: responses.some((r) => r.provider === 'sks-rs') ? 'mixed' : 'js',
|
|
82
|
+
responses,
|
|
83
|
+
processSpawns: spawns,
|
|
84
|
+
durationMs: Date.now() - started
|
|
85
|
+
};
|
|
86
|
+
}
|
|
87
|
+
export async function searchCapabilities(root = process.cwd()) {
|
|
88
|
+
const rust = await rustSearchStatus();
|
|
89
|
+
const rustSearch = rust.available && (await rustSupportsSearchCommand());
|
|
90
|
+
return {
|
|
91
|
+
schema: 'sks.search-capability.v1',
|
|
92
|
+
ok: true,
|
|
93
|
+
schemaVersion: SEARCH_SCHEMA_VERSION,
|
|
94
|
+
modes: {
|
|
95
|
+
files: {
|
|
96
|
+
available: true,
|
|
97
|
+
provider: rustSearch ? 'sks-rs' : 'js',
|
|
98
|
+
engine: rustSearch ? 'ignore' : 'js+git-ls-files',
|
|
99
|
+
externalBinaryRequired: false,
|
|
100
|
+
notes: rustSearch ? [] : ['Using JS fallback; build sks-rs for Rust ignore engine']
|
|
101
|
+
},
|
|
102
|
+
text: {
|
|
103
|
+
available: true,
|
|
104
|
+
provider: rustSearch ? 'sks-rs' : 'js',
|
|
105
|
+
engine: rustSearch ? 'grep-searcher' : 'js-regex-scanner',
|
|
106
|
+
externalBinaryRequired: false,
|
|
107
|
+
notes: rustSearch ? [] : ['Using JS fallback; build sks-rs for Rust grep engine']
|
|
108
|
+
},
|
|
109
|
+
structure: {
|
|
110
|
+
available: true,
|
|
111
|
+
provider: 'typescript-ast',
|
|
112
|
+
engine: 'typescript-compiler-api',
|
|
113
|
+
externalBinaryRequired: false,
|
|
114
|
+
notes: ['TS/JS only; unsupported languages return capability errors (never disguised as text)']
|
|
115
|
+
},
|
|
116
|
+
symbol: {
|
|
117
|
+
available: true,
|
|
118
|
+
provider: 'mixed',
|
|
119
|
+
engine: 'typescript-language-service',
|
|
120
|
+
externalBinaryRequired: false,
|
|
121
|
+
notes: [
|
|
122
|
+
'exact_definition/exact_reference via TypeScript LanguageService binding resolution',
|
|
123
|
+
'text_candidate never promoted to exact_*',
|
|
124
|
+
'non-TS/JS languages return symbol_unsupported_language'
|
|
125
|
+
]
|
|
126
|
+
},
|
|
127
|
+
context: {
|
|
128
|
+
available: true,
|
|
129
|
+
provider: 'triwiki',
|
|
130
|
+
engine: 'triwiki+codepack',
|
|
131
|
+
externalBinaryRequired: false,
|
|
132
|
+
notes: [`root=${path.resolve(root)}`, 'No vector DB']
|
|
133
|
+
}
|
|
134
|
+
},
|
|
135
|
+
rust: {
|
|
136
|
+
available: rust.available,
|
|
137
|
+
bin: rust.bin,
|
|
138
|
+
version: rust.version
|
|
139
|
+
},
|
|
140
|
+
warnings: rustSearch ? [] : ['sks_rs_search_unavailable']
|
|
141
|
+
};
|
|
142
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { findRustAccelerator, rustInfo } from '../rust-accelerator.js';
|
|
2
|
+
import { PACKAGE_VERSION, runProcess } from '../fsx.js';
|
|
3
|
+
export { findRustAccelerator };
|
|
4
|
+
export async function rustAcceleratorProbeForSearch() {
|
|
5
|
+
const bin = await findRustAccelerator();
|
|
6
|
+
if (!bin)
|
|
7
|
+
return { bin: null, compatible: false, version: null };
|
|
8
|
+
const result = await runProcess(bin, ['--version'], { timeoutMs: 5000, maxOutputBytes: 20_000 }).catch((err) => ({ code: 1, stdout: '', stderr: err.message }));
|
|
9
|
+
const version = `${result.stdout || ''}${result.stderr || ''}`.trim();
|
|
10
|
+
const compatible = result.code === 0 && version === `sks-rs ${PACKAGE_VERSION}`;
|
|
11
|
+
return { bin, compatible, version };
|
|
12
|
+
}
|
|
13
|
+
export async function rustSupportsSearchCommand() {
|
|
14
|
+
const probe = await rustAcceleratorProbeForSearch();
|
|
15
|
+
if (!probe.bin || !probe.compatible)
|
|
16
|
+
return false;
|
|
17
|
+
const help = await runProcess(probe.bin, ['search', '--help'], { timeoutMs: 5000, maxOutputBytes: 20_000 }).catch(() => ({ code: 1, stdout: '', stderr: '' }));
|
|
18
|
+
const text = `${help.stdout || ''}${help.stderr || ''}`;
|
|
19
|
+
return help.code === 0 || /search files|search text|search batch/i.test(text);
|
|
20
|
+
}
|
|
21
|
+
export async function rustSearchInfoNote() {
|
|
22
|
+
const info = await rustInfo();
|
|
23
|
+
return info.mode === 'rust_accelerated' ? 'rust_accelerated' : 'js_fallback';
|
|
24
|
+
}
|