@openflowjs/cli 0.2.0

package/dist/commands/validate.js

@@ -0,0 +1,310 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { isRecord, errorMessage, collectFiles } from "../shared/fs.js";
+import { printSuccess, printFailure, printFileStatus } from "../shared/terminal.js";
+import { FLOW_GATES, normalizeOpenFlowStage, validateOpenFlowArtifacts, } from "../core/index.js";
+export async function runValidateCommand(args) {
+    const options = parseValidateArgs(args);
+    const result = await validateFlowDirectory(options.flowPath);
+    printValidationResult(result.issues, options.json);
+    if (!result.valid) {
+        process.exitCode = 1;
+    }
+}
+function parseValidateArgs(args) {
+    const options = {
+        flowPath: ".openflow",
+        json: false
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--json") {
+            options.json = true;
+            continue;
+        }
+        if (arg === "--flow") {
+            const value = args[index + 1];
+            if (!value) {
+                throw new Error("openflow validate --flow requires a path.");
+            }
+            options.flowPath = value;
+            index += 1;
+            continue;
+        }
+        throw new Error(`unknown validate option "${arg}". Supported options: --flow <path>, --json`);
+    }
+    return options;
+}
+async function validateFlowDirectory(flowPath) {
+    const issues = [];
+    if (!existsSync(flowPath)) {
+        return {
+            valid: false,
+            issues: [
+                {
+                    code: "flow.missing",
+                    message: `OpenFlow directory does not exist: ${flowPath}`,
+                    path: flowPath,
+                    severity: "error"
+                }
+            ]
+        };
+    }
+    const resolved = await resolveFlowDirectory(flowPath, issues);
+    if (!resolved) {
+        return {
+            valid: false,
+            issues
+        };
+    }
+    const artifacts = {};
+    if (resolved.projectPath) {
+        await readOptionalJson(resolved.projectPath, "config.json", issues, (value) => {
+            artifacts.config = value;
+        });
+    }
+    else {
+        await readOptionalJson(resolved.iterationPath, "config.json", issues, (value) => {
+            artifacts.config = value;
+        });
+    }
+    await readRequiredJson(resolved.iterationPath, "flow.json", issues, (value) => {
+        artifacts.flow = value;
+    });
+    await readRequiredMarkdown(resolved.iterationPath, "STATE.md", issues, (value) => {
+        artifacts.stateMarkdown = value;
+    });
+    await readRequiredMarkdown(resolved.iterationPath, "SPEC.md", issues, (value) => {
+        artifacts.specMarkdown = value;
+    });
+    const flowContext = resolveFlowValidationContext(artifacts.flow);
+    const requiresContext = requiresContextArtifact(flowContext);
+    const requiresPlanAndTasks = requiresPlanAndTasksArtifacts(flowContext);
+    await readMarkdownByRequirement(resolved.iterationPath, "CONTEXT.md", requiresContext, issues, (value) => {
+        artifacts.contextMarkdown = value;
+    });
+    await readMarkdownByRequirement(resolved.iterationPath, "PLAN.md", requiresPlanAndTasks, issues, (value) => {
+        artifacts.planMarkdown = value;
+    });
+    await readMarkdownByRequirement(resolved.iterationPath, "TASKS.md", requiresPlanAndTasks, issues, (value) => {
+        artifacts.tasksMarkdown = value;
+    });
+    await readOptionalJson(resolved.iterationPath, "reviews/spec-review.json", issues, (value) => {
+        artifacts.specReview = value;
+    });
+    await readOptionalMarkdown(resolved.iterationPath, "SUMMARY.md", issues, (value) => {
+        artifacts.summaryMarkdown = value;
+    });
+    artifacts.extensionResults = await readExtensionResults(resolved.iterationPath, issues);
+    issues.push(...validateOpenFlowArtifacts(artifacts).issues);
+    return {
+        valid: issues.every((issue) => issue.severity !== "error"),
+        issues
+    };
+}
+function resolveFlowValidationContext(flow) {
+    if (!isRecord(flow)) {
+        return {};
+    }
+    const level = isOpenFlowLevel(flow.level) ? flow.level : undefined;
+    const stage = normalizeOpenFlowStage(flow.stage) ?? undefined;
+    const gate = isFlowGate(flow.gate) ? flow.gate : undefined;
+    return { level, stage, gate };
+}
+function requiresContextArtifact(flow) {
+    return flow.level === "2" || flow.level === "3";
+}
+function requiresPlanAndTasksArtifacts(flow) {
+    if (!requiresContextArtifact(flow)) {
+        return false;
+    }
+    if (flow.stage === "implement" || flow.stage === "finalize" || flow.stage === "archived") {
+        return true;
+    }
+    return flow.stage === "spec" && flow.gate === "approved";
+}
+async function resolveFlowDirectory(flowPath, issues) {
+    if (existsSync(join(flowPath, "flow.json"))) {
+        return { iterationPath: flowPath };
+    }
+    if (!existsSync(join(flowPath, "current.json"))) {
+        issues.push({
+            code: "flow.iteration",
+            message: `OpenFlow validate expects an iteration directory or a project .openflow directory with current.json: ${flowPath}`,
+            path: flowPath,
+            severity: "error"
+        });
+        return undefined;
+    }
+    let current;
+    await readRequiredJson(flowPath, "current.json", issues, (value) => {
+        current = value;
+    });
+    if (!isRecord(current)) {
+        issues.push({
+            code: "current.type",
+            message: "current.json must contain a JSON object.",
+            path: "current.json",
+            severity: "error"
+        });
+        return undefined;
+    }
+    const activeIteration = current.activeIteration;
+    if (typeof activeIteration !== "string" || activeIteration.trim().length === 0) {
+        issues.push({
+            code: "current.activeIteration",
+            message: "current.json must point to an active iteration for validation.",
+            path: "current.json.activeIteration",
+            severity: "error"
+        });
+        return undefined;
+    }
+    const iterationPath = join(flowPath, "iterations", activeIteration);
+    if (!existsSync(iterationPath)) {
+        issues.push({
+            code: "current.activeIteration.missing",
+            message: `current.json points to a missing iteration: ${activeIteration}`,
+            path: iterationPath,
+            severity: "error"
+        });
+        return undefined;
+    }
+    return {
+        iterationPath,
+        projectPath: flowPath
+    };
+}
+async function readRequiredMarkdown(flowPath, fileName, issues, onRead) {
+    const value = await readOptionalText(flowPath, fileName, issues);
+    if (value === undefined) {
+        issues.push(missingFile(fileName));
+        return;
+    }
+    onRead(value);
+}
+async function readMarkdownByRequirement(flowPath, fileName, required, issues, onRead) {
+    if (required) {
+        await readRequiredMarkdown(flowPath, fileName, issues, onRead);
+        return;
+    }
+    await readOptionalMarkdown(flowPath, fileName, issues, onRead);
+}
+async function readOptionalMarkdown(flowPath, fileName, issues, onRead) {
+    const value = await readOptionalText(flowPath, fileName, issues);
+    if (value !== undefined) {
+        onRead(value);
+    }
+}
+async function readRequiredJson(flowPath, fileName, issues, onRead) {
+    const text = await readOptionalText(flowPath, fileName, issues);
+    if (text === undefined) {
+        issues.push(missingFile(fileName));
+        return;
+    }
+    parseJson(fileName, text, issues, onRead);
+}
+async function readOptionalJson(flowPath, fileName, issues, onRead) {
+    const text = await readOptionalText(flowPath, fileName, issues);
+    if (text !== undefined) {
+        parseJson(fileName, text, issues, onRead);
+    }
+}
+async function readOptionalText(flowPath, fileName, issues) {
+    const filePath = join(flowPath, fileName);
+    if (!existsSync(filePath)) {
+        return undefined;
+    }
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        issues.push({
+            code: "file.read",
+            message: `Could not read ${fileName}: ${errorMessage(error)}`,
+            path: fileName,
+            severity: "error"
+        });
+        return undefined;
+    }
+}
+function parseJson(fileName, text, issues, onRead) {
+    try {
+        onRead(JSON.parse(text));
+    }
+    catch (error) {
+        issues.push({
+            code: "json.parse",
+            message: `Could not parse ${fileName}: ${errorMessage(error)}`,
+            path: fileName,
+            severity: "error"
+        });
+    }
+}
+async function readExtensionResults(flowPath, issues) {
+    const extensionRoot = join(flowPath, "extensions");
+    if (!existsSync(extensionRoot)) {
+        return [];
+    }
+    const results = [];
+    const files = await collectFiles(extensionRoot);
+    for (const filePath of files) {
+        if (!filePath.endsWith("result.json")) {
+            continue;
+        }
+        const displayPath = relative(flowPath, filePath);
+        const text = await readFile(filePath, "utf8").catch((error) => {
+            issues.push({
+                code: "file.read",
+                message: `Could not read ${displayPath}: ${errorMessage(error)}`,
+                path: displayPath,
+                severity: "error"
+            });
+            return undefined;
+        });
+        if (text === undefined) {
+            continue;
+        }
+        parseJson(displayPath, text, issues, (value) => {
+            results.push({ path: displayPath, value });
+        });
+    }
+    return results;
+}
+function printValidationResult(issues, json) {
+    const valid = issues.every((issue) => issue.severity !== "error");
+    if (json) {
+        console.log(JSON.stringify({ valid, issues }, null, 2));
+        return;
+    }
+    if (valid) {
+        printSuccess("openflow validate: ok");
+        if (issues.length > 0) {
+            printIssues(issues);
+        }
+        return;
+    }
+    printFailure("openflow validate: failed");
+    printIssues(issues);
+}
+function printIssues(issues) {
+    for (const issue of issues) {
+        const location = issue.path ? ` ${issue.path}` : "";
+        printFileStatus(issue.severity, `${location} ${issue.code}: ${issue.message}`.trim());
+    }
+}
+function missingFile(fileName) {
+    return {
+        code: "file.missing",
+        message: `${fileName} is required for an active OpenFlow directory.`,
+        path: fileName,
+        severity: "error"
+    };
+}
+function isOpenFlowLevel(value) {
+    return value === "0" || value === "1" || value === "2" || value === "3";
+}
+function isFlowGate(value) {
+    return typeof value === "string" && FLOW_GATES.includes(value);
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"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"}

