@downcity/plugins 1.0.4

package/bin/task/runtime/CronTrigger.js

@@ -0,0 +1,93 @@
+/**
+ * Task cron 触发引擎。
+ *
+ * 关键点（中文）
+ * - 该模块仅服务于 task plugin runtime，不放在 core。
+ * - 只提供 cron 注册与调度，不承载 task 业务语义。
+ */
+import cron from "node-cron";
+export class TaskCronTriggerEngine {
+    definitions = new Map();
+    scheduledJobs = new Map();
+    started = false;
+    register(definition) {
+        const id = String(definition.id || "").trim();
+        if (!id)
+            throw new Error("TaskCronTriggerDefinition.id is required");
+        const expression = String(definition.expression || "").trim();
+        if (!expression)
+            throw new Error(`Cron expression is required for job: ${id}`);
+        if (!cron.validate(expression)) {
+            throw new Error(`Invalid cron expression for job ${id}: ${expression}`);
+        }
+        const normalized = {
+            ...definition,
+            id,
+            expression,
+        };
+        this.definitions.set(id, normalized);
+        if (this.started) {
+            this.scheduleOne(normalized);
+        }
+    }
+    unregister(id) {
+        const key = String(id || "").trim();
+        if (!key)
+            return;
+        this.definitions.delete(key);
+        const scheduled = this.scheduledJobs.get(key);
+        if (scheduled) {
+            try {
+                scheduled.stop();
+            }
+            catch {
+                // ignore
+            }
+            this.scheduledJobs.delete(key);
+        }
+    }
+    async start() {
+        if (this.started)
+            return;
+        this.started = true;
+        for (const definition of this.definitions.values()) {
+            this.scheduleOne(definition);
+        }
+    }
+    async stop() {
+        if (!this.started)
+            return;
+        this.started = false;
+        for (const scheduled of this.scheduledJobs.values()) {
+            try {
+                scheduled.stop();
+            }
+            catch {
+                // ignore
+            }
+        }
+        this.scheduledJobs.clear();
+    }
+    scheduleOne(definition) {
+        const previous = this.scheduledJobs.get(definition.id);
+        if (previous) {
+            try {
+                previous.stop();
+            }
+            catch {
+                // ignore
+            }
+            this.scheduledJobs.delete(definition.id);
+        }
+        const scheduled = cron.schedule(definition.expression, async () => {
+            try {
+                await Promise.resolve(definition.execute());
+            }
+            catch {
+                // ignore
+            }
+        }, definition.timezone ? { timezone: definition.timezone } : undefined);
+        this.scheduledJobs.set(definition.id, scheduled);
+    }
+}
+//# sourceMappingURL=CronTrigger.js.map

package/bin/task/runtime/CronTrigger.js.map

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

package/bin/task/runtime/Frontmatter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Markdown frontmatter parser（任务系统内核复用）。
+ *
+ * 关键点（中文）
+ * - 内核只保留通用 frontmatter 解析，不依赖 skills 模块实现。
+ * - 解析规则保持稳定：仅识别文档起始的 `--- yaml ---` 头块。
+ */
+export type FrontMatterParseResult = {
+    frontMatterYaml: string | null;
+    body: string;
+};
+export declare function parseFrontMatter(markdown: string): FrontMatterParseResult;
+//# sourceMappingURL=Frontmatter.d.ts.map

package/bin/task/runtime/Frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Frontmatter.d.ts","sourceRoot":"","sources":["../../../src/task/runtime/Frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,sBAAsB,GAAG;IACnC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAUzE"}

package/bin/task/runtime/Frontmatter.js

@@ -0,0 +1,19 @@
+/**
+ * Markdown frontmatter parser（任务系统内核复用）。
+ *
+ * 关键点（中文）
+ * - 内核只保留通用 frontmatter 解析，不依赖 skills 模块实现。
+ * - 解析规则保持稳定：仅识别文档起始的 `--- yaml ---` 头块。
+ */
+export function parseFrontMatter(markdown) {
+    const text = String(markdown ?? "");
+    if (!text.startsWith("---"))
+        return { frontMatterYaml: null, body: text };
+    const match = text.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
+    if (!match)
+        return { frontMatterYaml: null, body: text };
+    const frontMatterYaml = match[1] ?? "";
+    const body = text.slice(match[0].length);
+    return { frontMatterYaml, body };
+}
+//# sourceMappingURL=Frontmatter.js.map

