@entelligentsia/forgecli 1.0.3 → 1.0.14

package/dist/extensions/forgecli/loaders/workflow-loader.d.ts

@@ -1,41 +0,0 @@
-import { type Static, Type } from "typebox";
-export declare const AUDIENCE_VALUES: readonly ["orchestrator-only", "subagent", "any"];
-export type AudienceValue = (typeof AUDIENCE_VALUES)[number];
-export declare const WorkflowFrontmatterSchema: Type.TObject<{
-    audience: Type.TOptional<Type.TUnion<[Type.TLiteral<"orchestrator-only">, Type.TLiteral<"subagent">, Type.TLiteral<"any">]>>;
-    deps: Type.TOptional<Type.TObject<{
-        personas: Type.TOptional<Type.TArray<Type.TString>>;
-    }>>;
-}>;
-export type WorkflowFrontmatter = Static<typeof WorkflowFrontmatterSchema>;
-export interface LoadedWorkflow {
-    filePath: string;
-    rawMarkdown: string;
-    frontmatter: WorkflowFrontmatter;
-    /** Resolved audience; defaults to "any" when the key is absent. */
-    audience: AudienceValue;
-}
-export type WorkflowLoaderErrorCode = "missing_file" | "invalid_frontmatter" | "validation_failed";
-export declare class WorkflowLoaderError extends Error {
-    readonly code: WorkflowLoaderErrorCode;
-    constructor(code: WorkflowLoaderErrorCode, message: string);
-}
-/**
- * Parse the YAML-like frontmatter of a workflow markdown file.
- *
- * Returns `{}` if the file does not start with `---`.
- * Throws `WorkflowLoaderError("invalid_frontmatter", ...)` on malformed YAML.
- */
-export declare function parseWorkflowFrontmatter(rawMarkdown: string): WorkflowFrontmatter;
-/**
- * Extract the audience value from a parsed WorkflowFrontmatter.
- * Returns "any" when the key is absent or has an unrecognised value.
- */
-export declare function extractAudience(frontmatter: WorkflowFrontmatter): AudienceValue;
-/**
- * Load and parse a materialized workflow markdown file.
- *
- * Throws `WorkflowLoaderError("missing_file", ...)` if the file is absent or unreadable.
- * Throws `WorkflowLoaderError("invalid_frontmatter", ...)` if frontmatter is malformed.
- */
-export declare function loadWorkflow(workflowPath: string): LoadedWorkflow;

package/dist/extensions/forgecli/loaders/workflow-loader.js

