salmon-loop 0.2.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/LICENSE +21 -0
- package/README.md +144 -0
- package/README.zh-CN.md +144 -0
- package/dist/cli/argv/headless-detection.js +60 -0
- package/dist/cli/argv/print-mode.js +60 -0
- package/dist/cli/authorization/allowlist.js +908 -0
- package/dist/cli/authorization/non-interactive.js +166 -0
- package/dist/cli/authorization/provider.js +416 -0
- package/dist/cli/chat-interface.js +83 -0
- package/dist/cli/chat.js +492 -0
- package/dist/cli/cli-runtime-context.js +12 -0
- package/dist/cli/commander-error-adapter.js +35 -0
- package/dist/cli/commander-error-meta.js +13 -0
- package/dist/cli/commands/allowlist.js +270 -0
- package/dist/cli/commands/chat.js +120 -0
- package/dist/cli/commands/config.js +250 -0
- package/dist/cli/commands/context.js +57 -0
- package/dist/cli/commands/dispatcher.js +53 -0
- package/dist/cli/commands/exit.js +9 -0
- package/dist/cli/commands/llm-output.js +135 -0
- package/dist/cli/commands/log-mode.js +143 -0
- package/dist/cli/commands/mode.js +136 -0
- package/dist/cli/commands/new.js +18 -0
- package/dist/cli/commands/parallel.js +256 -0
- package/dist/cli/commands/queue.js +130 -0
- package/dist/cli/commands/registry.js +85 -0
- package/dist/cli/commands/restore.js +26 -0
- package/dist/cli/commands/run/assistant-message.js +14 -0
- package/dist/cli/commands/run/config-resolution.js +37 -0
- package/dist/cli/commands/run/early-errors.js +108 -0
- package/dist/cli/commands/run/execute.js +73 -0
- package/dist/cli/commands/run/extensions-resolution.js +22 -0
- package/dist/cli/commands/run/handler.js +434 -0
- package/dist/cli/commands/run/headless-error-writer.js +182 -0
- package/dist/cli/commands/run/instruction-guard.js +24 -0
- package/dist/cli/commands/run/loop-params.js +46 -0
- package/dist/cli/commands/run/mode.js +8 -0
- package/dist/cli/commands/run/parse-options.js +67 -0
- package/dist/cli/commands/run/persist-session.js +35 -0
- package/dist/cli/commands/run/preflight.js +156 -0
- package/dist/cli/commands/run/reporter-factory.js +52 -0
- package/dist/cli/commands/run/runtime-llm.js +56 -0
- package/dist/cli/commands/run/runtime-options.js +30 -0
- package/dist/cli/commands/run/session.js +19 -0
- package/dist/cli/commands/run/structured-output.js +106 -0
- package/dist/cli/commands/run/types.js +2 -0
- package/dist/cli/commands/run/validate-options.js +28 -0
- package/dist/cli/commands/run/verbose.js +36 -0
- package/dist/cli/commands/run.js +2 -0
- package/dist/cli/commands/serve.js +323 -0
- package/dist/cli/commands/session.js +77 -0
- package/dist/cli/commands/snapshot-interactive.js +165 -0
- package/dist/cli/commands/snapshot.js +159 -0
- package/dist/cli/commands/status.js +17 -0
- package/dist/cli/commands/subagent.js +178 -0
- package/dist/cli/commands/subcommand-suggestions.js +63 -0
- package/dist/cli/commands/tool-names.js +155 -0
- package/dist/cli/commands/types.js +2 -0
- package/dist/cli/commands/utils.js +42 -0
- package/dist/cli/config.js +16 -0
- package/dist/cli/crash-reporter.js +5 -0
- package/dist/cli/headless/anthropic-stream-normalized-encoder.js +164 -0
- package/dist/cli/headless/anthropic-stream-protocol.js +62 -0
- package/dist/cli/headless/json-protocol.js +124 -0
- package/dist/cli/headless/native-stream-normalized-encoder.js +206 -0
- package/dist/cli/headless/openai-responses-canonical-applier.js +94 -0
- package/dist/cli/headless/openai-responses-state.js +294 -0
- package/dist/cli/headless/openai-stream-encoder.js +152 -0
- package/dist/cli/headless/stdout-writer.js +9 -0
- package/dist/cli/headless/stream-json-protocol.js +136 -0
- package/dist/cli/index.js +8 -0
- package/dist/cli/locales/en.js +409 -0
- package/dist/cli/locales/index.js +7 -0
- package/dist/cli/program-bootstrap.js +14 -0
- package/dist/cli/program-commands.js +106 -0
- package/dist/cli/program-options.js +15 -0
- package/dist/cli/program-output-mode.js +11 -0
- package/dist/cli/program-parse.js +24 -0
- package/dist/cli/reporters/anthropic-stream.js +77 -0
- package/dist/cli/reporters/base.js +2 -0
- package/dist/cli/reporters/json.js +69 -0
- package/dist/cli/reporters/openai-stream.js +72 -0
- package/dist/cli/reporters/standard.js +226 -0
- package/dist/cli/reporters/stderr-log-reporter.js +71 -0
- package/dist/cli/reporters/stream-json.js +111 -0
- package/dist/cli/run-cli.js +25 -0
- package/dist/cli/slash/runtime.js +240 -0
- package/dist/cli/ui/App.js +273 -0
- package/dist/cli/ui/authorization/bus.js +35 -0
- package/dist/cli/ui/components/CommandInput.js +200 -0
- package/dist/cli/ui/components/CommandSuggestionList.js +20 -0
- package/dist/cli/ui/components/Markdown.js +423 -0
- package/dist/cli/ui/components/MessageList.js +34 -0
- package/dist/cli/ui/components/StatusBannerLine.js +7 -0
- package/dist/cli/ui/components/TodoDrawer.js +60 -0
- package/dist/cli/ui/components/WelcomeMessage.js +14 -0
- package/dist/cli/ui/components/animations/StretchingThinking.js +51 -0
- package/dist/cli/ui/components/animations/ThinkingWave.js +15 -0
- package/dist/cli/ui/components/animations/TypeIndicator.js +30 -0
- package/dist/cli/ui/components/layout/SplitPane.js +11 -0
- package/dist/cli/ui/components/messageList/MessageItem.js +27 -0
- package/dist/cli/ui/components/messageList/QueuePreviewList.js +11 -0
- package/dist/cli/ui/components/messageList/items/EmphasisMessageItem.js +20 -0
- package/dist/cli/ui/components/messageList/items/InterruptMessageItem.js +10 -0
- package/dist/cli/ui/components/messageList/items/LightweightMessageItem.js +12 -0
- package/dist/cli/ui/components/messageList/items/StandardMessageItem.js +23 -0
- package/dist/cli/ui/components/messageList/items/WelcomeMessageItem.js +7 -0
- package/dist/cli/ui/components/messageList/messageListLayout.js +27 -0
- package/dist/cli/ui/components/messageList/streaming.js +51 -0
- package/dist/cli/ui/components/messageList/types.js +2 -0
- package/dist/cli/ui/components/messageList/utils.js +7 -0
- package/dist/cli/ui/components/sidebar/FileContext.js +8 -0
- package/dist/cli/ui/components/sidebar/MissionControl.js +8 -0
- package/dist/cli/ui/config.js +59 -0
- package/dist/cli/ui/hooks/useCommandLifecycle.js +110 -0
- package/dist/cli/ui/hooks/useCommandSuggestions.js +87 -0
- package/dist/cli/ui/hooks/useInputHistory.js +57 -0
- package/dist/cli/ui/hooks/useLoopEvents.js +382 -0
- package/dist/cli/ui/hooks/useLoopState.js +73 -0
- package/dist/cli/ui/hooks/useOnionExit.js +31 -0
- package/dist/cli/ui/hooks/useTerminalDimensions.js +34 -0
- package/dist/cli/ui/index.js +136 -0
- package/dist/cli/ui/selection/bus.js +35 -0
- package/dist/cli/ui/status/formatStatusBanner.js +8 -0
- package/dist/cli/ui/store/context.js +17 -0
- package/dist/cli/ui/store/reducer.js +264 -0
- package/dist/cli/ui/store/types.js +81 -0
- package/dist/cli/ui/styles/theme.js +295 -0
- package/dist/cli/ui/types.js +2 -0
- package/dist/cli/ui/utils/sanitizer.js +122 -0
- package/dist/cli/ui/utils/transcript.js +28 -0
- package/dist/cli/utils/asyncQueue.js +125 -0
- package/dist/cli/utils/audit-scope.js +10 -0
- package/dist/cli/utils/detectors/index.js +38 -0
- package/dist/cli/utils/llm-output.js +34 -0
- package/dist/cli/utils/outcome-reporter.js +17 -0
- package/dist/cli/utils/safe-fs.js +184 -0
- package/dist/cli/utils/verify-resolver.js +34 -0
- package/dist/cli/utils/worktree-prepare-resolver.js +18 -0
- package/dist/core/adapters/fs/atomic-file-writer.js +129 -0
- package/dist/core/adapters/fs/file-adapter.js +95 -0
- package/dist/core/adapters/fs/filesystem.js +31 -0
- package/dist/core/adapters/fs/index.js +5 -0
- package/dist/core/adapters/fs/node-fs.js +7 -0
- package/dist/core/adapters/fs/readonly-filesystem.js +23 -0
- package/dist/core/adapters/git/git-adapter.js +704 -0
- package/dist/core/adapters/git/git-runner.js +119 -0
- package/dist/core/adapters/git/lock-manager.js +314 -0
- package/dist/core/adapters/git/types.js +2 -0
- package/dist/core/adapters/path/index.js +2 -0
- package/dist/core/adapters/path/path-adapter.js +23 -0
- package/dist/core/ast/guard.js +116 -0
- package/dist/core/ast/index.js +4 -0
- package/dist/core/ast/parser.js +284 -0
- package/dist/core/ast/validator.js +46 -0
- package/dist/core/backends/salmon-loop/task-executor.js +68 -0
- package/dist/core/checkpoint-domain/manifest-store.js +379 -0
- package/dist/core/checkpoint-domain/service.js +84 -0
- package/dist/core/checkpoint-domain/types.js +2 -0
- package/dist/core/config/defaults.js +50 -0
- package/dist/core/config/errors.js +11 -0
- package/dist/core/config/file-format.js +108 -0
- package/dist/core/config/index.js +7 -0
- package/dist/core/config/limits.js +77 -0
- package/dist/core/config/load.js +34 -0
- package/dist/core/config/normalize.js +35 -0
- package/dist/core/config/paths.js +20 -0
- package/dist/core/config/redact.js +16 -0
- package/dist/core/config/resolve-env.js +43 -0
- package/dist/core/config/resolve-llm.js +130 -0
- package/dist/core/config/resolve.js +68 -0
- package/dist/core/config/resolvers/ast-validation.js +8 -0
- package/dist/core/config/resolvers/context.js +21 -0
- package/dist/core/config/resolvers/observability.js +45 -0
- package/dist/core/config/resolvers/output.js +8 -0
- package/dist/core/config/resolvers/permission-mode.js +6 -0
- package/dist/core/config/resolvers/security.js +14 -0
- package/dist/core/config/resolvers/server.js +36 -0
- package/dist/core/config/resolvers/tool-authorization.js +39 -0
- package/dist/core/config/resolvers/ui.js +26 -0
- package/dist/core/config/types/config-file.js +2 -0
- package/dist/core/config/types/primitives.js +9 -0
- package/dist/core/config/types/resolved.js +2 -0
- package/dist/core/config/types.js +4 -0
- package/dist/core/config/validate.js +852 -0
- package/dist/core/context/assembly/default-prompt-assembler.js +7 -0
- package/dist/core/context/assembly/prompt-assembler.js +2 -0
- package/dist/core/context/ast/import-extractor.js +28 -0
- package/dist/core/context/ast/module-resolver.js +61 -0
- package/dist/core/context/ast/source-outline.js +25 -0
- package/dist/core/context/audit-constants.js +23 -0
- package/dist/core/context/audit.js +54 -0
- package/dist/core/context/budget/dynamic-adjuster.js +149 -0
- package/dist/core/context/budget/example-integration.js +49 -0
- package/dist/core/context/budget/integration.js +93 -0
- package/dist/core/context/builder.js +289 -0
- package/dist/core/context/cache/errors.js +16 -0
- package/dist/core/context/cache/incremental-updater.js +131 -0
- package/dist/core/context/cache/index.js +25 -0
- package/dist/core/context/cache/path-resolver.js +127 -0
- package/dist/core/context/cache/prompt-caching.js +207 -0
- package/dist/core/context/cache/store-factory.js +63 -0
- package/dist/core/context/cache/store.js +193 -0
- package/dist/core/context/cache/types.js +15 -0
- package/dist/core/context/compression/js-like-comments.js +139 -0
- package/dist/core/context/compression/smart-compress.js +61 -0
- package/dist/core/context/compression/whitespace.js +26 -0
- package/dist/core/context/dependencies.js +102 -0
- package/dist/core/context/effectiveness/index.js +25 -0
- package/dist/core/context/effectiveness/tracker.js +253 -0
- package/dist/core/context/effectiveness/types.js +15 -0
- package/dist/core/context/formatters/index.js +7 -0
- package/dist/core/context/formatters/json-converter.js +662 -0
- package/dist/core/context/formatters/types.js +6 -0
- package/dist/core/context/formatters/xml-context.js +296 -0
- package/dist/core/context/gatherers/architecture-gatherer.js +75 -0
- package/dist/core/context/gatherers/artifact-gatherer.js +53 -0
- package/dist/core/context/gatherers/ast-gatherer.js +370 -0
- package/dist/core/context/gatherers/ghost-dependency-gatherer.js +46 -0
- package/dist/core/context/gatherers/git-diff-gatherer.js +91 -0
- package/dist/core/context/gatherers/git-history-gatherer.js +57 -0
- package/dist/core/context/gatherers/knowledge-gatherer.js +101 -0
- package/dist/core/context/gatherers/metadata-gatherer.js +59 -0
- package/dist/core/context/gatherers/primary-text-gatherer.js +36 -0
- package/dist/core/context/gatherers/ripgrep-gatherer.js +104 -0
- package/dist/core/context/hash.js +52 -0
- package/dist/core/context/index.js +3 -0
- package/dist/core/context/keywords.js +179 -0
- package/dist/core/context/policies/budget-policy.js +36 -0
- package/dist/core/context/policies/pack-until-full.js +419 -0
- package/dist/core/context/scoring/relevance.js +191 -0
- package/dist/core/context/service-deps.js +32 -0
- package/dist/core/context/service-helpers.js +32 -0
- package/dist/core/context/service.js +265 -0
- package/dist/core/context/steps/context-budget.js +157 -0
- package/dist/core/context/steps/context-gather.js +71 -0
- package/dist/core/context/steps/context-primary.js +19 -0
- package/dist/core/context/steps/context-promotion.js +78 -0
- package/dist/core/context/steps/context-targets.js +85 -0
- package/dist/core/context/steps/types.js +2 -0
- package/dist/core/context/summarization/index.js +27 -0
- package/dist/core/context/summarization/prompts.js +80 -0
- package/dist/core/context/summarization/summarizer.js +377 -0
- package/dist/core/context/summarization/types.js +29 -0
- package/dist/core/context/targeting/churn-policy.js +27 -0
- package/dist/core/context/targeting/target-resolver.js +491 -0
- package/dist/core/context/token/adaptive-budget.js +364 -0
- package/dist/core/context/token/cache.js +163 -0
- package/dist/core/context/token/counter.js +190 -0
- package/dist/core/context/token/encoding-registry.js +173 -0
- package/dist/core/context/token/index.js +31 -0
- package/dist/core/context/token/token-budget.js +213 -0
- package/dist/core/context/token/types.js +10 -0
- package/dist/core/context/truncation/index.js +23 -0
- package/dist/core/context/truncation/semantic-truncator.js +103 -0
- package/dist/core/context/truncation/strategies/error-stack.js +94 -0
- package/dist/core/context/truncation/strategies/generic.js +48 -0
- package/dist/core/context/truncation/strategies/git-diff.js +99 -0
- package/dist/core/context/truncation/strategies/index.js +10 -0
- package/dist/core/context/truncation/strategies/json.js +142 -0
- package/dist/core/context/truncation/strategies/log.js +131 -0
- package/dist/core/context/truncation/strategies/test-result.js +140 -0
- package/dist/core/context/truncation/type-detector.js +133 -0
- package/dist/core/context/truncation/types.js +16 -0
- package/dist/core/context/types.js +2 -0
- package/dist/core/extensions/index.js +118 -0
- package/dist/core/extensions/load.js +36 -0
- package/dist/core/extensions/merge.js +29 -0
- package/dist/core/extensions/paths.js +40 -0
- package/dist/core/extensions/redact.js +37 -0
- package/dist/core/extensions/schemas.js +70 -0
- package/dist/core/extensions/types.js +2 -0
- package/dist/core/facades/cli-authorization-allowlist.js +3 -0
- package/dist/core/facades/cli-authorization-non-interactive.js +3 -0
- package/dist/core/facades/cli-authorization-provider.js +2 -0
- package/dist/core/facades/cli-chat.js +11 -0
- package/dist/core/facades/cli-command-allowlist.js +3 -0
- package/dist/core/facades/cli-command-chat.js +8 -0
- package/dist/core/facades/cli-command-checkpoint.js +3 -0
- package/dist/core/facades/cli-command-config.js +10 -0
- package/dist/core/facades/cli-command-dispatcher.js +2 -0
- package/dist/core/facades/cli-command-parallel.js +8 -0
- package/dist/core/facades/cli-command-session.js +2 -0
- package/dist/core/facades/cli-command-tool-names.js +6 -0
- package/dist/core/facades/cli-context.js +8 -0
- package/dist/core/facades/cli-headless.js +3 -0
- package/dist/core/facades/cli-observability.js +3 -0
- package/dist/core/facades/cli-program-bootstrap.js +2 -0
- package/dist/core/facades/cli-reporters.js +5 -0
- package/dist/core/facades/cli-run-execute.js +3 -0
- package/dist/core/facades/cli-run-handler.js +7 -0
- package/dist/core/facades/cli-run-headless-error-writer.js +2 -0
- package/dist/core/facades/cli-run-loop-params.js +2 -0
- package/dist/core/facades/cli-run-persist-session.js +2 -0
- package/dist/core/facades/cli-run-runtime-llm.js +5 -0
- package/dist/core/facades/cli-serve.js +21 -0
- package/dist/core/facades/cli-slash-runtime.js +9 -0
- package/dist/core/facades/cli-subagent.js +2 -0
- package/dist/core/facades/cli-ui.js +5 -0
- package/dist/core/facades/cli-utils-llm-output.js +3 -0
- package/dist/core/facades/cli-utils-path.js +2 -0
- package/dist/core/facades/cli-utils-worktree.js +2 -0
- package/dist/core/failure/diagnostics.js +221 -0
- package/dist/core/feedback/index.js +28 -0
- package/dist/core/feedback/parsers.js +59 -0
- package/dist/core/feedback/patterns.js +26 -0
- package/dist/core/feedback/types.js +2 -0
- package/dist/core/grizzco/domain/grizzco-types.js +41 -0
- package/dist/core/grizzco/dsl/DecisionEngine.js +149 -0
- package/dist/core/grizzco/dsl/MicroTaskRunner.js +39 -0
- package/dist/core/grizzco/dsl/llm-strategy.js +80 -0
- package/dist/core/grizzco/dsl/strategies.js +69 -0
- package/dist/core/grizzco/dsl/types.js +2 -0
- package/dist/core/grizzco/engine/observability/event-adapter.js +41 -0
- package/dist/core/grizzco/engine/observability/index.js +3 -0
- package/dist/core/grizzco/engine/observability/loop-telemetry.js +51 -0
- package/dist/core/grizzco/engine/outcome/index.js +2 -0
- package/dist/core/grizzco/engine/outcome/loop-result-mapper.js +167 -0
- package/dist/core/grizzco/engine/pipeline/pipeline.js +335 -0
- package/dist/core/grizzco/engine/pipeline/types.js +2 -0
- package/dist/core/grizzco/engine/transaction/attempt-failure.js +242 -0
- package/dist/core/grizzco/engine/transaction/authorization-summary.js +44 -0
- package/dist/core/grizzco/engine/transaction/index.js +3 -0
- package/dist/core/grizzco/engine/transaction/report-mapper.js +50 -0
- package/dist/core/grizzco/engine/transaction/retry-policy.js +19 -0
- package/dist/core/grizzco/engine/transaction/runner-builder.js +45 -0
- package/dist/core/grizzco/engine/transaction/session.js +58 -0
- package/dist/core/grizzco/engine/transaction/transaction-runner.js +193 -0
- package/dist/core/grizzco/engine/transaction/types.js +2 -0
- package/dist/core/grizzco/execution/Executor.js +58 -0
- package/dist/core/grizzco/execution/RejectionManager.js +71 -0
- package/dist/core/grizzco/execution/WorkerFactory.js +31 -0
- package/dist/core/grizzco/flows/SalmonLoopFlow.js +102 -0
- package/dist/core/grizzco/runtime/apply-back-runtime.js +136 -0
- package/dist/core/grizzco/runtime/apply-back-utils.js +13 -0
- package/dist/core/grizzco/runtime/host/host-runner.js +99 -0
- package/dist/core/grizzco/runtime/host/index.js +2 -0
- package/dist/core/grizzco/runtime/host/types.js +2 -0
- package/dist/core/grizzco/services/CachedService.js +42 -0
- package/dist/core/grizzco/services/implementations/default/GitConfigService.js +38 -0
- package/dist/core/grizzco/services/implementations/mock/MockLockService.js +11 -0
- package/dist/core/grizzco/services/implementations/mock/MockUserQuotaService.js +11 -0
- package/dist/core/grizzco/services/registry.js +30 -0
- package/dist/core/grizzco/services/types.js +2 -0
- package/dist/core/grizzco/steps/answer.js +75 -0
- package/dist/core/grizzco/steps/apply-back.js +46 -0
- package/dist/core/grizzco/steps/apply.js +136 -0
- package/dist/core/grizzco/steps/ast-validate.js +37 -0
- package/dist/core/grizzco/steps/audit.js +311 -0
- package/dist/core/grizzco/steps/context.js +74 -0
- package/dist/core/grizzco/steps/display-answer.js +6 -0
- package/dist/core/grizzco/steps/display-report.js +158 -0
- package/dist/core/grizzco/steps/display-research.js +6 -0
- package/dist/core/grizzco/steps/displayReview.js +6 -0
- package/dist/core/grizzco/steps/explore.js +245 -0
- package/dist/core/grizzco/steps/extractIssues.js +27 -0
- package/dist/core/grizzco/steps/generateFixPlan.js +13 -0
- package/dist/core/grizzco/steps/generateReview.js +71 -0
- package/dist/core/grizzco/steps/patch.js +220 -0
- package/dist/core/grizzco/steps/plan.js +191 -0
- package/dist/core/grizzco/steps/preflight.js +93 -0
- package/dist/core/grizzco/steps/prepare-deps.js +49 -0
- package/dist/core/grizzco/steps/read-only-shrink.js +4 -0
- package/dist/core/grizzco/steps/research.js +188 -0
- package/dist/core/grizzco/steps/rollback.js +138 -0
- package/dist/core/grizzco/steps/shrink.js +64 -0
- package/dist/core/grizzco/steps/validate.js +40 -0
- package/dist/core/grizzco/steps/verify.js +136 -0
- package/dist/core/grizzco/validation/AstValidationService.js +133 -0
- package/dist/core/grizzco/validation/ContextValidator.js +17 -0
- package/dist/core/grizzco/validation/ast-validation-policy.js +11 -0
- package/dist/core/grizzco/workers/direct-write-worker.js +44 -0
- package/dist/core/grizzco/workers/git-apply-worker.js +75 -0
- package/dist/core/grizzco/workers/i-merge-worker.js +2 -0
- package/dist/core/grizzco/workers/mm-three-way-worker.js +117 -0
- package/dist/core/grizzco/workers/no-op-worker.js +18 -0
- package/dist/core/grizzco/workers/overwrite-binary-worker.js +29 -0
- package/dist/core/grizzco/workers/strata-sync-worker.js +69 -0
- package/dist/core/grizzco/workers/three-way-merge-worker.js +84 -0
- package/dist/core/grizzco/workers/three-way-staged-worker.js +93 -0
- package/dist/core/grizzco/workers/union-merge-worker.js +71 -0
- package/dist/core/history/input-history.js +55 -0
- package/dist/core/intent/chat-intent.js +250 -0
- package/dist/core/interaction/events/bus.js +52 -0
- package/dist/core/interaction/model/events.js +2 -0
- package/dist/core/interaction/model/index.js +3 -0
- package/dist/core/interaction/model/task-state.js +9 -0
- package/dist/core/interaction/model/transition-policy.js +50 -0
- package/dist/core/interaction/model/types.js +2 -0
- package/dist/core/interaction/orchestration/facade.js +190 -0
- package/dist/core/interaction/orchestration/index.js +2 -0
- package/dist/core/interaction/orchestration/store.js +32 -0
- package/dist/core/interaction/sync/task-sync-engine.js +57 -0
- package/dist/core/interaction/turn-stop-reason.js +27 -0
- package/dist/core/language-support/index.js +3 -0
- package/dist/core/language-support/orchestrator.js +37 -0
- package/dist/core/language-support/strategies/extension-candidate-strategy.js +27 -0
- package/dist/core/language-support/strategies/index.js +3 -0
- package/dist/core/language-support/strategies/language-query-strategy.js +26 -0
- package/dist/core/llm/ai-sdk/chat-executor.js +88 -0
- package/dist/core/llm/ai-sdk/langfuse-headers.js +28 -0
- package/dist/core/llm/ai-sdk/message-mapper.js +240 -0
- package/dist/core/llm/ai-sdk/observation-context.js +16 -0
- package/dist/core/llm/ai-sdk/provider-factory.js +29 -0
- package/dist/core/llm/ai-sdk/request-params.js +18 -0
- package/dist/core/llm/ai-sdk/request-runtime.js +168 -0
- package/dist/core/llm/ai-sdk/result-mapper.js +31 -0
- package/dist/core/llm/ai-sdk/retry-classifier.js +82 -0
- package/dist/core/llm/ai-sdk/retry-executor.js +38 -0
- package/dist/core/llm/ai-sdk.js +92 -0
- package/dist/core/llm/audit.js +2 -0
- package/dist/core/llm/base-url.js +18 -0
- package/dist/core/llm/contracts/repair.js +68 -0
- package/dist/core/llm/errors.js +172 -0
- package/dist/core/llm/factory.js +21 -0
- package/dist/core/llm/http/index.js +2 -0
- package/dist/core/llm/index.js +6 -0
- package/dist/core/llm/message-composition.js +25 -0
- package/dist/core/llm/openai.js +69 -0
- package/dist/core/llm/output-policy.js +192 -0
- package/dist/core/llm/phase-router.js +55 -0
- package/dist/core/llm/redact.js +37 -0
- package/dist/core/llm/registry.js +81 -0
- package/dist/core/llm/retry-utils.js +114 -0
- package/dist/core/llm/stream-utils.js +87 -0
- package/dist/core/llm/utils.js +82 -0
- package/dist/core/observability/audit-file.js +199 -0
- package/dist/core/observability/audit-trail.js +125 -0
- package/dist/core/observability/authorization-decisions.js +54 -0
- package/dist/core/observability/debug-artifacts.js +61 -0
- package/dist/core/observability/error-envelope.js +63 -0
- package/dist/core/observability/error-mapping.js +271 -0
- package/dist/core/observability/ignored-error.js +6 -0
- package/dist/core/observability/logger.js +457 -0
- package/dist/core/observability/loop-event-reporter.js +46 -0
- package/dist/core/observability/monitor.js +240 -0
- package/dist/core/observability/run-outcome-reporter.js +15 -0
- package/dist/core/observability/token-usage.js +36 -0
- package/dist/core/observability/ui-log-sanitize.js +35 -0
- package/dist/core/patch/aggregator.js +93 -0
- package/dist/core/patch/diff.js +298 -0
- package/dist/core/permission-gate/default-gate.js +115 -0
- package/dist/core/permission-gate/gate.js +2 -0
- package/dist/core/permission-gate/types.js +2 -0
- package/dist/core/plan/index.js +2 -0
- package/dist/core/plan/manager.js +123 -0
- package/dist/core/plan/markdown-editor.js +238 -0
- package/dist/core/plan/storage.js +75 -0
- package/dist/core/plan/types.js +2 -0
- package/dist/core/plugin/interface.js +2 -0
- package/dist/core/plugin/loader.js +130 -0
- package/dist/core/plugin/registry.js +90 -0
- package/dist/core/plugin/validator.js +98 -0
- package/dist/core/prompts/registry.js +189 -0
- package/dist/core/prompts/runtime.js +69 -0
- package/dist/core/prompts/schema.js +2 -0
- package/dist/core/prompts/templates/phases/explore_user.hbs +26 -0
- package/dist/core/prompts/templates/phases/patch_user.hbs +57 -0
- package/dist/core/prompts/templates/phases/plan_user.hbs +33 -0
- package/dist/core/prompts/templates/system/_context_json_legend.hbs +21 -0
- package/dist/core/prompts/templates/system/_tool_defs.hbs +60 -0
- package/dist/core/prompts/templates/system/explore_system.hbs +26 -0
- package/dist/core/prompts/templates/system/main_system.hbs +18 -0
- package/dist/core/prompts/templates/system/patch_system.hbs +10 -0
- package/dist/core/prompts/templates/system/plan_system.hbs +1 -0
- package/dist/core/prompts/templates/system/reflection.hbs +39 -0
- package/dist/core/protocols/a2a/agent-card.js +30 -0
- package/dist/core/protocols/a2a/mapper.js +14 -0
- package/dist/core/protocols/a2a/sdk/auth-middleware.js +31 -0
- package/dist/core/protocols/a2a/sdk/executor.js +301 -0
- package/dist/core/protocols/a2a/sdk/server.js +24 -0
- package/dist/core/protocols/a2a/task-projection.js +45 -0
- package/dist/core/protocols/acp/acp-command-runner.js +204 -0
- package/dist/core/protocols/acp/acp-filesystem.js +43 -0
- package/dist/core/protocols/acp/checkpoint-meta.js +2 -0
- package/dist/core/protocols/acp/formal-agent.js +1201 -0
- package/dist/core/protocols/acp/handlers.js +51 -0
- package/dist/core/protocols/acp/permission-provider.js +122 -0
- package/dist/core/protocols/acp/stdio-server.js +116 -0
- package/dist/core/reflection/engine.js +55 -0
- package/dist/core/reflection/types.js +2 -0
- package/dist/core/runtime/agent-server-runtime.js +88 -0
- package/dist/core/runtime/bun-runtime.js +26 -0
- package/dist/core/runtime/command-runner-context.js +16 -0
- package/dist/core/runtime/exit-codes.js +11 -0
- package/dist/core/runtime/fastify-fetch-bridge.js +51 -0
- package/dist/core/runtime/fastify-server-bundle.js +26 -0
- package/dist/core/runtime/initialize.js +132 -0
- package/dist/core/runtime/loop-finalize.js +71 -0
- package/dist/core/runtime/loop-run-lifecycle.js +73 -0
- package/dist/core/runtime/loop-run-reporter.js +19 -0
- package/dist/core/runtime/loop-runtime-config.js +26 -0
- package/dist/core/runtime/loop-session-runner.js +30 -0
- package/dist/core/runtime/loop.js +84 -0
- package/dist/core/runtime/paths.js +84 -0
- package/dist/core/runtime/process-runner.js +16 -0
- package/dist/core/runtime/process-types.js +2 -0
- package/dist/core/runtime/semaphore.js +41 -0
- package/dist/core/runtime/sidecar-fastify-plugin.js +35 -0
- package/dist/core/runtime/sidecar-paths.js +47 -0
- package/dist/core/runtime/sidecar-route-catalog.js +103 -0
- package/dist/core/runtime/spawn-command.js +392 -0
- package/dist/core/runtime/spawn-interactive.js +71 -0
- package/dist/core/security/redaction.js +160 -0
- package/dist/core/session/compression.js +323 -0
- package/dist/core/session/flow.js +85 -0
- package/dist/core/session/manager.js +313 -0
- package/dist/core/session/pruning-strategy.js +153 -0
- package/dist/core/session/session-context-builder.js +122 -0
- package/dist/core/session/summary-sync.js +82 -0
- package/dist/core/session/token-tracker.js +82 -0
- package/dist/core/session/types.js +2 -0
- package/dist/core/skills/bridge.js +33 -0
- package/dist/core/skills/index.js +8 -0
- package/dist/core/skills/loader.js +80 -0
- package/dist/core/skills/parser.js +66 -0
- package/dist/core/skills/runtime/MicroTaskRunner.js +102 -0
- package/dist/core/skills/runtime/SkillRunner.js +108 -0
- package/dist/core/skills/strategy.js +29 -0
- package/dist/core/skills/types.js +2 -0
- package/dist/core/slash/index.js +6 -0
- package/dist/core/slash/parser.js +33 -0
- package/dist/core/slash/registry.js +78 -0
- package/dist/core/slash/router.js +76 -0
- package/dist/core/slash/steps/slash-decide.js +19 -0
- package/dist/core/slash/steps/slash-execute.js +73 -0
- package/dist/core/slash/steps/types.js +2 -0
- package/dist/core/slash/strategy.js +33 -0
- package/dist/core/slash/types.js +2 -0
- package/dist/core/strata/checkpoint/manager.js +492 -0
- package/dist/core/strata/checkpoint/snapshot-audit.js +88 -0
- package/dist/core/strata/checkpoint/snapshot-create.js +79 -0
- package/dist/core/strata/checkpoint/snapshot-write-tree.js +72 -0
- package/dist/core/strata/engine/shadow-merge-engine.js +394 -0
- package/dist/core/strata/index.js +15 -0
- package/dist/core/strata/interaction/content-guardian.js +59 -0
- package/dist/core/strata/interaction/file-system-provider.js +89 -0
- package/dist/core/strata/layers/file-state-resolver.js +157 -0
- package/dist/core/strata/layers/immutable-git-layer.js +42 -0
- package/dist/core/strata/layers/shadow-driver/copy-backend.js +114 -0
- package/dist/core/strata/layers/shadow-driver/env.js +29 -0
- package/dist/core/strata/layers/shadow-driver/error-classifier.js +41 -0
- package/dist/core/strata/layers/shadow-driver/index.js +17 -0
- package/dist/core/strata/layers/shadow-driver/readonly-lock.js +221 -0
- package/dist/core/strata/layers/shadow-driver/shadow-driver.js +234 -0
- package/dist/core/strata/layers/shadow-driver/strategy.js +86 -0
- package/dist/core/strata/layers/sidecar-layer.js +96 -0
- package/dist/core/strata/layers/worktree.js +240 -0
- package/dist/core/strata/runtime/environment.js +377 -0
- package/dist/core/strata/runtime/synchronizer.js +819 -0
- package/dist/core/strata/types.js +46 -0
- package/dist/core/streaming/canonical/canonical-responses-event-emitter.js +326 -0
- package/dist/core/streaming/canonical/function-call-item-id.js +13 -0
- package/dist/core/streaming/canonical/parts-from-llm-stream-chunk.js +54 -0
- package/dist/core/streaming/canonical/responses-event-emitter.js +127 -0
- package/dist/core/streaming/canonical/responses-events.js +2 -0
- package/dist/core/streaming/normalized-events.js +9 -0
- package/dist/core/streaming/normalized-from-text.js +47 -0
- package/dist/core/streaming/stream-assembler.js +347 -0
- package/dist/core/structured-output/index.js +3 -0
- package/dist/core/structured-output/json-extract.js +70 -0
- package/dist/core/structured-output/json-schema-validator.js +90 -0
- package/dist/core/structured-output/types.js +2 -0
- package/dist/core/sub-agent/artifacts/store.js +141 -0
- package/dist/core/sub-agent/artifacts/types.js +2 -0
- package/dist/core/sub-agent/controller.js +69 -0
- package/dist/core/sub-agent/core/loop.js +79 -0
- package/dist/core/sub-agent/core/manager.js +246 -0
- package/dist/core/sub-agent/registry-defaults.js +52 -0
- package/dist/core/sub-agent/registry.js +35 -0
- package/dist/core/sub-agent/tools/task-spawn.js +29 -0
- package/dist/core/sub-agent/types.js +23 -0
- package/dist/core/target-runtime/command-resolver.js +42 -0
- package/dist/core/target-runtime/index.js +3 -0
- package/dist/core/target-runtime/profile.js +73 -0
- package/dist/core/testgen/detector.js +17 -0
- package/dist/core/testgen/index.js +38 -0
- package/dist/core/testgen/templates.js +46 -0
- package/dist/core/tools/audit.js +140 -0
- package/dist/core/tools/authorization/types.js +2 -0
- package/dist/core/tools/budget.js +118 -0
- package/dist/core/tools/builtin/artifact.js +29 -0
- package/dist/core/tools/builtin/ast-grep.js +107 -0
- package/dist/core/tools/builtin/ast.js +62 -0
- package/dist/core/tools/builtin/code-search/backends/powershell.js +84 -0
- package/dist/core/tools/builtin/code-search/backends/rg.js +85 -0
- package/dist/core/tools/builtin/code-search/executor.js +87 -0
- package/dist/core/tools/builtin/code-search/parse/plain-grep.js +59 -0
- package/dist/core/tools/builtin/code-search/parse/rg-json.js +31 -0
- package/dist/core/tools/builtin/code-search/spec.js +82 -0
- package/dist/core/tools/builtin/fs.js +243 -0
- package/dist/core/tools/builtin/git.js +118 -0
- package/dist/core/tools/builtin/index.js +80 -0
- package/dist/core/tools/builtin/interaction.js +120 -0
- package/dist/core/tools/builtin/knowledge.js +98 -0
- package/dist/core/tools/builtin/plan.js +148 -0
- package/dist/core/tools/builtin/proposal.js +207 -0
- package/dist/core/tools/builtin/shell.js +71 -0
- package/dist/core/tools/builtin/verify.js +41 -0
- package/dist/core/tools/capability/executor.js +84 -0
- package/dist/core/tools/capability/runner.js +50 -0
- package/dist/core/tools/capability/types.js +2 -0
- package/dist/core/tools/dispatcher.js +80 -0
- package/dist/core/tools/headless-payload.js +37 -0
- package/dist/core/tools/loader.js +100 -0
- package/dist/core/tools/mapper.js +142 -0
- package/dist/core/tools/mcp/client.js +308 -0
- package/dist/core/tools/mcp/loader.js +110 -0
- package/dist/core/tools/mcp/schema.js +54 -0
- package/dist/core/tools/mcp/streamable-http.js +101 -0
- package/dist/core/tools/mcp/types.js +26 -0
- package/dist/core/tools/parallel/isolation.js +25 -0
- package/dist/core/tools/parallel/lock-manager.js +124 -0
- package/dist/core/tools/parallel/persistence.js +126 -0
- package/dist/core/tools/parallel/plan-builder.js +66 -0
- package/dist/core/tools/parallel/plan.js +2 -0
- package/dist/core/tools/parallel/refs.js +7 -0
- package/dist/core/tools/parallel/resolve-args.js +50 -0
- package/dist/core/tools/parallel/resource-helpers.js +35 -0
- package/dist/core/tools/parallel/resources.js +2 -0
- package/dist/core/tools/parallel/scheduler.js +372 -0
- package/dist/core/tools/parser.js +89 -0
- package/dist/core/tools/permissions/permission-rules.js +503 -0
- package/dist/core/tools/plugins/loader.js +102 -0
- package/dist/core/tools/policy.js +87 -0
- package/dist/core/tools/registry.js +29 -0
- package/dist/core/tools/router.js +514 -0
- package/dist/core/tools/sanitize.js +78 -0
- package/dist/core/tools/schema-utils.js +71 -0
- package/dist/core/tools/session.js +1105 -0
- package/dist/core/tools/streaming/ToolCallAccumulator.js +64 -0
- package/dist/core/tools/types.js +2 -0
- package/dist/core/types/authorization.js +2 -0
- package/dist/core/types/context.js +2 -0
- package/dist/core/types/errors.js +29 -0
- package/dist/core/types/execution.js +65 -0
- package/dist/core/types/index.js +9 -0
- package/dist/core/types/llm.js +9 -0
- package/dist/core/types/loop.js +2 -0
- package/dist/core/types/planning.js +2 -0
- package/dist/core/types/runtime.js +2 -0
- package/dist/core/types/usage.js +2 -0
- package/dist/core/ui/kaomoji.js +5 -0
- package/dist/core/utils/path.js +116 -0
- package/dist/core/utils/platform-shell.js +10 -0
- package/dist/core/utils/sanitizer.js +107 -0
- package/dist/core/verification/runner.js +265 -0
- package/dist/integrations/langfuse/litellm-langfuse-outcome-reporter.js +272 -0
- package/dist/integrations/langfuse/outcome-proxy.js +68 -0
- package/dist/interfaces/cli/task-runner.js +11 -0
- package/dist/languages/typescript/index.js +178 -0
- package/dist/locales/en.js +679 -0
- package/dist/locales/index.js +11 -0
- package/dist/utils/eol.js +35 -0
- package/package.json +153 -0
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import { join } from 'path';
|
|
2
|
+
import { stat } from '../../adapters/fs/node-fs.js';
|
|
3
|
+
import { classifyGitFailureHint } from './snapshot-audit.js';
|
|
4
|
+
export async function tryWriteTreeWithRetry(git, retryDelaysMs) {
|
|
5
|
+
let attempts = 0;
|
|
6
|
+
let lastError;
|
|
7
|
+
for (let i = 0; i <= retryDelaysMs.length; i += 1) {
|
|
8
|
+
attempts = i + 1;
|
|
9
|
+
try {
|
|
10
|
+
return { tree: (await git.query(['write-tree'])).trim(), attempts };
|
|
11
|
+
}
|
|
12
|
+
catch (error) {
|
|
13
|
+
lastError = error;
|
|
14
|
+
if (i >= retryDelaysMs.length)
|
|
15
|
+
break;
|
|
16
|
+
await new Promise((resolve) => setTimeout(resolve, retryDelaysMs[i]));
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
throw Object.assign(lastError instanceof Error ? lastError : new Error('write-tree failed'), {
|
|
20
|
+
writeTreeAttempts: attempts,
|
|
21
|
+
});
|
|
22
|
+
}
|
|
23
|
+
export async function probeWriteTreeFailure(git) {
|
|
24
|
+
const details = {};
|
|
25
|
+
const indexLockPath = join(git.repoPath, '.git', 'index.lock');
|
|
26
|
+
try {
|
|
27
|
+
const lockStat = await stat(indexLockPath);
|
|
28
|
+
details.indexLockPresent = true;
|
|
29
|
+
details.indexLockAgeMs = Math.max(0, Math.floor(Date.now() - lockStat.mtimeMs));
|
|
30
|
+
}
|
|
31
|
+
catch {
|
|
32
|
+
details.indexLockPresent = false;
|
|
33
|
+
}
|
|
34
|
+
try {
|
|
35
|
+
const unmergedRaw = await git.exec(['ls-files', '-u'], { allowError: true });
|
|
36
|
+
const count = unmergedRaw
|
|
37
|
+
.split('\n')
|
|
38
|
+
.map((line) => line.trim())
|
|
39
|
+
.filter(Boolean).length;
|
|
40
|
+
details.unmergedCount = count;
|
|
41
|
+
}
|
|
42
|
+
catch {
|
|
43
|
+
details.unmergedCount = undefined;
|
|
44
|
+
}
|
|
45
|
+
try {
|
|
46
|
+
const insideMeta = await git.execMeta(['rev-parse', '--is-inside-work-tree']);
|
|
47
|
+
if (insideMeta.ok) {
|
|
48
|
+
details.isInsideWorkTree = insideMeta.stdout.toString('utf8').trim() === 'true';
|
|
49
|
+
}
|
|
50
|
+
else {
|
|
51
|
+
details.isInsideWorkTree = false;
|
|
52
|
+
details.spawnErrorCode =
|
|
53
|
+
typeof insideMeta.error?.code === 'string' ? insideMeta.error.code : undefined;
|
|
54
|
+
details.workTreeProbeErrorCode =
|
|
55
|
+
insideMeta.error?.code ||
|
|
56
|
+
(typeof insideMeta.code === 'number' ? `EXIT_${insideMeta.code}` : undefined);
|
|
57
|
+
details.workTreeProbeHintCode = classifyGitFailureHint({
|
|
58
|
+
message: insideMeta.error?.message ||
|
|
59
|
+
(typeof insideMeta.code === 'number'
|
|
60
|
+
? `rev-parse exited ${insideMeta.code}`
|
|
61
|
+
: 'rev-parse failed'),
|
|
62
|
+
stderr: insideMeta.stderr,
|
|
63
|
+
command: 'rev-parse --is-inside-work-tree',
|
|
64
|
+
});
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
catch {
|
|
68
|
+
details.isInsideWorkTree = undefined;
|
|
69
|
+
}
|
|
70
|
+
return details;
|
|
71
|
+
}
|
|
72
|
+
//# sourceMappingURL=snapshot-write-tree.js.map
|
|
@@ -0,0 +1,394 @@
|
|
|
1
|
+
import path from 'path';
|
|
2
|
+
import { text } from '../../../locales/index.js';
|
|
3
|
+
import { GitAdapter } from '../../adapters/git/git-adapter.js';
|
|
4
|
+
import { logIgnoredError } from '../../observability/ignored-error.js';
|
|
5
|
+
import { getLogger } from '../../observability/logger.js';
|
|
6
|
+
import { getRejectionsDir, getTmpDir } from '../../runtime/paths.js';
|
|
7
|
+
import { normalizePath } from '../../utils/path.js';
|
|
8
|
+
import { StrataContentGuardian } from '../interaction/content-guardian.js';
|
|
9
|
+
import { StrataFileSystemProvider } from '../interaction/file-system-provider.js';
|
|
10
|
+
export class ShadowMergeEngine {
|
|
11
|
+
options;
|
|
12
|
+
checkpoints;
|
|
13
|
+
sidecar;
|
|
14
|
+
gitAdapter;
|
|
15
|
+
guardian;
|
|
16
|
+
fsp;
|
|
17
|
+
constructor(options, checkpoints, sidecar) {
|
|
18
|
+
this.options = options;
|
|
19
|
+
this.checkpoints = checkpoints;
|
|
20
|
+
this.sidecar = sidecar ?? createNoopSidecar();
|
|
21
|
+
this.gitAdapter = new GitAdapter(options.mainRepoPath);
|
|
22
|
+
this.guardian = new StrataContentGuardian();
|
|
23
|
+
this.fsp = options.fileSystemProvider ?? new StrataFileSystemProvider(this.gitAdapter);
|
|
24
|
+
}
|
|
25
|
+
async apply() {
|
|
26
|
+
const { mainRepoPath, shadowWorktreePath, initialRef, latestRef } = this.options;
|
|
27
|
+
// L3: SyntheticSidecarLayer Injection
|
|
28
|
+
await this.sidecar.inject(shadowWorktreePath);
|
|
29
|
+
// Strategy Pattern Implementation
|
|
30
|
+
const strategy = this.options.applyBackOnDirty || 'abort';
|
|
31
|
+
// Check if workspace is dirty
|
|
32
|
+
const isDirty = await this.isWorkspaceDirty(mainRepoPath);
|
|
33
|
+
if (isDirty && strategy === 'abort') {
|
|
34
|
+
throw new Error(text.loop.workspaceDirtyAbort);
|
|
35
|
+
}
|
|
36
|
+
if (isDirty && strategy === '3way') {
|
|
37
|
+
getLogger().warn(text.loop.using3WayMergeStrategy);
|
|
38
|
+
}
|
|
39
|
+
// Zero Trust Workflow: Pre-Flight (Safety)
|
|
40
|
+
getLogger().debug('[ShadowMergeEngine] Creating snapshot for atomic transaction');
|
|
41
|
+
const snapshot = await this.checkpoints.createSafeSnapshot(mainRepoPath);
|
|
42
|
+
// T1: Dirty Transaction Backup (Captured early to satisfy Atomicity Contract and Unit Tests)
|
|
43
|
+
const t1BackupHash = await this.checkpoints.createDirtyBackup(mainRepoPath);
|
|
44
|
+
if (t1BackupHash) {
|
|
45
|
+
getLogger().debug(`[ShadowMergeEngine] Created T1 Dirty Backup: ${t1BackupHash}`);
|
|
46
|
+
}
|
|
47
|
+
try {
|
|
48
|
+
const diffEntries = await this.getShadowDiffEntries(shadowWorktreePath, initialRef, latestRef);
|
|
49
|
+
const operations = [];
|
|
50
|
+
for (const entry of diffEntries) {
|
|
51
|
+
if (entry.status === 'R' || entry.status === 'C') {
|
|
52
|
+
if (entry.oldPath) {
|
|
53
|
+
operations.push({ type: 'D', path: entry.oldPath });
|
|
54
|
+
}
|
|
55
|
+
operations.push({ type: 'A', path: entry.path });
|
|
56
|
+
continue;
|
|
57
|
+
}
|
|
58
|
+
if (entry.status === 'A' || entry.status === 'M' || entry.status === 'D') {
|
|
59
|
+
operations.push({ type: entry.status, path: entry.path });
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
if (operations.length === 0) {
|
|
63
|
+
return;
|
|
64
|
+
}
|
|
65
|
+
const conflicts = [];
|
|
66
|
+
const skipped = [];
|
|
67
|
+
const maxFileBytes = this.options.maxFileBytes ?? 1024 * 1024;
|
|
68
|
+
for (const op of operations) {
|
|
69
|
+
const policy = await this.shouldAllowPath(op.path);
|
|
70
|
+
if (!policy.allowed) {
|
|
71
|
+
skipped.push(`${op.path} (${policy.reason})`);
|
|
72
|
+
continue;
|
|
73
|
+
}
|
|
74
|
+
const status = await this.getStatusForPath(mainRepoPath, op.path);
|
|
75
|
+
const hasUserChanges = status
|
|
76
|
+
? status.staged || status.unstaged || status.untracked
|
|
77
|
+
: false;
|
|
78
|
+
if (op.type === 'A') {
|
|
79
|
+
const aiContent = await this.gitShowFile(shadowWorktreePath, latestRef, op.path);
|
|
80
|
+
if (!aiContent) {
|
|
81
|
+
skipped.push(`${op.path} (missing-ai)`);
|
|
82
|
+
continue;
|
|
83
|
+
}
|
|
84
|
+
if (aiContent.length > maxFileBytes) {
|
|
85
|
+
skipped.push(`${op.path} (size-limit)`);
|
|
86
|
+
continue;
|
|
87
|
+
}
|
|
88
|
+
if (hasUserChanges) {
|
|
89
|
+
const ignored = await this.isIgnoredPath(mainRepoPath, op.path);
|
|
90
|
+
if (ignored) {
|
|
91
|
+
const userWorkingPath = path.join(mainRepoPath, op.path);
|
|
92
|
+
/**
|
|
93
|
+
* 🛡️ CONTROLLED IO: Explicitly pass mainRepoPath as rootContext
|
|
94
|
+
* to prevent AI-driven path traversal to system files.
|
|
95
|
+
*/
|
|
96
|
+
const userWorkingContent = await this.fsp.readFileBufferSafe(userWorkingPath, mainRepoPath);
|
|
97
|
+
if (userWorkingContent) {
|
|
98
|
+
const isBinary = (await this.isBinaryPath(mainRepoPath, op.path, userWorkingContent)) ||
|
|
99
|
+
(await this.isBinaryPath(shadowWorktreePath, op.path, aiContent));
|
|
100
|
+
if (isBinary) {
|
|
101
|
+
skipped.push(`${op.path} (binary)`);
|
|
102
|
+
continue;
|
|
103
|
+
}
|
|
104
|
+
const emptyBase = Buffer.alloc(0);
|
|
105
|
+
getLogger().warn(text.loop.unionMergeWarning(op.path));
|
|
106
|
+
const workingMerge = await this.mergeFileContents(mainRepoPath, emptyBase, userWorkingContent, aiContent, { union: true });
|
|
107
|
+
await this.fsp.writeFile(userWorkingPath, workingMerge.merged, mainRepoPath);
|
|
108
|
+
continue;
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
conflicts.push(op.path);
|
|
112
|
+
continue;
|
|
113
|
+
}
|
|
114
|
+
const destPath = path.join(mainRepoPath, op.path);
|
|
115
|
+
try {
|
|
116
|
+
await this.fsp.mkdir(path.dirname(destPath), { recursive: true }, mainRepoPath);
|
|
117
|
+
await this.fsp.writeFile(destPath, aiContent, mainRepoPath);
|
|
118
|
+
}
|
|
119
|
+
catch (error) {
|
|
120
|
+
const err = error;
|
|
121
|
+
if (err?.code === 'EISDIR' || err?.code === 'EEXIST' || err?.code === 'ENOTDIR') {
|
|
122
|
+
conflicts.push(`${op.path} (fs-collision)`);
|
|
123
|
+
continue;
|
|
124
|
+
}
|
|
125
|
+
throw error;
|
|
126
|
+
}
|
|
127
|
+
continue;
|
|
128
|
+
}
|
|
129
|
+
if (op.type === 'D') {
|
|
130
|
+
if (hasUserChanges) {
|
|
131
|
+
conflicts.push(op.path);
|
|
132
|
+
continue;
|
|
133
|
+
}
|
|
134
|
+
const targetPath = path.join(mainRepoPath, op.path);
|
|
135
|
+
try {
|
|
136
|
+
await this.fsp.unlink(targetPath, mainRepoPath);
|
|
137
|
+
}
|
|
138
|
+
catch (error) {
|
|
139
|
+
const err = error;
|
|
140
|
+
if (err?.code !== 'ENOENT') {
|
|
141
|
+
throw error;
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
continue;
|
|
145
|
+
}
|
|
146
|
+
// Merge logic
|
|
147
|
+
if (status?.deleted && !status?.untracked) {
|
|
148
|
+
conflicts.push(op.path);
|
|
149
|
+
continue;
|
|
150
|
+
}
|
|
151
|
+
if (status?.untracked) {
|
|
152
|
+
const userWorkingPath = path.join(mainRepoPath, op.path);
|
|
153
|
+
const userWorkingContent = await this.fsp.readFileBufferSafe(userWorkingPath, mainRepoPath);
|
|
154
|
+
if (!userWorkingContent) {
|
|
155
|
+
conflicts.push(op.path);
|
|
156
|
+
continue;
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
const baseContent = await this.getBaseContent(shadowWorktreePath, initialRef, op.path);
|
|
160
|
+
const aiContent = await this.gitShowFile(shadowWorktreePath, latestRef, op.path);
|
|
161
|
+
if (!baseContent || !aiContent) {
|
|
162
|
+
conflicts.push(op.path);
|
|
163
|
+
continue;
|
|
164
|
+
}
|
|
165
|
+
const userWorkingPath = path.join(mainRepoPath, op.path);
|
|
166
|
+
const userWorkingContent = await this.fsp.readFileBufferSafe(userWorkingPath, mainRepoPath);
|
|
167
|
+
if (!userWorkingContent) {
|
|
168
|
+
conflicts.push(op.path);
|
|
169
|
+
continue;
|
|
170
|
+
}
|
|
171
|
+
const isBinary = (await this.isBinaryPath(shadowWorktreePath, op.path, aiContent)) ||
|
|
172
|
+
(await this.isBinaryPath(mainRepoPath, op.path, userWorkingContent));
|
|
173
|
+
if (isBinary) {
|
|
174
|
+
skipped.push(`${op.path} (binary)`);
|
|
175
|
+
continue;
|
|
176
|
+
}
|
|
177
|
+
const workingMerge = await this.mergeFileContents(mainRepoPath, baseContent, userWorkingContent, aiContent);
|
|
178
|
+
await this.fsp.writeFile(userWorkingPath, workingMerge.merged, mainRepoPath);
|
|
179
|
+
if (workingMerge.conflict) {
|
|
180
|
+
conflicts.push(op.path);
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
if (skipped.length > 0) {
|
|
184
|
+
getLogger().warn(text.loop.skippedFiles(skipped.join(', ')));
|
|
185
|
+
}
|
|
186
|
+
if (conflicts.length > 0) {
|
|
187
|
+
const rejectionsDir = getRejectionsDir(mainRepoPath);
|
|
188
|
+
await this.fsp.mkdir(rejectionsDir, { recursive: true }, mainRepoPath);
|
|
189
|
+
for (const conflictPath of conflicts) {
|
|
190
|
+
try {
|
|
191
|
+
const aiContent = await this.gitShowFile(shadowWorktreePath, latestRef, conflictPath);
|
|
192
|
+
if (aiContent) {
|
|
193
|
+
const rejFullPath = path.join(rejectionsDir, `${conflictPath}.rej`);
|
|
194
|
+
await this.fsp.mkdir(path.dirname(rejFullPath), { recursive: true }, mainRepoPath);
|
|
195
|
+
await this.fsp.writeFile(rejFullPath, aiContent, mainRepoPath);
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
catch (e) {
|
|
199
|
+
getLogger().error(`Failed to generate rejection for ${conflictPath}: ${e}`);
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
throw new Error(text.loop.applyBackCompletedWithConflicts(conflicts.length, conflicts.join(', ')));
|
|
203
|
+
}
|
|
204
|
+
getLogger().debug('[ShadowMergeEngine] Transaction completed successfully');
|
|
205
|
+
}
|
|
206
|
+
catch (error) {
|
|
207
|
+
getLogger().error(`[ShadowMergeEngine] Transaction failed, rolling back: ${error}`);
|
|
208
|
+
if (t1BackupHash) {
|
|
209
|
+
getLogger().debug(`[ShadowMergeEngine] T1 backup found (${t1BackupHash}), performing safe rollback.`);
|
|
210
|
+
await this.checkpoints.restoreDirtyBackup(mainRepoPath, t1BackupHash);
|
|
211
|
+
}
|
|
212
|
+
else if (!isDirty) {
|
|
213
|
+
getLogger().warn(`[ShadowMergeEngine] No T1 backup found in clean workspace rollback. Restoring T0 snapshot: ${snapshot.commitHash}`);
|
|
214
|
+
await this.checkpoints.restoreToMain(mainRepoPath, snapshot.commitHash, true);
|
|
215
|
+
}
|
|
216
|
+
else {
|
|
217
|
+
// If T1 backup is missing, restoring T0 can overwrite user dirty state.
|
|
218
|
+
// Do not perform automated restore in this branch.
|
|
219
|
+
getLogger().error(`[ShadowMergeEngine] CRITICAL: No T1 backup found during rollback. ` +
|
|
220
|
+
`Skipping automated restore to prevent potential data loss. ` +
|
|
221
|
+
`Please verify workspace state manually. Snapshot was: ${snapshot.commitHash}`);
|
|
222
|
+
}
|
|
223
|
+
throw error;
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
async shouldAllowPath(relativePath, contentSize) {
|
|
227
|
+
if (!this.options.shouldAllowPath)
|
|
228
|
+
return { allowed: true };
|
|
229
|
+
return this.options.shouldAllowPath(relativePath, contentSize);
|
|
230
|
+
}
|
|
231
|
+
async getBaseContent(worktreePath, ref, relativePath) {
|
|
232
|
+
const base = await this.gitShowFile(worktreePath, ref, relativePath);
|
|
233
|
+
if (base)
|
|
234
|
+
return base;
|
|
235
|
+
if (this.sidecar.has(relativePath)) {
|
|
236
|
+
return this.sidecar.get(relativePath);
|
|
237
|
+
}
|
|
238
|
+
return null;
|
|
239
|
+
}
|
|
240
|
+
async isBinaryPath(repoPath, relativePath, content) {
|
|
241
|
+
const ext = path.extname(relativePath).toLowerCase();
|
|
242
|
+
const binaryExtensions = [
|
|
243
|
+
'.png',
|
|
244
|
+
'.jpg',
|
|
245
|
+
'.jpeg',
|
|
246
|
+
'.gif',
|
|
247
|
+
'.bmp',
|
|
248
|
+
'.ico',
|
|
249
|
+
'.pdf',
|
|
250
|
+
'.zip',
|
|
251
|
+
'.tar',
|
|
252
|
+
'.gz',
|
|
253
|
+
'.7z',
|
|
254
|
+
'.exe',
|
|
255
|
+
'.dll',
|
|
256
|
+
'.so',
|
|
257
|
+
'.dylib',
|
|
258
|
+
'.bin',
|
|
259
|
+
'.dat',
|
|
260
|
+
];
|
|
261
|
+
if (binaryExtensions.includes(ext))
|
|
262
|
+
return true;
|
|
263
|
+
if (content)
|
|
264
|
+
return this.guardian.inspect(content).isBinary;
|
|
265
|
+
try {
|
|
266
|
+
const filePath = path.join(repoPath, relativePath);
|
|
267
|
+
const buffer = await this.fsp.readFileBufferSafe(filePath, repoPath);
|
|
268
|
+
if (!buffer)
|
|
269
|
+
return false;
|
|
270
|
+
return this.guardian.inspect(buffer).isBinary;
|
|
271
|
+
}
|
|
272
|
+
catch {
|
|
273
|
+
return false;
|
|
274
|
+
}
|
|
275
|
+
}
|
|
276
|
+
async isIgnoredPath(repoPath, relativePath) {
|
|
277
|
+
const normalized = normalizePath(relativePath);
|
|
278
|
+
return await this.gitAdapter.checkIgnore(normalized);
|
|
279
|
+
}
|
|
280
|
+
async gitShowFile(repoPath, ref, relativePath) {
|
|
281
|
+
const git = repoPath === this.options.mainRepoPath ? this.gitAdapter : new GitAdapter(repoPath);
|
|
282
|
+
try {
|
|
283
|
+
return await git.show(ref, relativePath);
|
|
284
|
+
}
|
|
285
|
+
catch {
|
|
286
|
+
return null;
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
async mergeFileContents(repoPath, baseContent, userContent, aiContent, _options = {}) {
|
|
290
|
+
const { normalized: normBase } = this.guardian.inspect(baseContent);
|
|
291
|
+
const { normalized: normUser, eol: detectedEOL } = this.guardian.inspect(userContent);
|
|
292
|
+
const { normalized: normAi } = this.guardian.inspect(aiContent);
|
|
293
|
+
const finalTargetEOL = detectedEOL;
|
|
294
|
+
const suffix = `${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
|
|
295
|
+
const tmpDir = getTmpDir(repoPath);
|
|
296
|
+
const basePath = path.join(tmpDir, `base-${suffix}`);
|
|
297
|
+
const userPath = path.join(tmpDir, `user-${suffix}`);
|
|
298
|
+
const aiPath = path.join(tmpDir, `ai-${suffix}`);
|
|
299
|
+
/**
|
|
300
|
+
* 🛡️ TMP FILES: Still within the repo sandbox for git merge-file
|
|
301
|
+
* but using atomic FSP to ensure cleanup and safety.
|
|
302
|
+
*/
|
|
303
|
+
await this.fsp.mkdir(tmpDir, { recursive: true }, repoPath);
|
|
304
|
+
await this.fsp.writeFile(basePath, normBase, repoPath);
|
|
305
|
+
await this.fsp.writeFile(userPath, normUser, repoPath);
|
|
306
|
+
await this.fsp.writeFile(aiPath, normAi, repoPath);
|
|
307
|
+
try {
|
|
308
|
+
const result = await this.gitAdapter.mergeFile(basePath, userPath, aiPath, {
|
|
309
|
+
union: _options.union,
|
|
310
|
+
});
|
|
311
|
+
const mergedStr = result.content.toString('utf8');
|
|
312
|
+
const restoredBuffer = this.guardian.restore(mergedStr, finalTargetEOL);
|
|
313
|
+
return {
|
|
314
|
+
merged: restoredBuffer,
|
|
315
|
+
conflict: result.hasConflict,
|
|
316
|
+
};
|
|
317
|
+
}
|
|
318
|
+
catch (error) {
|
|
319
|
+
const msg = error instanceof Error ? error.message : String(error);
|
|
320
|
+
throw new Error(`git merge-file failed: ${msg}`);
|
|
321
|
+
}
|
|
322
|
+
finally {
|
|
323
|
+
await this.fsp
|
|
324
|
+
.unlink(basePath, repoPath)
|
|
325
|
+
.catch((error) => logIgnoredError(`[ShadowMerge] cleanup ${basePath}`, error));
|
|
326
|
+
await this.fsp
|
|
327
|
+
.unlink(userPath, repoPath)
|
|
328
|
+
.catch((error) => logIgnoredError(`[ShadowMerge] cleanup ${userPath}`, error));
|
|
329
|
+
await this.fsp
|
|
330
|
+
.unlink(aiPath, repoPath)
|
|
331
|
+
.catch((error) => logIgnoredError(`[ShadowMerge] cleanup ${aiPath}`, error));
|
|
332
|
+
}
|
|
333
|
+
}
|
|
334
|
+
async getStatusForPath(repoPath, relativePath) {
|
|
335
|
+
const git = new GitAdapter(repoPath);
|
|
336
|
+
return await git.getStatusForPath(relativePath);
|
|
337
|
+
}
|
|
338
|
+
async getShadowDiffEntries(worktreePath, initialRef, latestRef) {
|
|
339
|
+
const git = new GitAdapter(worktreePath);
|
|
340
|
+
const output = await git.query(['diff', '--name-status', '-z', initialRef, latestRef]);
|
|
341
|
+
if (!output)
|
|
342
|
+
return [];
|
|
343
|
+
const tokens = output.split('\0').filter((token) => token.length > 0);
|
|
344
|
+
const entries = [];
|
|
345
|
+
for (let i = 0; i < tokens.length; i += 1) {
|
|
346
|
+
const statusToken = tokens[i];
|
|
347
|
+
const status = statusToken.charAt(0);
|
|
348
|
+
if (status === 'R' || status === 'C') {
|
|
349
|
+
const oldPath = tokens[i + 1];
|
|
350
|
+
const newPath = tokens[i + 2];
|
|
351
|
+
if (oldPath && newPath) {
|
|
352
|
+
entries.push({
|
|
353
|
+
status,
|
|
354
|
+
path: normalizePath(newPath),
|
|
355
|
+
oldPath: normalizePath(oldPath),
|
|
356
|
+
});
|
|
357
|
+
}
|
|
358
|
+
i += 2;
|
|
359
|
+
continue;
|
|
360
|
+
}
|
|
361
|
+
const pathToken = tokens[i + 1];
|
|
362
|
+
if (pathToken) {
|
|
363
|
+
entries.push({ status, path: normalizePath(pathToken) });
|
|
364
|
+
}
|
|
365
|
+
i += 1;
|
|
366
|
+
}
|
|
367
|
+
return entries;
|
|
368
|
+
}
|
|
369
|
+
async isWorkspaceDirty(repoPath) {
|
|
370
|
+
try {
|
|
371
|
+
const git = new GitAdapter(repoPath);
|
|
372
|
+
const status = await git.query(['status', '--porcelain']);
|
|
373
|
+
return status.trim().length > 0;
|
|
374
|
+
}
|
|
375
|
+
catch (error) {
|
|
376
|
+
getLogger().error(`Failed to check workspace status: ${error}`);
|
|
377
|
+
return false;
|
|
378
|
+
}
|
|
379
|
+
}
|
|
380
|
+
}
|
|
381
|
+
function createNoopSidecar() {
|
|
382
|
+
return {
|
|
383
|
+
async capture() { },
|
|
384
|
+
async inject() { },
|
|
385
|
+
has() {
|
|
386
|
+
return false;
|
|
387
|
+
},
|
|
388
|
+
async get() {
|
|
389
|
+
return null;
|
|
390
|
+
},
|
|
391
|
+
async clear() { },
|
|
392
|
+
};
|
|
393
|
+
}
|
|
394
|
+
//# sourceMappingURL=shadow-merge-engine.js.map
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
// Types
|
|
2
|
+
export * from './types.js';
|
|
3
|
+
// Checkpoint
|
|
4
|
+
export * from './checkpoint/manager.js';
|
|
5
|
+
// Engine
|
|
6
|
+
// ShadowMergeEngineOptions is exported from types.js as well?
|
|
7
|
+
// No, it is defined in engine/shadow-merge-engine.ts
|
|
8
|
+
// If types.ts also exports it, we have conflict.
|
|
9
|
+
// Let's check src/core/strata/types.ts
|
|
10
|
+
export * from './engine/shadow-merge-engine.js';
|
|
11
|
+
// Layers
|
|
12
|
+
export * from './layers/worktree.js';
|
|
13
|
+
export * from './layers/sidecar-layer.js';
|
|
14
|
+
export * from './layers/immutable-git-layer.js';
|
|
15
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { TextNormalizer } from '../../../utils/eol.js';
|
|
2
|
+
import { LIMITS } from '../../config/limits.js';
|
|
3
|
+
/**
|
|
4
|
+
* Strata Content Guardian
|
|
5
|
+
*
|
|
6
|
+
* Implements strict content safety protocols for Strata file interactions.
|
|
7
|
+
* - Binary Detection: Prevents corruption of binary files
|
|
8
|
+
* - EOL Normalization: Ensures cross-platform merge consistency
|
|
9
|
+
* - Size Guard: Prevents memory exhaustion attacks
|
|
10
|
+
*/
|
|
11
|
+
export class StrataContentGuardian {
|
|
12
|
+
static BINARY_CHECK_BYTES = LIMITS.binaryCheckBufferSize;
|
|
13
|
+
/**
|
|
14
|
+
* Sniff content for binary signatures and normalize text for processing.
|
|
15
|
+
* This is the entry point for ALL file content entering the Strata system.
|
|
16
|
+
*/
|
|
17
|
+
inspect(content) {
|
|
18
|
+
const isBinary = this.hasBinarySignature(content);
|
|
19
|
+
const size = content.length;
|
|
20
|
+
if (isBinary) {
|
|
21
|
+
return {
|
|
22
|
+
normalized: '', // We do not normalize binary content
|
|
23
|
+
eol: '\n', // Default fallback
|
|
24
|
+
isBinary: true,
|
|
25
|
+
size,
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
// For text files, perform EOL sniffing and normalization
|
|
29
|
+
const textContent = content.toString('utf8');
|
|
30
|
+
const { normalized, eol } = TextNormalizer.read(textContent);
|
|
31
|
+
return {
|
|
32
|
+
normalized,
|
|
33
|
+
eol,
|
|
34
|
+
isBinary: false,
|
|
35
|
+
size,
|
|
36
|
+
};
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Restore content to its original EOL format.
|
|
40
|
+
* Must be called before writing any merged content back to disk.
|
|
41
|
+
*/
|
|
42
|
+
restore(text, targetEOL) {
|
|
43
|
+
const restoredText = TextNormalizer.restore(text, targetEOL);
|
|
44
|
+
return Buffer.from(restoredText, 'utf8');
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Check for null bytes in the first N bytes of the buffer.
|
|
48
|
+
* This is the same heuristic used by Git.
|
|
49
|
+
*/
|
|
50
|
+
hasBinarySignature(content) {
|
|
51
|
+
const len = Math.min(content.length, StrataContentGuardian.BINARY_CHECK_BYTES);
|
|
52
|
+
for (let i = 0; i < len; i++) {
|
|
53
|
+
if (content[i] === 0)
|
|
54
|
+
return true;
|
|
55
|
+
}
|
|
56
|
+
return false;
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
//# sourceMappingURL=content-guardian.js.map
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import * as path from 'path';
|
|
2
|
+
import { promises as fs } from '../../adapters/fs/node-fs.js';
|
|
3
|
+
import { getLogger } from '../../observability/logger.js';
|
|
4
|
+
import { ensureInSandbox } from '../../utils/path.js';
|
|
5
|
+
import { StrataContentGuardian } from './content-guardian.js';
|
|
6
|
+
/**
|
|
7
|
+
* Strata File System Provider
|
|
8
|
+
*
|
|
9
|
+
* Implements the "Disk First" strategy for reading file content.
|
|
10
|
+
* 🛡️ SAFETY NOTE: All physical IO is protected by Sandbox checks to
|
|
11
|
+
* prevent unintended path traversal.
|
|
12
|
+
*/
|
|
13
|
+
export class StrataFileSystemProvider {
|
|
14
|
+
gitAdapter;
|
|
15
|
+
guardian;
|
|
16
|
+
constructor(gitAdapter) {
|
|
17
|
+
this.gitAdapter = gitAdapter;
|
|
18
|
+
this.guardian = new StrataContentGuardian();
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Reads the "Yours" version of a file.
|
|
22
|
+
*/
|
|
23
|
+
async readYours(repoPath, relativePath) {
|
|
24
|
+
// 🛡️ Guard: Ensure we don't leak files outside the targeted repository
|
|
25
|
+
const fullPath = ensureInSandbox(repoPath, path.join(repoPath, relativePath));
|
|
26
|
+
try {
|
|
27
|
+
getLogger().debug(`[StrataFileSystem] Reading 'Yours' content from disk: ${relativePath}`);
|
|
28
|
+
return await fs.readFile(fullPath);
|
|
29
|
+
}
|
|
30
|
+
catch (error) {
|
|
31
|
+
const err = error;
|
|
32
|
+
if (err.code === 'ENOENT') {
|
|
33
|
+
getLogger().debug(`[StrataFileSystem] File not found on disk: ${relativePath}`);
|
|
34
|
+
return null;
|
|
35
|
+
}
|
|
36
|
+
throw error;
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Reads a file as Buffer safely within a controlled root.
|
|
41
|
+
*/
|
|
42
|
+
async readFileBufferSafe(filePath, rootContext) {
|
|
43
|
+
try {
|
|
44
|
+
const safePath = rootContext ? ensureInSandbox(rootContext, filePath) : filePath;
|
|
45
|
+
return await fs.readFile(safePath);
|
|
46
|
+
}
|
|
47
|
+
catch (error) {
|
|
48
|
+
const err = error;
|
|
49
|
+
if (err?.code === 'ENOENT')
|
|
50
|
+
return null;
|
|
51
|
+
throw error;
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Writes content to a file with sandbox enforcement.
|
|
56
|
+
*/
|
|
57
|
+
async writeFile(filePath, content, rootContext) {
|
|
58
|
+
const safePath = rootContext ? ensureInSandbox(rootContext, filePath) : filePath;
|
|
59
|
+
await fs.writeFile(safePath, content);
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Creates a directory recursively with sandbox enforcement.
|
|
63
|
+
*/
|
|
64
|
+
async mkdir(dirPath, options, rootContext) {
|
|
65
|
+
const safePath = rootContext ? ensureInSandbox(rootContext, dirPath) : dirPath;
|
|
66
|
+
await fs.mkdir(safePath, options);
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* Deletes a file with sandbox enforcement.
|
|
70
|
+
*/
|
|
71
|
+
async unlink(filePath, rootContext) {
|
|
72
|
+
const safePath = rootContext ? ensureInSandbox(rootContext, filePath) : filePath;
|
|
73
|
+
await fs.unlink(safePath);
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* Checks if a file is binary with optional sandbox enforcement.
|
|
77
|
+
*/
|
|
78
|
+
async isBinary(filePath, rootContext) {
|
|
79
|
+
try {
|
|
80
|
+
const safePath = rootContext ? ensureInSandbox(rootContext, filePath) : filePath;
|
|
81
|
+
const buffer = await fs.readFile(safePath);
|
|
82
|
+
return this.guardian.inspect(buffer).isBinary;
|
|
83
|
+
}
|
|
84
|
+
catch {
|
|
85
|
+
return false;
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
//# sourceMappingURL=file-system-provider.js.map
|