@tiic-tech/openworkflow 0.1.0 → 0.1.2

package/dist/core/src/artifacts/readiness.js

@@ -0,0 +1,240 @@
+import { join } from "node:path";
+import { parseYaml } from "../contracts/yaml.js";
+import { isNotFound, readTextFile } from "../fs/index.js";
+export async function assessStageReadiness(root, command, currentState) {
+    if (command === "/ow:proto") {
+        return assessOptionalCurrentArtifact(root, currentState, "current_validation", validationTargetChecks);
+    }
+    if (command === "/ow:design") {
+        return assessCurrentArtifact(root, currentState, "current_prototype", prototypeEvidenceChecks);
+    }
+    if (command === "/ow:spec") {
+        return assessCurrentArtifact(root, currentState, "current_design", productDesignChecks);
+    }
+    if (command === "/ow:change") {
+        return assessCurrentArtifact(root, currentState, "current_spec", productionSpecChecks);
+    }
+    if (command === "/ow:team") {
+        return assessCurrentArtifact(root, currentState, "current_change", productionChangeChecks);
+    }
+    return { ok: true, blockers: [], warnings: [] };
+}
+async function assessOptionalCurrentArtifact(root, currentState, pointerKey, check) {
+    const artifactPath = stringValue(currentState?.[pointerKey]);
+    if (!artifactPath) {
+        return {
+            ok: false,
+            gate_status: "missing_validation",
+            blockers: [
+                `CURRENT_STATE.${pointerKey} is not set; before /ow:proto, auto-run /ow:validation and write a validation artifact with trigger.mode agent_auto`,
+            ],
+            warnings: [],
+        };
+    }
+    const artifact = await readArtifact(root, artifactPath);
+    if (!artifact) {
+        return {
+            ok: false,
+            gate_status: "missing_validation",
+            blockers: [`CURRENT_STATE.${pointerKey} references missing or unreadable artifact: ${artifactPath}`],
+            warnings: [],
+        };
+    }
+    return check(artifactPath, artifact);
+}
+async function assessCurrentArtifact(root, currentState, pointerKey, check) {
+    const artifactPath = stringValue(currentState?.[pointerKey]);
+    if (!artifactPath) {
+        return {
+            ok: false,
+            blockers: [`CURRENT_STATE.${pointerKey} is required for this command`],
+            warnings: [],
+        };
+    }
+    const artifact = await readArtifact(root, artifactPath);
+    if (!artifact) {
+        return {
+            ok: false,
+            blockers: [`CURRENT_STATE.${pointerKey} references missing or unreadable artifact: ${artifactPath}`],
+            warnings: [],
+        };
+    }
+    return check(artifactPath, artifact);
+}
+function validationTargetChecks(path, artifact) {
+    const blockers = commonArtifactBlockers(path, artifact, "validation_target");
+    const warnings = [];
+    if (!nonEmptyString(artifact.core_question)) {
+        blockers.push(`${path} core_question must be non-empty before /ow:proto`);
+    }
+    if (!nonEmptyString(artifact.central_uncertainty)) {
+        blockers.push(`${path} central_uncertainty must be non-empty before /ow:proto`);
+    }
+    if (!nonEmptyString(artifact.target_behavior)) {
+        blockers.push(`${path} target_behavior must be non-empty before /ow:proto`);
+    }
+    if (!hasNonEmptyPath(artifact, ["prototype_scope", "include"])) {
+        blockers.push(`${path} prototype_scope.include must name at least one prototype scope item before /ow:proto`);
+    }
+    if (!hasNonEmptyPath(artifact, ["prototype_experiment", "scenario"])) {
+        blockers.push(`${path} prototype_experiment.scenario must be non-empty before /ow:proto`);
+    }
+    if (!hasNonEmptyPath(artifact, ["prototype_experiment", "must_show"])) {
+        blockers.push(`${path} prototype_experiment.must_show must name at least one required prototype moment before /ow:proto`);
+    }
+    if (!hasNonEmptyPath(artifact, ["observable_signals", "pass"])) {
+        blockers.push(`${path} observable_signals.pass must name at least one pass signal before /ow:proto`);
+    }
+    if (!hasNonEmptyPath(artifact, ["observable_signals", "fail"])) {
+        blockers.push(`${path} observable_signals.fail must name at least one fail signal before /ow:proto`);
+    }
+    if (!nonEmptyArray(artifact.acceptance)) {
+        blockers.push(`${path} acceptance must name at least one success criterion before /ow:proto`);
+    }
+    if (!hasNonEmptyPath(artifact, ["decision_rules", "continue"])) {
+        blockers.push(`${path} decision_rules.continue must be non-empty before /ow:proto`);
+    }
+    if (!hasNonEmptyPath(artifact, ["decision_rules", "revise"])) {
+        blockers.push(`${path} decision_rules.revise must be non-empty before /ow:proto`);
+    }
+    const declaredGateStatus = validationGateStatus(valueAtPath(artifact, ["agent_readiness_gate", "status"]));
+    if (declaredGateStatus === "return_to_vision") {
+        blockers.push(`${path} agent_readiness_gate.status is return_to_vision; run /ow:vision before /ow:proto`);
+    }
+    else if (declaredGateStatus === "stale_validation") {
+        blockers.push(`${path} agent_readiness_gate.status is stale_validation; refresh /ow:validation before /ow:proto`);
+    }
+    else if (declaredGateStatus === "thin_validation") {
+        blockers.push(`${path} agent_readiness_gate.status is thin_validation; complete the validation target before /ow:proto`);
+    }
+    else if (!declaredGateStatus) {
+        warnings.push(`${path} agent_readiness_gate.status is missing; inferred readiness from validation fields`);
+    }
+    return result(blockers, warnings, blockers.length === 0 ? "ready_for_proto" : declaredGateStatus ?? "thin_validation");
+}
+function prototypeEvidenceChecks(path, artifact) {
+    const blockers = commonArtifactBlockers(path, artifact, "prototype_evidence");
+    const resultValue = stringValue(artifact.result);
+    if (resultValue !== "pass") {
+        blockers.push(`${path} result must be pass before /ow:design`);
+    }
+    const status = stringValue(artifact.status);
+    if (status && !["accepted", "reviewed"].includes(status)) {
+        blockers.push(`${path} status must be accepted or reviewed before /ow:design`);
+    }
+    return result(blockers);
+}
+function productDesignChecks(path, artifact) {
+    const blockers = commonArtifactBlockers(path, artifact, "product_design");
+    if (!hasBooleanPath(artifact, ["spec_readiness", "ready"], true)) {
+        blockers.push(`${path} spec_readiness.ready must be true before /ow:spec`);
+    }
+    return result(blockers);
+}
+function productionSpecChecks(path, artifact) {
+    const blockers = commonArtifactBlockers(path, artifact, "production_spec");
+    if (!hasBooleanPath(artifact, ["change_readiness", "ready"], true)) {
+        blockers.push(`${path} change_readiness.ready must be true before /ow:change`);
+    }
+    return result(blockers);
+}
+function productionChangeChecks(path, artifact) {
+    const blockers = commonArtifactBlockers(path, artifact, "production_change");
+    if (!hasBooleanPath(artifact, ["runtime_readiness", "ready"], true)) {
+        blockers.push(`${path} runtime_readiness.ready must be true before /ow:team`);
+    }
+    return result(blockers);
+}
+function commonArtifactBlockers(path, artifact, artifactType) {
+    const blockers = [];
+    if (artifact.artifact_type !== artifactType) {
+        blockers.push(`${path} artifact_type must be ${artifactType}`);
+    }
+    const status = stringValue(artifact.status);
+    if (!status || status === "draft") {
+        blockers.push(`${path} status must be beyond draft before downstream handoff`);
+    }
+    if (isPlaceholder(artifact.title)) {
+        blockers.push(`${path} title must be filled before downstream handoff`);
+    }
+    return blockers;
+}
+async function readArtifact(root, path) {
+    try {
+        const parsed = parseYaml(await readTextFile(join(root, path)));
+        return isRecord(parsed) ? parsed : null;
+    }
+    catch (error) {
+        if (isNotFound(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+function result(blockers, warnings = [], gateStatus) {
+    return { ok: blockers.length === 0, gate_status: gateStatus, blockers, warnings };
+}
+function hasNonEmptyPath(record, path) {
+    return hasNonEmptyValue(valueAtPath(record, path));
+}
+function hasBooleanPath(record, path, expected) {
+    let current = record;
+    for (const part of path) {
+        if (!isRecord(current)) {
+            return false;
+        }
+        current = current[part];
+    }
+    return current === expected;
+}
+function hasNonEmptyValue(value) {
+    if (value === null || value === undefined) {
+        return false;
+    }
+    if (typeof value === "string") {
+        return value.trim().length > 0 && !isPlaceholder(value);
+    }
+    if (Array.isArray(value)) {
+        return value.some((item) => hasNonEmptyValue(item));
+    }
+    if (isRecord(value)) {
+        return Object.values(value).some((item) => hasNonEmptyValue(item));
+    }
+    return true;
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0 && !isPlaceholder(value);
+}
+function nonEmptyArray(value) {
+    return Array.isArray(value) && value.some((item) => hasNonEmptyValue(item));
+}
+function isPlaceholder(value) {
+    return typeof value === "string" && /^<[^>]+>$/u.test(value.trim());
+}
+function stringValue(value) {
+    return typeof value === "string" ? value : null;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function valueAtPath(record, path) {
+    let current = record;
+    for (const part of path) {
+        if (!isRecord(current)) {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+function validationGateStatus(value) {
+    if (value === "missing_validation" ||
+        value === "thin_validation" ||
+        value === "stale_validation" ||
+        value === "ready_for_proto" ||
+        value === "return_to_vision") {
+        return value;
+    }
+    return null;
+}
+//# sourceMappingURL=readiness.js.map

package/dist/core/src/artifacts/readiness.js.map

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

package/dist/core/src/artifacts/registry.d.ts

@@ -1,7 +1,7 @@
-export type DiscoveryArtifactType = "vision_session" | "validation_target" | "prototype_evidence" | "decision_record" | "product_design";
+export type DiscoveryArtifactType = "vision_session" | "validation_target" | "prototype_evidence" | "decision_record" | "product_design" | "production_spec" | "production_change" | "team_runtime";
 export interface DiscoveryArtifactContract {
     artifactType: DiscoveryArtifactType;
-    contractType: "vision" | "validation" | "prototype" | "decision" | "design";
+    contractType: "vision" | "validation" | "prototype" | "decision" | "design" | "spec" | "change" | "runtime";
     command: string;
     title: string;
     sourceOfTruthPath: string;
@@ -16,9 +16,16 @@ export interface DiscoveryArtifactContract {
     activePointer: ActivePointer;
     evidencePolicy: string;
     handoffKey: string;
+    summaryPolicy?: SummaryPolicy;
     template: Record<string, unknown>;
     conditionalPackets?: readonly ConditionalPacketMetadata[];
 }
+export interface SummaryPolicy {
+    strategy: "summary_file" | "current_slice";
+    path: string;
+    loadBeforeFull: boolean;
+    refreshWhen: string;
+}
 export interface ConditionalPacketMetadata {
     artifactType: string;
     path: string;