Pengembangan dan Rilis Plugin SDK

Pengembangan, verifikasi, alat rilis, dan alur kerja 1.2, cache inkremental, alat eksternal, serta bridge LSP publik.

Panduan pengembangan, verifikasi, dan rilis DDS Plugin SDK 1.2.0. Audit keamanan dan validasi kerentanan masih tertunda; status API stabil dan pemeriksaan fungsional tidak merupakan penerimaan keamanan.

Panduan pemasangan SDK dan API

Template pengembangan dan pembuatan

Pilih command, language, theme, job, browser, atau configuration. init --dry-run melaporkan tujuan, inventaris berkas, hash, dan konflik tanpa menulis atau memasang. init biasa memerlukan direktori nyata yang baru. Setiap template menyertakan sumber, manifes, pengungkapan, lisensi/notice, pengujian, konsumen bertipe, dan contoh yang dapat dieksekusi. Template browser dan configuration menyertakan demo loopback. Dependensi yang dihasilkan mematok arsip GitHub yang tepat.

npx --no-install dds-plugin init example-plugin --template configuration --dry-run
npx --no-install dds-plugin init example-plugin --template configuration
cd example-plugin
npm install --ignore-scripts
npm run doctor
npm test
npm run typecheck
npm run example
npm run browser

dds-dev.json adalah data JSON terbatas untuk skema perintah, pengaturan, katalog locale, dan data tema. generate menghasilkan JSON runtime, ekspor ESM, tipe masukan TypeScript mentah/tervalidasi, tipe keluaran/pengaturan, JSON Schema, dan XML tema. Default JSON Schema merupakan anotasi; hanya validasi masukan SDK yang menerapkan default. Pembuatan tidak mengimpor plugin Anda. doctor memeriksa penyimpangan, metadata, modul yang hilang, dan apakah berkas runtime yang dihasilkan disertakan dalam allowlist paket.

npx --no-install dds-plugin generate . --check
npx --no-install dds-plugin generate . --dry-run
# Review the new files, then use the previous digest from the report:
npx --no-install dds-plugin generate . --expected-digest <previous-digest>

Penggantian memerlukan digest sebelumnya yang tepat dan byte hasil pembuatan yang tidak berubah. Suntingan manual, berkas tambahan, tautan, dan lock usang menghentikan penggantian. Kegagalan hanya menghapus entri tidak berubah yang dimiliki percobaan tersebut dan mempertahankan entri yang diubah atau tidak pasti untuk pemeriksaan. Batas berkas adalah 256, masing-masing 1 MiB dan total 4 MiB. Lock mengoordinasikan generator yang kooperatif; lock bukan perlindungan terhadap penulis sistem berkas bersamaan yang berbahaya atau transaksi atomik lintas direktori. Template proprieter memerlukan ketentuan yang diberikan pemanggil dan mempertahankan berkas lisensi/notice SDK yang diwarisi.

Pengujian deterministik dan replay

createScenarioHost dari /testing secara eksplisit memasang fixture berkas dalam memori, backend, pengaturan, rahasia, dan job yang dipilih. Awalnya tidak ada pemberian akses atau kemampuan. createTestClock menyediakan ID ber-seed, waktu, dan timer tanpa mengubah global; timer dengan waktu sama mempertahankan urutan penyisipan. Tunggu penyelesaian pemajuan clock untuk membuka penantian virtual. UUID yang dihasilkan adalah data uji, bukan entropi kriptografis. Default createTestHost yang sudah ada tetap kompatibel.

import {createScenarioHost} from '@altifigence/dds-plugin-sdk/testing';
const scenario = createScenarioHost({seed: 7, start: 1000,
  files: {'example.txt': 'synthetic'}, grants: ['workspace.read'],
});
try {
  // Activate your explicitly imported test plugin on scenario.host.
  scenario.faults.enqueue({operation: 'file.read', kind: 'delay', delayMs: 25});
  // Start its command, then await scenario.clock.advance(25).
} finally {
  await scenario.dispose();
  scenario.assertClean();
}

Port gangguan memodelkan penundaan, penolakan, putus koneksi, korupsi, kehabisan sumber daya, dan panggilan yang hilang; fixture peristiwa dapat dihilangkan, diduplikasi, atau dibalik urutannya tanpa mengulangi efek eksternal. replaceGrants menonaktifkan plugin yang kehilangan kewenangan. Snapshot job memori memvalidasi identitas, revisi, dan hash serta memodelkan pemulihan yang terputus tanpa eksekusi otomatis. Fixture ini tidak meniru durabilitas sistem berkas atau menemukan handle sistem operasi. Buku besar pemilik terpisah melacak sumber daya yang didaftarkan secara eksplisit. Teardown mempertahankan hitungan tertunda untuk callback yang mengabaikan pembatalan sampai benar-benar selesai. Pemeriksaan pengaturan kini dapat dibaca setelah disposal; pembacaan data tetap ditolak.