package/bin/task/runtime/Frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Frontmatter.js","sourceRoot":"","sources":["../../../src/task/runtime/Frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAE1E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC9D,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAEzD,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC"}

package/bin/task/runtime/Model.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Task definition parsing and validation.
+ *
+ * 关键点（中文）
+ * - `task.md` 使用 YAML frontmatter + markdown 正文
+ * - frontmatter 必须包含：title/when/description/sessionId/status
+ * - `when` 统一承载触发语义：`@manual` / cron / `time:<ISO8601-with-timezone>`
+ */
+import type { ShipTaskDefinitionV1, ShipTaskFrontmatterV1, ShipTaskKind, ShipTaskStatus } from "../../task/types/Task.js";
+import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
+type TaskRawValue = JsonValue | undefined;
+/**
+ * 校验并归一化 when。
+ *
+ * 规则（中文）
+ * - `@manual`
+ * - cron / alias
+ * - `time:<ISO8601-with-timezone>`（一次性触发）
+ * - 兼容裸 ISO 时间输入，会归一化为 `time:<iso>`
+ */
+export declare function normalizeTaskWhen(input: TaskRawValue): {
+    ok: true;
+    value: string;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * 兼容旧调用名：返回 cron 表达式或 `@manual`。
+ */
+export declare function normalizeTaskCronExpression(raw: string): string | null;
+export declare function isTaskWhenManual(input: string): boolean;
+export declare function isTaskWhenOneShot(input: string): boolean;
+/**
+ * when -> cron expression；非 cron 返回 null。
+ */
+export declare function resolveTaskWhenCronExpression(input: string): string | null;
+/**
+ * when -> one-shot 毫秒时间戳；非 one-shot 返回 null。
+ */
+export declare function resolveTaskWhenOneShotMs(input: string): number | null;
+/**
+ * 归一化 task 状态。
+ */
+export declare function normalizeTaskStatus(input: TaskRawValue): ShipTaskStatus | null;
+/**
+ * 归一化 task 执行类型。
+ */
+export declare function normalizeTaskKind(input: TaskRawValue): ShipTaskKind;
+/**
+ * 解析 task.md 为结构化定义。
+ */
+export declare function parseTaskMarkdown(params: {
+    taskId: string;
+    markdown: string;
+    taskMdPath: string;
+    projectRoot: string;
+}): {
+    ok: true;
+    task: ShipTaskDefinitionV1;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * 生成 task.md 文本。
+ */
+export declare function buildTaskMarkdown(params: {
+    frontmatter: ShipTaskFrontmatterV1;
+    body: string;
+}): string;
+export {};
+//# sourceMappingURL=Model.d.ts.map

package/bin/task/runtime/Model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Model.d.ts","sourceRoot":"","sources":["../../../src/task/runtime/Model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAa3F,KAAK,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AAgE1C;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,GAClB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAmC5D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKtE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM1E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQrE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,GAAG,IAAI,CAM9E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAInE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA4F1E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,WAAW,EAAE,qBAAqB,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CA8BT"}

package/bin/task/runtime/Model.js

@@ -0,0 +1,312 @@
+/**
+ * Task definition parsing and validation.
+ *
+ * 关键点（中文）
+ * - `task.md` 使用 YAML frontmatter + markdown 正文
+ * - frontmatter 必须包含：title/when/description/sessionId/status
+ * - `when` 统一承载触发语义：`@manual` / cron / `time:<ISO8601-with-timezone>`
+ */
+import yaml from "js-yaml";
+import path from "node:path";
+import cron from "node-cron";
+import { parseFrontMatter } from "./Frontmatter.js";
+/**
+ * 必填 frontmatter 字段清单。
+ */
+const REQUIRED_FIELDS = [
+    "title",
+    "when",
+    "description",
+    "sessionId",
+    "status",
+];
+function normalizeTaskReview(input) {
+    if (typeof input === "boolean")
+        return input;
+    if (typeof input !== "string")
+        return null;
+    const value = input.trim().toLowerCase();
+    if (!value)
+        return null;
+    if (["true", "1", "yes", "on"].includes(value))
+        return true;
+    if (["false", "0", "no", "off"].includes(value))
+        return false;
+    return null;
+}
+/**
+ * cron alias 映射表。
+ */
+const CRON_ALIAS_TO_EXPRESSION = {
+    "@manual": "@manual",
+    "@hourly": "0 * * * *",
+    "@daily": "0 0 * * *",
+    "@weekly": "0 0 * * 0",
+    "@monthly": "0 0 1 * *",
+    "@yearly": "0 0 1 1 *",
+    "@annually": "0 0 1 1 *",
+};
+const ISO_DATETIME_WITH_TZ_REGEXP = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d{1,3})?)?(?:Z|[+-]\d{2}:\d{2})$/i;
+const ISO_DATETIME_WITHOUT_TZ_REGEXP = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d{1,3})?)?$/i;
+function normalizeCronExpression(raw) {
+    const value = String(raw || "").trim();
+    if (!value)
+        return null;
+    const lower = value.toLowerCase();
+    return CRON_ALIAS_TO_EXPRESSION[lower] || value;
+}
+function normalizeOneShotTime(raw) {
+    const value = String(raw || "").trim();
+    if (!value) {
+        return {
+            ok: false,
+            error: "Invalid when time: expected ISO8601 datetime with timezone, e.g. 2026-03-08T10:30:00+08:00 or Z",
+        };
+    }
+    if (!ISO_DATETIME_WITH_TZ_REGEXP.test(value)) {
+        return {
+            ok: false,
+            error: `Invalid when time: "${value}" (expected ISO8601 datetime with timezone, e.g. 2026-03-08T10:30:00+08:00 or Z)`,
+        };
+    }
+    const ms = Date.parse(value);
+    if (!Number.isFinite(ms) || Number.isNaN(ms)) {
+        return {
+            ok: false,
+            error: `Invalid when time: "${value}" (expected ISO8601 datetime with timezone, e.g. 2026-03-08T10:30:00+08:00 or Z)`,
+        };
+    }
+    return { ok: true, value: new Date(ms).toISOString() };
+}
+/**
+ * 校验并归一化 when。
+ *
+ * 规则（中文）
+ * - `@manual`
+ * - cron / alias
+ * - `time:<ISO8601-with-timezone>`（一次性触发）
+ * - 兼容裸 ISO 时间输入，会归一化为 `time:<iso>`
+ */
+export function normalizeTaskWhen(input) {
+    const raw = String(input || "").trim();
+    if (!raw)
+        return { ok: false, error: "when cannot be empty" };
+    const lower = raw.toLowerCase();
+    if (lower === "@manual")
+        return { ok: true, value: "@manual" };
+    if (lower.startsWith("time:")) {
+        const timeRaw = raw.slice(raw.indexOf(":") + 1).trim();
+        const normalized = normalizeOneShotTime(timeRaw);
+        if (!normalized.ok)
+            return normalized;
+        return { ok: true, value: `time:${normalized.value}` };
+    }
+    if (ISO_DATETIME_WITH_TZ_REGEXP.test(raw)) {
+        const normalized = normalizeOneShotTime(raw);
+        if (!normalized.ok)
+            return normalized;
+        return { ok: true, value: `time:${normalized.value}` };
+    }
+    if (ISO_DATETIME_WITHOUT_TZ_REGEXP.test(raw)) {
+        return {
+            ok: false,
+            error: `Invalid when time: "${raw}" (expected ISO8601 datetime with timezone, e.g. 2026-03-08T10:30:00+08:00 or Z)`,
+        };
+    }
+    const cronExpression = normalizeCronExpression(raw);
+    if (!cronExpression)
+        return { ok: false, error: "when cannot be empty" };
+    const canonical = CRON_ALIAS_TO_EXPRESSION[lower] ? lower : raw;
+    if (cronExpression !== "@manual" && !cron.validate(cronExpression)) {
+        return { ok: false, error: `Invalid when (cron): "${raw}"` };
+    }
+    return { ok: true, value: canonical };
+}
+/**
+ * 兼容旧调用名：返回 cron 表达式或 `@manual`。
+ */
+export function normalizeTaskCronExpression(raw) {
+    const when = normalizeTaskWhen(raw);
+    if (!when.ok)
+        return null;
+    if (isTaskWhenOneShot(when.value))
+        return null;
+    return normalizeCronExpression(when.value);
+}
+export function isTaskWhenManual(input) {
+    const when = String(input || "").trim().toLowerCase();
+    return when === "@manual";
+}
+export function isTaskWhenOneShot(input) {
+    const when = String(input || "").trim().toLowerCase();
+    return when.startsWith("time:");
+}
+/**
+ * when -> cron expression；非 cron 返回 null。
+ */
+export function resolveTaskWhenCronExpression(input) {
+    const normalized = normalizeTaskWhen(input);
+    if (!normalized.ok)
+        return null;
+    if (isTaskWhenManual(normalized.value))
+        return null;
+    if (isTaskWhenOneShot(normalized.value))
+        return null;
+    return normalizeCronExpression(normalized.value);
+}
+/**
+ * when -> one-shot 毫秒时间戳；非 one-shot 返回 null。
+ */
+export function resolveTaskWhenOneShotMs(input) {
+    const normalized = normalizeTaskWhen(input);
+    if (!normalized.ok)
+        return null;
+    if (!isTaskWhenOneShot(normalized.value))
+        return null;
+    const iso = normalized.value.slice("time:".length).trim();
+    const ms = Date.parse(iso);
+    if (!Number.isFinite(ms) || Number.isNaN(ms))
+        return null;
+    return ms;
+}
+/**
+ * 归一化 task 状态。
+ */
+export function normalizeTaskStatus(input) {
+    const s = typeof input === "string" ? input.trim().toLowerCase() : "";
+    if (s === "enabled")
+        return "enabled";
+    if (s === "paused")
+        return "paused";
+    if (s === "disabled")
+        return "disabled";
+    return null;
+}
+/**
+ * 归一化 task 执行类型。
+ */
+export function normalizeTaskKind(input) {
+    const s = typeof input === "string" ? input.trim().toLowerCase() : "";
+    if (s === "script")
+        return "script";
+    return "agent";
+}
+/**
+ * 解析 task.md 为结构化定义。
+ */
+export function parseTaskMarkdown(params) {
+    const { taskId, markdown, taskMdPath, projectRoot } = params;
+    const text = String(markdown ?? "");
+    const { frontMatterYaml, body } = parseFrontMatter(text);
+    if (!frontMatterYaml || !frontMatterYaml.trim()) {
+        return { ok: false, error: "Missing YAML frontmatter (--- ... ---) in task.md" };
+    }
+    let meta = null;
+    try {
+        const loaded = yaml.load(frontMatterYaml);
+        if (loaded && typeof loaded === "object" && !Array.isArray(loaded)) {
+            meta = loaded;
+        }
+        else {
+            meta = null;
+        }
+    }
+    catch (e) {
+        return { ok: false, error: `Invalid YAML frontmatter: ${String(e)}` };
+    }
+    if (!meta || typeof meta !== "object") {
+        return { ok: false, error: "Invalid frontmatter: must be a YAML object" };
+    }
+    // 兼容已有任务定义：若无 when，则按旧字段推导。
+    const rawWhen = String(meta.when ?? "").trim();
+    if (!rawWhen) {
+        const rawTime = String(meta.time ?? "").trim();
+        const rawCron = String(meta.cron ?? "").trim();
+        if (rawTime) {
+            meta.when = `time:${rawTime}`;
+        }
+        else if (rawCron) {
+            meta.when = rawCron;
+        }
+    }
+    const missing = [];
+    const rawTitle = String(meta?.title ?? "").trim();
+    if (!rawTitle)
+        missing.push("title");
+    for (const f of REQUIRED_FIELDS.filter((x) => x !== "title")) {
+        if (meta?.[f] === undefined || meta?.[f] === null || String(meta?.[f]).trim() === "") {
+            missing.push(String(f));
+        }
+    }
+    if (missing.length > 0) {
+        return { ok: false, error: `Missing required frontmatter fields: ${missing.join(", ")}` };
+    }
+    const status = normalizeTaskStatus(meta.status);
+    if (!status) {
+        return {
+            ok: false,
+            error: `Invalid status: "${String(meta.status)}" (expected: enabled|paused|disabled)`,
+        };
+    }
+    const whenNormalized = normalizeTaskWhen(meta.when);
+    if (!whenNormalized.ok) {
+        return { ok: false, error: whenNormalized.error };
+    }
+    const kind = normalizeTaskKind(meta.kind);
+    const bodyText = String(body ?? "").trim();
+    if (kind === "script" && !bodyText) {
+        return { ok: false, error: "script task body cannot be empty" };
+    }
+    const fm = {
+        title: rawTitle,
+        when: whenNormalized.value,
+        description: String(meta.description).trim(),
+        sessionId: String(meta.sessionId).trim(),
+        kind,
+        ...(kind === "agent" && normalizeTaskReview(meta.review) === true ? { review: true } : {}),
+        status,
+    };
+    const relTaskMdPath = path
+        .relative(projectRoot, taskMdPath)
+        .split(path.sep)
+        .join("/");
+    const task = {
+        v: 1,
+        taskId,
+        frontmatter: fm,
+        body: String(body ?? "").trim(),
+        taskMdPath: relTaskMdPath,
+    };
+    return { ok: true, task };
+}
+/**
+ * 生成 task.md 文本。
+ */
+export function buildTaskMarkdown(params) {
+    const { frontmatter, body } = params;
+    const whenNormalized = normalizeTaskWhen(frontmatter.when);
+    if (!whenNormalized.ok) {
+        throw new Error(whenNormalized.error);
+    }
+    const kind = normalizeTaskKind(frontmatter.kind);
+    const bodyText = String(body ?? "").trim();
+    if (kind === "script" && !bodyText) {
+        throw new Error("script task body cannot be empty");
+    }
+    const meta = {
+        title: String(frontmatter.title || "").trim(),
+        when: whenNormalized.value,
+        description: String(frontmatter.description || "").trim(),
+        sessionId: String(frontmatter.sessionId || "").trim(),
+        kind,
+        ...(kind === "agent" ? { review: Boolean(frontmatter.review) } : {}),
+        status: String(frontmatter.status || "").trim(),
+    };
+    const yamlText = yaml.dump(meta, {
+        lineWidth: 120,
+        noRefs: true,
+    });
+    const bodyWithTrailingLf = bodyText ? bodyText + "\n" : "";
+    return `---\n${yamlText}---\n\n${bodyWithTrailingLf}`;
+}
+//# sourceMappingURL=Model.js.map

