Plugin SDK विकास और रिलीज़

विकास, सत्यापन, रिलीज़ टूल और 1.2 वर्कफ़्लो, इन्क्रिमेंटल कैश, बाहरी टूल तथा सार्वजनिक LSP ब्रिज।

DDS Plugin SDK 1.2.0 के विकास, सत्यापन और रिलीज़ का मार्गदर्शन। सुरक्षा ऑडिट और भेद्यता सत्यापन बाकी हैं; स्थिर API स्थिति और कार्यात्मक जाँच सुरक्षा स्वीकृति नहीं हैं।

SDK इंस्टॉलेशन और API गाइड

विकास टेम्पलेट और जनरेशन

command, language, theme, job, browser या configuration चुनें। init --dry-run बिना लिखे या इंस्टॉल किए गंतव्य, फ़ाइल सूची, हैश और टकराव बताता है। सामान्य init को नई वास्तविक डायरेक्टरी चाहिए। हर टेम्पलेट में सोर्स, मैनिफ़ेस्ट, डिस्क्लोज़र, लाइसेंस/नोटिस, टेस्ट, टाइपयुक्त उपभोक्ता और चलने योग्य उदाहरण है। browser और configuration टेम्पलेट में लूपबैक डेमो है। जनरेट निर्भरताएँ सटीक GitHub आर्काइव पिन करती हैं।

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 कमांड स्कीमा, सेटिंग्स, लोकेल कैटलॉग और थीम डेटा के लिए सीमित JSON डेटा है। generate से रनटाइम JSON, ESM एक्सपोर्ट, रॉ/सत्यापित TypeScript इनपुट टाइप, आउटपुट/सेटिंग्स टाइप, JSON Schema और थीम XML मिलते हैं। JSON Schema डिफ़ॉल्ट एनोटेशन हैं; केवल SDK इनपुट सत्यापन डिफ़ॉल्ट लागू करता है। जनरेशन आपका प्लगइन इम्पोर्ट नहीं करता। doctor विचलन, मेटाडेटा, गायब मॉड्यूल और जनरेट रनटाइम फ़ाइलें पैकेज अनुमति सूची में हैं या नहीं, यह जाँचता है।

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>

प्रतिस्थापन के लिए सटीक पिछला डाइजेस्ट और अपरिवर्तित जनरेट बाइट चाहिए। हाथ के संपादन, अतिरिक्त फ़ाइलें, लिंक और पुराने लॉक प्रतिस्थापन रोकते हैं। विफलता केवल उस प्रयास की अपरिवर्तित प्रविष्टियाँ हटाती है और बदली या अनिश्चित प्रविष्टियाँ निरीक्षण के लिए रखती है। सीमा 256 फ़ाइल, हर फ़ाइल 1 MiB और कुल 4 MiB है। लॉक सहयोगी जनरेटर में समन्वय करता है; शत्रुतापूर्ण समवर्ती फ़ाइलसिस्टम लेखक से सुरक्षा या अलग डायरेक्टरी में एटॉमिक ट्रांज़ैक्शन नहीं है। मालिकाना टेम्पलेट में कॉलर की शर्तें चाहिए और विरासत की SDK लाइसेंस/नोटिस फ़ाइलें बनी रहती हैं।

नियतात्मक परीक्षण और रीप्ले

/testing का createScenarioHost चुने इन-मेमोरी फ़ाइल, बैकएंड, सेटिंग्स, सीक्रेट और जॉब फ़िक्स्चर स्पष्ट रूप से माउंट करता है। शुरुआत में कोई अनुदान या क्षमता नहीं है। createTestClock वैश्विक मान बदले बिना सीड किए ID, समय और टाइमर देता है; समान-समय टाइमर डालने का क्रम रखते हैं। वर्चुअल प्रतीक्षा खोलने के लिए घड़ी आगे बढ़ाने को await करें। जनरेट UUID टेस्ट डेटा हैं, क्रिप्टोग्राफ़िक एंट्रॉपी नहीं। मौजूदा createTestHost डिफ़ॉल्ट संगत रहते हैं।

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();
}

फ़ॉल्ट पोर्ट देरी, अस्वीकार, डिस्कनेक्ट, क्षति, संसाधन समाप्ति और छूटे कॉल मॉडल करते हैं; बाहरी प्रभाव दोहराए बिना इवेंट फ़िक्स्चर हटाए, दोहराए या उलटे जा सकते हैं। replaceGrants अधिकार खोने वाले प्लगइन निष्क्रिय करता है। मेमोरी जॉब स्नैपशॉट पहचान, रिविज़न और हैश जाँचते हैं और स्वतः निष्पादन के बिना बाधित रिकवरी मॉडल करते हैं। ये फ़िक्स्चर फ़ाइलसिस्टम स्थायित्व का अनुकरण या ऑपरेटिंग सिस्टम हैंडल की खोज नहीं करते। अलग मालिक लेजर स्पष्ट पंजीकृत संसाधन ट्रैक करता है। रद्द करना अनदेखा करने वाले कॉलबैक वास्तव में पूरा होने तक teardown लंबित गिनती रखता है। disposal के बाद settings inspect पढ़ सकते हैं; डेटा पढ़ना फिर भी अस्वीकार होता है।

