@jamesaphoenix/tx-core 0.11.1 → 0.12.0

package/dist/utils/ears-validator.js

@@ -1,8 +1,11 @@
-import { EARS_PATTERNS } from "@jamesaphoenix/tx-types";
-const EARS_ID_PATTERN = /^EARS-[A-Z0-9]+-\d{3}$/;
-const EARS_PRIORITIES = ["must", "should", "could", "wont"];
-const validPatternSet = new Set(EARS_PATTERNS);
-const validPrioritySet = new Set(EARS_PRIORITIES);
+import { EARS_PATTERNS, MD_EARS_PRIORITIES, MD_EARS_REQUIREMENT_KINDS, } from "@jamesaphoenix/tx-types";
+const LEGACY_EARS_ID_PATTERN = /^EARS-[A-Z0-9]+-\d{3}$/;
+const MARKDOWN_EARS_ID_PATTERN = /^REQ-[A-Z0-9-]+$/;
+const LEGACY_EARS_PRIORITIES = ["must", "should", "could", "wont"];
+const validLegacyPatternSet = new Set(EARS_PATTERNS);
+const validLegacyPrioritySet = new Set(LEGACY_EARS_PRIORITIES);
+const validMarkdownKindSet = new Set(MD_EARS_REQUIREMENT_KINDS);
+const validMarkdownPrioritySet = new Set(MD_EARS_PRIORITIES);
 const asRecord = (value) => {
     if (typeof value !== "object" || value === null || Array.isArray(value)) {
         return null;
@@ -27,6 +30,20 @@ const requiredPatternField = (pattern) => {
             return null;
     }
 };
+const requiredMarkdownClause = (kind) => {
+    switch (kind) {
+        case "event-driven":
+            return "when";
+        case "state-driven":
+            return "while";
+        case "unwanted":
+            return "if";
+        case "optional":
+            return "where";
+        default:
+            return null;
+    }
+};
 export const validateEarsRequirements = (requirements) => {
     const errors = [];
     const seenIds = new Set();
@@ -43,10 +60,14 @@ export const validateEarsRequirements = (requirements) => {
             return;
         }
         const id = pickString(req, "id");
+        const statementRaw = req.statement;
+        const statement = typeof statementRaw === "string" ? statementRaw.trim() : null;
+        const kind = pickString(req, "kind");
         const pattern = pickString(req, "pattern");
         const system = pickString(req, "system");
         const response = pickString(req, "response");
         const priority = pickString(req, "priority");
+        const isMarkdownFormat = kind !== null || (id !== null && id.startsWith("REQ-"));
         if (!id) {
             errors.push({
                 index,
@@ -57,13 +78,17 @@ export const validateEarsRequirements = (requirements) => {
             });
         }
         else {
-            if (!EARS_ID_PATTERN.test(id)) {
+            const idPattern = isMarkdownFormat ? MARKDOWN_EARS_ID_PATTERN : LEGACY_EARS_ID_PATTERN;
+            const idFormatMessage = isMarkdownFormat
+                ? "Field 'id' must match REQ-<SCOPE>-<NNN> (e.g. REQ-DOCS-001)."
+                : "Field 'id' must match EARS-<SYSTEM>-NNN (e.g. EARS-FL-001).";
+            if (!idPattern.test(id)) {
                 errors.push({
                     index,
                     id,
                     field: "id",
                     code: "invalid_format",
-                    message: "Field 'id' must match EARS-<SYSTEM>-NNN (e.g. EARS-FL-001).",
+                    message: idFormatMessage,
                 });
             }
             if (seenIds.has(id)) {
@@ -79,6 +104,97 @@ export const validateEarsRequirements = (requirements) => {
                 seenIds.add(id);
             }
         }
+        if (isMarkdownFormat) {
+            if (!kind) {
+                errors.push({
+                    index,
+                    id,
+                    field: "kind",
+                    code: "missing_required",
+                    message: "Field 'kind' is required.",
+                });
+            }
+            else if (!validMarkdownKindSet.has(kind)) {
+                errors.push({
+                    index,
+                    id,
+                    field: "kind",
+                    code: "invalid_value",
+                    message: `Invalid EARS kind '${kind}'. Valid kinds: ${MD_EARS_REQUIREMENT_KINDS.join(", ")}.`,
+                });
+            }
+            if (!statement) {
+                errors.push({
+                    index,
+                    id,
+                    field: "statement",
+                    code: "missing_required",
+                    message: "Field 'statement' is required.",
+                });
+            }
+            if (!priority) {
+                errors.push({
+                    index,
+                    id,
+                    field: "priority",
+                    code: "missing_required",
+                    message: "Field 'priority' is required.",
+                });
+            }
+            else if (!validMarkdownPrioritySet.has(priority)) {
+                errors.push({
+                    index,
+                    id,
+                    field: "priority",
+                    code: "invalid_value",
+                    message: `Invalid priority '${priority}'. Valid priorities: ${MD_EARS_PRIORITIES.join(", ")}.`,
+                });
+            }
+            if (kind && validMarkdownKindSet.has(kind)) {
+                const clauseField = requiredMarkdownClause(kind);
+                if (clauseField) {
+                    const clauseValue = pickString(req, clauseField);
+                    if (!clauseValue) {
+                        errors.push({
+                            index,
+                            id,
+                            field: clauseField,
+                            code: "missing_required",
+                            message: `Kind '${kind}' requires field '${clauseField}'.`,
+                        });
+                    }
+                }
+                if (kind === "complex") {
+                    const hasClause = Boolean(pickString(req, "when")) ||
+                        Boolean(pickString(req, "while")) ||
+                        Boolean(pickString(req, "if")) ||
+                        Boolean(pickString(req, "where"));
+                    if (!hasClause) {
+                        errors.push({
+                            index,
+                            id,
+                            field: "kind",
+                            code: "missing_required",
+                            message: "Kind 'complex' requires at least one clause: when, while, if, or where.",
+                        });
+                    }
+                }
+            }
+            return;
+        }
+        const isLegacyStatementFormat = typeof statementRaw === "string";
+        if (isLegacyStatementFormat) {
+            if (!statement) {
+                errors.push({
+                    index,
+                    id,
+                    field: "statement",
+                    code: "missing_required",
+                    message: "Field 'statement' is required.",
+                });
+            }
+            return;
+        }
         if (!pattern) {
             errors.push({
                 index,
@@ -88,7 +204,7 @@ export const validateEarsRequirements = (requirements) => {
                 message: "Field 'pattern' is required.",
             });
         }
-        else if (!validPatternSet.has(pattern)) {
+        else if (!validLegacyPatternSet.has(pattern)) {
             errors.push({
                 index,
                 id,
@@ -115,16 +231,16 @@ export const validateEarsRequirements = (requirements) => {
                 message: "Field 'response' is required.",
             });
         }
-        if (priority && !validPrioritySet.has(priority)) {
+        if (priority && !validLegacyPrioritySet.has(priority)) {
             errors.push({
                 index,
                 id,
                 field: "priority",
                 code: "invalid_value",
-                message: `Invalid priority '${priority}'. Valid priorities: ${EARS_PRIORITIES.join(", ")}.`,
+                message: `Invalid priority '${priority}'. Valid priorities: ${LEGACY_EARS_PRIORITIES.join(", ")}.`,
             });
         }
-        if (pattern && validPatternSet.has(pattern)) {
+        if (pattern && validLegacyPatternSet.has(pattern)) {
             const requiredField = requiredPatternField(pattern);
             if (requiredField) {
                 const requiredValue = pickString(req, requiredField);
@@ -160,9 +276,7 @@ export const validateEarsRequirements = (requirements) => {
 export const formatEarsValidationErrors = (errors) => {
     return errors
         .map((error) => {
-        const location = error.id
-            ? `${error.id}`
-            : `entry #${error.index + 1}`;
+        const location = error.id ? `${error.id}` : `entry #${error.index + 1}`;
         return `${location} (${error.field}): ${error.message}`;
     })
         .join("; ");

package/dist/utils/ears-validator.js.map

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

package/dist/utils/md-doc-parser.d.ts

@@ -0,0 +1,15 @@
+import { Effect, Either } from "effect";
+import { type MdParsedDoc } from "@jamesaphoenix/tx-types";
+type ParseEither<A> = Either.Either<A, MdDocParseError>;
+declare const MdDocParseError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "MdDocParseError";
+} & Readonly<A>;
+export declare class MdDocParseError extends MdDocParseError_base<{
+    readonly reason: string;
+}> {
+    get message(): string;
+}
+export declare const parseMdDocSync: (content: string) => ParseEither<MdParsedDoc>;
+export declare const parseMdDoc: (content: string) => Effect.Effect<MdParsedDoc, MdDocParseError>;
+export {};
+//# sourceMappingURL=md-doc-parser.d.ts.map

package/dist/utils/md-doc-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"md-doc-parser.d.ts","sourceRoot":"","sources":["../../src/utils/md-doc-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,MAAM,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAA;AAErD,OAAO,EAcL,KAAK,WAAW,EAEjB,MAAM,yBAAyB,CAAA;AAiBhC,KAAK,WAAW,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,eAAe,CAAC,CAAA;;;;AAEvD,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,CAAC;IACA,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;AAqUD,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,KAAG,WAAW,CAAC,WAAW,CAyDvE,CAAA;AAED,eAAO,MAAM,UAAU,GACrB,SAAS,MAAM,KACd,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,eAAe,CAK5C,CAAA"}

package/dist/utils/md-doc-parser.js

@@ -0,0 +1,275 @@
+import { Data, Effect, Either, Schema } from "effect";
+import { parse as parseYaml } from "yaml";
+import { MD_REQUIRED_SECTIONS_BY_SPEC_TYPE, MdAcceptanceCriterionSchema, MdEmbeddedBlocksSchema, MdEarsRequirementSchema, MdFailureModeSchema, MdFrontmatterSchema, MdInterfaceSchema, MdInvariantSchema, MdParsedDocSchema, MdSectionSchema, MdVerificationSchema, } from "@jamesaphoenix/tx-types";
+import { formatEarsValidationErrors, validateEarsRequirements } from "./ears-validator.js";
+const EMBEDDED_BLOCK_SCHEMAS = {
+    ears_requirements: Schema.Array(MdEarsRequirementSchema),
+    invariants: Schema.Array(MdInvariantSchema),
+    verification: Schema.Array(MdVerificationSchema),
+    interfaces: Schema.Array(MdInterfaceSchema),
+    failure_modes: Schema.Array(MdFailureModeSchema),
+    acceptance_criteria: Schema.Array(MdAcceptanceCriterionSchema),
+};
+const EMBEDDED_BLOCK_KEYS = new Set(Object.keys(EMBEDDED_BLOCK_SCHEMAS));
+export class MdDocParseError extends Data.TaggedError("MdDocParseError") {
+    get message() {
+        return this.reason;
+    }
+}
+const asRecord = (value) => {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+};
+const formatDecodeError = (error) => {
+    if (typeof error === "object" && error !== null && "message" in error) {
+        const message = error.message;
+        if (typeof message === "string") {
+            return message;
+        }
+    }
+    return String(error);
+};
+const decodeUnknown = (schema, input, context) => {
+    try {
+        return Either.right(Schema.decodeUnknownSync(schema)(input));
+    }
+    catch (error) {
+        return Either.left(new MdDocParseError({ reason: `${context}: ${formatDecodeError(error)}` }));
+    }
+};
+const splitFrontmatter = (content) => {
+    const cleaned = content.startsWith("\uFEFF") ? content.slice(1) : content;
+    const hasFrontmatterOpen = cleaned.startsWith("---\n") || cleaned.startsWith("---\r\n");
+    if (!hasFrontmatterOpen) {
+        return Either.left(new MdDocParseError({ reason: "Document must start with YAML frontmatter delimiter '---'." }));
+    }
+    const openLength = cleaned.startsWith("---\r\n") ? 5 : 4;
+    const rest = cleaned.slice(openLength);
+    const lines = rest.split(/\r?\n/);
+    const closingIndex = lines.findIndex((line) => line.trimEnd() === "---");
+    if (closingIndex === -1) {
+        return Either.left(new MdDocParseError({ reason: "Frontmatter opening delimiter found, but closing '---' delimiter is missing." }));
+    }
+    const frontmatter = lines.slice(0, closingIndex).join("\n");
+    const body = lines.slice(closingIndex + 1).join("\n");
+    return Either.right({ frontmatter, body });
+};
+const parseYamlRecord = (yamlContent, context) => {
+    let parsed;
+    try {
+        parsed = parseYaml(yamlContent);
+    }
+    catch (error) {
+        return Either.left(new MdDocParseError({ reason: `${context}: YAML parse error: ${String(error)}` }));
+    }
+    const record = asRecord(parsed);
+    if (!record) {
+        return Either.left(new MdDocParseError({ reason: `${context}: expected YAML object at top level.` }));
+    }
+    return Either.right(record);
+};
+const extractYamlBlocks = (body) => {
+    const lines = body.split(/\r?\n/);
+    const blocks = [];
+    let inFence = false;
+    let isYamlFence = false;
+    let fenceBuffer = [];
+    for (const line of lines) {
+        const fenceMatch = line.match(/^\s*```([^\s`]*)?\s*$/);
+        if (!inFence) {
+            if (fenceMatch) {
+                inFence = true;
+                const language = (fenceMatch[1] ?? "").toLowerCase();
+                isYamlFence = language === "yaml" || language === "yml";
+                fenceBuffer = [];
+            }
+            continue;
+        }
+        if (fenceMatch) {
+            if (isYamlFence) {
+                blocks.push(fenceBuffer.join("\n"));
+            }
+            inFence = false;
+            isYamlFence = false;
+            fenceBuffer = [];
+            continue;
+        }
+        if (isYamlFence) {
+            fenceBuffer.push(line);
+        }
+    }
+    if (inFence && isYamlFence) {
+        return Either.left(new MdDocParseError({ reason: "Unclosed fenced YAML block detected." }));
+    }
+    return Either.right(blocks);
+};
+const mergeEmbeddedBlock = (accumulator, key, entries) => {
+    const existing = accumulator[key] ?? [];
+    accumulator[key] = [...existing, ...entries];
+};
+const decodeEmbeddedBlockEntries = (key, value) => {
+    switch (key) {
+        case "ears_requirements":
+            return decodeUnknown(Schema.Array(MdEarsRequirementSchema), value, "Embedded block 'ears_requirements' validation failed");
+        case "invariants":
+            return decodeUnknown(Schema.Array(MdInvariantSchema), value, "Embedded block 'invariants' validation failed");
+        case "verification":
+            return decodeUnknown(Schema.Array(MdVerificationSchema), value, "Embedded block 'verification' validation failed");
+        case "interfaces":
+            return decodeUnknown(Schema.Array(MdInterfaceSchema), value, "Embedded block 'interfaces' validation failed");
+        case "failure_modes":
+            return decodeUnknown(Schema.Array(MdFailureModeSchema), value, "Embedded block 'failure_modes' validation failed");
+        case "acceptance_criteria":
+            return decodeUnknown(Schema.Array(MdAcceptanceCriterionSchema), value, "Embedded block 'acceptance_criteria' validation failed");
+    }
+};
+const parseEmbeddedBlocks = (body) => {
+    const yamlBlocksResult = extractYamlBlocks(body);
+    if (Either.isLeft(yamlBlocksResult)) {
+        return Either.left(yamlBlocksResult.left);
+    }
+    const mergedBlocks = {};
+    for (const rawBlock of yamlBlocksResult.right) {
+        const parsedBlockResult = parseYamlRecord(rawBlock, "Embedded YAML block");
+        if (Either.isLeft(parsedBlockResult)) {
+            return Either.left(parsedBlockResult.left);
+        }
+        for (const [key, value] of Object.entries(parsedBlockResult.right)) {
+            if (!EMBEDDED_BLOCK_KEYS.has(key)) {
+                continue;
+            }
+            const typedKey = key;
+            const decodedEntriesResult = decodeEmbeddedBlockEntries(typedKey, value);
+            if (Either.isLeft(decodedEntriesResult)) {
+                return Either.left(decodedEntriesResult.left);
+            }
+            if (typedKey === "ears_requirements") {
+                const earsValidationErrors = validateEarsRequirements(decodedEntriesResult.right);
+                if (earsValidationErrors.length > 0) {
+                    return Either.left(new MdDocParseError({
+                        reason: `Embedded block 'ears_requirements' semantic validation failed: ${formatEarsValidationErrors(earsValidationErrors)}`,
+                    }));
+                }
+            }
+            mergeEmbeddedBlock(mergedBlocks, typedKey, decodedEntriesResult.right);
+        }
+    }
+    return decodeUnknown(MdEmbeddedBlocksSchema, mergedBlocks, "Embedded blocks validation failed");
+};
+const extractSections = (body) => {
+    const lines = body.split(/\r?\n/);
+    const sections = [];
+    let inFence = false;
+    let currentHeading = null;
+    let sectionBodyLines = [];
+    const flushSection = () => {
+        if (currentHeading === null) {
+            return;
+        }
+        sections.push({
+            heading: currentHeading,
+            body: sectionBodyLines.join("\n").trim(),
+        });
+        currentHeading = null;
+        sectionBodyLines = [];
+    };
+    for (const line of lines) {
+        if (/^\s*```/.test(line)) {
+            inFence = !inFence;
+            if (currentHeading !== null) {
+                sectionBodyLines.push(line);
+            }
+            continue;
+        }
+        if (!inFence) {
+            const headingMatch = line.match(/^(#{1,6})\s+(.+?)\s*$/);
+            if (headingMatch) {
+                flushSection();
+                currentHeading = headingMatch[2].replace(/\s+#+\s*$/, "").trim();
+                continue;
+            }
+        }
+        if (currentHeading !== null) {
+            sectionBodyLines.push(line);
+        }
+    }
+    flushSection();
+    return decodeUnknown(Schema.Array(MdSectionSchema), sections, "Section extraction validation failed");
+};
+const normalizeHeading = (heading) => heading.trim().toLowerCase();
+const validateRequiredSections = (frontmatter, sections) => {
+    const requiredSections = MD_REQUIRED_SECTIONS_BY_SPEC_TYPE[frontmatter.spec_type];
+    const present = new Set(sections.map((section) => normalizeHeading(section.heading)));
+    const missing = requiredSections.filter((requiredHeading) => !present.has(normalizeHeading(requiredHeading)));
+    if (missing.length > 0) {
+        return Either.left(new MdDocParseError({
+            reason: `Missing required section(s) for spec_type '${frontmatter.spec_type}': ${missing.join(", ")}`,
+        }));
+    }
+    return Either.right(undefined);
+};
+const parseFrontmatterByKind = (rawFrontmatter) => {
+    const kind = rawFrontmatter.kind;
+    if (kind === "spec") {
+        const decodedFrontmatter = decodeUnknown(MdFrontmatterSchema, rawFrontmatter, "Frontmatter validation failed");
+        if (Either.isLeft(decodedFrontmatter)) {
+            return Either.left(decodedFrontmatter.left);
+        }
+        return Either.right({ kind: "spec", frontmatter: decodedFrontmatter.right });
+    }
+    if (kind === "task") {
+        return Either.right({ kind: "task", frontmatter: rawFrontmatter });
+    }
+    return Either.left(new MdDocParseError({
+        reason: "Frontmatter 'kind' must be either 'spec' or 'task'.",
+    }));
+};
+export const parseMdDocSync = (content) => {
+    const frontmatterSplit = splitFrontmatter(content);
+    if (Either.isLeft(frontmatterSplit)) {
+        return Either.left(frontmatterSplit.left);
+    }
+    const rawFrontmatterResult = parseYamlRecord(frontmatterSplit.right.frontmatter, "Frontmatter");
+    if (Either.isLeft(rawFrontmatterResult)) {
+        return Either.left(rawFrontmatterResult.left);
+    }
+    const parsedFrontmatterResult = parseFrontmatterByKind(rawFrontmatterResult.right);
+    if (Either.isLeft(parsedFrontmatterResult)) {
+        return Either.left(parsedFrontmatterResult.left);
+    }
+    const sectionsResult = extractSections(frontmatterSplit.right.body);
+    if (Either.isLeft(sectionsResult)) {
+        return Either.left(sectionsResult.left);
+    }
+    const blocksResult = parseEmbeddedBlocks(frontmatterSplit.right.body);
+    if (Either.isLeft(blocksResult)) {
+        return Either.left(blocksResult.left);
+    }
+    if (parsedFrontmatterResult.right.kind === "spec") {
+        const sectionValidation = validateRequiredSections(parsedFrontmatterResult.right.frontmatter, sectionsResult.right);
+        if (Either.isLeft(sectionValidation)) {
+            return Either.left(sectionValidation.left);
+        }
+        return decodeUnknown(MdParsedDocSchema, {
+            kind: "spec",
+            frontmatter: parsedFrontmatterResult.right.frontmatter,
+            sections: sectionsResult.right,
+            blocks: blocksResult.right,
+        }, "Parsed spec document validation failed");
+    }
+    return decodeUnknown(MdParsedDocSchema, {
+        kind: "task",
+        frontmatter: parsedFrontmatterResult.right.frontmatter,
+        sections: sectionsResult.right,
+        blocks: blocksResult.right,
+    }, "Parsed task document validation failed");
+};
+export const parseMdDoc = (content) => {
+    const parsed = parseMdDocSync(content);
+    return Either.isLeft(parsed)
+        ? Effect.fail(parsed.left)
+        : Effect.succeed(parsed.right);
+};
+//# sourceMappingURL=md-doc-parser.js.map

package/dist/utils/md-doc-parser.js.map

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

package/dist/utils/toml-config.d.ts

@@ -1,4 +1,11 @@
 export type DashboardDefaultTaskAssigmentType = "human" | "agent";
+export type DashboardDefaultTaskView = "list" | "kanban";
+export type DashboardCycleStartDay = "sunday" | "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday";
+export type DashboardCyclesConfig = {
+    cycleLengthDays: number;
+    cycleStartDay: DashboardCycleStartDay;
+    carryStatuses: string[];
+};
 export type GuardMode = "advisory" | "enforce";
 export type TxConfig = {
     docs: {
@@ -17,6 +24,8 @@ export type TxConfig = {
     };
     dashboard: {
         defaultTaskAssigmentType: DashboardDefaultTaskAssigmentType;
+        defaultTaskView: DashboardDefaultTaskView;
+        cycles: DashboardCyclesConfig;
     };
     pins: {
         targetFiles: string[];
@@ -40,6 +49,10 @@ export type TxConfig = {
     };
 };
 export declare const DASHBOARD_DEFAULT_TASK_ASSIGMENT_KEY = "default_task_assigment_type";
+export declare const DASHBOARD_DEFAULT_TASK_VIEW_KEY = "default_task_view";
+export declare const DASHBOARD_CYCLE_LENGTH_DAYS_KEY = "cycle_length_days";
+export declare const DASHBOARD_CYCLE_START_DAY_KEY = "cycle_start_day";
+export declare const DASHBOARD_CARRY_STATUSES_KEY = "carry_statuses";
 /**
  * Read .tx/config.toml and return parsed config.
  * Falls back to defaults if file doesn't exist or is invalid.
@@ -50,6 +63,27 @@ export declare const readTxConfig: (cwd?: string) => TxConfig;
  * Preserves unrelated sections and comments.
  */
 export declare const writeDashboardDefaultTaskAssigmentType: (value: DashboardDefaultTaskAssigmentType, cwd?: string) => TxConfig;
+/**
+ * Patch the dashboard default task view in .tx/config.toml.
+ * Preserves unrelated sections and comments.
+ */
+export declare const writeDashboardDefaultTaskView: (value: DashboardDefaultTaskView, cwd?: string) => TxConfig;
+/**
+ * Read dashboard cycle settings from .tx/config.toml.
+ */
+export declare const readDashboardCyclesConfig: (cwd?: string) => DashboardCyclesConfig;
+/**
+ * Patch dashboard cycle length in .tx/config.toml.
+ */
+export declare const writeDashboardCycleLengthDays: (value: number, cwd?: string) => TxConfig;
+/**
+ * Patch dashboard cycle start day in .tx/config.toml.
+ */
+export declare const writeDashboardCycleStartDay: (value: DashboardCycleStartDay, cwd?: string) => TxConfig;
+/**
+ * Patch dashboard cycle carry statuses in .tx/config.toml.
+ */
+export declare const writeDashboardCarryStatuses: (value: readonly string[], cwd?: string) => TxConfig;
 /**
  * Scaffold .tx/config.toml with annotated defaults.
  * No-op if the file already exists (preserves user edits).

package/dist/utils/toml-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toml-config.d.ts","sourceRoot":"","sources":["../../src/utils/toml-config.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,iCAAiC,GAAG,OAAO,GAAG,OAAO,CAAA;AACjE,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,CAAA;AAE9C,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACtB,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;IAChC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9B,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACpE,SAAS,EAAE;QAAE,wBAAwB,EAAE,iCAAiC,CAAA;KAAE,CAAA;IAC1E,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,EAAE,CAAC;QAAC,+BAA+B,EAAE,OAAO,CAAA;KAAE,CAAA;IACzE,KAAK,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;IAC1G,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;IACzD,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,OAAO,CAAA;KAAE,CAAA;CAAC,CAAC;AAE7G,eAAO,MAAM,oCAAoC,gCAAgC,CAAA;AAwDjF;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,MAAK,MAAsB,KAAG,QAuF1D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,sCAAsC,GACjD,OAAO,iCAAiC,EACxC,MAAK,MAAsB,KAC1B,QAiBF,CAAA;AAmTD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAK,MAAsB,KAAG,OAShE,CAAA"}
+{"version":3,"file":"toml-config.d.ts","sourceRoot":"","sources":["../../src/utils/toml-config.ts"],"names":[],"mappings":"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"}