Perekaman memerlukan synthetic: true dan inventaris fixture terbatas yang eksplisit. Trace yang diekspor hanya memuat jenis operasi, ID fixture, timing, seed/versi, dan hash berantai. Gunakan ID yang tidak sensitif; hash tidak menganonimkan data yang dapat ditebak dan SDK tidak dapat mengklasifikasikan masukan sembarang sebagai sintetis. Replay murni memeriksa urutan, hash, dan identitas fixture serta mengembalikan keluaran fixture yang dipilih; replay tidak menerima callback efek. Batas mencakup 64 fixture, 1.024 peristiwa, dan trace 1 MiB. Jalankan contoh development-tools dalam paket untuk pemeriksaan gangguan, pemulihan, privasi, dan pembersihan.

Diagnostik lokal dan debugging

import {createDiagnosticSession, profileHost}
  from '@altifigence/dds-plugin-sdk/diagnostics';
const session = createDiagnosticSession({enabled: true, sampleEvery: 10});
const measured = profileHost(host, session);
try {
  await measured.executeCommand('example', 'run', {});
} finally {
  measured.dispose();
  console.log(session.snapshot());
  session.dispose();
}

Diagnostik secara default dinonaktifkan dan hanya bersifat lokal. Laporan memuat kode operasi/status/kesalahan tetap, ID korelasi, durasi, dan jumlah sumber daya; tidak ada API untuk isi dokumen, jalur, masukan, isi keluaran, atau teks pengecualian sembarang. Jumlah byte, kedalaman antrean, dan angka memori adalah estimasi pemilik yang eksplisit. profileTransport mengukur sampai panggilan yang dibungkus selesai, yang untuk fetch berarti header respons, bukan penyelesaian isi. Catatan selesai menggunakan ring terbatas dan kedaluwarsa pasif; tidak ada timer latar belakang diagnostik atau unggahan. Default adalah 128 peristiwa/60 detik; maksimum 256 peristiwa/5 menit, 64 span yang sedang berlangsung, dan 256 KiB per laporan.

npx --no-install dds-plugin dev . --trust-local-code --profile --command greet --input '{"name":"Ada"}'
npx --no-install dds-plugin dev . --trust-local-code --debug --debug-wait --timeout-ms 30000 --command greet --input '{"name":"Ada"}'

Mode debug hanya menyediakan inspector 127.0.0.1 sementara dalam proses anak yang dimiliki. --debug-wait menjeda sebelum mengimpor plugin dan memerlukan --debug. Anggaran waktu run total termasuk waktu menunggu debugger dan paling lama 30 detik. Penyelesaian, pembatalan, dan timeout menghentikan anak yang dimiliki serta inspector. Profiling dan debugging sama-sama memerlukan kepercayaan eksplisit pada kode lokal; keduanya bukan sandbox. Crash atau penghentian paksa dapat menyebabkan laporan profil tidak tercatat, dan stdout/stderr mentah plugin tetap merupakan stream terbatas terpisah yang tidak otomatis disunting untuk menghapus data sensitif.

Alat pengembangan · Pengujian · Diagnostik · Kompatibilitas

Kesesuaian host

Modul /conformance menjalankan probe sintetis berversi terhadap adapter host, pengaturan, ruang kerja, lokalisasi, pengujian, diagnostik, dan pengembangan yang Anda berikan secara eksplisit. Modul ini membedakan profil didukung, tidak didukung, dan gagal serta menyertakan host/versi/runtime/platform, ID pemeriksaan, timing, dan pembersihan. Fitur yang dideklarasikan dengan adapter hilang atau rusak akan gagal; fitur opsional yang tidak dikenal dicatat tanpa probe. Perintah, izin, dan pembatalan diperlukan secara default.

import {runConformance, formatConformanceReport}
  from '@altifigence/dds-plugin-sdk/conformance';
import {createPluginHost} from '@altifigence/dds-plugin-sdk';
const report = await runConformance({
  identity: {host: 'My host', version: '1.0.0', runtime: 'Node 24', platform: 'linux-x64'},
  features: ['commands', 'permissions', 'cancellation'],
  adapters: {host: options => createPluginHost(options)},
});
console.log(formatConformanceReport(report));