रिकॉर्डिंग के लिए synthetic: true और स्पष्ट सीमित फ़िक्स्चर सूची चाहिए। एक्सपोर्ट ट्रेस में केवल संचालन प्रकार, फ़िक्स्चर ID, टाइमिंग, सीड/संस्करण और श्रृंखलित हैश होते हैं। गैर-संवेदनशील ID उपयोग करें; हैश अनुमान योग्य डेटा अनाम नहीं करते और SDK मनमाने इनपुट को कृत्रिम वर्गीकृत नहीं कर सकता। शुद्ध रीप्ले क्रम, हैश और फ़िक्स्चर पहचान जाँचकर चुने फ़िक्स्चर आउटपुट लौटाता है; प्रभाव कॉलबैक नहीं लेता। सीमा 64 फ़िक्स्चर, 1,024 इवेंट और 1 MiB ट्रेस है। फ़ॉल्ट, रिकवरी, गोपनीयता और सफ़ाई जाँच के लिए पैकेज का development-tools उदाहरण चलाएँ।

स्थानीय डायग्नोस्टिक्स और डिबगिंग

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();
}

डायग्नोस्टिक्स डिफ़ॉल्ट में बंद और केवल स्थानीय हैं। रिपोर्ट में निश्चित संचालन/स्थिति/त्रुटि कोड, सहसंबंध ID, अवधि और संसाधन गिनती हैं; दस्तावेज़ बॉडी, पथ, इनपुट, आउटपुट बॉडी या मनमाने अपवाद पाठ के लिए API नहीं है। बाइट संख्या, क्यू गहराई और मेमोरी आँकड़े स्पष्ट मालिक अनुमान हैं। profileTransport लिपटे कॉल के पूरा होने तक मापता है; fetch में यह प्रतिक्रिया हेडर तक है, बॉडी पूरी होने तक नहीं। पूर्ण रिकॉर्ड सीमित रिंग और निष्क्रिय expiry उपयोग करते हैं; डायग्नोस्टिक बैकग्राउंड टाइमर या अपलोड नहीं हैं। डिफ़ॉल्ट 128 इवेंट/60 सेकंड; अधिकतम 256 इवेंट/5 मिनट, 64 चल रहे स्पैन और प्रति रिपोर्ट 256 KiB हैं।

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"}'

डिबग मोड केवल स्वामित्व वाली चाइल्ड प्रक्रिया में अस्थायी 127.0.0.1 इंस्पेक्टर देता है। --debug-wait प्लगइन इम्पोर्ट से पहले रोकता है और --debug चाहिए। कुल रन समय में डिबगर प्रतीक्षा शामिल है और अधिकतम 30 सेकंड है। पूर्णता, रद्द करना और टाइमआउट स्वामित्व वाली चाइल्ड तथा इंस्पेक्टर समाप्त करते हैं। प्रोफ़ाइलिंग और डिबगिंग दोनों में स्थानीय कोड पर स्पष्ट भरोसा चाहिए; कोई सैंडबॉक्स नहीं है। क्रैश या बलपूर्वक समाप्ति में प्रोफ़ाइल रिपोर्ट छूट सकती है, और रॉ प्लगइन stdout/stderr अलग सीमित स्ट्रीम हैं जिनसे संवेदनशील डेटा स्वतः नहीं हटता।

विकास टूल · परीक्षण · डायग्नोस्टिक्स · संगतता

होस्ट अनुरूपता

/conformance मॉड्यूल स्पष्ट दिए होस्ट, सेटिंग्स, वर्कस्पेस, स्थानीयकरण, परीक्षण, डायग्नोस्टिक्स और विकास एडाप्टर पर संस्करणयुक्त कृत्रिम जाँच चलाता है। यह समर्थित, असमर्थित और विफल प्रोफ़ाइल अलग करता है और होस्ट/संस्करण/रनटाइम/प्लेटफ़ॉर्म, जाँच ID, टाइमिंग और सफ़ाई शामिल करता है। घोषित सुविधा का एडाप्टर गायब या खराब हो तो विफल होता है; अज्ञात वैकल्पिक सुविधाएँ जाँच के बिना दर्ज होती हैं। डिफ़ॉल्ट में कमांड, अनुमतियाँ और रद्द करना आवश्यक हैं।

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));

होस्ट फ़ैक्टरी अपने एडाप्टर से बदलें और अपने प्लगइन टेस्ट भी चलाएँ। Node /conformance-node हेल्पर केवल नए अस्थायी फ़िक्स्चर और अस्थायी लूपबैक सर्वर बनाता है। ब्राउज़र उदाहरण उपलब्ध ब्राउज़र प्रोफ़ाइल चलाता है और गायब Node सुविधाएँ असमर्थित बताता है। त्वरित जाँच अनुबंध नमूने लेती है; लिंक किए उदाहरण और रिलीज़ टेस्ट व्यापक भाषा, रिकवरी और स्टोरेज मार्ग जाँचते हैं। रिपोर्ट परीक्षण प्रमाण है, ट्रस्ट प्रमाणपत्र नहीं।

समयसीमा प्रति केस डिफ़ॉल्ट 10 सेकंड, अधिकतम 30 सेकंड है। टाइमआउट या रद्द करना बाद के केस रोकता है; सफ़ाई विफलता केस विफल करती है और लंबित सफ़ाई असत्यापित रहती है। विश्वसनीय इन-प्रोसेस एडाप्टर समकालिक रूप से रोक सकते और परिवेश के अधिकार रख सकते हैं। रिपोर्ट में प्रोवाइडर त्रुटि बॉडी, पेलोड, टोकन और पथ नहीं होते; गैर-संवेदनशील पहचान लेबल चुनें। रिपोर्ट स्वतः अपलोड नहीं होती।