package/bin/task/runtime/Model.js.map

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

package/bin/task/runtime/Paths.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Task System paths and identifiers.
+ *
+ * 约定（中文）
+ * - task root: `./.downcity/task/`
+ * - definition: `./.downcity/task/<taskId>/task.md`
+ * - run dir: `./.downcity/task/<taskId>/<timestamp>/`
+ *
+ * 同时定义“task run sessionId”格式，用于把 Agent 的 session 映射到 run 目录：
+ * - `task-run:<taskId>:<timestamp>`
+ */
+export declare function isValidTaskId(input: string): boolean;
+/**
+ * 从 title 派生 taskId。
+ *
+ * 关键点（中文）
+ * - 目标：保证“title 与 taskId 同源”，避免随机 ID。
+ * - 处理：移除路径危险字符与非常见标点，压缩空白，最终按 taskId 规则校验。
+ */
+export declare function deriveTaskIdFromTitle(title: string): string;
+export declare function normalizeTaskId(input: string): string;
+export declare function getTaskRootDir(projectRoot: string): string;
+export declare function getTaskDir(projectRoot: string, taskId: string): string;
+export declare function getTaskMdPath(projectRoot: string, taskId: string): string;
+export declare function formatTaskRunTimestamp(date?: Date): string;
+export declare function getTaskRunDir(projectRoot: string, taskId: string, timestamp: string): string;
+export declare function createTaskRunSessionId(taskId: string, timestamp: string): string;
+export declare function parseTaskRunSessionId(sessionId: string): {
+    taskId: string;
+    timestamp: string;
+} | null;
+//# sourceMappingURL=Paths.d.ts.map

package/bin/task/runtime/Paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Paths.d.ts","sourceRoot":"","sources":["../../../src/task/runtime/Paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKpD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAc3D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAWtE;AAED,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CAIR;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKhF;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,GAChB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAU9C"}