package/dist/core/artifacts.d.ts

@@ -0,0 +1,140 @@
+import { type OpenFlowStage, type OpenFlowLevel } from "./index.js";
+export declare const REVIEW_STATUSES: readonly ["approved", "changes_requested", "partial", "rejected"];
+export type ReviewStatus = (typeof REVIEW_STATUSES)[number];
+export declare const EXTENSION_STATUSES: readonly ["passed", "failed", "skipped"];
+export type ExtensionStatus = (typeof EXTENSION_STATUSES)[number];
+export declare const FLOW_GATES: readonly ["draft", "review_required", "changes_requested", "approved", "skipped", "blocked"];
+export type FlowGate = (typeof FLOW_GATES)[number];
+export interface OpenFlowConfig {
+    version: 1;
+    defaultLevel: OpenFlowLevel;
+    language?: string;
+    review?: {
+        required: boolean;
+        port?: number;
+    };
+    extensions?: Record<string, OpenFlowExtensionConfig>;
+    modules?: string[];
+}
+export interface OpenFlowExtensionConfig {
+    enabled: boolean;
+    required?: boolean;
+    hooks?: string[];
+    command?: string;
+    outputs?: string[];
+}
+export interface OpenFlowFlow {
+    id: string;
+    title: string;
+    level: OpenFlowLevel;
+    stage: OpenFlowStage;
+    revision: number;
+    gate: FlowGate;
+    createdAt: string;
+    updatedAt: string;
+    activeTask: string | null;
+    knowledge_citations?: KnowledgeCitation[];
+}
+export interface KnowledgeCitation {
+    id: string;
+    phase: "spec" | "implement";
+    wave: string | null;
+    injected_at: string;
+}
+export interface ReviewResult {
+    stage: "spec" | "plan" | "prd" | "archive";
+    revision: number;
+    status: ReviewStatus;
+    reviewedAt: string;
+    comments: string[];
+    requestedChanges: string[];
+    annotations?: ReviewAnnotation[];
+    approvedBy?: string;
+}
+export interface ReviewAnnotation {
+    id: string;
+    artifact: "SPEC.md" | "TASKS.md" | "CONTEXT.md" | "PLAN.md" | "SUMMARY.md";
+    section?: string;
+    lineStart?: number;
+    lineEnd?: number;
+    kind: "question" | "change" | "risk" | "nit";
+    severity: "blocking" | "non_blocking";
+    text: string;
+    status: "open" | "resolved";
+}
+export interface ExtensionResult {
+    name: string;
+    status: ExtensionStatus;
+    required: boolean;
+    summary: string;
+    artifacts: string[];
+    createdAt: string;
+}
+export interface PrdMeta {
+    id: string;
+    status: "draft" | "reviewing" | "approved";
+    revision: number;
+    linkedIteration: string | null;
+    assets: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface KnowledgeIndexFile {
+    path: string;
+    value: unknown;
+}
+export interface OpenFlowArtifactSet {
+    config?: unknown;
+    flow?: unknown;
+    specReview?: unknown;
+    archiveReview?: unknown;
+    extensionResults?: Array<{
+        path: string;
+        value: unknown;
+    }>;
+    stateMarkdown?: string;
+    specMarkdown?: string;
+    contextMarkdown?: string;
+    tasksMarkdown?: string;
+    planMarkdown?: string;
+    summaryMarkdown?: string;
+    knowledgeCatalog?: unknown;
+    knowledgeIndexFiles?: KnowledgeIndexFile[];
+    workingMemoryMarkdown?: string;
+    knowledgeSubDirs?: string[];
+}
+export interface StageTransitionInput {
+    level: OpenFlowLevel;
+    currentStage: OpenFlowStage;
+    targetStage: OpenFlowStage;
+    review?: ReviewResult;
+}
+export interface ValidationIssue {
+    code: string;
+    message: string;
+    path?: string;
+    severity: "error" | "warning";
+}
+export interface ValidationResult {
+    valid: boolean;
+    issues: ValidationIssue[];
+}
+export declare function validateOpenFlowConfig(value: unknown, path?: string): ValidationResult;
+export declare function validateFlowState(value: unknown, path?: string): ValidationResult;
+export declare function validateReviewResult(value: unknown, path?: string): ValidationResult;
+export declare function validateExtensionResult(value: unknown, path?: string): ValidationResult;
+export declare function validatePrdMeta(value: unknown, path?: string): ValidationResult;
+export declare function validateStateMarkdown(markdown: string, path?: string): ValidationResult;
+export declare function validateSpecMarkdown(markdown: string, path?: string, level?: OpenFlowLevel): ValidationResult;
+export declare function validateContextMarkdown(markdown: string, path?: string): ValidationResult;
+export declare function validateTasksMarkdown(markdown: string, path?: string): ValidationResult;
+export declare function validatePlanMarkdown(markdown: string, path?: string, level?: OpenFlowLevel): ValidationResult;
+export declare function validateSummaryMarkdown(markdown: string, path?: string): ValidationResult;
+export declare function validateKnowledgeCatalog(value: unknown, path?: string): ValidationResult;
+export declare function validateKnowledgeIndex(value: unknown, path?: string): ValidationResult;
+export declare function validateWorkingMemoryMarkdown(markdown: string, path?: string): ValidationResult;
+export declare function validateStageTransition(input: StageTransitionInput): ValidationResult;
+export declare function validateOpenFlowArtifacts(artifacts: OpenFlowArtifactSet): ValidationResult;
+export declare function requiresHumanReview(level: OpenFlowLevel): boolean;
+export declare function requiresReviewBeforeExecute(level: OpenFlowLevel): boolean;
+export declare function requiresArchiveReview(_level: OpenFlowLevel): boolean;