SDK समर्थन और माइग्रेशन

API_SUPPORT.json हर एक्सपोर्ट मॉड्यूल, रनटाइम नाम, डिक्लेरेशन, डिक्लेरेशन डाइजेस्ट, परिवेश और स्थिरता की सूची देता है। स्थिर 1.x API सिमैंटिक संस्करण अपनाते हैं: संगत जोड़ माइनर रिलीज़ में और असंगत स्थिर बदलाव नए मेजर में होते हैं। artifact-resume-browser प्रयोगात्मक है और नए ब्राउज़र स्वीकृति परीक्षण के साथ सटीक SDK/ब्राउज़र संस्करण चाहिए। वैकल्पिक क्षमता खोज और वर्तमान अनुमतियाँ फिर भी आवश्यक हैं।

स्थिर शाखा नीति 1.0.0 से लागू है। नवीनतम स्थिर माइनर में सामान्य सुधार मिलते हैं; उससे पिछले माइनर को समर्थित रनटाइम में 90 दिन तक गंभीर सुरक्षा सुधार मिल सकते हैं। 1.0.0 में कोई स्थिर API अप्रचलित नहीं है। मेजर संस्करण में हटाने से कम से कम दो माइनर रिलीज़ और छह महीने पहले अप्रचलन घोषित होते हैं। RC और प्रीव्यू की जगह नए संस्करण आते हैं। यह ओपन-सोर्स नीति व्यावसायिक प्रतिक्रिया समय का वादा नहीं करती।

सर्वर और CLI स्वीकृति में पैच किए Node 22 या 24 के साथ Windows/Linux और TypeScript 5.9.3 के डिक्लेरेशन हैं। Node 22 समर्थन 2027-04-30 और Node 24 समर्थन 2028-04-30 को समाप्त होता है। रिलीज़ रसीद सटीक पैच संस्करण, OS इमेज और ब्राउज़र बिल्ड बताती है। दूसरे रनटाइम और ब्राउज़र/स्टोरेज संयोजन को अपना स्वीकृति परीक्षण चाहिए। SDK रनटाइम npm निर्भरताएँ खाली हैं।

स्थिर 1.0 प्लगइन >=1.0.0 <2.0.0 उपयोग करते हैं; बाद का API अपनाने पर न्यूनतम संस्करण बढ़ाएँ। RC1 पैकेज अपने सटीक 1.0.0-rc.1 peer रखते हैं। इसे बदलने के लिए फिर सत्यापित और नया प्लगइन संस्करण प्रकाशित करें; पुराने आर्काइव अपरिवर्तनीय रखें। पुराने आर्काइव इंटरऑपरेबिलिटी इनपुट हैं, रखरखाव शाखाएँ नहीं। रीस्टार्ट के बाद नया कनेक्शन और वर्तमान अनुदान लें; रिकवरी काम फिर चलाए बिना कमिट स्थिति पढ़ती है।

रिलीज़ स्वीकृति

मालिक के 2026-10-05 स्थगन के तहत सुरक्षा ऑडिट और भेद्यता सत्यापन बाकी हैं। कार्यात्मक, संगतता और प्रदर्शन परिणाम सुरक्षा स्वीकृति नहीं हैं। रखी समीक्षा अलग से फिर शुरू होगी; इस रिलीज़ को ऑडिट पास बताया नहीं जाना चाहिए।

संयुक्त फ़िक्स्चर भाषा/सेटिंग्स, समीक्षा संपादन, कमांड जॉब, प्रोजेक्ट वॉच, अपलोड/डाउनलोड और रखे स्टोरेज को एक साथ चलाता है। यह बाधा, गलत प्रतिक्रिया, निरस्तीकरण, जनरेशन बदलाव, रिकवरी और संसाधन सफ़ाई जाँचता है। अलग फ़ाइलसिस्टम/प्रक्रिया टेस्ट समाप्त चाइल्ड, क्षति, विफल लेखन, expiry और अनदेखे रद्दीकरण जाँचते हैं। RC स्वीकृति रिपोर्ट में दोहराने योग्य कमांड और हर परिणाम की सीमाएँ लिंक हैं।

प्रदर्शन में हर Windows/Linux और Node 22/24 प्रोफ़ाइल के पाँच नए-प्रक्रिया नमूने दर्ज हैं, जिनमें मध्यक/फैलाव, CPU समय, सैंपल मेमोरी, इम्पोर्ट/स्टार्टअप/वॉच टाइमिंग और तार्किक डिस्क/HTTP पेलोड गिनती शामिल हैं। आधार सीमा इन मापे नमूनों से है और मोटे रिग्रेशन संकेत हैं, लेटेंसी SLA नहीं। ये भौतिक डिस्क ट्रैफ़िक नहीं मापते और हर OS हैंडल खोजने की गारंटी नहीं देते।

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

अनुरूपता · API सूची · समर्थन नीति · RC स्वीकृति

स्थिर 1.0 रिलीज़ सामग्री

मूल 1.0 पैकेज में डिक्लेरेशन, उदाहरण, LICENSE और NOTICE के साथ 38 एक्सपोर्ट और 86 स्कीमा हैं। 1.1 नीचे के रिलीज़ टूल जोड़ता है; 1.2 नीचे के workflow/cache/tool/LSP अनुभाग जोड़ता है। रिलीज़ रसीद में सटीक सोर्स/CI/डाइजेस्ट, नए उपभोक्ता और फिर उपयोग किए ब्राउज़र प्रमाण अलग हैं।

