@tiic-tech/openworkflow 0.1.0 → 0.1.2

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

@@ -0,0 +1,294 @@
+import { execFile } from "node:child_process";
+import { join, resolve } from "node:path";
+import { promisify } from "node:util";
+import { detectAdapterPlatforms, getAdapterEntry } from "../../../adapters/src/registry.js";
+import { parseYaml } from "../../../core/src/contracts/yaml.js";
+import { isNotFound, readTextFile } from "../../../core/src/fs/index.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 { evaluateSummaryHealth } 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";
+const execFileAsync = promisify(execFile);
+export async function briefCommand(command, flags) {
+    const root = resolve(stringFlag(flags, "root", ".") ?? ".");
+    const json = booleanFlag(flags, "json");
+    const model = await buildBriefModel(root, parseTools(stringFlag(flags, "tools")));
+    if (json) {
+        const healthErrors = healthErrorsForBrief(model);
+        printJsonReport({
+            command,
+            ok: model.health.ok,
+            root,
+            data: model,
+            warnings: model.health.workflow.warnings.concat(model.health.agents_md.warnings, Object.values(model.health.adapters).flatMap((section) => section.warnings), model.health.summaries.warnings),
+            errors: model.health.workflow.errors.concat(model.health.agents_md.errors, Object.values(model.health.adapters).flatMap((section) => section.errors)),
+            health_errors: healthErrors,
+            effects: emptyEffects(),
+            next_actions: [model.agent_guidance.recommended_next_action],
+        });
+    }
+    else {
+        printBrief(model);
+    }
+    return model.health.ok ? 0 : 1;
+}
+export function healthErrorsForBrief(model) {
+    if (model.health.ok) {
+        return [];
+    }
+    return unique([
+        ...healthSectionErrors("workflow", model.health.workflow),
+        ...healthSectionErrors("agents_md", model.health.agents_md),
+        ...Object.entries(model.health.adapters).flatMap(([tool, section]) => healthSectionErrors(`adapter:${tool}`, section)),
+        ...(!model.health.summaries.ok ? model.health.summaries.warnings : []),
+    ]);
+}
+function healthSectionErrors(label, section) {
+    if (section.ok) {
+        return [];
+    }
+    const items = section.errors.length > 0 ? section.errors : section.warnings;
+    return items.map((item) => `${label}: ${item}`);
+}
+export async function buildBriefModel(root, explicitTools) {
+    const config = await readWorkflowConfig(root);
+    const detection = await detectAdapterPlatforms(root);
+    const autoTools = explicitTools.length === 0 || explicitTools.includes("auto");
+    const tools = autoTools ? detection.detected : explicitTools;
+    const workflowTools = autoTools ? uniqueTools([...tools, ...detection.unknownConfigured]) : tools;
+    const projectTitle = config?.projectTitle ?? basenameForTitle(root);
+    const projectSlug = slugify(config?.projectSlug ?? projectTitle);
+    const currentState = await readCurrentState(root);
+    const workflowHealth = await doctorOpenWorkflow({
+        root,
+        projectTitle,
+        projectSlug,
+        tools: workflowTools,
+        force: false,
+    });
+    const agentsGuideHealth = await doctorAgentsGuide(root);
+    const summaryHealth = await evaluateSummaryHealth(root);
+    const adapterHealth = {};
+    for (const tool of tools) {
+        const adapter = getAdapterEntry(tool);
+        if (!adapter) {
+            adapterHealth[tool] = {
+                ok: false,
+                warnings: [],
+                errors: [`unsupported adapter platform: ${tool}`],
+            };
+            continue;
+        }
+        adapterHealth[tool] = await adapter.doctor(root);
+    }
+    for (const tool of detection.unknownConfigured) {
+        adapterHealth[tool] = {
+            ok: false,
+            warnings: [`configured tool is not supported by this OpenWorkflow version: ${tool}`],
+            errors: [],
+        };
+    }
+    const health = {
+        ok: workflowHealth.ok && agentsGuideHealth.ok && summaryHealth.ok && Object.values(adapterHealth).every((item) => item.ok),
+        workflow: workflowHealth,
+        adapters: adapterHealth,
+        agents_md: agentsGuideHealth,
+        summaries: summaryHealth,
+        recommended_maintenance: maintenanceAction(workflowHealth, agentsGuideHealth, adapterHealth, summaryHealth),
+    };
+    return {
+        project: {
+            title: projectTitle,
+            slug: projectSlug,
+            root,
+            tools: config?.tools ?? [],
+            detected_tools: detection.detected,
+            unknown_configured_tools: detection.unknownConfigured,
+        },
+        workflow: {
+            active_stage: stringOrNull(currentState?.active_stage),
+            next_command: stringOrNull(currentState?.next_command),
+            blocked_by: stringList(currentState?.blocked_by),
+            last_decision: isRecord(currentState?.last_decision) ? currentState.last_decision : null,
+        },
+        read_this_first: stringList(currentState?.read_this_first),
+        active_pointers: activePointers(currentState),
+        health,
+        git: await gitState(root),
+        agent_guidance: {
+            recommended_next_action: recommendedNextAction(currentState, health),
+            safe_to_modify: ["Files required by the current task after checking git status and active pointers."],
+            do_not_touch: [
+                "Existing user artifacts or notes unless the current task explicitly requires them.",
+                "Stage artifacts not produced by the current /ow:* command.",
+            ],
+        },
+    };
+}
+async function readCurrentState(root) {
+    try {
+        const data = parseYaml(await readTextFile(join(root, ".openworkflow", "CURRENT_STATE.yaml")));
+        return isRecord(data) ? data : null;
+    }
+    catch (error) {
+        if (isNotFound(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+function printBrief(model) {
+    console.log(`OpenWorkflow brief for ${model.project.title}`);
+    console.log(`root: ${model.project.root}`);
+    console.log(`tools: ${formatList(model.project.detected_tools.length > 0 ? model.project.detected_tools : model.project.tools)}`);
+    console.log("");
+    console.log("Workflow:");
+    console.log(`  active_stage: ${model.workflow.active_stage ?? "unknown"}`);
+    console.log(`  next_command: ${model.workflow.next_command ?? "none"}`);
+    console.log(`  blocked_by: ${formatList(model.workflow.blocked_by)}`);
+    console.log(`  last_decision: ${formatRecord(model.workflow.last_decision)}`);
+    console.log("");
+    console.log("Read this first:");
+    for (const item of model.read_this_first.length > 0 ? model.read_this_first : ["none"]) {
+        console.log(`  - ${item}`);
+    }
+    console.log("");
+    console.log("Active pointers:");
+    for (const [key, value] of Object.entries(model.active_pointers)) {
+        console.log(`  ${key}: ${value ?? "none"}`);
+    }
+    console.log("");
+    console.log("Health:");
+    console.log(`  ok: ${model.health.ok}`);
+    console.log(`  workflow: ${healthLabel(model.health.workflow)}`);
+    console.log(`  agents_md: ${healthLabel(model.health.agents_md)}`);
+    console.log(`  summaries: current=${model.health.summaries.counts.current}, missing=${model.health.summaries.counts.missing}, stale_unknown=${model.health.summaries.counts.stale_unknown}, not_instantiated=${model.health.summaries.counts.not_instantiated}`);
+    for (const [tool, section] of Object.entries(model.health.adapters)) {
+        console.log(`  adapter:${tool}: ${healthLabel(section)}`);
+    }
+    console.log(`  recommended_maintenance: ${model.health.recommended_maintenance ?? "none"}`);
+    console.log("");
+    console.log("Git:");
+    console.log(`  available: ${model.git.available}`);
+    console.log(`  branch: ${model.git.branch ?? "none"}`);
+    console.log(`  dirty: ${model.git.dirty}`);
+    console.log(`  changed_files: ${formatList(model.git.changed_files)}`);
+    console.log("");
+    console.log("Agent guidance:");
+    console.log(`  recommended_next_action: ${model.agent_guidance.recommended_next_action}`);
+}
+function healthLabel(section) {
+    if (section.errors.length > 0) {
+        return `errors=${section.errors.length}, warnings=${section.warnings.length}`;
+    }
+    if (section.warnings.length > 0) {
+        return `warnings=${section.warnings.length}`;
+    }
+    return "ok";
+}
+function maintenanceAction(workflow, agentsGuide, adapters, summaries) {
+    const hasSyncFixableDrift = workflow.errors.length > 0
+        || workflow.warnings.length > 0
+        || agentsGuide.warnings.length > 0
+        || Object.values(adapters).some((section) => section.errors.length > 0 || section.warnings.length > 0);
+    if (hasSyncFixableDrift) {
+        return "run openworkflow sync, then openworkflow doctor";
+    }
+    if (!summaries.ok) {
+        return summaries.initialized
+            ? "run openworkflow summaries --json before relying on low-context artifact reads"
+            : "run openworkflow init or sync before relying on OpenWorkflow read models";
+    }
+    return null;
+}
+function recommendedNextAction(currentState, health) {
+    if (health.recommended_maintenance) {
+        return health.recommended_maintenance;
+    }
+    const nextCommand = stringOrNull(currentState?.next_command);
+    return nextCommand ? `continue with ${nextCommand}` : "inspect CURRENT_STATE.yaml and choose the next workflow command";
+}
+function activePointers(currentState) {
+    const keys = [
+        "current_vision",
+        "current_validation",
+        "current_prototype",
+        "current_decision",
+        "current_design",
+        "current_spec",
+        "current_change",
+        "current_run",
+    ];
+    return Object.fromEntries(keys.map((key) => [key, currentPointerValue(currentState, key)]));
+}
+function currentPointerValue(currentState, key) {
+    const direct = stringOrNull(currentState?.[key]);
+    if (direct || key !== "current_vision") {
+        return direct;
+    }
+    return stringOrNull(currentState?.current_session);
+}
+async function gitState(root) {
+    try {
+        await execGit(root, ["rev-parse", "--is-inside-work-tree"]);
+        const branch = await gitBranch(root);
+        const status = await execGit(root, ["status", "--porcelain"]);
+        const changedFiles = status.split("\n").filter(Boolean).map((line) => line.slice(3).trim()).filter(Boolean);
+        return {
+            available: true,
+            branch,
+            dirty: changedFiles.length > 0,
+            changed_files: changedFiles,
+        };
+    }
+    catch {
+        return {
+            available: false,
+            branch: null,
+            dirty: false,
+            changed_files: [],
+        };
+    }
+}
+async function gitBranch(root) {
+    try {
+        const branch = (await execGit(root, ["branch", "--show-current"])).trim();
+        return branch.length > 0 ? branch : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function execGit(root, args) {
+    const { stdout } = await execFileAsync("git", args, { cwd: root });
+    return stdout;
+}
+function formatList(items) {
+    return items.length > 0 ? items.join(", ") : "none";
+}
+function formatRecord(value) {
+    if (!value) {
+        return "none";
+    }
+    const outcome = value.outcome;
+    return typeof outcome === "string" && outcome.length > 0 ? outcome : "none";
+}
+function stringList(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function stringOrNull(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function uniqueTools(tools) {
+    return [...new Set(tools)];
+}
+function unique(values) {
+    return [...new Set(values.filter((value) => value.trim().length > 0))];
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=brief.js.map

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

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

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

@@ -0,0 +1,42 @@
+export interface ReadinessModel {
+    command: string | null;
+    normalized_command: string | null;
+    ready: boolean;
+    blockers: string[];
+    warnings: string[];
+    required_context: ContextStatus[];
+    optional_context: ContextStatus[];
+    forbidden_context: ContextStatus[];
+    conditional_context: string[];
+    allowed_outputs: string[];
+    forbidden_outputs: string[];
+    handoff_commands: string[];
+    artifact_contracts: ArtifactSummary[];
+    semantic_readiness: SemanticReadinessSummary | null;
+    summary_guidance: SummaryGuidance[];
+    read_this_first: string[];
+    active_pointers: Record<string, string | null>;
+    next_actions: string[];
+}
+export interface ContextStatus {
+    path: string;
+    exists: boolean;
+}
+export interface ArtifactSummary {
+    artifact_type: string;
+    source_of_truth_path: string;
+    summary_policy: string | null;
+}
+export interface SummaryGuidance {
+    artifact_type: string;
+    status: string;
+    next_actions: string[];
+}
+export interface SemanticReadinessSummary {
+    gate_status: string | null;
+    ok: boolean;
+    blockers: string[];
+    warnings: string[];
+}
+export declare function checkCommand(positional: string[], flags: Map<string, string | boolean>): Promise<number>;
+export declare function buildReadiness(root: string, requested: string): Promise<ReadinessModel>;

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

@@ -0,0 +1,326 @@
+import { readdir, stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { getDiscoveryArtifactContractsForCommand } from "../../../core/src/artifacts/registry.js";
+import { assessStageReadiness } from "../../../core/src/artifacts/readiness.js";
+import { getWorkflowCommands } from "../../../core/src/commands/registry.js";
+import { parseYaml } from "../../../core/src/contracts/yaml.js";
+import { isNotFound, readTextFile } from "../../../core/src/fs/index.js";
+import { evaluateSummaryHealth } from "../../../core/src/workflow/summaryHealth.js";
+import { booleanFlag, stringFlag } from "../args.js";
+import { emptyEffects, printJsonReport } from "../report.js";
+export async function checkCommand(positional, flags) {
+    const root = resolve(stringFlag(flags, "root", ".") ?? ".");
+    const json = booleanFlag(flags, "json");
+    const requested = positional[0];
+    if (!requested) {
+        const data = missingCommandModel();
+        return finish(root, json, data, "Missing command argument.", ["run openworkflow check /ow:vision --root ."]);
+    }
+    const model = await buildReadiness(root, requested);
+    const ok = model.ready;
+    const exitCode = model.blockers.length > 0 ? 1 : 0;
+    if (json) {
+        printJsonReport({
+            command: "check",
+            ok,
+            root,
+            data: model,
+            warnings: model.warnings,
+            errors: model.blockers,
+            health_errors: ok ? [] : model.blockers,
+            effects: emptyEffects(),
+            next_actions: model.next_actions,
+        });
+    }
+    else {
+        printReadiness(model);
+    }
+    return exitCode;
+}
+async function finish(root, json, data, error, nextActions) {
+    if (json) {
+        printJsonReport({
+            command: "check",
+            ok: false,
+            root,
+            data,
+            warnings: [],
+            errors: [error],
+            health_errors: [error],
+            effects: emptyEffects(),
+            next_actions: nextActions,
+        });
+    }
+    else {
+        console.error(error);
+    }
+    return 1;
+}
+export async function buildReadiness(root, requested) {
+    const normalized = normalizeCommand(requested);
+    const command = findCommand(normalized);
+    const currentState = await readCurrentState(root);
+    if (!command) {
+        return {
+            ...baseModel(requested, normalized, currentState),
+            blockers: [`unknown workflow command: ${requested}`],
+            next_actions: ["run openworkflow --help to inspect supported workflow commands"],
+        };
+    }
+    const protocol = command.protocol;
+    const summaryHealth = await evaluateSummaryHealth(root);
+    const required = await contextStatuses(root, protocol?.requiredContext ?? [".openworkflow/workflow/WORKFLOW_INDEX.yaml"]);
+    const optional = await contextStatuses(root, protocol?.optionalContext ?? []);
+    const forbidden = await contextStatuses(root, protocol?.forbiddenContext ?? []);
+    const semanticReadiness = await assessStageReadiness(root, command.trigger, currentState);
+    const blockers = [
+        ...required.filter((item) => !item.exists).map((item) => `missing required context: ${item.path}`),
+        ...forbidden.filter((item) => item.exists).map((item) => `forbidden context exists: ${item.path}`),
+        ...semanticReadiness.blockers,
+    ];
+    const warnings = [];
+    const nextCommand = stringOrNull(currentState?.next_command);
+    if (nextCommand && nextCommand !== command.trigger) {
+        warnings.push(`CURRENT_STATE next_command is ${nextCommand}, not ${command.trigger}`);
+    }
+    if (command.visibility === "internal") {
+        warnings.push(`${command.trigger} is an internal command and is not a normal user-facing step`);
+    }
+    const summaryGuidance = summaryGuidanceFor(command.trigger, summaryHealth.entries);
+    warnings.push(...summaryWarnings(summaryGuidance));
+    if (!summaryHealth.initialized) {
+        warnings.push("summary health unavailable because OpenWorkflow artifact contracts are missing");
+    }
+    warnings.push(...semanticReadiness.warnings);
+    const nextActions = nextActionsFor(command, blockers, warnings, currentState);
+    return {
+        ...baseModel(requested, command.trigger, currentState),
+        ready: blockers.length === 0,
+        blockers,
+        warnings,
+        required_context: required,
+        optional_context: optional,
+        forbidden_context: forbidden,
+        conditional_context: protocol?.conditionalOutputs ?? [],
+        allowed_outputs: protocol?.allowedOutputs ?? command.targetArtifacts,
+        forbidden_outputs: protocol?.forbiddenOutputs ?? [],
+        handoff_commands: protocol?.handoffCommands ?? [],
+        artifact_contracts: getDiscoveryArtifactContractsForCommand(command.trigger).map((artifact) => ({
+            artifact_type: artifact.artifactType,
+            source_of_truth_path: artifact.sourceOfTruthPath,
+            summary_policy: artifact.summaryPolicy?.strategy ?? null,
+        })),
+        semantic_readiness: {
+            gate_status: semanticReadiness.gate_status ?? null,
+            ok: semanticReadiness.ok,
+            blockers: semanticReadiness.blockers,
+            warnings: semanticReadiness.warnings,
+        },
+        summary_guidance: summaryGuidance,
+        next_actions: nextActions,
+    };
+}
+function printReadiness(model) {
+    console.log(`OpenWorkflow command check: ${model.normalized_command ?? model.command ?? "unknown"}`);
+    console.log(`ready: ${model.ready}`);
+    printList("blockers", model.blockers);
+    printList("warnings", model.warnings);
+    printContext("required_context", model.required_context);
+    printContext("forbidden_context", model.forbidden_context);
+    printList("allowed_outputs", model.allowed_outputs);
+    printList("forbidden_outputs", model.forbidden_outputs);
+    printList("handoff_commands", model.handoff_commands);
+    if (model.semantic_readiness) {
+        console.log(`semantic_readiness: ${model.semantic_readiness.gate_status ?? "unknown"}`);
+    }
+    printList("summary_guidance", model.summary_guidance.map((item) => `${item.artifact_type}: ${item.status}`));
+    printList("read_this_first", model.read_this_first);
+    printList("next_actions", model.next_actions);
+}
+function printList(label, values) {
+    console.log(`${label}:`);
+    for (const value of values.length > 0 ? values : ["none"]) {
+        console.log(`  - ${value}`);
+    }
+}
+function printContext(label, values) {
+    console.log(`${label}:`);
+    for (const value of values.length > 0 ? values : [{ path: "none", exists: false }]) {
+        console.log(`  - ${value.path} (${value.exists ? "exists" : "missing"})`);
+    }
+}
+function missingCommandModel() {
+    return {
+        command: null,
+        normalized_command: null,
+        ready: false,
+        blockers: ["missing command argument"],
+        warnings: [],
+        required_context: [],
+        optional_context: [],
+        forbidden_context: [],
+        conditional_context: [],
+        allowed_outputs: [],
+        forbidden_outputs: [],
+        handoff_commands: [],
+        artifact_contracts: [],
+        semantic_readiness: null,
+        summary_guidance: [],
+        read_this_first: [],
+        active_pointers: {},
+        next_actions: ["run openworkflow check /ow:vision --root ."],
+    };
+}
+function baseModel(requested, normalized, currentState) {
+    return {
+        command: requested,
+        normalized_command: normalized,
+        ready: false,
+        blockers: [],
+        warnings: [],
+        required_context: [],
+        optional_context: [],
+        forbidden_context: [],
+        conditional_context: [],
+        allowed_outputs: [],
+        forbidden_outputs: [],
+        handoff_commands: [],
+        artifact_contracts: [],
+        semantic_readiness: null,
+        summary_guidance: [],
+        read_this_first: stringList(currentState?.read_this_first),
+        active_pointers: activePointers(currentState),
+        next_actions: [],
+    };
+}
+function summaryGuidanceFor(command, entries) {
+    const artifactTypes = new Set(getDiscoveryArtifactContractsForCommand(command).map((artifact) => artifact.artifactType));
+    return entries
+        .filter((entry) => artifactTypes.has(entry.artifact_type) && entry.strategy !== "none")
+        .map((entry) => ({
+        artifact_type: entry.artifact_type,
+        status: entry.status,
+        next_actions: entry.next_actions,
+    }));
+}
+function summaryWarnings(guidance) {
+    return guidance
+        .filter((entry) => entry.status === "missing" || entry.status === "stale_unknown")
+        .map((entry) => `summary health for ${entry.artifact_type} is ${entry.status}; inspect summaries before relying on low-context reads`);
+}
+function nextActionsFor(command, blockers, warnings, currentState) {
+    if (blockers.length > 0) {
+        return ["resolve blockers before starting the workflow command"];
+    }
+    const nextCommand = stringOrNull(currentState?.next_command);
+    if (nextCommand && nextCommand !== command.trigger && warnings.length > 0) {
+        return [`consider running ${nextCommand} first, or confirm why ${command.trigger} is appropriate now`];
+    }
+    return [`start ${command.trigger} using the repo-local Agent skill`];
+}
+async function contextStatuses(root, paths) {
+    return Promise.all(paths.map(async (path) => ({ path, exists: await contextExists(root, path) })));
+}
+async function contextExists(root, pattern) {
+    const clean = pattern.replace(/<[^>]+>/gu, "");
+    if (clean.includes("**")) {
+        return existsPrefix(root, clean.split("**", 1)[0] ?? clean);
+    }
+    if (clean.endsWith("/")) {
+        return existsPath(root, clean);
+    }
+    return existsPath(root, clean);
+}
+async function existsPrefix(root, prefix) {
+    const path = join(root, prefix);
+    try {
+        const info = await stat(path);
+        if (info.isFile()) {
+            return true;
+        }
+        if (info.isDirectory()) {
+            const entries = await readdir(path);
+            return entries.length > 0;
+        }
+        return false;
+    }
+    catch (error) {
+        if (isNotFound(error)) {
+            return false;
+        }
+        throw error;
+    }
+}
+async function existsPath(root, relativePath) {
+    try {
+        await stat(join(root, relativePath));
+        return true;
+    }
+    catch (error) {
+        if (isNotFound(error)) {
+            return false;
+        }
+        throw error;
+    }
+}
+async function readCurrentState(root) {
+    try {
+        const data = parseYaml(await readTextFile(join(root, ".openworkflow", "CURRENT_STATE.yaml")));
+        return isRecord(data) ? data : null;
+    }
+    catch (error) {
+        if (isNotFound(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+function normalizeCommand(value) {
+    const trimmed = value.trim();
+    if (trimmed.startsWith("/ow:")) {
+        return trimmed;
+    }
+    if (trimmed.startsWith("ow:")) {
+        return `/${trimmed}`;
+    }
+    if (trimmed.startsWith("ow-")) {
+        return `/ow:${trimmed.slice("ow-".length)}`;
+    }
+    if (trimmed.startsWith("/")) {
+        return trimmed;
+    }
+    return `/ow:${trimmed}`;
+}
+function findCommand(normalized) {
+    return getWorkflowCommands().find((command) => command.trigger === normalized || command.legacyTriggers.includes(normalized));
+}
+function activePointers(currentState) {
+    const keys = [
+        "current_vision",
+        "current_validation",
+        "current_prototype",
+        "current_decision",
+        "current_design",
+        "current_spec",
+        "current_change",
+        "current_run",
+    ];
+    return Object.fromEntries(keys.map((key) => [key, currentPointerValue(currentState, key)]));
+}
+function currentPointerValue(currentState, key) {
+    const direct = stringOrNull(currentState?.[key]);
+    if (direct || key !== "current_vision") {
+        return direct;
+    }
+    return stringOrNull(currentState?.current_session);
+}
+function stringList(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function stringOrNull(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=check.js.map