@zq-silk/yui 0.2.0 → 0.4.2

package/dist/output/timePresentation.js

@@ -0,0 +1,55 @@
+export const DEFAULT_TIME_ZONE = "Asia/Shanghai";
+export function resolveTimeZone(value) {
+    const timeZone = value ?? DEFAULT_TIME_ZONE;
+    if (typeof timeZone !== "string" || timeZone.trim() !== timeZone || timeZone.length === 0) {
+        throw new TypeError("timeZone must be a valid IANA timezone.");
+    }
+    try {
+        new Intl.DateTimeFormat("en", { timeZone }).format(0);
+    }
+    catch {
+        throw new TypeError("timeZone must be a valid IANA timezone.");
+    }
+    return timeZone;
+}
+/** Formats persisted UTC/RFC 3339 timestamps for human-facing CLI output. */
+export function formatTimestamp(value, configuredTimeZone) {
+    const instant = new Date(value);
+    if (!Number.isFinite(instant.getTime()))
+        throw new TypeError("Timestamp is invalid.");
+    const timeZone = resolveTimeZone(configuredTimeZone);
+    const parts = Object.fromEntries(new Intl.DateTimeFormat("en-CA", {
+        timeZone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        hourCycle: "h23",
+        timeZoneName: "longOffset"
+    }).formatToParts(instant).map(({ type, value: part }) => [type, part]));
+    const offset = parts.timeZoneName === "GMT"
+        ? "+00:00"
+        : parts.timeZoneName?.replace(/^GMT/, "");
+    if (offset === undefined)
+        throw new TypeError("Timezone offset is unavailable.");
+    return `${parts.year}-${parts.month}-${parts.day} ${parts.hour}:${parts.minute}:${parts.second} ${offset}`;
+}
+/** Compact elapsed time for recent human-facing activity lists. */
+export function formatRelativeTimestamp(value, now = new Date()) {
+    const instant = new Date(value);
+    if (!Number.isFinite(instant.getTime()) || !Number.isFinite(now.getTime())) {
+        throw new TypeError("Timestamp is invalid.");
+    }
+    const seconds = Math.floor(Math.max(0, now.getTime() - instant.getTime()) / 1_000);
+    if (seconds < 60)
+        return seconds <= 5 ? "now" : `${seconds}s ago`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    return `${Math.floor(hours / 24)}d ago`;
+}

package/dist/profile/agentProfile.js