@@ -1,164 +0,0 @@
-// workflow-loader.ts — Parses a materialized workflow markdown file.
-// Exports WorkflowFrontmatter (TypeBox), loadWorkflow(), extractAudience(),
-// and parseWorkflowFrontmatter() (FORGE-S21-T01).
-//
-// Iron Laws:
-//   IL1 — code only under forge-cli/src/extensions/forgecli/.
-//   IL6 — no shell-string interpolation; all I/O via fs synchronous APIs.
-//   IL7 — no silent continuation; malformed state throws typed errors.
-import * as fs from "node:fs";
-import { Type } from "typebox";
-// ── Types ─────────────────────────────────────────────────────────────────
-export const AUDIENCE_VALUES = ["orchestrator-only", "subagent", "any"];
-export const WorkflowFrontmatterSchema = Type.Object({
-    audience: Type.Optional(Type.Union([
-        Type.Literal("orchestrator-only"),
-        Type.Literal("subagent"),
-        Type.Literal("any"),
-    ])),
-    deps: Type.Optional(Type.Object({
-        personas: Type.Optional(Type.Array(Type.String())),
-    }, { additionalProperties: true })),
-}, { additionalProperties: true });
-export class WorkflowLoaderError extends Error {
-    code;
-    constructor(code, message) {
-        super(message);
-        this.name = "WorkflowLoaderError";
-        this.code = code;
-    }
-}
-// ── Frontmatter parser ────────────────────────────────────────────────────
-function parseInlineArray(raw) {
-    const trimmed = raw.trim();
-    if (!trimmed.startsWith("[") || !trimmed.endsWith("]"))
-        return null;
-    const inner = trimmed.slice(1, -1);
-    if (inner.trim() === "")
-        return [];
-    return inner
-        .split(",")
-        .map((s) => {
-        const t = s.trim();
-        if ((t.startsWith('"') && t.endsWith('"') && t.length >= 2) ||
-            (t.startsWith("'") && t.endsWith("'") && t.length >= 2)) {
-            return t.slice(1, -1);
-        }
-        return t;
-    })
-        .filter((s) => s.length > 0);
-}
-function stripQuotes(value) {
-    const v = value.trim();
-    if ((v.startsWith('"') && v.endsWith('"') && v.length >= 2) ||
-        (v.startsWith("'") && v.endsWith("'") && v.length >= 2)) {
-        return v.slice(1, -1);
-    }
-    return v;
-}
-/**
- * Parse the YAML-like frontmatter of a workflow markdown file.
- *
- * Returns `{}` if the file does not start with `---`.
- * Throws `WorkflowLoaderError("invalid_frontmatter", ...)` on malformed YAML.
- */
-export function parseWorkflowFrontmatter(rawMarkdown) {
-    const lines = rawMarkdown.split(/\r?\n/);
-    if (lines.length === 0 || lines[0] !== "---") {
-        return {};
-    }
-    const fm = {};
-    let currentBlock = null;
-    let blockChildren = {};
-    let closed = false;
-    for (let i = 1; i < lines.length; i++) {
-        const line = lines[i];
-        if (line === "---") {
-            if (currentBlock !== null) {
-                fm[currentBlock] = blockChildren;
-                currentBlock = null;
-                blockChildren = {};
-            }
-            closed = true;
-            break;
-        }
-        if (line.trim() === "")
-            continue;
-        // Indented line → child of current block.
-        if (/^\s/.test(line)) {
-            if (currentBlock === null) {
-                throw new WorkflowLoaderError("invalid_frontmatter", `Indented frontmatter line ${i + 1} with no parent block: ${JSON.stringify(line)}`);
-            }
-            const childMatch = /^\s+([A-Za-z0-9_.-]+):\s*(.*)$/.exec(line);
-            if (!childMatch) {
-                throw new WorkflowLoaderError("invalid_frontmatter", `Malformed indented frontmatter line ${i + 1}: ${JSON.stringify(line)}`);
-            }
-            const childKey = childMatch[1];
-            const childRaw = childMatch[2].trim();
-            const arr = parseInlineArray(childRaw);
-            blockChildren[childKey] = arr !== null ? arr : stripQuotes(childRaw);
-            continue;
-        }
-        // Top-level key:value or bare block key.
-        const topMatch = /^([A-Za-z0-9_.-]+):\s*(.*)$/.exec(line);
-        if (!topMatch) {
-            throw new WorkflowLoaderError("invalid_frontmatter", `Malformed frontmatter line ${i + 1}: ${JSON.stringify(line)}`);
-        }
-        if (currentBlock !== null) {
-            fm[currentBlock] = blockChildren;
-            currentBlock = null;
-            blockChildren = {};
-        }
-        const key = topMatch[1];
-        const rawValue = topMatch[2].trim();
-        if (rawValue === "") {
-            currentBlock = key;
-            blockChildren = {};
-        }
-        else {
-            const arr = parseInlineArray(rawValue);
-            fm[key] = arr !== null ? arr : stripQuotes(rawValue);
-        }
-    }
-    if (!closed) {
-        throw new WorkflowLoaderError("invalid_frontmatter", "Workflow frontmatter block opened with `---` but never closed");
-    }
-    return fm;
-}
-// ── Audience extraction ───────────────────────────────────────────────────
-/**
- * Extract the audience value from a parsed WorkflowFrontmatter.
- * Returns "any" when the key is absent or has an unrecognised value.
- */
-export function extractAudience(frontmatter) {
-    const raw = frontmatter.audience;
-    if (!raw)
-        return "any";
-    if (AUDIENCE_VALUES.includes(raw))
-        return raw;
-    return "any";
-}
-// ── loadWorkflow ──────────────────────────────────────────────────────────
-/**
- * Load and parse a materialized workflow markdown file.
- *
- * Throws `WorkflowLoaderError("missing_file", ...)` if the file is absent or unreadable.
- * Throws `WorkflowLoaderError("invalid_frontmatter", ...)` if frontmatter is malformed.
- */
-export function loadWorkflow(workflowPath) {
-    if (!fs.existsSync(workflowPath)) {
-        throw new WorkflowLoaderError("missing_file", `Workflow not found: ${workflowPath}`);
-    }
-    let rawMarkdown;
-    try {
-        rawMarkdown = fs.readFileSync(workflowPath, "utf8");
-    }
-    catch (err) {
-        const e = err;
-        throw new WorkflowLoaderError("missing_file", `Failed to read workflow ${workflowPath}: ${e.message ?? "unknown"}`);
-    }
-    const frontmatter = parseWorkflowFrontmatter(rawMarkdown);
-    const audience = extractAudience(frontmatter);
-    return { filePath: workflowPath, rawMarkdown, frontmatter, audience };
-}
-//# sourceMappingURL=workflow-loader.js.map

package/dist/extensions/forgecli/loaders/workflow-loader.js.map

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

package/dist/forge-payload/.base-pack/commands/quiz-agent.md

@@ -1,6 +0,0 @@
----
-name: quiz-agent
-description: Renamed in v1.0 — use /{{PREFIX}}:check-agent
----
-
-× /{{PREFIX}}:quiz-agent was renamed to /{{PREFIX}}:check-agent in v1.0.

package/dist/forge-payload/.base-pack/commands/retrospective.md

@@ -1,6 +0,0 @@
----
-name: retrospective
-description: Renamed in v1.0 — use /{{PREFIX}}:retro
----
-
-× /{{PREFIX}}:retrospective was renamed to /{{PREFIX}}:retro in v1.0.

package/dist/forge-payload/.base-pack/commands/sprint-intake.md

@@ -1,6 +0,0 @@
----
-name: sprint-intake
-description: Renamed in v1.0 — use /{{PREFIX}}:new-sprint
----
-
-× /{{PREFIX}}:sprint-intake was renamed to /{{PREFIX}}:new-sprint in v1.0.

package/dist/forge-payload/.base-pack/commands/sprint-plan.md

@@ -1,6 +0,0 @@
----
-name: sprint-plan
-description: Renamed in v1.0 — use /{{PREFIX}}:plan-sprint
----
-
-× /{{PREFIX}}:sprint-plan was renamed to /{{PREFIX}}:plan-sprint in v1.0.