Ganti factory host dengan adapter Anda dan jalankan pula pengujian plugin Anda. Helper Node /conformance-node hanya membuat fixture sementara baru dan server loopback sementara. Contoh browser menjalankan profil browser yang tersedia dan melaporkan fitur Node yang tidak ada sebagai tidak didukung. Probe cepat mengambil sampel kontrak; contoh tertaut dan pengujian rilis mencakup jalur bahasa, pemulihan, dan penyimpanan yang lebih besar. Laporan adalah bukti pengujian, bukan sertifikat kepercayaan.

Tenggat default adalah 10 detik per kasus, maksimum 30 detik. Timeout atau pembatalan menghentikan kasus berikutnya; kegagalan pembersihan menggagalkan kasus, dan pembersihan tertunda tetap belum terverifikasi. Adapter tepercaya dalam proses dapat memblokir secara sinkron dan mempertahankan kewenangan yang tersedia di lingkungannya. Laporan mengecualikan isi kesalahan penyedia, payload, token, dan jalur; pilih label identitas yang tidak sensitif. Tidak ada laporan yang diunggah otomatis.

Dukungan dan migrasi SDK

API_SUPPORT.json mencantumkan setiap modul yang diekspor, nama runtime, deklarasi, digest deklarasi, lingkungan, dan stabilitas. API 1.x stabil mengikuti versioning semantik: penambahan kompatibel menggunakan rilis minor dan perubahan stabil yang tidak kompatibel memerlukan major baru. artifact-resume-browser tetap eksperimental dan memerlukan versi SDK/browser yang tepat dengan penerimaan browser baru. Penelusuran kemampuan opsional dan izin saat ini tetap diperlukan.

Kebijakan lini stabil berlaku sejak 1.0.0. Minor stabil terbaru menerima perbaikan biasa; minor sebelumnya tetap memenuhi syarat untuk perbaikan keamanan kritis selama 90 hari dalam runtime yang didukung. Tidak ada API stabil yang ditandai usang pada 1.0.0. Penghentian diumumkan setidaknya dua rilis minor dan enam bulan sebelum penghapusan pada versi major. RC dan preview digantikan. Kebijakan sumber terbuka ini tidak menjanjikan waktu respons komersial.

Penerimaan server dan CLI mencakup Windows/Linux dengan Node 22 atau 24 yang telah dipatch, serta deklarasi dengan TypeScript 5.9.3. Dukungan Node 22 berakhir 2027-04-30 dan Node 24 berakhir 2028-04-30. Tanda terima rilis mengidentifikasi versi patch yang tepat, citra OS, dan build browser. Runtime lain dan kombinasi browser/penyimpanan memerlukan penerimaan masing-masing. Dependensi npm runtime SDK tetap kosong.

Plugin 1.0 stabil menggunakan >=1.0.0 <2.0.0; naikkan versi minimum saat memakai API yang lebih baru. Paket RC1 mempertahankan peer 1.0.0-rc.1 yang tepat. Validasi ulang dan terbitkan versi plugin baru untuk mengubahnya; pertahankan arsip sebelumnya agar tidak berubah. Arsip lama adalah masukan interoperabilitas, bukan lini yang dipelihara. Setelah restart, buat koneksi baru dan pemberian akses terkini; pemulihan membaca status yang telah di-commit tanpa menjalankan ulang pekerjaan.

Penerimaan rilis

Audit keamanan dan validasi kerentanan masih tertunda berdasarkan penundaan pemilik pada 2026-10-05. Hasil fungsional, kompatibilitas, dan performa tidak merupakan penerimaan keamanan. Peninjauan yang dipertahankan akan dilanjutkan secara terpisah; rilis ini tidak boleh disebut telah lulus audit tersebut.

Fixture gabungan secara bersamaan menguji bahasa/pengaturan, suntingan yang ditinjau, job perintah, pemantauan proyek, unggah/unduh, dan penyimpanan yang dipertahankan. Fixture memeriksa interupsi, respons dengan format salah, pencabutan, perubahan generasi, pemulihan, dan pembersihan sumber daya. Pengujian sistem berkas/proses terpisah mencakup anak yang dihentikan paksa, korupsi, penulisan gagal, kedaluwarsa, dan pembatalan yang diabaikan. Laporan penerimaan RC menautkan perintah yang dapat direproduksi dan batas setiap hasil.

Performa mencatat lima sampel proses baru per profil Windows/Linux dan Node 22/24, termasuk median/sebaran, waktu CPU, memori tersampel, timing impor/startup/watch, dan hitungan payload disk/HTTP logis. Ambang dasar berasal dari sampel terukur tersebut dan merupakan penjaga regresi kasar, bukan SLA latensi. Angka ini tidak mengukur lalu lintas disk fisik atau menjamin setiap handle sistem operasi ditemukan.

npm ci --ignore-scripts
npm run check
npm run example:conformance -- --json
npm run example:combined -- --faults
npm run benchmark:combined
npm run example:conformance-browser

