openxiangda-devkit-core 2.0.0-alpha.100

package/README.md

@@ -0,0 +1,13 @@
+# openxiangda-devkit-core
+
+Application services shared by the OpenXiangda 2.0 CLI and MCP server:
+
+- validate `openxiangda-app.config.ts`;
+- create a deterministic `WorkspaceContext`;
+- compile and digest an `AppPackage`;
+- negotiate platform capabilities;
+- upload immutable artifacts and create/query a durable `DeploymentRun`.
+- run loopback Web, NestJS and a connected proxy against the linked platform;
+- keep developer access and connected Dev Session tokens in memory only.
+
+The package has no console, prompt or global process-state dependencies.

package/dist/app-spec.d.ts

@@ -0,0 +1,210 @@
+import { SCHEMA_VERSIONS, type Diagnostic } from "openxiangda-contracts";
+export declare const APP_SPEC_SCHEMAS: {
+    readonly app: "openxiangda.appspec/app/v1";
+    readonly capability: "openxiangda.appspec/capability/v1";
+    readonly change: "openxiangda.appspec/change/v1";
+    readonly decision: "openxiangda.appspec/decision/v1";
+    readonly context: "openxiangda.appspec/context/v2";
+};
+export declare const APP_SPEC_LIMITS: {
+    readonly maximumFiles: 128;
+    readonly maximumFileBytes: number;
+    readonly maximumTotalBytes: number;
+    readonly maximumContextBytes: number;
+    readonly maximumDirectoryEntries: 256;
+    readonly maximumHistoryDepth: 1;
+};
+export type AppSpecRisk = "L1" | "L2" | "L3";
+export type AppSpecCurrentSpecStatus = "pending" | "merged" | "not-applicable";
+export type AppSpecDocumentKind = "app" | "capability" | "change" | "decision";
+type MetadataValue = string | string[] | boolean;
+export interface AppSpecContractIndex {
+    appCode: string;
+    resourceCodes: string[];
+    actionCodes: string[];
+    configDigest?: string;
+    contractDigest?: string;
+    aiCatalogDigest?: string;
+}
+export interface AppSpecDocument {
+    kind: AppSpecDocumentKind;
+    id: string;
+    title: string;
+    status: string;
+    path: string;
+    metadata: Record<string, MetadataValue>;
+    requirementIds: string[];
+    acceptanceIds: string[];
+    references: {
+        capabilities: string[];
+        requirements: string[];
+        resources: string[];
+        actions: string[];
+        decisions: string[];
+    };
+    content: string;
+}
+export interface AppSpecDocumentSummary {
+    kind: AppSpecDocumentKind;
+    id: string;
+    title: string;
+    status: string;
+    path: string;
+    risk: AppSpecRisk | null;
+    requirementCount: number;
+    acceptanceScenarioCount: number;
+}
+export interface AppSpecContext {
+    schemaVersion: typeof APP_SPEC_SCHEMAS.context;
+    enabled: boolean;
+    mode: "advisory";
+    releaseGate: false;
+    root: "appspec";
+    selector: string | null;
+    contract: AppSpecContractIndex;
+    index: {
+        application: AppSpecDocumentSummary | null;
+        capabilities: AppSpecDocumentSummary[];
+        activeChanges: AppSpecDocumentSummary[];
+        decisions: AppSpecDocumentSummary[];
+        history: AppSpecDocumentSummary[];
+    };
+    application: AppSpecDocument | null;
+    capabilities: AppSpecDocument[];
+    activeChanges: AppSpecDocument[];
+    archivedChanges: AppSpecDocument[];
+    decisions: AppSpecDocument[];
+    contextBudget: {
+        maximumBytes: number;
+        contentBytes: number;
+        truncated: boolean;
+        omitted: AppSpecDocumentSummary[];
+    };
+    stats: {
+        files: number;
+        bytes: number;
+        capabilities: number;
+        activeChanges: number;
+        historyChanges: number;
+        decisions: number;
+        requirements: number;
+        acceptanceScenarios: number;
+    };
+    workspaceDigest: string | null;
+    selectionDigest: string | null;
+    diagnostics: Diagnostic[];
+}
+export interface InitializeAppSpecInput {
+    root: string;
+    appCode: string;
+    appName: string;
+}
+export interface CreateAppSpecCapabilityInput extends InitializeAppSpecInput {
+    id: string;
+    title: string;
+    resources?: string[];
+    actions?: string[];
+}
+export interface CreateAppSpecChangeInput extends InitializeAppSpecInput {
+    id: string;
+    title: string;
+    risk?: AppSpecRisk;
+    summary?: string;
+    capabilities?: string[];
+    requirements?: string[];
+    resources?: string[];
+    actions?: string[];
+}
+export interface CloseAppSpecChangeInput {
+    root: string;
+    id: string;
+    summary?: string;
+    currentSpec?: Exclude<AppSpecCurrentSpecStatus, "pending">;
+    contract: AppSpecContractIndex;
+}
+export declare function initializeAppSpec(input: InitializeAppSpecInput): {
+    schemaVersion: "openxiangda.appspec/context/v2";
+    enabled: boolean;
+    advisory: boolean;
+    releaseGate: boolean;
+    created: string[];
+    existing: string[];
+};
+export declare function createAppSpecCapability(input: CreateAppSpecCapabilityInput): {
+    schemaVersion: "openxiangda.appspec/context/v2";
+    enabled: boolean;
+    advisory: boolean;
+    releaseGate: boolean;
+    created: string;
+};
+export declare function createAppSpecChange(input: CreateAppSpecChangeInput): {
+    schemaVersion: "openxiangda.appspec/context/v2";
+    enabled: boolean;
+    advisory: boolean;
+    releaseGate: boolean;
+    created: string;
+    risk: AppSpecRisk;
+    status: string;
+};
+export declare function closeAppSpecChange(input: CloseAppSpecChangeInput): {
+    schemaVersion: "openxiangda.appspec/context/v2";
+    enabled: boolean;
+    advisory: boolean;
+    releaseGate: boolean;
+    archived: null;
+    status: string;
+    converged: boolean;
+    diagnostics: Diagnostic[];
+} | {
+    schemaVersion: "openxiangda.appspec/context/v2";
+    enabled: boolean;
+    advisory: boolean;
+    releaseGate: boolean;
+    archived: string;
+    status: string;
+    converged: boolean;
+    diagnostics: Diagnostic[];
+};
+export declare function inspectAppSpec(root: string, contract: AppSpecContractIndex, selector?: string): AppSpecContext;
+export declare function advisoryAppSpecDiagnostics(diagnostics: Diagnostic[]): {
+    severity: "info" | "warning";
+    remediation: string;
+    schemaVersion: typeof SCHEMA_VERSIONS.diagnostic;
+    code: string;
+    message: string;
+    path?: string;
+    source?: string;
+    retryable: boolean;
+    details?: Record<string, unknown>;
+}[];
+export declare function summarizeAppSpecContext(context: AppSpecContext): {
+    enabled: boolean;
+    mode: "advisory";
+    releaseGate: false;
+    workspaceDigest: string | null;
+    selectionDigest: string | null;
+    contextBudget: {
+        maximumBytes: number;
+        contentBytes: number;
+        truncated: boolean;
+        omitted: AppSpecDocumentSummary[];
+    };
+    stats: {
+        files: number;
+        bytes: number;
+        capabilities: number;
+        activeChanges: number;
+        historyChanges: number;
+        decisions: number;
+        requirements: number;
+        acceptanceScenarios: number;
+    };
+    diagnostics: {
+        errors: number;
+        warnings: number;
+        info: number;
+    };
+    nextCommand: string;
+};
+export {};
+//# sourceMappingURL=app-spec.d.ts.map