@@ -0,0 +1,128 @@
+import { cloneJson, normalizedUniqueText, optionalText, requireIdentity, requirePositiveInteger, requireTimestamp } from "../domain/validation.js";
+export const BUILTIN_PROFILE_IDS = Object.freeze([
+    "worker",
+    "explorer",
+    "implementer",
+    "reviewer"
+]);
+export function createAgentProfile(input, now) {
+    const timestamp = now.toISOString();
+    return validateAgentProfile({
+        schemaVersion: 2,
+        id: requireIdentity(input.id, "Agent Profile id"),
+        revision: 1,
+        ...normalizeInput(input),
+        createdAt: timestamp,
+        updatedAt: timestamp
+    });
+}
+export function updateAgentProfile(profile, patch, now) {
+    validateAgentProfile(profile);
+    const candidate = {
+        ...cloneJson(profile),
+        ...normalizePatch(patch),
+        revision: profile.revision + 1,
+        updatedAt: now.toISOString()
+    };
+    for (const key of ["description", "instructions", "skills", "model", "effort"]) {
+        if (candidate[key] === undefined)
+            delete candidate[key];
+    }
+    return validateAgentProfile(candidate);
+}
+export function validateAgentProfile(profile) {
+    if (profile.schemaVersion !== 2) {
+        throw new Error("AgentProfile must use schemaVersion 2.");
+    }
+    requireIdentity(profile.id, "Agent Profile id");
+    requirePositiveInteger(profile.revision, "Agent Profile revision");
+    validateAccess(profile.defaultAccess);
+    if (profile.description !== undefined)
+        optionalText(profile.description, "Profile description");
+    if (profile.instructions !== undefined)
+        optionalText(profile.instructions, "Profile instructions");
+    if (profile.skills !== undefined)
+        normalizedUniqueText(profile.skills, "Profile skill");
+    if (profile.model !== undefined)
+        optionalText(profile.model, "Profile model");
+    if (profile.effort !== undefined)
+        optionalText(profile.effort, "Profile effort");
+    requireTimestamp(profile.createdAt, "Agent Profile createdAt");
+    requireTimestamp(profile.updatedAt, "Agent Profile updatedAt");
+    if (Date.parse(profile.updatedAt) < Date.parse(profile.createdAt)) {
+        throw new Error("Agent Profile updatedAt cannot precede createdAt.");
+    }
+    return profile;
+}
+export function builtinAgentProfileInputs() {
+    return [
+        {
+            id: "worker",
+            description: "Implement and validate one bounded delegated WorkItem.",
+            defaultAccess: "write"
+        },
+        {
+            id: "explorer",
+            description: "Inspect sources and return evidence without modifying them.",
+            instructions: "Do not modify files or external state.",
+            defaultAccess: "read"
+        },
+        {
+            id: "implementer",
+            description: "Implement and validate one bounded result.",
+            defaultAccess: "write"
+        },
+        {
+            id: "reviewer",
+            description: "Review one candidate against the user's core outcome, supported behavior, and direct evidence.",
+            instructions: "Start from user intent and acceptance criteria. Inspect the complete relevant change and report only reachable, material, actionable problems with direct evidence. Separate defects from verification gaps, and prefer the smallest sufficient correction. Follow the bound Project's Policy and Knowledge for build, test, migration, release, and review expectations; do not import rules from another Project or Task. For normal software delivery, review the frozen integrated Task result as one final ReviewRound rather than inventing a per-WorkItem protocol unless the Project Policy explicitly requires one. Do not turn speculative or extreme edge cases into new state, retries, fallbacks, or protocol. In a ReviewRound-owned workspace you may edit source or tests, run local checks, and optionally commit diagnostic evidence. Never push, integrate, mutate Task state, touch another workspace or stable checkout, or write the real Yui control-plane home. Report complete findings, checks actually run, uncertainty, and bounded next actions through the exact Review yield; Yui preserves the full free-form report. Expose evidence and options to the Leader, who decides.",
+            defaultAccess: "write"
+        }
+    ];
+}
+function normalizeInput(input) {
+    return {
+        defaultAccess: validatedAccess(input.defaultAccess ?? "read"),
+        ...(input.description === undefined
+            ? {}
+            : { description: optionalText(input.description, "Profile description") }),
+        ...(input.instructions === undefined
+            ? {}
+            : { instructions: optionalText(input.instructions, "Profile instructions") }),
+        ...(input.skills === undefined
+            ? {}
+            : { skills: normalizedUniqueText(input.skills, "Profile skill") }),
+        ...(input.model === undefined ? {} : { model: optionalText(input.model, "Profile model") }),
+        ...(input.effort === undefined ? {} : { effort: optionalText(input.effort, "Profile effort") })
+    };
+}
+function normalizePatch(patch) {
+    const result = {};
+    if (Object.hasOwn(patch, "defaultAccess")) {
+        result.defaultAccess = validatedAccess(patch.defaultAccess);
+    }
+    for (const key of ["description", "instructions", "model", "effort"]) {
+        if (!Object.hasOwn(patch, key))
+            continue;
+        result[key] = patch[key] === undefined
+            ? undefined
+            : optionalText(patch[key], `Profile ${key}`);
+    }
+    if (Object.hasOwn(patch, "skills")) {
+        result.skills = patch.skills === undefined
+            ? undefined
+            : normalizedUniqueText(patch.skills, "Profile skill");
+    }
+    return result;
+}
+function validatedAccess(value) {
+    if (value === undefined)
+        throw new Error("Agent Profile default access is required.");
+    validateAccess(value);
+    return value;
+}
+function validateAccess(value) {
+    if (value !== "read" && value !== "write") {
+        throw new Error(`Agent Profile default access is invalid: ${String(value)}.`);
+    }
+}