Kesesuaian · Inventaris API · Kebijakan dukungan · Penerimaan RC

Isi rilis stabil 1.0

Paket 1.0 asli mencakup 38 ekspor dan 86 skema dengan deklarasi, contoh, LICENSE, dan NOTICE. 1.1 menambahkan alat rilis di bawah; 1.2 menambahkan bagian alur kerja/cache/alat/LSP di bawah. Tanda terima rilis membedakan sumber/CI/digest yang tepat, konsumen baru, dan bukti browser yang digunakan kembali.

Untuk downgrade, hentikan pekerjaan yang dimiliki dan secara eksplisit pilih arsip SDK/plugin kompatibel yang dipertahankan serta ekspor konfigurasi. Tinjau pemberian akses terkini dan buat koneksi baru. Pemulihan hasil hanya berupa pembacaan kembali; efek eksternal dan pengaturan tidak kompatibel tidak otomatis dibatalkan. Uji format dan fitur opsional yang benar-benar digunakan.

Isi rilis, migrasi, dan dukungan

Bundel luring dan SBOM

SDK 1.1 menambahkan lima titik masuk opsional khusus Node: /bundles, /provenance, /updates, /updates-node, dan /upstream. Paket memuat 43 ekspor, 96 skema, deklarasi, dan contoh yang dapat dijalankan tanpa dependensi npm runtime. API 1.0 yang sudah ada dan arsip DDS .tgz tanpa tanda tangan tetap kompatibel.

lockBundleDependency mengunci pohon berkas ESM/CommonJS yang ditinjau pada versi yang tepat, sumber HTTPS, digest berkas kanonis, peta dependensi, LICENSE/NOTICE, dan keputusan redistribusi eksplisit. Digest menjelaskan pohon yang ditinjau; digest bukan hash arsip upstream. createPluginBundle menyematkan arsip plugin DDS asli dan metadata rilis, graf dependensi asiklik satu versi, serta SBOM CycloneDX 1.6 deterministik.

verifyPluginBundle memeriksa snapshot byte terbatas yang tepat. installPluginBundle memerlukan expectedSha256-nya, approved: true, dan direktori baru di bawah induk yang dimiliki operator. Operasi ini tidak menjalankan npm, skrip siklus hidup, unduhan, atau kode plugin. Dependensi tidak mewarisi pemberian akses baru. SDK host adalah dependensi terpisah. Addon native, export map, dan resolusi dependensi npm sembarang berada di luar format ini.

Batas: 32 paket dependensi, 1.024 berkas yang diekspansi, 4 MiB per berkas dependensi, 32 MiB isi yang diekspansi, dan 48 MiB bundel terenkode. Arsip root asli memiliki batas lebih kecil sendiri. Versi hilang atau konflik, siklus, dependensi yatim, hash berubah, lisensi/NOTICE hilang, jalur/tautan, dan benturan berkas-direktori ditolak. Pemasangan gagal mempertahankan tujuan baru untuk pemeriksaan. Cegah penulis bersamaan; alat ini bukan sandbox OS.

Tanda tangan terpisah dan kepercayaan operator

createProvenanceStatement mengikat nama/versi/SHA-256 bundel yang tepat, penerbit, revisi sumber, serta waktu penerbitan/kedaluwarsa. signPluginProvenance menggunakan KeyObject Ed25519 milik pemanggil. canonicalProvenancePayload menyediakan DDS-PROVENANCE-V1 diikuti JSON kanonis agar penanda tangan lain dapat mereproduksi payload yang sama. SDK tidak menyediakan kunci penandatanganan privat atau kewenangan penandatanganan produk DDS.

verifyPluginProvenance menerima akar kepercayaan yang dipilih operator, ikatan penerbit/subjek, waktu saat ini, validitas/pencabutan kunci, dan bukti pencabutan bertanda waktu. Verifikasi luring menggunakan bukti yang disediakan dan menerapkan anggaran kesegaran yang sama; verifikasi tidak pernah mengambil informasi pencabutan baru sendiri. Kunci paket baru tidak dipercaya sampai operator menambahkannya. Akar yang bertumpang tindih secara eksplisit mendukung rotasi. Selisih clock maksimum lima menit dan usia bukti maksimum 30 hari; pilih batas lebih ketat jika diperlukan.

Tanda terima memisahkan checksum, tanda tangan, penerbit, dan kebijakan serta selalu mengembalikan executionAuthorized: false. Tanda tangan tidak membuktikan keamanan kode atau memberikan eksekusi, akses data, atau kewenangan sandbox. Paket lama tanpa tanda tangan memerlukan envelope: null dan allowUnsigned: true, tetapi tetap melaporkan tanpa tanda tangan dan penerbit belum terverifikasi. Audit keamanan dan validasi kerentanan tetap tertunda secara independen.

