@akanjs/devkit 2.3.9-rc.7 → 2.3.9-rc.8

package/workflow/types.ts

@@ -108,6 +108,133 @@ export interface WorkflowRecommendation {
   confidence?: "high" | "medium" | "low";
 }
 
+export interface AkanSourceSpan {
+  file: string;
+  startLine: number;
+  endLine: number;
+  startOffset: number;
+  endOffset: number;
+}
+
+export type AkanIndexedFileKind =
+  | "abstract"
+  | "constant"
+  | "dictionary"
+  | "service"
+  | "signal"
+  | "store"
+  | "template"
+  | "unit"
+  | "util"
+  | "view"
+  | "zone"
+  | "other";
+
+export interface AkanIndexedFile {
+  kind: AkanIndexedFileKind;
+  path: string;
+  expectedPath: string;
+  filename: string;
+  expectedFilename: string;
+  present: boolean;
+  casing: "match" | "mismatch" | "missing";
+}
+
+export type AkanFieldOutlineKind = "constant" | "dictionary" | "lightProjection";
+
+export interface AkanFieldOutline {
+  name: string;
+  kind: AkanFieldOutlineKind;
+  order: number;
+  typeSummary?: string;
+  sourceSpan: AkanSourceSpan;
+}
+
+export interface AkanProjectionOutline {
+  className: string;
+  fields: AkanFieldOutline[];
+  sourceSpan?: AkanSourceSpan;
+}
+
+export interface AkanConstantIndex {
+  path: string;
+  inputClassName: string;
+  builderName: string | null;
+  fields: AkanFieldOutline[];
+  lightProjection?: AkanProjectionOutline;
+  sourceSpan?: AkanSourceSpan;
+}
+
+export interface AkanDictionaryIndex {
+  path: string;
+  modelClassName: string;
+  translatorName: string | null;
+  fields: AkanFieldOutline[];
+  sourceSpan?: AkanSourceSpan;
+}
+
+export interface AkanFieldPresence {
+  name: string;
+  requested: boolean;
+  constant: boolean;
+  dictionary: boolean;
+  lightProjection: boolean;
+}
+
+export interface AkanModuleContextIndex {
+  schemaVersion: 1;
+  app: string;
+  module: string;
+  moduleClassName: string;
+  files: AkanIndexedFile[];
+  fieldPresence: AkanFieldPresence[];
+  constant?: AkanConstantIndex;
+  dictionary?: AkanDictionaryIndex;
+  diagnostics: WorkflowDiagnostic[];
+}
+
+export type InspectAkanContextRequest =
+  | { type: "workspaceOverview" }
+  | { type: "moduleContext"; app: string; module: string }
+  | { type: "fieldInsertionContext"; app: string; module: string; field: string; fieldType: string }
+  | { type: "workflowDiagnostics"; runIdOrPlan: string }
+  | { type: "escape"; reason: string; nextStep?: string };
+
+export interface InspectAkanContextProps {
+  question: string;
+  draft: {
+    reason: string;
+    type: InspectAkanContextRequest["type"];
+  };
+  review: string;
+  request: InspectAkanContextRequest;
+}
+
+export interface AkanContextEvidence {
+  kind: "workspace" | "module" | "field-insertion" | "workflow" | "escape";
+  summary: string;
+  path?: string;
+  target?: string;
+  sourceSpan?: AkanSourceSpan;
+}
+
+export interface AkanContextNext {
+  action: "answer" | "inspect" | "plan_workflow" | "validate" | "escape" | "clarify";
+  reason: string;
+  tool?: string;
+  args?: Record<string, unknown>;
+}
+
+export interface InspectAkanContextResult {
+  schemaVersion: 1;
+  type: InspectAkanContextRequest["type"];
+  question: string;
+  diagnostics: WorkflowDiagnostic[];
+  evidence: AkanContextEvidence[];
+  next: AkanContextNext;
+  data?: Record<string, unknown>;
+}
+
 export interface WorkflowPlan {
   schemaVersion: 1;
   workflow: string;
@@ -184,6 +311,8 @@ export interface WorkflowPostApplyCheck {
   message: string;
 }
 
+export type WorkflowNextActionCode = "answer" | "validate" | "manual-review" | "repair" | "blocked";
+
 export interface PrimitiveGeneratedFile {
   path: string;
   action: "sync";
@@ -198,6 +327,7 @@ export interface PrimitiveValidationCommand {
 export interface PrimitiveNextAction {
   command: string;
   reason: string;
+  action?: WorkflowNextActionCode;
 }
 
 export interface PrimitiveWriteReport {