डाउनग्रेड के लिए अपने काम रोकें और रखे संगत SDK/प्लगइन आर्काइव तथा कॉन्फ़िगरेशन एक्सपोर्ट स्पष्ट चुनें। वर्तमान अनुदान देखें और नया कनेक्शन बनाएँ। परिणाम रिकवरी केवल पढ़ना है; बाहरी प्रभाव और असंगत सेटिंग्स स्वतः वापस नहीं होते। वास्तव में उपयोग प्रारूप और वैकल्पिक सुविधाएँ टेस्ट करें।

रिलीज़ सामग्री, माइग्रेशन और समर्थन

ऑफ़लाइन बंडल और SBOM

SDK 1.1 पाँच वैकल्पिक केवल-Node प्रवेश बिंदु जोड़ता है: /bundles, /provenance, /updates, /updates-node और /upstream। पैकेज में 43 एक्सपोर्ट, 96 स्कीमा, डिक्लेरेशन और चलने योग्य उदाहरण हैं, रनटाइम npm निर्भरताएँ शून्य हैं। मौजूदा 1.0 API और बिना हस्ताक्षर DDS .tgz आर्काइव संगत हैं।

lockBundleDependency समीक्षा किए ESM/CommonJS फ़ाइल ट्री को सटीक संस्करण, HTTPS सोर्स, कैनोनिकल फ़ाइल डाइजेस्ट, निर्भरता मैप, LICENSE/NOTICE और स्पष्ट पुनर्वितरण निर्णय से लॉक करता है। डाइजेस्ट समीक्षा किए ट्री का वर्णन है, अपस्ट्रीम आर्काइव हैश नहीं। createPluginBundle मूल DDS प्लगइन आर्काइव और रिलीज़ मेटाडेटा, एकल-संस्करण अचक्रीय निर्भरता ग्राफ़ और नियतात्मक CycloneDX 1.6 SBOM एम्बेड करता है।

verifyPluginBundle सटीक सीमित बाइट स्नैपशॉट जाँचता है। installPluginBundle को उसका expectedSha256, approved: true और ऑपरेटर के स्वामित्व वाले पैरेंट के नीचे नई डायरेक्टरी चाहिए। यह npm, जीवनचक्र स्क्रिप्ट, डाउनलोड या प्लगइन कोड नहीं चलाता। निर्भरताओं को नया अनुदान नहीं मिलता। होस्ट SDK अलग निर्भरता है। नेटिव ऐडऑन, एक्सपोर्ट मैप और मनमाना npm निर्भरता रिज़ॉल्यूशन इस प्रारूप से बाहर हैं।

सीमाएँ: 32 निर्भरता पैकेज, 1,024 विस्तारित फ़ाइलें, हर निर्भरता फ़ाइल 4 MiB, विस्तारित सामग्री 32 MiB और एन्कोड बंडल 48 MiB। मूल रूट आर्काइव की अपनी छोटी सीमाएँ हैं। गायब/टकराते संस्करण, चक्र, अनाथ निर्भरताएँ, बदले हैश, गायब लाइसेंस/NOTICE, पथ/लिंक और फ़ाइल-डायरेक्टरी टकराव अस्वीकार होते हैं। विफल इंस्टॉलेशन नई जगह निरीक्षण के लिए रखते हैं। समवर्ती लेखक बाहर रखें; यह OS सैंडबॉक्स नहीं है।

अलग हस्ताक्षर और ऑपरेटर भरोसा

createProvenanceStatement सटीक बंडल नाम/संस्करण/SHA-256, पब्लिशर, सोर्स रिविज़न और जारी/समाप्ति समय जोड़ता है। signPluginProvenance कॉलर के Ed25519 KeyObject का उपयोग करता है। canonicalProvenancePayload, DDS-PROVENANCE-V1 के बाद कैनोनिकल JSON देता है ताकि दूसरा हस्ताक्षरकर्ता वही पेलोड बना सके। SDK निजी हस्ताक्षर कुंजी या DDS उत्पाद हस्ताक्षर अधिकार नहीं देता।

verifyPluginProvenance ऑपरेटर के चुने ट्रस्ट रूट, पब्लिशर/विषय संबंध, वर्तमान समय, कुंजी वैधता/निरस्तीकरण और टाइमस्टैम्प वाले निरस्तीकरण प्रमाण लेता है। ऑफ़लाइन सत्यापन दिए प्रमाण और वही नवीनता सीमा उपयोग करता है; खुद नया निरस्तीकरण डेटा कभी नहीं लाता। ऑपरेटर जोड़े बिना नई पैकेज कुंजी अविश्वसनीय है। स्पष्ट अतिव्यापी रूट रोटेशन देते हैं। अधिकतम घड़ी अंतर पाँच मिनट और प्रमाण आयु 30 दिन है; ज़रूरत पर कड़ी सीमा चुनें।

रसीद चेकसम, हस्ताक्षर, पब्लिशर और नीति अलग रखती और हमेशा executionAuthorized: false लौटाती हैं। हस्ताक्षर कोड सुरक्षा साबित या निष्पादन, डेटा पहुँच अथवा सैंडबॉक्स अधिकार नहीं देता। पुराने बिना हस्ताक्षर पैकेज में envelope: null और allowUnsigned: true चाहिए; फिर भी unsigned और असत्यापित पब्लिशर बताते हैं। सुरक्षा ऑडिट और भेद्यता सत्यापन अलग से बाकी रहते हैं।

समीक्षा, सक्रियण और वापसी