Tinjau, aktifkan, dan rollback

createPluginUpdatePlan membandingkan versi lama/baru, API, pemberian akses, sumber/hash dependensi, alat yang dideklarasikan, lisensi, hash pengaturan, identitas migrasi, tanda tangan, dan kunci, lalu menetapkan digest peninjauan. createPluginUpdateController memiliki host terotorisasi dan pengaturan saat ini serta port getPolicy/prepare operator. Stage memverifikasi dan membuat snapshot kandidat; approve harus cocok dengan digest rencana, pemberian akses, dan ID kunci yang tepat. Activate memeriksa pengaturan terkini dan menyegarkan kepercayaan sebelum serta setelah menyiapkan host kandidat terpisah.

wait menunda aktivasi selama job berjalan. retain-old membiarkan job lama pada host/pengaturan/hash aslinya dan mengirim eksekusi baru ke host baru setelah peralihan. execute mengembalikan hash plugin bersama setiap hasil. Job tidak dibatalkan secara implisit. Penggantian pengaturan membatalkan validitas persetujuan tertunda; perubahan bersamaan dan persiapan gagal mempertahankan atau secara eksplisit melaporkan status sebelumnya. Rollback menyiapkan paket/pengaturan lama sebagai pembaruan baru yang ditinjau dan memerlukan kepercayaan terkini serta persetujuan baru.

Persiapan dan migrasi berjalan melalui port tepercaya yang dimiliki operator. Rollback maupun kegagalan tidak membatalkan berkas eksternal, permintaan jaringan, atau efek lain. reversible adalah metadata peninjauan, bukan janji undo otomatis. Jurnal Node hanya dapat ditambahkan, memiliki satu penulis, dan berada di luar ruang kerja, dengan CAS revisi tepat dan batas 256 catatan / 128 KiB per envelope / total 8 MiB. Arsipkan di bawah kendali operator sebelum membuka jurnal baru saat batas tercapai.

inspectNodeUpdateJournal membaca status persisten tanpa replay. Crash selama preparing atau pengakuan yang ambigu memerlukan pembacaan kembali host/pengaturan secara eksplisit; reconcilePluginUpdateJournal mencatat digest lama/baru yang diketahui dan disetujui serta hash pengaturan. Bagian akhir yang korup memerlukan pemeriksaan/perbaikan operator. recoverStaleLock hanya memulihkan penulis pada mesin yang sama yang terbukti mati. Ini tidak menjanjikan transaksi host/pengaturan lintas proses atau atomisitas universal saat kehilangan daya.

Pemeriksaan upstream dan kandidat yang eksplisit

fetchUpstreamArtifact memerlukan pemanggilan eksplisit, enabled: true, URL/versi/digest sumber yang tepat, allowlist URL yang tepat, kebijakan luring, anggaran byte, dan tenggat. Tujuan pengalihan juga harus ada dalam allowlist. Operasi tidak mengirim cookie atau header autentikasi, tidak mencoba ulang secara otomatis, dan melaporkan verified / digest-mismatch / unavailable / offline / unverified dengan waktu pengamatan. Tag atau hash berubah memerlukan peninjauan baru. HTTP loopback hanya tersedia melalui opsi fixture eksplisit.

Adapter dapat menerbitkan upstream-manifest yang ditinjau, berisi inventaris API, revisi sumber yang tepat, lisensi/NOTICE lengkap, dan hash berkas. inspectUpstreamManifest mengikat metadata itu ke byte yang diunduh; operasi ini tidak menganalisis kode sumber sembarang atau menyimpulkan izin redistribusi. createUpstreamCandidate mengembalikan perbedaan API/berkas/lisensi dan patch before-digest/replacement-source. Kecocokan dengan matriks versi yang tepat tanpa pemeriksaan fungsional pengembang tetap belum terverifikasi; API wajib yang hilang berarti tidak didukung.

Kandidat yang didukung tetap memerlukan peninjauan manusia. Array automaticActions-nya kosong; API ini tidak membuat branch, merge, menerbitkan, menyetujui pemberian akses baru, atau memasang monitor. Host mengelola eksekusi dan pembatalan pengujian adapter. Contoh publik lengkap di bawah hanya menguji fixture lokal. API alur kerja/cache/alat/LSP tersedia dalam bagian 1.2 di bawah.

node node_modules/@altifigence/dds-plugin-sdk/examples/release-tools/run.mjs

Tipe, API, batas, dan sumber lengkap yang dapat dijalankan

Alur kerja perintah dan pemulihan eksplisit

