@tiic-tech/openworkflow 0.1.0 → 0.1.2

package/dist/cli/src/commands/doctor.js

@@ -1,26 +1,136 @@
 import { resolve } from "node:path";
-import { doctorCodexAdapter } from "../../../adapters/codex/src/doctorCodexAdapter.js";
-import { stringFlag } from "../args.js";
-import { parseTools } from "./shared.js";
+import { detectAdapterPlatforms, getAdapterEntry, getSupportedAdapterIds } from "../../../adapters/src/registry.js";
+import { doctorAgentsGuide } from "../../../core/src/onboarding/agentsGuide.js";
+import { doctorOpenWorkflow } from "../../../core/src/workflow/doctorOpenWorkflow.js";
+import { readWorkflowConfig } from "../../../core/src/workflow/readWorkflowConfig.js";
+import { buildSummaryQualitySummary, evaluateSummaryHealth, evaluateSummaryQualityGate } from "../../../core/src/workflow/summaryHealth.js";
+import { booleanFlag, stringFlag } from "../args.js";
+import { emptyEffects, printJsonReport } from "../report.js";
+import { basenameForTitle, parseTools, slugify } from "./shared.js";
 export async function doctorCommand(flags) {
     const root = resolve(stringFlag(flags, "root", ".") ?? ".");
-    const tools = parseTools(stringFlag(flags, "tools", "codex"));
-    if (!tools.includes("codex")) {
-        console.error("No supported tools selected. M06 supports --tools codex.");
+    const json = booleanFlag(flags, "json");
+    const explicitTools = parseTools(stringFlag(flags, "tools"));
+    const autoTools = isAutoTools(explicitTools);
+    const detection = await detectAdapterPlatforms(root);
+    const tools = autoTools ? detection.detected : explicitTools;
+    const workflowTools = autoTools ? uniqueTools([...tools, ...detection.unknownConfigured]) : tools;
+    const supported = new Set(getSupportedAdapterIds());
+    const unsupportedRequested = tools.filter((tool) => !supported.has(tool));
+    if (unsupportedRequested.length > 0) {
+        if (json) {
+            printJsonReport({
+                command: "doctor",
+                ok: false,
+                root,
+                data: { requested_tools: tools, supported_tools: getSupportedAdapterIds() },
+                warnings: [],
+                errors: [`Unsupported tools selected: ${unsupportedRequested.join(", ")}.`],
+                effects: emptyEffects(),
+                next_actions: [`use --tools ${getSupportedAdapterIds().join(",") || "auto"}`],
+            });
+            return 1;
+        }
+        console.error(`Unsupported tools selected: ${unsupportedRequested.join(", ")}. Supported tools: ${getSupportedAdapterIds().join(", ")}.`);
         return 1;
     }
-    const adapter = await doctorCodexAdapter(root);
-    for (const warning of adapter.warnings) {
+    const config = await readWorkflowConfig(root);
+    const projectTitle = config?.projectTitle ?? basenameForTitle(root);
+    const projectSlug = slugify(config?.projectSlug ?? projectTitle);
+    const workflow = await doctorOpenWorkflow({
+        root,
+        projectTitle,
+        projectSlug,
+        tools: workflowTools,
+        force: false,
+    });
+    const agentsGuide = await doctorAgentsGuide(root);
+    const summaryHealth = await evaluateSummaryHealth(root);
+    const handoffQuality = evaluateSummaryQualityGate(summaryHealth, true);
+    const qualitySummary = buildSummaryQualitySummary(summaryHealth, handoffQuality);
+    const adapterResults = [];
+    for (const tool of tools) {
+        const adapter = getAdapterEntry(tool);
+        if (!adapter) {
+            continue;
+        }
+        adapterResults.push({ tool, result: await adapter.doctor(root) });
+    }
+    const warnings = [
+        ...workflow.warnings,
+        ...agentsGuide.warnings,
+        ...summaryHealth.warnings.map((warning) => `summary health: ${warning}`),
+        ...detection.unknownConfigured.map((tool) => `Configured tool is not supported by this OpenWorkflow version and was not checked: ${tool}`),
+        ...adapterResults.flatMap((entry) => entry.result.warnings),
+    ];
+    const errors = [...workflow.errors, ...agentsGuide.errors, ...adapterResults.flatMap((entry) => entry.result.errors)];
+    const managedSurfaceOk = workflow.ok && agentsGuide.ok;
+    const adapterOk = adapterResults.every((entry) => entry.result.ok);
+    const summaryFreshnessOk = summaryHealth.ok;
+    const handoffQualityOk = qualitySummary.handoff_quality_ok;
+    const ok = managedSurfaceOk && adapterOk;
+    if (json) {
+        printJsonReport({
+            command: "doctor",
+            ok,
+            root,
+            data: {
+                workflow,
+                agents_md: agentsGuide,
+                summary_health: summaryHealth,
+                strict_quality: handoffQuality,
+                quality_summary: qualitySummary,
+                managed_surface_ok: managedSurfaceOk,
+                adapter_ok: adapterOk,
+                summary_freshness_ok: summaryFreshnessOk,
+                handoff_quality_ok: handoffQualityOk,
+                scope: {
+                    managed_surfaces: "doctor ok covers generated workflow files, AGENTS.md managed block, and selected adapters",
+                    artifact_summaries: "summary freshness and handoff quality are reported separately; use openworkflow summaries --strict --json for artifact summary trust",
+                },
+                detection,
+                tools,
+                adapters: Object.fromEntries(adapterResults.map((entry) => [entry.tool, entry.result])),
+            },
+            warnings,
+            errors,
+            effects: emptyEffects(),
+            next_actions: doctorNextActions(ok, summaryHealth.ok, handoffQuality.ok),
+        });
+        return ok ? 0 : 1;
+    }
+    for (const warning of warnings) {
         console.warn(`Warning: ${warning}`);
     }
-    if (!adapter.ok) {
-        console.error("OpenWorkflow doctor found adapter issues:");
-        for (const error of adapter.errors) {
+    if (!ok) {
+        console.error("OpenWorkflow doctor found issues:");
+        for (const error of errors) {
             console.error(`- ${error}`);
         }
         return 1;
     }
-    console.log(adapter.warnings.length > 0 ? "OpenWorkflow doctor passed with warnings." : "OpenWorkflow doctor passed.");
+    console.log(warnings.length > 0 ? "OpenWorkflow doctor passed with warnings." : "OpenWorkflow doctor passed.");
+    if (!handoffQuality.ok) {
+        console.log("handoff_quality: warnings; run openworkflow summaries --root . --strict --json");
+    }
     return 0;
 }
+function doctorNextActions(ok, summariesOk, handoffQualityOk) {
+    if (!ok) {
+        return ["run openworkflow sync, then openworkflow doctor"];
+    }
+    if (!summariesOk) {
+        return ["run openworkflow summaries --json before relying on low-context artifact reads"];
+    }
+    if (!handoffQualityOk) {
+        return ["run openworkflow summaries --root . --strict --json before trusting artifact handoff quality"];
+    }
+    return [];
+}
+function isAutoTools(tools) {
+    return tools.length === 0 || tools.includes("auto");
+}
+function uniqueTools(tools) {
+    return [...new Set(tools)];
+}
 //# sourceMappingURL=doctor.js.map

package/dist/cli/src/commands/doctor.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../../packages/cli/src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAoC;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAE9D,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC1E,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC/C,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC3D,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,2CAA2C,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC;IACvH,OAAO,CAAC,CAAC;AACX,CAAC"}
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../../packages/cli/src/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/cli/src/commands/draft.d.ts

@@ -0,0 +1 @@
+export declare function draftCommand(flags: Map<string, string | boolean>): Promise<number>;

package/dist/cli/src/commands/draft.js

@@ -0,0 +1,175 @@
+import { mkdir, stat, writeFile } from "node:fs/promises";
+import { dirname, join, relative, resolve } from "node:path";
+import { getDiscoveryArtifactContracts } from "../../../core/src/artifacts/registry.js";
+import { dumpYaml } from "../../../core/src/contracts/yaml.js";
+import { isNotFound } from "../../../core/src/fs/index.js";
+import { booleanFlag, stringFlag } from "../args.js";
+import { emptyEffects, printJsonReport } from "../report.js";
+export async function draftCommand(flags) {
+    const root = resolve(stringFlag(flags, "root", ".") ?? ".");
+    const json = booleanFlag(flags, "json");
+    const write = booleanFlag(flags, "write");
+    const force = booleanFlag(flags, "force");
+    const artifactType = stringFlag(flags, "artifact");
+    const id = stringFlag(flags, "id");
+    if (!(await isInitialized(root))) {
+        return finishError(root, json, "missing OpenWorkflow artifact contracts: .openworkflow/audit/ARTIFACT_CONTRACTS.yaml", [
+            "run openworkflow init <folder> --tools codex, or run openworkflow sync on an initialized project",
+        ]);
+    }
+    if (!artifactType) {
+        return finishError(root, json, "missing --artifact <type>", ["run openworkflow draft --root . --artifact validation_target --id val-1 --json"]);
+    }
+    if (!id || !isSafeId(id)) {
+        return finishError(root, json, "invalid --id; use lowercase letters, numbers, dots, underscores, or hyphens", [
+            "rerun with an id like val-1 or proto-2026-05-20",
+        ]);
+    }
+    const contract = getDiscoveryArtifactContracts().find((item) => item.artifactType === artifactType);
+    if (!contract) {
+        return finishError(root, json, `unknown artifact type: ${artifactType}`, [
+            `supported artifact types: ${getDiscoveryArtifactContracts().map((item) => item.artifactType).join(", ")}`,
+        ]);
+    }
+    const model = buildDraftModel(contract, id, write, force);
+    const effects = await applyDraft(root, model, write, force);
+    const ok = effects.skipped.length === 0;
+    const warnings = effects.skipped.map((item) => item);
+    const errors = ok ? [] : effects.skipped;
+    if (json) {
+        printJsonReport({
+            command: "draft",
+            ok,
+            root,
+            data: model,
+            warnings,
+            errors,
+            effects,
+            next_actions: ok
+                ? [`edit ${model.path} with task-specific content`, "run openworkflow validate --root . --json"]
+                : ["rerun with --force only if replacing the existing draft is intended"],
+        });
+    }
+    else {
+        printDraft(model, effects);
+    }
+    return ok ? 0 : 1;
+}
+function buildDraftModel(contract, id, write, force) {
+    const path = replaceId(contract.sourceOfTruthPath, id);
+    return {
+        artifact_type: contract.artifactType,
+        id,
+        write,
+        force,
+        path,
+        contract: {
+            command: contract.command,
+            source_of_truth_path: contract.sourceOfTruthPath,
+            index_path: contract.indexPath,
+            summary_policy: contract.summaryPolicy?.strategy ?? null,
+        },
+        content: dumpYaml(replacePlaceholders(contract.template, id)),
+    };
+}
+async function applyDraft(root, model, write, force) {
+    const effects = emptyEffects();
+    const absolutePath = join(root, model.path);
+    const normalized = relative(root, absolutePath);
+    if (normalized.startsWith("..")) {
+        effects.skipped.push(`draft path escapes root: ${model.path}`);
+        return effects;
+    }
+    if (await exists(absolutePath)) {
+        if (!force) {
+            effects.skipped.push(`artifact already exists: ${model.path}`);
+            return effects;
+        }
+        if (!write) {
+            effects.planned.push(model.path);
+            return effects;
+        }
+        await writeArtifact(absolutePath, model.content);
+        effects.updated.push(model.path);
+        return effects;
+    }
+    if (!write) {
+        effects.planned.push(model.path);
+        return effects;
+    }
+    await writeArtifact(absolutePath, model.content);
+    effects.written.push(model.path);
+    return effects;
+}
+async function writeArtifact(path, content) {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, content, "utf8");
+}
+async function isInitialized(root) {
+    return exists(join(root, ".openworkflow", "audit", "ARTIFACT_CONTRACTS.yaml"));
+}
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch (error) {
+        if (isNotFound(error)) {
+            return false;
+        }
+        throw error;
+    }
+}
+function replacePlaceholders(value, id) {
+    if (typeof value === "string") {
+        return replaceId(value, id);
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => replacePlaceholders(item, id));
+    }
+    if (isRecord(value)) {
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, replacePlaceholders(item, id)]));
+    }
+    return value;
+}
+function replaceId(value, id) {
+    return value.replaceAll("<id>", id);
+}
+function isSafeId(value) {
+    return /^[a-z0-9][a-z0-9._-]*$/u.test(value) && !value.includes("..") && !value.includes("/") && !value.includes("\\");
+}
+function printDraft(model, effects) {
+    console.log("OpenWorkflow draft");
+    console.log(`artifact_type: ${model.artifact_type}`);
+    console.log(`id: ${model.id}`);
+    console.log(`path: ${model.path}`);
+    console.log(`write: ${model.write}`);
+    console.log(`force: ${model.force}`);
+    console.log(`planned: ${effects.planned.length}, written: ${effects.written.length}, updated: ${effects.updated.length}, skipped: ${effects.skipped.length}`);
+    if (!model.write) {
+        console.log("---");
+        console.log(model.content.trimEnd());
+    }
+}
+function finishError(root, json, error, nextActions) {
+    if (json) {
+        printJsonReport({
+            command: "draft",
+            ok: false,
+            root,
+            data: { ok: false },
+            warnings: [],
+            errors: [error],
+            effects: emptyEffects(),
+            next_actions: nextActions,
+        });
+    }
+    else {
+        console.error(error);
+    }
+    return 1;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=draft.js.map

package/dist/cli/src/commands/draft.js.map

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

package/dist/cli/src/commands/gitAutomation.d.ts

@@ -0,0 +1 @@
+export declare function gitAutomationCommand(positional: string[], flags: Map<string, string | boolean>): Promise<number>;