createPluginUpdatePlan पुराने/नए संस्करण, API, अनुदान, निर्भरता सोर्स/हैश, घोषित टूल, लाइसेंस, सेटिंग्स हैश, माइग्रेशन पहचान, हस्ताक्षर और कुंजी की तुलना कर समीक्षा डाइजेस्ट तय करता है। createPluginUpdateController वर्तमान अधिकृत होस्ट और सेटिंग्स तथा ऑपरेटर के getPolicy/prepare पोर्ट का स्वामी है। stage प्रत्याशी सत्यापित और स्नैपशॉट करता है; approve को सटीक योजना डाइजेस्ट, अनुदान और कुंजी ID से मेल चाहिए। activate अलग प्रत्याशी होस्ट तैयार करने से पहले और बाद में वर्तमान सेटिंग्स जाँचता और ट्रस्ट रीफ़्रेश करता है।

wait चल रहे जॉब के दौरान सक्रियण स्थगित करता है। retain-old पुराने जॉब मूल होस्ट/सेटिंग्स/हैश पर रखता है और बदलाव के बाद नया निष्पादन नए होस्ट को भेजता है। execute हर परिणाम के साथ प्लगइन हैश लौटाता है। जॉब स्वतः रद्द नहीं होते। सेटिंग्स प्रतिस्थापन लंबित स्वीकृति अमान्य करता है; समवर्ती बदलाव और विफल तैयारी पिछली स्थिति रखते या स्पष्ट बताते हैं। rollback पुराने पैकेज/सेटिंग्स को नई समीक्षा अपडेट की तरह stage करता है और वर्तमान ट्रस्ट तथा नई स्वीकृति माँगता है।

तैयारी और माइग्रेशन ऑपरेटर के विश्वसनीय पोर्ट से चलते हैं। rollback या विफलता बाहरी फ़ाइलें, नेटवर्क अनुरोध या दूसरे प्रभाव वापस नहीं करते। reversible समीक्षा मेटाडेटा है, स्वतः पूर्ववत का वादा नहीं। Node जर्नल केवल जोड़ने योग्य, एकल-लेखक और वर्कस्पेस के बाहर है, सटीक रिविज़न CAS तथा 256 रिकॉर्ड / प्रति एनवेलप 128 KiB / कुल 8 MiB सीमाओं के साथ। सीमा पर नया जर्नल खोलने से पहले ऑपरेटर के नियंत्रण में आर्काइव करें।

inspectNodeUpdateJournal रीप्ले के बिना स्थायी स्थिति पढ़ता है। preparing में क्रैश या अस्पष्ट पुष्टि में स्पष्ट होस्ट/सेटिंग्स readback चाहिए; reconcilePluginUpdateJournal स्वीकृत ज्ञात पुराने/नए डाइजेस्ट और सेटिंग्स हैश दर्ज करता है। खराब अंत भाग में ऑपरेटर निरीक्षण/मरम्मत चाहिए। recoverStaleLock केवल उसी मशीन के मृत सिद्ध लेखक का लॉक रिकवर करता है। इससे अलग प्रक्रियाओं का होस्ट/सेटिंग्स ट्रांज़ैक्शन या सभी पावर-लॉस में एटॉमिकता सुनिश्चित नहीं होती।

स्पष्ट अपस्ट्रीम जाँच और प्रत्याशी

fetchUpstreamArtifact को स्पष्ट कॉल, enabled: true, सटीक सोर्स URL/संस्करण/डाइजेस्ट, सटीक URL अनुमति सूची, ऑफ़लाइन नीति, बाइट बजट और समयसीमा चाहिए। रीडायरेक्ट लक्ष्य भी अनुमति सूची में हों। कुकी या auth हेडर नहीं भेजता, स्वतः पुनः प्रयास नहीं करता और अवलोकन समय के साथ verified / digest-mismatch / unavailable / offline / unverified बताता है। बदले टैग या हैश की नई समीक्षा चाहिए। लूपबैक HTTP केवल स्पष्ट फ़िक्स्चर विकल्प से उपलब्ध है।

एडाप्टर समीक्षा किया upstream-manifest प्रकाशित कर सकते हैं, जिसमें API सूची, सटीक सोर्स रिविज़न, पूरा लाइसेंस/NOTICE और फ़ाइल हैश हों। inspectUpstreamManifest यह मेटाडेटा डाउनलोड बाइट से जोड़ता है; मनमाना सोर्स कोड नहीं जाँचता और पुनर्वितरण अनुमति नहीं अनुमानता। createUpstreamCandidate API/फ़ाइल/लाइसेंस अंतर और before-digest/replacement-source पैच लौटाता है। डेवलपर की कार्यात्मक जाँच के बिना सटीक संस्करण मैट्रिक्स मेल भी असत्यापित रहता है; आवश्यक API गायब हो तो असमर्थित है।

समर्थित प्रत्याशी को भी मानवीय समीक्षा चाहिए। उसका automaticActions एरे खाली है; ये API ब्रांच, मर्ज, प्रकाशन, नए अनुदान स्वीकृति या मॉनिटर इंस्टॉल नहीं करते। एडाप्टर टेस्ट निष्पादन और रद्द करना होस्ट का है। नीचे पूरा सार्वजनिक उदाहरण केवल स्थानीय फ़िक्स्चर चलाता है। workflow/cache/tool/LSP API नीचे के 1.2 अनुभागों में हैं।

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

टाइप, API, सीमाएँ और पूरा चलने योग्य सोर्स