SDK 1.2 menambahkan tujuh ekspor opsional: /workflows, /workflows-node, /workflow-cache, /workflow-cache-node, /tool-streams, /tool-streams-node, dan /lsp-node. Paket saat ini memiliki 50 ekspor, 107 skema, deklarasi TypeScript, dan contoh terpasang independen, tanpa dependensi npm runtime. Hanya /tool-streams yang portabel ke browser; ekspor baru lainnya memerlukan Node. Protokol ruang kerja yang ada dan API 1.x tetap kompatibel. Plugin yang mengimpor API 1.2 baru harus mendeklarasikan 1.2.0 sebagai versi SDK minimum.

prepareWorkflowPlan memvalidasi ID perintah terdaftar, langkah unik, dependensi asiklik, skema data masukan/keluaran tertutup, dan ikatan keluaran wajib sebelum eksekusi. Setiap masukan adalah literal {value} atau ikatan {step, path} ke dependensi eksplisit. Batasan skema harus cocok tepat. Rencana yang tidak dapat diubah mengikat perintah, pemberian akses, cakupan, dan masukannya ke SHA-256. run memerlukan approved: true dan digest tepat yang telah ditinjau. Port authorize dan execute host tetap dimiliki operator.

createCommandJobExecutor menghubungkan PluginHost terisolasi yang sudah ada dan dipilih oleh resolveHost, yang mengembalikan cakupan host, pemberian akses langkah, dan hash plugin yang tepat. Pemberian akses tidak pernah digabungkan antar langkah. Otorisasi terkini diperiksa sebelum eksekusi, setelah hasil, dan sebelum penggunaan kembali. continue menyelesaikan cabang independen dan memblokir turunan yang gagal; fail-fast membatalkan langkah tersisa. Catatan mempertahankan ID job/percobaan induk, job individual, digest masukan/keluaran, artefak, alasan, dan stempel waktu. Hit cache tidak memiliki ID job baru dan tidak dapat mengklaim artefak job yang dapat berubah.

recover membaca checkpoint tersimpan dan melaporkan pekerjaan tertunda/berjalan sebagai terinterupsi tanpa eksekusi. Resume manual memberikan catatan sebelumnya yang tepat dan previousAttemptId dalam persetujuan baru, membuat percobaan baru, dan hanya mempertahankan hasil berhasil yang cocok serta belum kedaluwarsa. retrySteps menjalankan ulang langkah terpilih dan turunannya bahkan dalam DAG tanpa urutan. Keluaran kedaluwarsa memerlukan pemilihan retry eksplisit; perubahan skema, masukan, pemberian akses, atau hash plugin memerlukan rencana baru. Executor yang mengabaikan pembatalan tetap dihitung sebagai belum selesai dan mencegah retry yang bertumpang tindih.

createNodeWorkflowStore menggunakan direktori penyimpanan/ruang kerja nyata yang terpisah, penanda cakupan dan identitas sistem berkas, satu penulis, envelope ber-checksum, dan checkpoint CAS. Setelah crash yang diketahui, recoverStaleLock eksplisit hanya menerima pemilik pada mesin yang sama yang terbukti mati. Pembersihan default menangani catatan korup yang dikenali dan penulisan yang belum selesai sambil mempertahankan berkas/tautan yang tidak dikenal. cleanup({expiredBefore}) juga dapat menghapus catatan terminal yang kedaluwarsa; catatan aktif tetap disimpan untuk pemulihan. Windows tidak mengklaim fsync direktori atau durabilitas saat kehilangan daya. Batas: 64 langkah, 8 langkah bersamaan, tenggat alur kerja 10 menit, 64 KiB per hasil, 1 MiB keluaran gabungan, catatan 2 MiB, 64 catatan yang dipertahankan, dan retensi hasil parsial paling lama 24 jam.

Tipe, API, batas, dan contoh lengkap yang dapat dijalankan

Cache deterministik dan eksekusi inkremental

fingerprintWorkflowInputs melakukan hash pada byte berkas sebenarnya beserta versi SDK, cakupan ruang kerja/keamanan, skema/masukan perintah, hash plugin/alat, pengaturan, lingkungan yang dideklarasikan, dan pemberian akses. mtime dan jalur saja tidak pernah menjadi identitas isi. Operator secara eksplisit mendeklarasikan optIn, deterministic, declaredInputsComplete, dan secretDependent. Masukan tidak dikenal atau tidak lengkap, nondeterminisme, ketergantungan rahasia, lingkungan hilang/tidak dideklarasikan, dan masukan referensi rahasia melewati cache dengan alasan. Host juga harus mengecualikan rahasia mentah dan efek samping; SDK tidak dapat menyimpulkan masukan tersembunyi.

