intentdna 1.7.4 → 1.8.0

package/dist/assets/candidates.d.ts

@@ -0,0 +1,124 @@
+import { type WorkflowAssetSummary } from "./catalog.js";
+import { type WorkflowAssetEvidenceIndex, type WorkflowAssetEvidenceModule } from "./evidence.js";
+export type AssetCandidateType = "stabilize_current_asset" | "extract_workflow" | "evidence_infrastructure" | "active_evidence_followup" | "captured_run_fact_bootstrap" | "captured_run_fact_review";
+export type WorkflowCandidateEditOperation = "insert_step" | "add_verifier" | "tighten_boundary" | "split_step" | "replace_role";
+export type WorkflowCandidateActionPathStepId = "source_lineage" | "source_evidence" | "candidate_action" | "candidate_inspect" | "candidate_governance" | "candidate_diff" | "manager_rationale" | "adoption_review" | "evolution_preview" | "organization_bind" | "local_init" | "sync_dry_run" | "sync_apply" | "rerun_suggestions" | "rerun_mine" | "rollout_review";
+export type WorkflowCandidateActionPathStatus = "ready" | "current" | "later";
+export interface WorkflowCandidateActionPathStep {
+    id: WorkflowCandidateActionPathStepId;
+    label: string;
+    command: string;
+    purpose: string;
+    writes: boolean;
+    status: WorkflowCandidateActionPathStatus;
+}
+export type WorkflowCandidateAction = {
+    kind: "review";
+    command: string;
+    reason: string;
+} | {
+    kind: "draft";
+    goal: string;
+    example: "dev_pipeline" | "evidence_review" | "rewrite_governance";
+    strictness: "high";
+    saveTemplate: string;
+    command: string;
+    scaffold: true;
+    deprecatedPrimaryCreationPath: "dna workflow authoring-packet";
+} | {
+    kind: "edit_plan";
+    instruction: string;
+    fromTemplate: string;
+    workflow: string;
+    operation: WorkflowCandidateEditOperation;
+    targetStep: string;
+    saveTemplate: string;
+    command: string;
+};
+export interface AssetWorkflowCandidate {
+    id: string;
+    type: AssetCandidateType;
+    priority: "high" | "medium" | "low";
+    title: string;
+    candidateAssetName: string;
+    sourceAsset: string;
+    evidence: string;
+    rationale: string;
+    sourceModules: string[];
+    sourceWorkflows: string[];
+    nextCommand: string;
+    reviewCommands: string[];
+    actionPath: WorkflowCandidateActionPathStep[];
+    mutationBoundary: string;
+    plainLanguage?: {
+        label: string;
+        purpose: string;
+        workflowImprovement: string;
+        preserves: string[];
+        requiredBeforeUse: string[];
+    };
+    continuityBoundary?: string;
+    action: WorkflowCandidateAction;
+}
+export interface AssetCandidateReviewPacket {
+    currentState: string;
+    primaryAction: string;
+    decision: "review_active_evidence_first" | "review_candidates" | "no_candidates";
+    reason: string;
+    allowedNow: string[];
+    blockedNow: string[];
+    reviewPath: string[];
+}
+export interface AssetCandidateBacklog {
+    mode: "workflow_candidate_backlog";
+    scope: "asset" | "all_assets";
+    focusAsset?: string;
+    summary: {
+        assetsScanned: number;
+        dogfoodAssets: number;
+        evidenceModules: number;
+        pass: number;
+        activeModules: number;
+        captureFacts: number;
+        captureGaps: number;
+        candidates: number;
+    };
+    reviewPacket: AssetCandidateReviewPacket;
+    candidates: AssetWorkflowCandidate[];
+    nextCommands: string[];
+    mutation: {
+        writes: false;
+        note: string;
+    };
+}
+export type ActiveEvidenceFollowupRouteStatus = "draft_missing" | "draft_incomplete" | "draft_structural_drift" | "draft_reviewable";
+export interface ActiveEvidenceFollowupReviewRoute {
+    candidateId: string;
+    sourceAsset: string;
+    candidateAssetName: string;
+    status: ActiveEvidenceFollowupRouteStatus;
+    candidateAsset?: WorkflowAssetSummary;
+    currentEvidence?: string;
+    createCommand: string;
+    inspectCommand: string;
+    governanceCommand: string;
+    diffCommand: string;
+    adoptionCommand: string;
+    bindCommand: string;
+    rolloutCommand: string;
+    currentCommand: string;
+    currentWrites: boolean;
+    reason: string;
+    reviewCommands: string[];
+}
+export declare function activeEvidenceModules(index: WorkflowAssetEvidenceIndex): WorkflowAssetEvidenceModule[];
+export declare function activeEvidenceFollowupRoute(asset: string): {
+    candidateId: string;
+    assetName: string;
+    command: string;
+};
+export declare function activeEvidenceFollowupReviewRoute(sourceAsset: string, assets: WorkflowAssetSummary[], evidenceIndex?: WorkflowAssetEvidenceIndex): ActiveEvidenceFollowupReviewRoute;
+export declare function buildWorkflowAssetCandidateBacklog(opts: {
+    name?: string;
+    projectDir?: string;
+}): Promise<AssetCandidateBacklog | undefined>;