कमांड वर्कफ़्लो और स्पष्ट रिकवरी

SDK 1.2 सात वैकल्पिक एक्सपोर्ट जोड़ता है: /workflows, /workflows-node, /workflow-cache, /workflow-cache-node, /tool-streams, /tool-streams-node और /lsp-node। वर्तमान पैकेज में 50 एक्सपोर्ट, 107 स्कीमा, TypeScript डिक्लेरेशन और स्वतंत्र इंस्टॉल उदाहरण हैं, रनटाइम npm निर्भरताएँ शून्य हैं। केवल /tool-streams ब्राउज़र में पोर्टेबल है; बाकी नए एक्सपोर्ट में Node चाहिए। मौजूदा वर्कस्पेस प्रोटोकॉल और 1.x API संगत हैं। नया 1.2 API इम्पोर्ट करने वाला प्लगइन न्यूनतम SDK संस्करण 1.2.0 घोषित करे।

prepareWorkflowPlan निष्पादन से पहले पंजीकृत कमांड ID, अनन्य चरण, अचक्रीय निर्भरता, बंद इनपुट/आउटपुट डेटा स्कीमा और आवश्यक आउटपुट संबंध जाँचता है। हर इनपुट literal {value} या स्पष्ट निर्भरता से {step, path} संबंध है। स्कीमा कंस्ट्रेंट बिल्कुल मेल हों। अपरिवर्तनीय योजना अपने कमांड, अनुदान, दायरा और इनपुट को SHA-256 से बाँधती है। run को approved: true और वही सटीक समीक्षा डाइजेस्ट चाहिए। होस्ट authorize और execute पोर्ट ऑपरेटर के हैं।

createCommandJobExecutor, resolveHost द्वारा चुने अलग मौजूदा PluginHost से जुड़ता है, जो सटीक होस्ट दायरा, चरण अनुदान और प्लगइन हैश लौटाता है। चरणों के अनुदान कभी जोड़े नहीं जाते। निष्पादन से पहले, परिणाम के बाद और फिर उपयोग से पहले वर्तमान अनुमति जाँची जाती है। continue स्वतंत्र शाखाएँ पूरा करता और विफल वंशज रोकता है; fail-fast बाकी चरण रद्द करता है। रिकॉर्ड मूल जॉब/प्रयास ID, अलग जॉब, इनपुट/आउटपुट डाइजेस्ट, आर्टिफ़ैक्ट, कारण और टाइमस्टैम्प रखते हैं। कैश हिट में नया जॉब ID नहीं होता और बदलने योग्य जॉब आर्टिफ़ैक्ट का दावा नहीं कर सकते।

recover सेव चेकपॉइंट पढ़कर लंबित/चल रहे काम को बाधित बताता है, चलाता नहीं। मैनुअल resume में नई स्वीकृति के साथ सटीक पिछला रिकॉर्ड और previousAttemptId देते हैं, नया प्रयास बनता है और केवल मेल खाते, अवधि बाकी सफल परिणाम रखे जाते हैं। retrySteps चुने चरण और वंशज फिर चलाता है, बिना क्रम वाले DAG में भी। समाप्त आउटपुट के लिए स्पष्ट retry चयन चाहिए; बदले स्कीमा, इनपुट, अनुदान या प्लगइन हैश में नई योजना चाहिए। रद्द करना अनदेखा करने वाला executor असमाप्त गिना जाता है और अतिव्यापी retry रोकता है।

createNodeWorkflowStore वास्तविक अलग store/workspace डायरेक्टरी, दायरा और फ़ाइलसिस्टम पहचान चिह्न, एक लेखक, चेकसमयुक्त एनवेलप और CAS चेकपॉइंट उपयोग करता है। ज्ञात क्रैश के बाद स्पष्ट recoverStaleLock केवल उसी मशीन के मृत सिद्ध मालिक को स्वीकार करता है। डिफ़ॉल्ट सफ़ाई ज्ञात खराब रिकॉर्ड और अधूरे लेखन सँभालती है, अज्ञात फ़ाइल/लिंक रखती है। cleanup({expiredBefore}) समाप्त अंतिम रिकॉर्ड भी हटा सकता है; सक्रिय रिकॉर्ड रिकवरी के लिए रहते हैं। Windows में directory fsync या पावर-लॉस स्थायित्व का दावा नहीं है। सीमाएँ: 64 चरण, 8 समवर्ती चरण, 10-मिनट वर्कफ़्लो समयसीमा, प्रति परिणाम 64 KiB, संयुक्त आउटपुट 1 MiB, रिकॉर्ड 2 MiB, 64 रखे रिकॉर्ड और आंशिक परिणाम अधिकतम 24 घंटे रखना।

टाइप, API, सीमाएँ और पूरे चलने योग्य उदाहरण

नियतात्मक कैश और इन्क्रिमेंटल निष्पादन

fingerprintWorkflowInputs वास्तविक फ़ाइल बाइट के साथ SDK संस्करण, वर्कस्पेस/सुरक्षा दायरा, कमांड स्कीमा/इनपुट, प्लगइन/टूल हैश, सेटिंग्स, घोषित परिवेश और अनुदान हैश करता है। केवल mtime और पथ सामग्री पहचान कभी नहीं हैं। ऑपरेटर optIn, deterministic, declaredInputsComplete और secretDependent स्पष्ट घोषित करता है। अज्ञात/अधूरा इनपुट, अनियतता, सीक्रेट निर्भरता, गायब/अघोषित परिवेश और सीक्रेट-रेफ़रेंस इनपुट कारण के साथ कैश छोड़ते हैं। होस्ट को रॉ सीक्रेट और बाहरी प्रभाव भी बाहर रखने होंगे; SDK छिपे इनपुट नहीं अनुमान सकता।