createWorkflowCache memeriksa ulang otorisasi terkini pada lookup/fill/after-fill/hit/return dan memverifikasi hash nilai, cakupan, pemberian akses, serta kedaluwarsa. Miss bersamaan yang memenuhi syarat berbagi satu fill; membatalkan satu penunggu tidak membatalkan lainnya. Nilai kedaluwarsa atau rusak dianggap miss. TTL/LRU, anggaran entri/nilai, dan pembersihan penyimpanan yang dimiliki mengendalikan penyimpanan; kegagalan penulisan tetap berupa hasil yang dihitung dengan alasan eksplisit. Hasil referensi rahasia tidak pernah dipertahankan. Batas fingerprint adalah 64 berkas, masing-masing 4 MiB dan total 16 MiB; batas cache adalah 512 entri, 16 MiB byte nilai yang dipertahankan, delapan fill, dan 60 detik per fill.

Contoh alur kerja hanya melakukan lookup cache setelah dependensi saat ini berhasil. Berkas berubah membatalkan validitas langkahnya; keluaran berubah membatalkan fingerprint masukan dependennya. Dependensi gagal memblokir induk sebelum mencari hasil induk dalam cache. Tanda terima membedakan hit, miss, shared, dan bypass, eksekusi sebenarnya dari penggunaan kembali, counter cache, byte penyimpanan, dan timing lokal. Status cache yang persisten menggunakan direktori pemilik terpisah dan penggantian atomik, dengan pemulihan penulisan yatim/korupsi; proses tidak menghapus berkas sumber.

Tipe, API, batas, dan contoh lengkap yang dapat dijalankan

Stream keluaran alat terdaftar

createToolStreamParser adalah dekoder UTF-8 JSONL/teks yang portabel dan terbatas. Tunggu write(bytes, stdout/stderr) untuk backpressure dan panggil finish hanya setelah kedua stream berakhir. Parser mempertahankan karakter multibyte yang terbelah dan baris akhir parsial, serta mengeluarkan peristiwa log, progres, diagnostik, dan unknown yang berkorelasi. UTF-8 dengan format salah dan batas keras menghentikan parsing. Jalur diagnostik relatif, posisi berurutan, dan tingkat keparahan divalidasi; editor yang menggunakannya juga harus memvalidasi posisi terhadap teks dokumen terkini. createJobToolEventSink menghubungkan progres/log ke JobReporter yang sudah ada dan menyerahkan diagnostik ke sink milik pemanggil.

Runner Node opsional menerima registrasi operator tetap: backend/alat/versi, executable absolut dan patokan implementasi yang dipilih, probe versi tepat, lingkungan eksplisit, skema masukan tertutup, dan slot argumen skalar wajib. Slot berkas harus menyebut berkas ruang kerja relatif yang sudah ada. Pemanggilan plugin hanya memilih alat/versi yang sudah terdaftar dan masukan tervalidasi; plugin tidak dapat memilih shell atau executable. Otorisasi terkini diperiksa sebelum persiapan/start, saat peristiwa, dan setelah penyelesaian. Tanda terima mempertahankan kode keluar, alasan pembatalan/kegagalan, dan statistik keluaran.

Literal rahasia/jalur satu baris yang diketahui dimask setelah perakitan baris, termasuk chunk yang terbelah; rahasia terenkode atau tidak dikenal tidak dideteksi secara otomatis. Runner hanya memiliki anak langsung/pipe-nya dan menutupnya saat pembatalan atau close. Runner tidak memindai atau menghentikan pohon proses yang tidak terkait atau proses turunan dan bukan sandbox OS. Batas: chunk 64 KiB, baris 16 KiB, total keluaran 2 MiB, 4.096 peristiwa, delapan penulisan dalam antrean, sink lima detik, 32 alat, dan empat eksekusi bersamaan. Probe lima detik/16 KiB terpisah memeriksa versi yang dikonfigurasi.

Fixture alat yang dibuat SDK dan dapat didistribusikan ulang menguji UTF-8/JSONL terfragmentasi, keluaran akhir, status keluar bukan nol, pembatalan, dan batas. Adapter sebenarnya adalah TypeScript 5.9.3 dengan --noEmit --noLib --pretty false dan fixture tipe intrinsik sekali pakai yang menghasilkan TS2322. Berikan secara eksplisit root TypeScript yang sudah ada dan disetujui untuk menjalankannya. SDK tidak pernah otomatis memasang atau mengunduh alat eksternal; hash yang diberikan tidak mengautentikasi penerbitnya secara independen.

Tipe, API, batas, dan contoh lengkap yang dapat dijalankan

Bridge LSP stdio publik