package/dist/app-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-spec.d.ts","sourceRoot":"","sources":["../src/app-spec.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,eAAe,EACf,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,gBAAgB;;;;;;CAMnB,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;;;CAOlB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC7C,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,QAAQ,GAAG,gBAAgB,CAAC;AAC/E,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/E,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;AAEjD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE;QACV,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,OAAO,gBAAgB,CAAC,OAAO,CAAC;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,KAAK,CAAC;IACnB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,EAAE;QACL,WAAW,EAAE,sBAAsB,GAAG,IAAI,CAAC;QAC3C,YAAY,EAAE,sBAAsB,EAAE,CAAC;QACvC,aAAa,EAAE,sBAAsB,EAAE,CAAC;QACxC,SAAS,EAAE,sBAAsB,EAAE,CAAC;QACpC,OAAO,EAAE,sBAAsB,EAAE,CAAC;KACnC,CAAC;IACF,WAAW,EAAE,eAAe,GAAG,IAAI,CAAC;IACpC,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,aAAa,EAAE,eAAe,EAAE,CAAC;IACjC,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,aAAa,EAAE;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,OAAO,CAAC;QACnB,OAAO,EAAE,sBAAsB,EAAE,CAAC;KACnC,CAAC;IACF,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA6B,SAAQ,sBAAsB;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC;IAC3D,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AASD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB;;;;;;;EA8B9D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B;;;;;;EA0B1E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB;;;;;;;;EAiClE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB;;;;;;;;;;;;;;;;;;EA2GhE;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,CAAC,EAAE,MAAM,GAChB,cAAc,CAkFhB;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,UAAU,EAAE;;;;;;;;;;IASnE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc;;;;;;;sBA1W7C,MAAM;sBACN,MAAM;mBACT,OAAO;iBACT,sBAAsB,EAAE;;;eAG1B,MAAM;eACN,MAAM;sBACC,MAAM;uBACL,MAAM;wBACL,MAAM;mBACX,MAAM;sBACH,MAAM;6BACC,MAAM;;;;;;;;EA+W9B"}