createWorkflowCache lookup/fill/after-fill/hit/return पर वर्तमान अनुमति फिर जाँचता है और मान हैश, दायरा, अनुदान तथा expiry जाँचता है। एकसाथ योग्य मिस एक fill साझा करते हैं; एक प्रतीक्षारत को रद्द करने से दूसरे रद्द नहीं होते। समाप्त या खराब मान मिस हैं। TTL/LRU, प्रविष्टि/मान बजट और स्वामित्व स्टोर सफ़ाई भंडारण नियंत्रित करते हैं; लेखन विफलता स्पष्ट कारण के साथ गणना परिणाम रहती है। सीक्रेट-रेफ़रेंस परिणाम कभी नहीं रखे जाते। फ़िंगरप्रिंट सीमा 64 फ़ाइल, हर 4 MiB और कुल 16 MiB; कैश सीमा 512 प्रविष्टि, रखे मान बाइट 16 MiB, आठ fill और प्रति fill 60 सेकंड है।

वर्कफ़्लो उदाहरण वर्तमान निर्भरताओं की सफलता के बाद ही कैश lookup करता है। बदली फ़ाइल उसका चरण अमान्य करती है; बदले आउटपुट निर्भर इनपुट फ़िंगरप्रिंट अमान्य करते हैं। विफल निर्भरता कैश का मूल परिणाम देखने से पहले मूल चरण रोकती है। रसीद hit, miss, shared और bypass, वास्तविक निष्पादन तथा पुनः उपयोग, कैश काउंटर, स्टोरेज बाइट और स्थानीय समय अलग करती है। टिकाऊ कैश स्थिति अलग मालिक डायरेक्टरी और एटॉमिक प्रतिस्थापन उपयोग करती है, अनाथ-लेखन/क्षति रिकवरी के साथ; सोर्स फ़ाइलें नहीं हटाती।

टाइप, API, सीमाएँ और पूरे चलने योग्य उदाहरण

पंजीकृत टूल आउटपुट स्ट्रीम

createToolStreamParser पोर्टेबल सीमित UTF-8 JSONL/टेक्स्ट डिकोडर है। backpressure के लिए write(bytes, stdout/stderr) को await करें और दोनों स्ट्रीम खत्म होने पर ही finish करें। यह टूटे बहुबाइट अक्षर और अंतिम आंशिक पंक्ति रखकर संबंधित log, progress, diagnostic और unknown इवेंट देता है। गलत UTF-8 और कठोर सीमा पार्सिंग रोकते हैं। सापेक्ष डायग्नोस्टिक पथ, क्रमबद्ध स्थान और गंभीरता जाँचे जाते हैं; उपभोक्ता एडिटर को वर्तमान दस्तावेज़ पाठ के अनुसार स्थान भी जाँचना होगा। createJobToolEventSink progress/logs को मौजूदा JobReporter से जोड़ता है और diagnostics कॉलर के sink को छोड़ता है।

वैकल्पिक Node रनर निश्चित ऑपरेटर पंजीकरण स्वीकार करता है: backend/tool/version, पूर्ण प्रोग्राम पथ और चुने कार्यान्वयन पिन, सटीक संस्करण जाँच, स्पष्ट परिवेश, बंद इनपुट स्कीमा और आवश्यक scalar argument slot। फ़ाइल slot में मौजूदा सापेक्ष वर्कस्पेस फ़ाइल का नाम हो। प्लगइन कॉल केवल पहले पंजीकृत tool/version और सत्यापित इनपुट चुनता है; shell या executable नहीं चुन सकता। तैयारी/शुरुआत से पहले, इवेंट पर और पूर्णता के बाद वर्तमान अनुमति जाँची जाती है। रसीद एग्ज़िट कोड, रद्दीकरण/विफलता कारण और आउटपुट आँकड़े रखती है।

ज्ञात एक-पंक्ति सीक्रेट/पथ literal, टूटे chunk समेत पंक्ति जुड़ने के बाद छिपाए जाते हैं; encoded या अज्ञात सीक्रेट स्वतः नहीं पहचाने जाते। रनर केवल सीधे चाइल्ड/पाइप का स्वामी है और रद्द या बंद होने पर उन्हें बंद करता है। असंबंधित या वंशज प्रक्रिया ट्री स्कैन/समाप्त नहीं करता और OS सैंडबॉक्स नहीं है। सीमाएँ: 64 KiB chunk, 16 KiB पंक्ति, कुल आउटपुट 2 MiB, 4,096 इवेंट, आठ कतार लेखन, पाँच-सेकंड sink, 32 टूल और चार समवर्ती निष्पादन। अलग पाँच-सेकंड/16 KiB probe कॉन्फ़िगर संस्करण जाँचता है।

SDK का पुनर्वितरण योग्य टूल फ़िक्स्चर खंडित UTF-8/JSONL, अंतिम आउटपुट, गैर-शून्य एग्ज़िट, रद्दीकरण और सीमाएँ जाँचता है। वास्तविक एडाप्टर TypeScript 5.9.3 है, --noEmit --noLib --pretty false और अस्थायी intrinsic-types फ़िक्स्चर से TS2322 बनाता है। चलाने के लिए मौजूदा स्वीकृत TypeScript रूट स्पष्ट दें। SDK कभी बाहरी टूल स्वतः इंस्टॉल या डाउनलोड नहीं करता; दिए हैश उसके पब्लिशर को स्वतंत्र रूप से प्रमाणित नहीं करते।