createLspBridge menghubungkan proses stdio yang dipatok dan disetujui secara eksplisit ke permintaan/penyedia bahasa SDK yang sudah ada. Bridge menegosiasikan subset LSP 3.17 yang didukung, posisi UTF-16, dan snapshot penuh. capabilities melaporkan dukungan yang diiklankan secara terpisah dari eksekusi berhasil. Pemetaan yang didukung mencakup completion, hover, definition, references, simbol datar/hierarkis, signature help, prepare-rename/rename, pemformatan dokumen/rentang, code actions, token semantik penuh, folding, dan inlay hints: 15 fitur SDK.

syncDocument dan closeDocument menangani didOpen/didChange/didClose. Perubahan versi dan generasi terkini membatalkan pekerjaan usang, ID permintaan aktif duplikat ditolak, dan balasan terlambat diabaikan. URI lokal harus terurai di dalam ruang kerja tanpa tautan; sumber dan target suntingan memerlukan otorisasi terkini serta snapshot tepat yang terbuka atau disediakan host. Hasil rename/format/action adalah usulan suntingan ruang kerja bersyarat dengan hash dasar, bukan suntingan yang diterapkan otomatis atau perintah yang dapat dieksekusi.

Diagnostik hanya diterima dengan versi dokumen terkini. Notifikasi tanpa versi/usang dibuang dan dihitung. Fitur yang secara eksplisit tidak didukung adalah completion resolve/snippets, code-action resolve, delta semantik, perintah server, kemampuan dinamis, operasi sumber daya, transport socket, dan diagnostik tanpa versi. workspace/applyEdit mengembalikan applied:false. Batas: pesan 1 MiB, header 8 KiB, sesi 64 MiB/20.000 pesan, 16 permintaan tertunda dan penulisan dalam antrean, 32 dokumen/4 MiB teks agregat, tenggat permintaan hingga 30 detik, dan 64 KiB stderr yang dibuang.

close mengirim shutdown/exit dan melakukan pembersihan proses langsung/pipe yang terbatas, membedakan pengakuan yang tertib, server yang menolak/crash, dan penutupan proses sebenarnya. Server dapat mengakui shutdown tetapi masih memerlukan penghentian proses yang dimiliki. Tidak ada restart atau replay otomatis: operator membuat bridge baru dan secara eksplisit mengirim ulang snapshot terkini yang dipilih. Pengujian sintetis mencakup framing dengan format salah, crash/timeout, pembatalan/balasan terlambat, race dokumen, shutdown yang ditolak, permintaan tidak didukung, dan setiap fitur yang dipetakan.

Pemeriksaan server independen sebenarnya menggunakan typescript-language-server komunitas 5.3.0 dengan TypeScript 5.9.3: completion, hover, definition, references, symbols, signature help, formatting, dan token semantik lulus. Berkas implementasi yang dipilih dan Node dipatok, jalur tsserver ditetapkan, dan perolehan typings otomatis dinonaktifkan. Versi server ini tidak menyertakan initialize.serverInfo opsional dan mengirim diagnostik tanpa versi, sehingga diagnostiknya secara eksplisit tidak didukung oleh bridge ini; diagnostik berversi diverifikasi menggunakan server sintetis independen. Operator harus mempercayai seluruh alat terpasang dan akses OS-nya.

Penerimaan 1.2 mencakup konsumen paket independen, deklarasi, 107 skema, adapter compiler/server sebenarnya, dan interoperabilitas arsip publik historis. Contoh alur kerja membedakan pemulihan persisten dan retry eksplisit dari replay otomatis. Audit keamanan dan validasi kerentanan tetap tertunda berdasarkan penundaan pemilik. Rilis ini tidak merupakan penerimaan UI DDS, Engine, penjadwal Cloud, Marketplace, pemasang, atau sandbox keamanan.

Tipe, API, batas, dan contoh lengkap yang dapat dijalankan

node node_modules/@altifigence/dds-plugin-sdk/examples/workflows/run.mjs
node node_modules/@altifigence/dds-plugin-sdk/examples/workflow-tools/run.mjs
node node_modules/@altifigence/dds-plugin-sdk/examples/lsp/run.mjs
node node_modules/@altifigence/dds-plugin-sdk/examples/tool-streams-browser/serve.mjs

Untuk adapter sebenarnya, tambahkan jalur absolut ke pemasangan yang sudah ada dan disetujui operator. Contoh default hanya menggunakan fixture yang dibuat SDK dan tidak pernah mengunduh alat.

node node_modules/@altifigence/dds-plugin-sdk/examples/workflow-tools/run.mjs --typescript-root /absolute/path/to/typescript
node node_modules/@altifigence/dds-plugin-sdk/examples/lsp/run.mjs --typescript-root /absolute/path/to/typescript --language-server-root /absolute/path/to/typescript-language-server