@askdkc/kiokuko 0.1.17 → 0.1.19
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.ja.md +91 -112
- package/README.ko.md +90 -102
- package/README.md +103 -262
- package/README.zh-CN.md +88 -102
- package/dist/agent-file/atomic-write.d.ts +90 -3
- package/dist/agent-file/atomic-write.d.ts.map +1 -1
- package/dist/agent-file/atomic-write.js +990 -14
- package/dist/agent-file/atomic-write.js.map +1 -1
- package/dist/agent-file/managed-block.d.ts +12 -1
- package/dist/agent-file/managed-block.d.ts.map +1 -1
- package/dist/agent-file/managed-block.js +49 -4
- package/dist/agent-file/managed-block.js.map +1 -1
- package/dist/agent-file/render.d.ts +1 -1
- package/dist/agent-file/render.d.ts.map +1 -1
- package/dist/agent-file/render.js +10 -7
- package/dist/agent-file/render.js.map +1 -1
- package/dist/akinator/agent-task.d.ts +11 -22
- package/dist/akinator/agent-task.d.ts.map +1 -1
- package/dist/akinator/agent-task.js +454 -99
- package/dist/akinator/agent-task.js.map +1 -1
- package/dist/akinator/capabilities.d.ts +18 -6
- package/dist/akinator/capabilities.d.ts.map +1 -1
- package/dist/akinator/capabilities.js +72 -35
- package/dist/akinator/capabilities.js.map +1 -1
- package/dist/akinator/capability-binding.d.ts +11 -0
- package/dist/akinator/capability-binding.d.ts.map +1 -0
- package/dist/akinator/capability-binding.js +56 -0
- package/dist/akinator/capability-binding.js.map +1 -0
- package/dist/akinator/domain.js +2 -2
- package/dist/akinator/domain.js.map +1 -1
- package/dist/akinator/knowledge-path.d.ts.map +1 -1
- package/dist/akinator/knowledge-path.js +409 -39
- package/dist/akinator/knowledge-path.js.map +1 -1
- package/dist/akinator/orchestrator.d.ts +3 -4
- package/dist/akinator/orchestrator.d.ts.map +1 -1
- package/dist/akinator/orchestrator.js +1 -4
- package/dist/akinator/orchestrator.js.map +1 -1
- package/dist/akinator/service.d.ts +0 -4
- package/dist/akinator/service.d.ts.map +1 -1
- package/dist/akinator/service.js +19 -35
- package/dist/akinator/service.js.map +1 -1
- package/dist/akinator/skill-discovery-attempt.d.ts +20 -0
- package/dist/akinator/skill-discovery-attempt.d.ts.map +1 -0
- package/dist/akinator/skill-discovery-attempt.js +390 -0
- package/dist/akinator/skill-discovery-attempt.js.map +1 -0
- package/dist/akinator/store.d.ts.map +1 -1
- package/dist/akinator/store.js +107 -52
- package/dist/akinator/store.js.map +1 -1
- package/dist/akinator/types.d.ts +0 -12
- package/dist/akinator/types.d.ts.map +1 -1
- package/dist/bin/kiokuko.js +0 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +534 -148
- package/dist/cli.js.map +1 -1
- package/dist/client/server-client.d.ts +5 -3
- package/dist/client/server-client.d.ts.map +1 -1
- package/dist/client/server-client.js +486 -181
- package/dist/client/server-client.js.map +1 -1
- package/dist/commands/agent.d.ts +2 -0
- package/dist/commands/agent.d.ts.map +1 -1
- package/dist/commands/agent.js +861 -86
- package/dist/commands/agent.js.map +1 -1
- package/dist/commands/backup.d.ts +2 -1
- package/dist/commands/backup.d.ts.map +1 -1
- package/dist/commands/backup.js +64 -8
- package/dist/commands/backup.js.map +1 -1
- package/dist/commands/doctor.d.ts +5 -1
- package/dist/commands/doctor.d.ts.map +1 -1
- package/dist/commands/doctor.js +70 -26
- package/dist/commands/doctor.js.map +1 -1
- package/dist/commands/export.d.ts +0 -4
- package/dist/commands/export.d.ts.map +1 -1
- package/dist/commands/export.js +191 -32
- package/dist/commands/export.js.map +1 -1
- package/dist/commands/import.d.ts +10 -1
- package/dist/commands/import.d.ts.map +1 -1
- package/dist/commands/import.js +592 -113
- package/dist/commands/import.js.map +1 -1
- package/dist/commands/init.d.ts +19 -1
- package/dist/commands/init.d.ts.map +1 -1
- package/dist/commands/init.js +569 -22
- package/dist/commands/init.js.map +1 -1
- package/dist/commands/purge.d.ts.map +1 -1
- package/dist/commands/purge.js +3 -0
- package/dist/commands/purge.js.map +1 -1
- package/dist/commands/setup.d.ts +34 -8
- package/dist/commands/setup.d.ts.map +1 -1
- package/dist/commands/setup.js +418 -86
- package/dist/commands/setup.js.map +1 -1
- package/dist/commands/skills.d.ts +9 -0
- package/dist/commands/skills.d.ts.map +1 -0
- package/dist/commands/skills.js +317 -0
- package/dist/commands/skills.js.map +1 -0
- package/dist/commands/use.d.ts +10 -2
- package/dist/commands/use.d.ts.map +1 -1
- package/dist/commands/use.js +851 -73
- package/dist/commands/use.js.map +1 -1
- package/dist/config/paths.d.ts +11 -1
- package/dist/config/paths.d.ts.map +1 -1
- package/dist/config/paths.js +64 -29
- package/dist/config/paths.js.map +1 -1
- package/dist/config/project-config.d.ts +1 -0
- package/dist/config/project-config.d.ts.map +1 -1
- package/dist/config/project-config.js +70 -32
- package/dist/config/project-config.js.map +1 -1
- package/dist/context/broker.d.ts +28 -14
- package/dist/context/broker.d.ts.map +1 -1
- package/dist/context/broker.js +604 -145
- package/dist/context/broker.js.map +1 -1
- package/dist/context/delivery.d.ts +6 -21
- package/dist/context/delivery.d.ts.map +1 -1
- package/dist/context/delivery.js +196 -147
- package/dist/context/delivery.js.map +1 -1
- package/dist/context/feedback.d.ts +11 -12
- package/dist/context/feedback.d.ts.map +1 -1
- package/dist/context/feedback.js +229 -261
- package/dist/context/feedback.js.map +1 -1
- package/dist/context/ranking.d.ts +1 -12
- package/dist/context/ranking.d.ts.map +1 -1
- package/dist/context/ranking.js +13 -4
- package/dist/context/ranking.js.map +1 -1
- package/dist/context/recommendations.d.ts +0 -5
- package/dist/context/recommendations.d.ts.map +1 -1
- package/dist/context/recommendations.js +0 -1
- package/dist/context/recommendations.js.map +1 -1
- package/dist/context/run-state.d.ts +26 -0
- package/dist/context/run-state.d.ts.map +1 -0
- package/dist/context/run-state.js +399 -0
- package/dist/context/run-state.js.map +1 -0
- package/dist/context/scoped-broker.d.ts +17 -5
- package/dist/context/scoped-broker.d.ts.map +1 -1
- package/dist/context/scoped-broker.js +512 -106
- package/dist/context/scoped-broker.js.map +1 -1
- package/dist/context/selection-state.d.ts +19 -0
- package/dist/context/selection-state.d.ts.map +1 -0
- package/dist/context/selection-state.js +250 -0
- package/dist/context/selection-state.js.map +1 -0
- package/dist/db/adapter.d.ts +5 -3
- package/dist/db/adapter.d.ts.map +1 -1
- package/dist/db/adapter.js +6 -3
- package/dist/db/adapter.js.map +1 -1
- package/dist/db/capabilities.d.ts.map +1 -1
- package/dist/db/capabilities.js +34 -16
- package/dist/db/capabilities.js.map +1 -1
- package/dist/db/connection.d.ts +8 -0
- package/dist/db/connection.d.ts.map +1 -1
- package/dist/db/connection.js +55 -26
- package/dist/db/connection.js.map +1 -1
- package/dist/db/migrate.d.ts +28 -7
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +106 -78
- package/dist/db/migrate.js.map +1 -1
- package/dist/db/sqlite-retry.d.ts +11 -0
- package/dist/db/sqlite-retry.d.ts.map +1 -0
- package/dist/db/sqlite-retry.js +66 -0
- package/dist/db/sqlite-retry.js.map +1 -0
- package/dist/db/transaction.d.ts +13 -0
- package/dist/db/transaction.d.ts.map +1 -1
- package/dist/db/transaction.js +53 -24
- package/dist/db/transaction.js.map +1 -1
- package/dist/db/upgrade-backup.d.ts +58 -2
- package/dist/db/upgrade-backup.d.ts.map +1 -1
- package/dist/db/upgrade-backup.js +757 -28
- package/dist/db/upgrade-backup.js.map +1 -1
- package/dist/errors.js +1 -1
- package/dist/errors.js.map +1 -1
- package/dist/gateway/agent-service.d.ts +4 -1
- package/dist/gateway/agent-service.d.ts.map +1 -1
- package/dist/gateway/agent-service.js +71 -58
- package/dist/gateway/agent-service.js.map +1 -1
- package/dist/gateway/checkpoint-service.d.ts +1 -0
- package/dist/gateway/checkpoint-service.d.ts.map +1 -1
- package/dist/gateway/checkpoint-service.js +47 -24
- package/dist/gateway/checkpoint-service.js.map +1 -1
- package/dist/ledger/archive.d.ts +1 -4
- package/dist/ledger/archive.d.ts.map +1 -1
- package/dist/ledger/archive.js +77 -39
- package/dist/ledger/archive.js.map +1 -1
- package/dist/ledger/maintenance.d.ts +0 -11
- package/dist/ledger/maintenance.d.ts.map +1 -1
- package/dist/ledger/maintenance.js +24 -40
- package/dist/ledger/maintenance.js.map +1 -1
- package/dist/ledger/projection.d.ts +0 -1
- package/dist/ledger/projection.d.ts.map +1 -1
- package/dist/ledger/projection.js.map +1 -1
- package/dist/ledger/promotion.d.ts +0 -9
- package/dist/ledger/promotion.d.ts.map +1 -1
- package/dist/ledger/promotion.js.map +1 -1
- package/dist/ledger/query.d.ts +1 -15
- package/dist/ledger/query.d.ts.map +1 -1
- package/dist/ledger/query.js.map +1 -1
- package/dist/ledger/store.d.ts +0 -1
- package/dist/ledger/store.d.ts.map +1 -1
- package/dist/ledger/store.js +11 -8
- package/dist/ledger/store.js.map +1 -1
- package/dist/ledger/types.d.ts +0 -4
- package/dist/ledger/types.d.ts.map +1 -1
- package/dist/ledger/types.js.map +1 -1
- package/dist/ledger/validate.d.ts.map +1 -1
- package/dist/ledger/validate.js +0 -5
- package/dist/ledger/validate.js.map +1 -1
- package/dist/mcp/server.d.ts +4 -0
- package/dist/mcp/server.d.ts.map +1 -1
- package/dist/mcp/server.js +105 -54
- package/dist/mcp/server.js.map +1 -1
- package/dist/memory/audit.d.ts +0 -1
- package/dist/memory/audit.d.ts.map +1 -1
- package/dist/memory/audit.js +0 -1
- package/dist/memory/audit.js.map +1 -1
- package/dist/memory/curator.d.ts.map +1 -1
- package/dist/memory/curator.js +172 -96
- package/dist/memory/curator.js.map +1 -1
- package/dist/memory/entries.d.ts +12 -2
- package/dist/memory/entries.d.ts.map +1 -1
- package/dist/memory/entries.js +198 -114
- package/dist/memory/entries.js.map +1 -1
- package/dist/memory/federated-retrieval.d.ts +12 -1
- package/dist/memory/federated-retrieval.d.ts.map +1 -1
- package/dist/memory/federated-retrieval.js +183 -70
- package/dist/memory/federated-retrieval.js.map +1 -1
- package/dist/memory/hybrid-retrieval.d.ts +5 -11
- package/dist/memory/hybrid-retrieval.d.ts.map +1 -1
- package/dist/memory/hybrid-retrieval.js +78 -58
- package/dist/memory/hybrid-retrieval.js.map +1 -1
- package/dist/memory/lifecycle.d.ts.map +1 -1
- package/dist/memory/lifecycle.js +17 -13
- package/dist/memory/lifecycle.js.map +1 -1
- package/dist/memory/rebuild-search.d.ts +5 -0
- package/dist/memory/rebuild-search.d.ts.map +1 -1
- package/dist/memory/rebuild-search.js +101 -76
- package/dist/memory/rebuild-search.js.map +1 -1
- package/dist/memory/retrieval-query.d.ts +0 -5
- package/dist/memory/retrieval-query.d.ts.map +1 -1
- package/dist/memory/retrieval-query.js +0 -5
- package/dist/memory/retrieval-query.js.map +1 -1
- package/dist/memory/retrieval.d.ts.map +1 -1
- package/dist/memory/retrieval.js +25 -131
- package/dist/memory/retrieval.js.map +1 -1
- package/dist/memory/revisions.d.ts +76 -1
- package/dist/memory/revisions.d.ts.map +1 -1
- package/dist/memory/revisions.js +539 -35
- package/dist/memory/revisions.js.map +1 -1
- package/dist/memory/scoped-memory.d.ts +16 -1
- package/dist/memory/scoped-memory.d.ts.map +1 -1
- package/dist/memory/scoped-memory.js +240 -107
- package/dist/memory/scoped-memory.js.map +1 -1
- package/dist/memory/secrets.d.ts +2 -0
- package/dist/memory/secrets.d.ts.map +1 -1
- package/dist/memory/secrets.js +36 -0
- package/dist/memory/secrets.js.map +1 -1
- package/dist/memory/structured-memory.d.ts +3 -2
- package/dist/memory/structured-memory.d.ts.map +1 -1
- package/dist/memory/structured-memory.js +54 -22
- package/dist/memory/structured-memory.js.map +1 -1
- package/dist/memory/workspaces.d.ts +9 -0
- package/dist/memory/workspaces.d.ts.map +1 -1
- package/dist/memory/workspaces.js +67 -0
- package/dist/memory/workspaces.js.map +1 -1
- package/dist/package-version.d.ts +2 -0
- package/dist/package-version.d.ts.map +1 -0
- package/dist/package-version.js +7 -0
- package/dist/package-version.js.map +1 -0
- package/dist/repository/binding.d.ts +5 -0
- package/dist/repository/binding.d.ts.map +1 -1
- package/dist/repository/binding.js +117 -17
- package/dist/repository/binding.js.map +1 -1
- package/dist/repository/framework-version.d.ts +8 -0
- package/dist/repository/framework-version.d.ts.map +1 -0
- package/dist/repository/framework-version.js +29 -0
- package/dist/repository/framework-version.js.map +1 -0
- package/dist/repository/identity-value.d.ts +4 -0
- package/dist/repository/identity-value.d.ts.map +1 -0
- package/dist/repository/identity-value.js +24 -0
- package/dist/repository/identity-value.js.map +1 -0
- package/dist/repository/identity.d.ts.map +1 -1
- package/dist/repository/identity.js +2 -0
- package/dist/repository/identity.js.map +1 -1
- package/dist/repository/project-fingerprint.d.ts +14 -2
- package/dist/repository/project-fingerprint.d.ts.map +1 -1
- package/dist/repository/project-fingerprint.js +312 -33
- package/dist/repository/project-fingerprint.js.map +1 -1
- package/dist/repository/remote-url.d.ts +0 -1
- package/dist/repository/remote-url.d.ts.map +1 -1
- package/dist/repository/remote-url.js +0 -1
- package/dist/repository/remote-url.js.map +1 -1
- package/dist/runtime-version.d.ts +2 -1
- package/dist/runtime-version.d.ts.map +1 -1
- package/dist/runtime-version.js +21 -4
- package/dist/runtime-version.js.map +1 -1
- package/dist/serialization/boundary-json.d.ts +20 -0
- package/dist/serialization/boundary-json.d.ts.map +1 -0
- package/dist/serialization/boundary-json.js +129 -0
- package/dist/serialization/boundary-json.js.map +1 -0
- package/dist/serialization/envelope.js +1 -1
- package/dist/serialization/envelope.js.map +1 -1
- package/dist/serialization/validate.d.ts +7 -0
- package/dist/serialization/validate.d.ts.map +1 -1
- package/dist/serialization/validate.js +53 -13
- package/dist/serialization/validate.js.map +1 -1
- package/dist/server/app.js +1 -1
- package/dist/server/app.js.map +1 -1
- package/dist/server/http.d.ts +4 -3
- package/dist/server/http.d.ts.map +1 -1
- package/dist/server/http.js +90 -50
- package/dist/server/http.js.map +1 -1
- package/dist/server/idempotency.d.ts +0 -6
- package/dist/server/idempotency.d.ts.map +1 -1
- package/dist/server/idempotency.js.map +1 -1
- package/dist/server/router.d.ts.map +1 -1
- package/dist/server/router.js +21 -4
- package/dist/server/router.js.map +1 -1
- package/dist/server/routes/agent-capability-gate.d.ts +40 -0
- package/dist/server/routes/agent-capability-gate.d.ts.map +1 -0
- package/dist/server/routes/agent-capability-gate.js +182 -0
- package/dist/server/routes/agent-capability-gate.js.map +1 -0
- package/dist/server/routes/agent-events.d.ts.map +1 -1
- package/dist/server/routes/agent-events.js +8 -1
- package/dist/server/routes/agent-events.js.map +1 -1
- package/dist/server/routes/agent-intake.d.ts.map +1 -1
- package/dist/server/routes/agent-intake.js +10 -2
- package/dist/server/routes/agent-intake.js.map +1 -1
- package/dist/server/routes/agent-promotions.d.ts.map +1 -1
- package/dist/server/routes/agent-promotions.js +5 -2
- package/dist/server/routes/agent-promotions.js.map +1 -1
- package/dist/server/routes/agent-runs.d.ts.map +1 -1
- package/dist/server/routes/agent-runs.js +18 -4
- package/dist/server/routes/agent-runs.js.map +1 -1
- package/dist/server/routes/request-binding.d.ts +5 -0
- package/dist/server/routes/request-binding.d.ts.map +1 -0
- package/dist/server/routes/request-binding.js +49 -0
- package/dist/server/routes/request-binding.js.map +1 -0
- package/dist/server/routes/task5-support.d.ts +1 -8
- package/dist/server/routes/task5-support.d.ts.map +1 -1
- package/dist/server/routes/task5-support.js +1 -17
- package/dist/server/routes/task5-support.js.map +1 -1
- package/dist/server/routes/task5.d.ts.map +1 -1
- package/dist/server/routes/task5.js +106 -36
- package/dist/server/routes/task5.js.map +1 -1
- package/dist/server/write-queue.js +2 -2
- package/dist/server/write-queue.js.map +1 -1
- package/dist/setup/claude-config.d.ts +2 -1
- package/dist/setup/claude-config.d.ts.map +1 -1
- package/dist/setup/claude-config.js +54 -4
- package/dist/setup/claude-config.js.map +1 -1
- package/dist/setup/client-detection.d.ts +7 -2
- package/dist/setup/client-detection.d.ts.map +1 -1
- package/dist/setup/client-detection.js +27 -9
- package/dist/setup/client-detection.js.map +1 -1
- package/dist/setup/hermes-config.d.ts +2 -1
- package/dist/setup/hermes-config.d.ts.map +1 -1
- package/dist/setup/hermes-config.js +53 -12
- package/dist/setup/hermes-config.js.map +1 -1
- package/dist/setup/legacy-client-cleanup.d.ts +6 -0
- package/dist/setup/legacy-client-cleanup.d.ts.map +1 -0
- package/dist/setup/legacy-client-cleanup.js +152 -0
- package/dist/setup/legacy-client-cleanup.js.map +1 -0
- package/dist/setup/managed-text.d.ts.map +1 -1
- package/dist/setup/managed-text.js +11 -1
- package/dist/setup/managed-text.js.map +1 -1
- package/dist/setup/opencode-config.d.ts +2 -1
- package/dist/setup/opencode-config.d.ts.map +1 -1
- package/dist/setup/opencode-config.js +57 -5
- package/dist/setup/opencode-config.js.map +1 -1
- package/dist/setup/render.d.ts +2 -1
- package/dist/setup/render.d.ts.map +1 -1
- package/dist/setup/render.js +91 -17
- package/dist/setup/render.js.map +1 -1
- package/dist/setup/standard-skills.d.ts +16 -2
- package/dist/setup/standard-skills.d.ts.map +1 -1
- package/dist/setup/standard-skills.js +37 -13
- package/dist/setup/standard-skills.js.map +1 -1
- package/dist/setup/strict-json.d.ts +7 -0
- package/dist/setup/strict-json.d.ts.map +1 -0
- package/dist/setup/strict-json.js +98 -0
- package/dist/setup/strict-json.js.map +1 -0
- package/dist/setup/strict-toml.d.ts +7 -0
- package/dist/setup/strict-toml.d.ts.map +1 -0
- package/dist/setup/strict-toml.js +470 -0
- package/dist/setup/strict-toml.js.map +1 -0
- package/dist/skills/cache.d.ts +15 -0
- package/dist/skills/cache.d.ts.map +1 -0
- package/dist/skills/cache.js +19 -0
- package/dist/skills/cache.js.map +1 -0
- package/dist/skills/candidate-ranking.d.ts +15 -0
- package/dist/skills/candidate-ranking.d.ts.map +1 -0
- package/dist/skills/candidate-ranking.js +52 -0
- package/dist/skills/candidate-ranking.js.map +1 -0
- package/dist/skills/chunking.d.ts +11 -0
- package/dist/skills/chunking.d.ts.map +1 -0
- package/dist/skills/chunking.js +291 -0
- package/dist/skills/chunking.js.map +1 -0
- package/dist/skills/config.d.ts +19 -0
- package/dist/skills/config.d.ts.map +1 -0
- package/dist/skills/config.js +103 -0
- package/dist/skills/config.js.map +1 -0
- package/dist/skills/discovery-service.d.ts +26 -0
- package/dist/skills/discovery-service.d.ts.map +1 -0
- package/dist/skills/discovery-service.js +921 -0
- package/dist/skills/discovery-service.js.map +1 -0
- package/dist/skills/external-transport.d.ts +2 -0
- package/dist/skills/external-transport.d.ts.map +1 -0
- package/dist/skills/external-transport.js +30 -0
- package/dist/skills/external-transport.js.map +1 -0
- package/dist/skills/find.d.ts +16 -0
- package/dist/skills/find.d.ts.map +1 -0
- package/dist/skills/find.js +58 -0
- package/dist/skills/find.js.map +1 -0
- package/dist/skills/gap-detection.d.ts +23 -0
- package/dist/skills/gap-detection.d.ts.map +1 -0
- package/dist/skills/gap-detection.js +62 -0
- package/dist/skills/gap-detection.js.map +1 -0
- package/dist/skills/import-preparation.d.ts +4 -0
- package/dist/skills/import-preparation.d.ts.map +1 -0
- package/dist/skills/import-preparation.js +20 -0
- package/dist/skills/import-preparation.js.map +1 -0
- package/dist/skills/materialization-authority.d.ts +11 -0
- package/dist/skills/materialization-authority.d.ts.map +1 -0
- package/dist/skills/materialization-authority.js +92 -0
- package/dist/skills/materialization-authority.js.map +1 -0
- package/dist/skills/materialization-service.d.ts +22 -0
- package/dist/skills/materialization-service.d.ts.map +1 -0
- package/dist/skills/materialization-service.js +101 -0
- package/dist/skills/materialization-service.js.map +1 -0
- package/dist/skills/official-catalog.d.ts +31 -0
- package/dist/skills/official-catalog.d.ts.map +1 -0
- package/dist/skills/official-catalog.js +110 -0
- package/dist/skills/official-catalog.js.map +1 -0
- package/dist/skills/providers/schema.d.ts +30 -0
- package/dist/skills/providers/schema.d.ts.map +1 -0
- package/dist/skills/providers/schema.js +354 -0
- package/dist/skills/providers/schema.js.map +1 -0
- package/dist/skills/providers/skills-sh-compat.d.ts +17 -0
- package/dist/skills/providers/skills-sh-compat.d.ts.map +1 -0
- package/dist/skills/providers/skills-sh-compat.js +71 -0
- package/dist/skills/providers/skills-sh-compat.js.map +1 -0
- package/dist/skills/providers/skills-sh-v1.d.ts +23 -0
- package/dist/skills/providers/skills-sh-v1.d.ts.map +1 -0
- package/dist/skills/providers/skills-sh-v1.js +134 -0
- package/dist/skills/providers/skills-sh-v1.js.map +1 -0
- package/dist/skills/query-builder.d.ts +18 -0
- package/dist/skills/query-builder.d.ts.map +1 -0
- package/dist/skills/query-builder.js +93 -0
- package/dist/skills/query-builder.js.map +1 -0
- package/dist/skills/source/errors.d.ts +9 -0
- package/dist/skills/source/errors.d.ts.map +1 -0
- package/dist/skills/source/errors.js +15 -0
- package/dist/skills/source/errors.js.map +1 -0
- package/dist/skills/source/frontmatter.d.ts +9 -0
- package/dist/skills/source/frontmatter.d.ts.map +1 -0
- package/dist/skills/source/frontmatter.js +77 -0
- package/dist/skills/source/frontmatter.js.map +1 -0
- package/dist/skills/source/github-fetcher.d.ts +20 -0
- package/dist/skills/source/github-fetcher.d.ts.map +1 -0
- package/dist/skills/source/github-fetcher.js +292 -0
- package/dist/skills/source/github-fetcher.js.map +1 -0
- package/dist/skills/source/snapshot-validator.d.ts +28 -0
- package/dist/skills/source/snapshot-validator.d.ts.map +1 -0
- package/dist/skills/source/snapshot-validator.js +186 -0
- package/dist/skills/source/snapshot-validator.js.map +1 -0
- package/dist/skills/store.d.ts +181 -0
- package/dist/skills/store.d.ts.map +1 -0
- package/dist/skills/store.js +1710 -0
- package/dist/skills/store.js.map +1 -0
- package/dist/skills/types.d.ts +169 -0
- package/dist/skills/types.d.ts.map +1 -0
- package/dist/skills/types.js +2 -0
- package/dist/skills/types.js.map +1 -0
- package/dist/web/i18n.d.ts +32 -0
- package/dist/web/i18n.d.ts.map +1 -1
- package/dist/web/i18n.js +128 -0
- package/dist/web/i18n.js.map +1 -1
- package/dist/web/server.d.ts.map +1 -1
- package/dist/web/server.js +386 -38
- package/dist/web/server.js.map +1 -1
- package/dist/web/ui.d.ts +4 -0
- package/dist/web/ui.d.ts.map +1 -1
- package/dist/web/ui.js +382 -6
- package/dist/web/ui.js.map +1 -1
- package/migrations/009_external_skill_discovery.sql +126 -0
- package/package.json +4 -3
- package/skills/kiokuko-single-purpose-functions/SKILL.md +288 -0
- package/skills/kiokuko-single-purpose-functions/references/kiokuko-patterns.md +344 -0
- package/skills/kiokuko-single-purpose-functions/references/review-checklist.md +97 -0
- package/skills/kiokuko-ui-design-soul/SKILL.md +1186 -28
- package/templates/AGENTS.md +8 -7
- package/dist/client/runtime-discovery.d.ts +0 -15
- package/dist/client/runtime-discovery.d.ts.map +0 -1
- package/dist/client/runtime-discovery.js +0 -45
- package/dist/client/runtime-discovery.js.map +0 -1
- package/dist/commands/call.d.ts +0 -7
- package/dist/commands/call.d.ts.map +0 -1
- package/dist/commands/call.js +0 -10
- package/dist/commands/call.js.map +0 -1
- package/dist/commands/link.d.ts +0 -6
- package/dist/commands/link.d.ts.map +0 -1
- package/dist/commands/link.js +0 -6
- package/dist/commands/link.js.map +0 -1
- package/dist/commands/promote.d.ts +0 -6
- package/dist/commands/promote.d.ts.map +0 -1
- package/dist/commands/promote.js +0 -6
- package/dist/commands/promote.js.map +0 -1
- package/dist/commands/read.d.ts +0 -6
- package/dist/commands/read.d.ts.map +0 -1
- package/dist/commands/read.js +0 -4
- package/dist/commands/read.js.map +0 -1
- package/dist/commands/recall.d.ts +0 -6
- package/dist/commands/recall.d.ts.map +0 -1
- package/dist/commands/recall.js +0 -4
- package/dist/commands/recall.js.map +0 -1
- package/dist/commands/record.d.ts +0 -6
- package/dist/commands/record.d.ts.map +0 -1
- package/dist/commands/record.js +0 -4
- package/dist/commands/record.js.map +0 -1
- package/dist/commands/search.d.ts +0 -6
- package/dist/commands/search.d.ts.map +0 -1
- package/dist/commands/search.js +0 -4
- package/dist/commands/search.js.map +0 -1
- package/dist/commands/supersede.d.ts +0 -6
- package/dist/commands/supersede.d.ts.map +0 -1
- package/dist/commands/supersede.js +0 -6
- package/dist/commands/supersede.js.map +0 -1
- package/dist/knowledge/sources.d.ts +0 -72
- package/dist/knowledge/sources.d.ts.map +0 -1
- package/dist/knowledge/sources.js +0 -388
- package/dist/knowledge/sources.js.map +0 -1
- package/dist/setup/opencode-evidence.d.ts +0 -37
- package/dist/setup/opencode-evidence.d.ts.map +0 -1
- package/dist/setup/opencode-evidence.js +0 -58
- package/dist/setup/opencode-evidence.js.map +0 -1
- package/dist/setup/opencode-loop-guard.d.ts +0 -9
- package/dist/setup/opencode-loop-guard.d.ts.map +0 -1
- package/dist/setup/opencode-loop-guard.js +0 -248
- package/dist/setup/opencode-loop-guard.js.map +0 -1
package/README.zh-CN.md
CHANGED
|
@@ -1,150 +1,136 @@
|
|
|
1
|
-
# Kiokuko
|
|
1
|
+
# Kiokuko(记忆库)
|
|
2
2
|
|
|
3
3
|
[English](README.md) | [日本語](README.ja.md) | 简体中文 | [한국어](README.ko.md)
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
**通过 MCP 连接、用 RAG 回忆,并在工作后保存记忆。**
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Kiokuko 是面向 AI 编程智能体的外部记忆。
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
它会将过去工作中获得的知识保存到本地 SQLite,并在下一次请求中仅检索相关记忆传递给 AI。
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
npm install --global @askdkc/kiokuko
|
|
13
|
-
kiokuko setup
|
|
14
|
-
```
|
|
11
|
+
用户无需每次都在提示词中粘贴过去的背景,也无需手动查找记忆。只需像平常一样使用 AI,项目特有的知识就会逐步积累,并在下一次工作中复用。
|
|
15
12
|
|
|
16
|
-
|
|
13
|
+
## 快速开始
|
|
17
14
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
设置完成后,请重启 setup 结果中显示的客户端。Hermes 的 `/reload-mcp` 可以重新加载 MCP 注册,但更新后的标准技能仍需要重启或新会话才能发现;可用 `hermes mcp test kiokuko` 做 smoke test。Hermes 使用有效 profile 中的原生 stdio MCP;Kiokuko 不会创建全局指令文件、Hermes plugin 或 hook。
|
|
21
|
-
|
|
22
|
-
`setup` 是显式且幂等的操作。npm 的 `postinstall` 永远不会修改 AI 客户端配置。现有 TOML/JSON/JSONC/YAML 设置、注释、指令内容、换行符和文件权限都会保留;Kiokuko 只管理自己的区块。默认情况下,setup 还会从固定的本地清单安装 `kiokuko-ui-design-soul` 标准技能,不会在 setup 时下载或抓取 HIG 页面。
|
|
23
|
-
|
|
24
|
-
如果现有数据库存在尚未应用的迁移,setup 会先在当前用户数据目录下的 `backups/` 中创建备份并执行完整性检查。由更新版本 Kiokuko 写入的数据库会被拒绝,且不会受到修改。
|
|
15
|
+
需要 Node.js 24.16 或更高版本。
|
|
16
|
+
使用以下两条命令即可轻松开始 💕
|
|
25
17
|
|
|
26
18
|
```bash
|
|
27
|
-
|
|
28
|
-
kiokuko setup
|
|
29
|
-
|
|
30
|
-
# 只配置一个客户端
|
|
31
|
-
kiokuko setup --clients codex
|
|
32
|
-
kiokuko setup --clients opencode
|
|
33
|
-
kiokuko setup --clients claude
|
|
34
|
-
kiokuko setup --clients hermes
|
|
35
|
-
|
|
36
|
-
# 如果客户端进程未继承 npm 的 PATH,请使用可执行文件绝对路径
|
|
37
|
-
kiokuko setup --command /absolute/path/to/kiokuko
|
|
38
|
-
|
|
39
|
-
# 跳过新的标准技能放置;不会删除已安装的副本
|
|
40
|
-
kiokuko setup --no-standard-skills
|
|
19
|
+
npm install --global @askdkc/kiokuko
|
|
20
|
+
kiokuko setup
|
|
41
21
|
```
|
|
42
22
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
23
|
+
`setup` 会检测已安装的受支持客户端,并自动配置 SQLite 数据库和 MCP 连接。
|
|
24
|
+
交互式setup会询问是否也将已审计的community技能用作参考资料,默认选择“否”。
|
|
25
|
+
面向模型的记忆只能通过带 capability gate 的 MCP 工具 `task_prepare` 和
|
|
26
|
+
`task_answer` 进入任务。Kiokuko 不会安装在这些调用之前静默检索记忆的客户端
|
|
27
|
+
Hook 或插件。
|
|
28
|
+
|
|
29
|
+
设置完成后,启动目标 AI 客户端即可像平时一样使用。如果客户端已经启动,请先退出,再重新启动。
|
|
30
|
+
|
|
31
|
+
支持的客户端:
|
|
32
|
+
|
|
33
|
+
- Codex
|
|
34
|
+
- OpenCode
|
|
35
|
+
- Claude Code
|
|
36
|
+
- Hermes Agent
|
|
37
|
+
|
|
38
|
+
## 越用越聪明的机制
|
|
39
|
+
|
|
40
|
+
```text
|
|
41
|
+
用户的请求
|
|
42
|
+
↓
|
|
43
|
+
搜索相关的过去记忆
|
|
44
|
+
↓
|
|
45
|
+
AI 参考这些记忆开展工作
|
|
46
|
+
↓
|
|
47
|
+
保存可复用的成果或经验
|
|
48
|
+
↓
|
|
49
|
+
在下一次请求中再次搜索
|
|
47
50
|
```
|
|
48
51
|
|
|
49
|
-
|
|
52
|
+
Kiokuko 会重复以下流程。
|
|
50
53
|
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
设置目标如下:
|
|
54
|
+
1. 工作前,搜索当前项目和 Global 记忆
|
|
55
|
+
2. 仅将相关性高的记忆传递给 AI
|
|
56
|
+
3. AI 执行工作
|
|
57
|
+
4. 工作后,保存可复用的知识作为记忆
|
|
58
|
+
5. 在下一次工作中复用这些记忆
|
|
58
59
|
|
|
59
|
-
|
|
60
|
-
|---|---|---|---|---|
|
|
61
|
-
| Codex | `$CODEX_HOME/config.toml` 或 `~/.codex/config.toml` | `$CODEX_HOME/AGENTS.md` 或 `~/.codex/AGENTS.md` | — | `~/.agents/skills/kiokuko-ui-design-soul` |
|
|
62
|
-
| OpenCode | `$XDG_CONFIG_HOME/opencode/opencode.json` 或 `~/.config/opencode/opencode.json` | 同目录下的 `AGENTS.md` | `plugins/kiokuko-loop-guard.js` | 全局配置中的 `skills/kiokuko-ui-design-soul` |
|
|
63
|
-
| Claude Code | `$CLAUDE_CONFIG_DIR/.claude.json` 或 `~/.claude.json` | `$CLAUDE_CONFIG_DIR/CLAUDE.md` 或 `~/.claude/CLAUDE.md` | — | Claude 配置中的 `skills/kiokuko-ui-design-soul` |
|
|
64
|
-
| Hermes Agent | 有效 profile 的 `config.yaml`(`$HERMES_HOME`、`$HOME/.hermes` 或 `%LOCALAPPDATA%/hermes`) | 无 | 无 | 有效 profile 中的 `skills/kiokuko-ui-design-soul` |
|
|
60
|
+
也就是说,Kiokuko 是一个**不断积累持久记忆的 RAG 系统**。
|
|
65
61
|
|
|
66
|
-
|
|
62
|
+
MCP 将 AI 客户端与 Kiokuko 连接起来,RAG 则检索所需记忆并传递给 AI。
|
|
67
63
|
|
|
68
|
-
|
|
64
|
+
## 记忆按项目分离
|
|
69
65
|
|
|
70
|
-
|
|
66
|
+
普通搜索不会混入无关项目的记忆。
|
|
71
67
|
|
|
72
|
-
|
|
68
|
+
- **Project 记忆**
|
|
69
|
+
仅在当前仓库中使用的知识
|
|
73
70
|
|
|
74
|
-
|
|
71
|
+
- **Global 记忆**
|
|
72
|
+
可在多个项目中复用的知识,例如语言、框架、数据库和工具
|
|
75
73
|
|
|
76
|
-
|
|
77
|
-
- `global` 记忆仅用于真正跨项目适用的偏好和经验。
|
|
78
|
-
- 默认的 `auto` recall 只返回当前项目与 global 记忆。
|
|
79
|
-
- 没有 remote 的仓库会获得由路径派生的稳定标识。自动解析时,Kiokuko 不会向仓库写入任何文件。
|
|
74
|
+
项目会根据 Git remote 或路径自动判断。
|
|
80
75
|
|
|
81
|
-
|
|
76
|
+
如果要将 Project 记忆迁移到 Global 记忆,请通过 Curator 确认候选项并明确批准。
|
|
82
77
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
- `memory_checkpoint`:在用户请求结束时仅执行一次,将有界的持久性条目保存为 `candidate` 和 `untrusted`;疑似密钥的内容会被拒绝。
|
|
78
|
+
```bash
|
|
79
|
+
kiokuko curator
|
|
80
|
+
```
|
|
87
81
|
|
|
88
|
-
|
|
82
|
+
## 查看记忆
|
|
89
83
|
|
|
90
|
-
|
|
84
|
+
通过本地 Web UI,可以搜索、查看和编辑已保存的记忆。
|
|
91
85
|
|
|
92
86
|
```bash
|
|
93
|
-
|
|
94
|
-
npm run typecheck
|
|
95
|
-
npm test
|
|
96
|
-
npm run build
|
|
97
|
-
npm pack --dry-run
|
|
87
|
+
kiokuko web
|
|
98
88
|
```
|
|
99
89
|
|
|
100
|
-
|
|
90
|
+
请在浏览器中打开以下地址。
|
|
101
91
|
|
|
102
|
-
```
|
|
103
|
-
|
|
104
|
-
npm exec -- tsx src/bin/kiokuko.ts mcp
|
|
92
|
+
```text
|
|
93
|
+
http://127.0.0.1:4173
|
|
105
94
|
```
|
|
106
95
|
|
|
107
|
-
|
|
96
|
+
Web UI 仅在本地环境运行,不会暴露到外部网络。
|
|
97
|
+
Web UI 和显式 memory CLI 命令是供人类/operator使用的管理界面,不是模型绕过
|
|
98
|
+
`task_prepare` / `task_answer` 获取任务记忆的路径。
|
|
108
99
|
|
|
109
|
-
##
|
|
100
|
+
## 外部技能
|
|
110
101
|
|
|
111
|
-
|
|
102
|
+
外部技能发现仅用于参考数据,Akinator任务准备默认使用 `official` 模式。Kiokuko会
|
|
103
|
+
验证当前GitHub提交,将有界内容保存为不可信候选记忆,并且不会自动安装或执行。
|
|
104
|
+
如需关闭自动发现,请设置 `KIOKUKO_SKILL_DISCOVERY=off`;`community` 仍须明确启用。
|
|
105
|
+
交互式 `kiokuko setup` 会询问是否启用;批处理可使用 `--skill-discovery community`。
|
|
112
106
|
|
|
113
|
-
|
|
107
|
+
命令示例:
|
|
114
108
|
|
|
115
109
|
```bash
|
|
116
|
-
kiokuko
|
|
117
|
-
|
|
118
|
-
kiokuko
|
|
119
|
-
|
|
120
|
-
kiokuko guide answer <session-id> --workspace <workspace> \
|
|
121
|
-
--question-id expected --value "All tests pass" --json
|
|
122
|
-
kiokuko guide context <session-id> --workspace <workspace> --json
|
|
110
|
+
kiokuko skills find svelte --official-only --json
|
|
111
|
+
kiokuko skills list
|
|
112
|
+
kiokuko skills disable sveltejs/ai-tools/svelte-code-writer
|
|
113
|
+
kiokuko skills refresh sveltejs/ai-tools/svelte-code-writer
|
|
123
114
|
```
|
|
124
115
|
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
- https://github.com/mattpocock/skills
|
|
116
|
+
Web UI的外部技能页面可查看来源状态并禁用或重新启用导入映射;其中没有安装、脚本
|
|
117
|
+
执行或MCP注册操作。
|
|
128
118
|
|
|
129
|
-
|
|
119
|
+
## 安全性
|
|
130
120
|
|
|
131
|
-
|
|
121
|
+
Kiokuko 不会保存完整对话。
|
|
132
122
|
|
|
133
|
-
|
|
123
|
+
对于密码、API 密钥、令牌、私钥等看起来像机密的内容,会拒绝保存。
|
|
134
124
|
|
|
135
|
-
|
|
125
|
+
保存的记忆始终作为参考信息处理。当前代码、配置和执行结果优先于过去的记忆。
|
|
136
126
|
|
|
137
|
-
|
|
138
|
-
kiokuko web
|
|
139
|
-
# 打开 http://127.0.0.1:4173
|
|
140
|
-
```
|
|
141
|
-
|
|
142
|
-
UI支持英语、日语、简体中文和韩语。首次使用时采用浏览器语言,明确选择的语言会保存在浏览器中;也可以使用`?lang=en`、`?lang=ja`、`?lang=zh-CN`或`?lang=ko`覆盖。
|
|
127
|
+
## 注意
|
|
143
128
|
|
|
144
|
-
|
|
129
|
+
Kiokuko 不是拦截提示词的机制。由于自动使用依赖于各 AI 客户端和模型对 MCP 的调用,因此不保证每一轮都会调用。
|
|
145
130
|
|
|
146
|
-
|
|
131
|
+
详细命令请查看以下内容。
|
|
147
132
|
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
133
|
+
```bash
|
|
134
|
+
kiokuko --help
|
|
135
|
+
kiokuko setup --help
|
|
136
|
+
```
|
|
@@ -1,6 +1,93 @@
|
|
|
1
|
-
|
|
1
|
+
import { chmod, type FileHandle } from 'node:fs/promises';
|
|
2
|
+
export interface FileIdentity {
|
|
3
|
+
device: bigint;
|
|
4
|
+
inode: bigint;
|
|
5
|
+
}
|
|
6
|
+
export interface RegularFileSnapshot {
|
|
2
7
|
content: string;
|
|
3
8
|
mode: number;
|
|
4
|
-
|
|
5
|
-
|
|
9
|
+
identity: FileIdentity;
|
|
10
|
+
}
|
|
11
|
+
export interface FileExpectation {
|
|
12
|
+
expected: RegularFileSnapshot | undefined;
|
|
13
|
+
/** Paths whose absence is part of the same decision (for example an alternate config path). */
|
|
14
|
+
mustRemainAbsent?: readonly string[];
|
|
15
|
+
/** Reject every symbolic-link component below this already-resolved root. */
|
|
16
|
+
containmentRoot?: string;
|
|
17
|
+
/** When present, the parent must preexist and retain this exact directory identity. */
|
|
18
|
+
expectedParentDirectory?: FileIdentity;
|
|
19
|
+
}
|
|
20
|
+
export declare class AtomicCleanupFailure extends Error {
|
|
21
|
+
/** Exact pathname of the owned artifact, when its full binding was proven after the failure. */
|
|
22
|
+
readonly artifactPath: string | undefined;
|
|
23
|
+
constructor(
|
|
24
|
+
/** Exact pathname of the owned artifact, when its full binding was proven after the failure. */
|
|
25
|
+
artifactPath: string | undefined, options: {
|
|
26
|
+
cause: unknown;
|
|
27
|
+
});
|
|
28
|
+
}
|
|
29
|
+
export interface AtomicWriteResult {
|
|
30
|
+
installed: RegularFileSnapshot;
|
|
31
|
+
cleanupFailures: readonly AtomicCleanupFailure[];
|
|
32
|
+
}
|
|
33
|
+
export interface AtomicUnlinkResult {
|
|
34
|
+
cleanupFailures: readonly AtomicCleanupFailure[];
|
|
35
|
+
}
|
|
36
|
+
export declare class AtomicCommittedMutationError extends AggregateError {
|
|
37
|
+
readonly outcome: AtomicWriteResult;
|
|
38
|
+
readonly operationError: unknown;
|
|
39
|
+
constructor(outcome: AtomicWriteResult, operationError: unknown);
|
|
40
|
+
}
|
|
41
|
+
export declare class AtomicCommittedUnlinkError extends AggregateError {
|
|
42
|
+
readonly outcome: AtomicUnlinkResult;
|
|
43
|
+
readonly operationError: unknown;
|
|
44
|
+
constructor(outcome: AtomicUnlinkResult, operationError: unknown);
|
|
45
|
+
}
|
|
46
|
+
export declare function assertAtomicCleanupComplete(result: Pick<AtomicWriteResult | AtomicUnlinkResult, 'cleanupFailures'>): void;
|
|
47
|
+
export interface AtomicWriteDependencies {
|
|
48
|
+
chmod?: typeof chmod;
|
|
49
|
+
beforeLink?: (source: string, destination: string) => void | Promise<void>;
|
|
50
|
+
afterLink?: (source: string, destination: string) => void | Promise<void>;
|
|
51
|
+
beforeRename?: (source: string, destination: string) => void | Promise<void>;
|
|
52
|
+
afterRename?: (source: string, destination: string) => void | Promise<void>;
|
|
53
|
+
beforeCleanup?: (artifactPath: string) => void | Promise<void>;
|
|
54
|
+
beforeCommit?: (filePath: string) => void | Promise<void>;
|
|
55
|
+
afterQuarantine?: (filePath: string) => void | Promise<void>;
|
|
56
|
+
afterInstall?: (filePath: string) => void | Promise<void>;
|
|
57
|
+
}
|
|
58
|
+
export interface ReadRegularFileDependencies {
|
|
59
|
+
/** Test seam for proving that reads remain bound to the opened descriptor. */
|
|
60
|
+
afterOpen?: (filePath: string, handle: FileHandle) => void | Promise<void>;
|
|
61
|
+
/** Test seam for preserving an operation failure when descriptor close also fails. */
|
|
62
|
+
closeHandle?: (handle: FileHandle) => Promise<void>;
|
|
63
|
+
/** Test seam for exercising the Windows no-O_NOFOLLOW strategy on any host. */
|
|
64
|
+
platform?: NodeJS.Platform;
|
|
65
|
+
}
|
|
66
|
+
export interface ConditionalUnlinkDependencies {
|
|
67
|
+
beforeRename?: (source: string, destination: string) => void | Promise<void>;
|
|
68
|
+
afterRename?: (source: string, destination: string) => void | Promise<void>;
|
|
69
|
+
beforeCleanup?: (artifactPath: string) => void | Promise<void>;
|
|
70
|
+
beforeCommit?: (filePath: string) => void | Promise<void>;
|
|
71
|
+
}
|
|
72
|
+
export declare function readRegularFile(filePath: string, dependencies?: ReadRegularFileDependencies & {
|
|
73
|
+
containmentRoot?: string;
|
|
74
|
+
}): Promise<RegularFileSnapshot | undefined>;
|
|
75
|
+
/** Read an exact directory identity without following its final path component. */
|
|
76
|
+
export declare function readDirectoryIdentity(directoryPath: string): Promise<FileIdentity | undefined>;
|
|
77
|
+
export interface PendingAtomicMutation {
|
|
78
|
+
kind: 'deleted' | 'previous' | 'rollback';
|
|
79
|
+
snapshot: RegularFileSnapshot;
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Bind a native atomic-write quarantine for this exact basename without
|
|
83
|
+
* following path components. Its snapshot may constrain convergence, but it
|
|
84
|
+
* never grants the caller ownership of the artifact.
|
|
85
|
+
*/
|
|
86
|
+
export declare function readPendingAtomicMutation(filePath: string, expectedParentDirectory: FileIdentity, containmentRoot?: string): Promise<PendingAtomicMutation | undefined>;
|
|
87
|
+
export declare function assertFileExpectation(filePath: string, expectation: FileExpectation): Promise<void>;
|
|
88
|
+
export declare function atomicWriteText(filePath: string, content: string, mode?: number, dependencyOverrides?: AtomicWriteDependencies): Promise<AtomicWriteResult>;
|
|
89
|
+
/** Write only when the target is still the exact file observed at planning time. */
|
|
90
|
+
export declare function atomicWriteTextIfUnchanged(filePath: string, content: string, expectation: FileExpectation, mode?: number, dependencyOverrides?: AtomicWriteDependencies): Promise<AtomicWriteResult>;
|
|
91
|
+
/** Delete only when the target is still the exact planned file identity and content. */
|
|
92
|
+
export declare function unlinkRegularFileIfUnchanged(filePath: string, expectation: FileExpectation, dependencyOverrides?: ConditionalUnlinkDependencies): Promise<AtomicUnlinkResult>;
|
|
6
93
|
//# sourceMappingURL=atomic-write.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../src/agent-file/atomic-write.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../src/agent-file/atomic-write.ts"],"names":[],"mappings":"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"}
|