@supacloud/compiler 0.8.0 → 0.9.0

package/dist/inspect.d.ts

@@ -1,4 +1,15 @@
-import type { ApplicationGraph, Diagnostic } from "./types";
+import type { ApplicationGraph, Diagnostic, ModuleNode } from "./types";
+export interface ContextPack {
+    version: 1;
+    subject: string;
+    modules: ModuleNode[];
+    files: string[];
+    externalTokens: string[];
+    relatedModules: {
+        importedBy: string[];
+        imports: string[];
+    };
+}
 export interface DoctorResult {
     checks: Array<{
         name: string;
@@ -10,6 +21,11 @@ export interface DoctorResult {
 }
 export declare function formatGraph(graph: ApplicationGraph): string;
 export declare function explainGraph(graph: ApplicationGraph, subject: string): string;
+/**
+ * Extracts the smallest graph neighborhood that is useful for an agent
+ * editing one feature: the subject module, its imports, and its dependents.
+ */
+export declare function createContextPack(graph: ApplicationGraph, subject: string): ContextPack;
 export declare function doctorProject(rootDir: string, outDir: string, graph: ApplicationGraph, upToDate: boolean, diagnostics?: Diagnostic[]): DoctorResult;
 /**
  * Exports the application module architecture as a Mermaid graph diagram.

package/dist/traits.d.ts

@@ -1,5 +1,5 @@
 import * as ts from "@typescript/typescript6";
-export type TraitKind = "module" | "injectable" | "controller" | "command" | "query" | "defineModule" | "injectionToken";
+export type TraitKind = "module" | "injectable" | "controller" | "command" | "query" | "defineModule" | "defineFeatureSlice" | "injectionToken";
 export interface TraitRecord {
     kind: TraitKind;
     name: string;

package/dist/types.d.ts

@@ -42,7 +42,56 @@ export interface Diagnostic {
     errorCode?: string;
     /** Documentation URL for this diagnostic. */
     docsUrl?: string;
+    /** Machine-readable remediation that an agent or IDE can apply. */
+    fix?: DiagnosticFix;
 }
+/**
+ * Stable, semantic repair actions. These intentionally describe intent rather
+ * than raw text offsets so fixes remain valid after unrelated edits.
+ */
+export type DiagnosticFix = {
+    type: "add_module_import";
+    targetFile: string;
+    module: string;
+    provider?: string;
+    importPath?: string;
+    symbol?: string;
+    targetModule?: string;
+} | {
+    type: "add_provider";
+    targetFile: string;
+    token: string;
+    module: string;
+} | {
+    type: "mark_optional_dependency";
+    targetFile: string;
+    owner: string;
+    token: string;
+} | {
+    type: "change_provider_scope";
+    targetFile: string;
+    provider: string;
+    from: Scope;
+    to: Scope;
+} | {
+    type: "add_command_permission";
+    targetFile: string;
+    command: string;
+    module: string;
+    permission?: string;
+} | {
+    type: "add_route_parameter_binding";
+    targetFile: string;
+    controller: string;
+    route: string;
+    parameter: string;
+    binding: "param" | "query";
+} | {
+    type: "remove_route_body_binding";
+    targetFile: string;
+    controller: string;
+    route: string;
+};
 export interface ProviderNode {
     /** Token name (InjectionToken variable name or class name). */
     token: string;
@@ -180,6 +229,24 @@ export interface QueryNode {
     className: string;
     name: string;
 }
+export interface FeatureTransitionNode {
+    name: string;
+    from: string;
+    to: string;
+    permission?: string;
+    command?: string;
+    route?: string;
+    transaction?: "required" | "none";
+    idempotency?: "required" | "none";
+    audit?: string;
+}
+export interface FeatureSpecNode {
+    name: string;
+    states: string[];
+    transitions: FeatureTransitionNode[];
+    file?: string;
+    line?: number;
+}
 export interface ModuleNode {
     /** Name from @Module({ name }) or defineModule. */
     name: string;
@@ -199,6 +266,7 @@ export interface ModuleNode {
     aspects?: AspectRefNode[];
     /** Exported token names. */
     exports: string[];
+    featureSpec?: FeatureSpecNode;
 }
 export interface ApplicationGraph {
     modules: ModuleNode[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/compiler",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Static compiler for @supacloud/app metadata: builds the application graph from AST, validates it, and generates reflection-free factory code",
   "type": "module",
   "main": "./dist/index.js",
@@ -27,6 +27,7 @@
     "clean": "rm -rf dist",
     "prepublishOnly": "bun run build",
     "test": "bun test",
+    "benchmark": "bun run src/benchmark.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "typecheck:test": "tsc -p tsconfig.test.json --noEmit"
   },