टाइप, API, सीमाएँ और पूरे चलने योग्य उदाहरण

सार्वजनिक Stdio LSP ब्रिज

createLspBridge स्पष्ट स्वीकृत पिन की stdio प्रक्रिया को मौजूदा SDK भाषा अनुरोध/प्रोवाइडर से जोड़ता है। यह समर्थित LSP 3.17 उपसमुच्चय, UTF-16 स्थान और पूर्ण स्नैपशॉट तय करता है। capabilities घोषित समर्थन और सफल निष्पादन अलग बताता है। समर्थित मैपिंग में completion, hover, definition, references, flat/hierarchical symbols, signature help, prepare-rename/rename, document/range formatting, code actions, full semantic tokens, folding और inlay hints हैं: 15 SDK सुविधाएँ।

syncDocument और closeDocument, didOpen/didChange/didClose सँभालते हैं। वर्तमान संस्करण और जनरेशन बदलाव पुराना काम रद्द करते हैं, दोहरे सक्रिय request ID अस्वीकार होते हैं और देर के उत्तर अनदेखे होते हैं। स्थानीय URI लिंक के बिना वर्कस्पेस के भीतर जाएँ; सोर्स और संपादन लक्ष्य में वर्तमान अनुमति तथा खुला या होस्ट का सटीक स्नैपशॉट चाहिए। rename/format/action परिणाम आधार हैश वाले सशर्त वर्कस्पेस-संपादन प्रस्ताव हैं, स्वतः लागू संपादन या चलने योग्य कमांड नहीं।

डायग्नोस्टिक्स केवल वर्तमान दस्तावेज़ संस्करण के साथ स्वीकार होते हैं। बिना संस्करण/पुराने नोटिफ़िकेशन हटाकर गिने जाते हैं। स्पष्ट असमर्थित सुविधाएँ हैं: completion resolve/snippets, code-action resolve, semantic deltas, server commands, dynamic capabilities, resource operations, socket transports और बिना संस्करण diagnostics। workspace/applyEdit से applied:false मिलता है। सीमाएँ: 1 MiB संदेश, 8 KiB हेडर, 64 MiB/20,000-संदेश सत्र, 16 लंबित अनुरोध और कतार लेखन, 32 दस्तावेज़/कुल पाठ 4 MiB, अनुरोध समयसीमा अधिकतम 30 सेकंड और छोड़ा stderr 64 KiB।

close, shutdown/exit भेजकर सीमित प्रत्यक्ष-प्रक्रिया/पाइप सफ़ाई करता है और सामान्य पुष्टि, अस्वीकार/क्रैश सर्वर तथा वास्तविक प्रक्रिया बंद होना अलग बताता है। सर्वर shutdown मानकर भी स्वामित्व प्रक्रिया रोकने की ज़रूरत रख सकता है। स्वतः रीस्टार्ट या रीप्ले नहीं है: ऑपरेटर नया ब्रिज बनाकर चुने वर्तमान स्नैपशॉट स्पष्ट दोबारा भेजता है। कृत्रिम टेस्ट गलत framing, क्रैश/टाइमआउट, रद्दीकरण/देर उत्तर, दस्तावेज़ दौड़, अस्वीकार shutdown, असमर्थित अनुरोध और हर मैप की सुविधा जाँचते हैं।

वास्तविक स्वतंत्र सर्वर जाँच में community typescript-language-server 5.3.0 और TypeScript 5.9.3 हैं: completion, hover, definition, references, symbols, signature help, formatting और semantic tokens पास हुए। चुनी कार्यान्वयन फ़ाइलें और Node पिन हैं, tsserver पथ निश्चित और automatic typings acquisition बंद है। इस सर्वर संस्करण में वैकल्पिक initialize.serverInfo नहीं है और बिना संस्करण diagnostics भेजता है, इसलिए उसके diagnostics ब्रिज में स्पष्ट असमर्थित हैं; संस्करणयुक्त diagnostics स्वतंत्र कृत्रिम सर्वर से सत्यापित हैं। ऑपरेटर को पूरे इंस्टॉल टूल और उसकी OS पहुँच पर भरोसा चाहिए।

1.2 स्वीकृति में स्वतंत्र पैक उपभोक्ता, डिक्लेरेशन, 107 स्कीमा, वास्तविक compiler/server एडाप्टर और ऐतिहासिक सार्वजनिक आर्काइव इंटरऑपरेबिलिटी हैं। वर्कफ़्लो उदाहरण टिकाऊ रिकवरी और स्पष्ट retry को स्वतः रीप्ले से अलग बताता है। मालिक के स्थगन में सुरक्षा ऑडिट और भेद्यता सत्यापन बाकी हैं। यह रिलीज़ DDS UI, Engine, Cloud scheduler, Marketplace, इंस्टॉलर या सुरक्षा-सैंडबॉक्स स्वीकृति नहीं है।

टाइप, API, सीमाएँ और पूरे चलने योग्य उदाहरण

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

वास्तविक एडाप्टर के लिए मौजूदा ऑपरेटर-स्वीकृत इंस्टॉलेशन के पूर्ण पथ जोड़ें। डिफ़ॉल्ट उदाहरण केवल SDK के फ़िक्स्चर उपयोग करते हैं और टूल कभी डाउनलोड नहीं करते।

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