@docyrus/docyrus 0.0.46 → 0.0.48

package/main.js

@@ -138273,7 +138273,7 @@ function buildInputSchema(args2, env2, options2) {
 // package.json
 var package_default = {
   name: "@docyrus/docyrus",
-  version: "0.0.46",
+  version: "0.0.48",
   private: false,
   description: "Docyrus API CLI",
   main: "./main.js",
@@ -148246,16 +148246,30 @@ function normalizeTaskId(featureId, type, title) {
 function compareStrings(left, right) {
   return left.localeCompare(right);
 }
+function compareOrder(left, right) {
+  if (left !== void 0 && right !== void 0) {
+    return left - right;
+  }
+  if (left !== void 0) {
+    return -1;
+  }
+  if (right !== void 0) {
+    return 1;
+  }
+  return 0;
+}
 function sortGraph(graph) {
   return {
     version: 1,
-    sections: [...graph.sections].sort((left, right) => compareStrings(left.id, right.id)),
-    features: [...graph.features].sort((left, right) => {
-      return compareStrings(left.sectionId, right.sectionId) || compareStrings(left.title, right.title) || compareStrings(left.id, right.id);
-    }),
-    tasks: [...graph.tasks].sort((left, right) => {
-      return compareStrings(left.sectionId, right.sectionId) || compareStrings(left.featureId, right.featureId) || compareStrings(left.title, right.title) || compareStrings(left.id, right.id);
-    })
+    sections: [...graph.sections].sort(
+      (left, right) => compareOrder(left.order, right.order) || compareStrings(left.id, right.id)
+    ),
+    features: [...graph.features].sort(
+      (left, right) => compareOrder(left.order, right.order) || compareStrings(left.sectionId, right.sectionId) || compareStrings(left.title, right.title) || compareStrings(left.id, right.id)
+    ),
+    tasks: [...graph.tasks].sort(
+      (left, right) => compareOrder(left.order, right.order) || compareStrings(left.sectionId, right.sectionId) || compareStrings(left.featureId, right.featureId) || compareStrings(left.title, right.title) || compareStrings(left.id, right.id)
+    )
   };
 }
 function resolveProjectPlanDirectory(root) {
@@ -148283,14 +148297,16 @@ function parseProjectPlanGraph(rawValue) {
     id: isNonEmptyString(value2.id) ? value2.id.trim() : "",
     title: isNonEmptyString(value2.title) ? value2.title.trim() : "",
     slug: isNonEmptyString(value2.slug) ? value2.slug.trim() : "",
-    summary: typeof value2.summary === "string" ? value2.summary.trim() : ""
+    summary: typeof value2.summary === "string" ? value2.summary.trim() : "",
+    ...typeof value2.order === "number" ? { order: value2.order } : {}
   })).filter((value2) => value2.id.length > 0) : [];
   const features = Array.isArray(rawValue.features) ? rawValue.features.filter((value2) => isRecord3(value2)).map((value2) => ({
     id: isNonEmptyString(value2.id) ? value2.id.trim() : "",
     title: isNonEmptyString(value2.title) ? value2.title.trim() : "",
     slug: isNonEmptyString(value2.slug) ? value2.slug.trim() : "",
     summary: typeof value2.summary === "string" ? value2.summary.trim() : "",
-    sectionId: isNonEmptyString(value2.sectionId) ? value2.sectionId.trim() : ""
+    sectionId: isNonEmptyString(value2.sectionId) ? value2.sectionId.trim() : "",
+    ...typeof value2.order === "number" ? { order: value2.order } : {}
   })).filter((value2) => value2.id.length > 0) : [];
   const tasks = Array.isArray(rawValue.tasks) ? rawValue.tasks.filter((value2) => isRecord3(value2)).map((value2) => ({
     id: isNonEmptyString(value2.id) ? value2.id.trim() : "",
@@ -148301,7 +148317,8 @@ function parseProjectPlanGraph(rawValue) {
     status: typeof value2.status === "string" ? value2.status : "planned",
     acceptanceCriteria: normalizeStringArray(value2.acceptanceCriteria),
     featureId: isNonEmptyString(value2.featureId) ? value2.featureId.trim() : "",
-    sectionId: isNonEmptyString(value2.sectionId) ? value2.sectionId.trim() : ""
+    sectionId: isNonEmptyString(value2.sectionId) ? value2.sectionId.trim() : "",
+    ...typeof value2.order === "number" ? { order: value2.order } : {}
   })).filter((value2) => value2.id.length > 0) : [];
   return sortGraph({
     version: 1,
@@ -148671,7 +148688,8 @@ async function upsertProjectPlanSection(params) {
     id: existing?.id || sectionId,
     title: params.title.trim(),
     slug,
-    summary: params.summary?.trim() || ""
+    summary: params.summary?.trim() || "",
+    ...params.order !== void 0 ? { order: params.order } : existing?.order !== void 0 ? { order: existing.order } : {}
   };
   const nextSections = existing ? graph.sections.map((section2) => section2.id === existing.id ? nextSection : section2) : [...graph.sections, nextSection];
   await writeProjectPlanFiles(params.root, {
@@ -148703,7 +148721,8 @@ async function upsertProjectPlanFeature(params) {
     title: params.title.trim(),
     slug,
     summary: params.summary?.trim() || "",
-    sectionId: params.sectionId
+    sectionId: params.sectionId,
+    ...params.order !== void 0 ? { order: params.order } : existing?.order !== void 0 ? { order: existing.order } : {}
   };
   const nextFeatures = existing ? graph.features.map((feature) => feature.id === existing.id ? nextFeature : feature) : [...graph.features, nextFeature];
   await writeProjectPlanFiles(params.root, {
@@ -148745,7 +148764,8 @@ async function upsertProjectPlanTask(params) {
     status: params.status || "planned",
     acceptanceCriteria: [...new Set((params.acceptanceCriteria || []).map((item) => item.trim()).filter(Boolean))],
     featureId: feature.id,
-    sectionId
+    sectionId,
+    ...params.order !== void 0 ? { order: params.order } : existing?.order !== void 0 ? { order: existing.order } : {}
   };
   const nextTasks = existing ? graph.tasks.map((task) => task.id === existing.id ? nextTask : task) : [...graph.tasks, nextTask];
   await writeProjectPlanFiles(params.root, {
@@ -148770,6 +148790,43 @@ async function updateProjectPlanTaskStatus(params) {
   });
   return nextTask;
 }
+async function setProjectPlanOrder(params) {
+  const graph = await readProjectPlanGraph(params.root);
+  if (params.entityType === "section") {
+    const entity2 = graph.sections.find((item) => item.id === params.entityId);
+    if (!entity2) {
+      throw new Error(`Section "${params.entityId}" not found.`);
+    }
+    const next2 = { ...entity2, order: params.order };
+    await writeProjectPlanFiles(params.root, {
+      ...graph,
+      sections: graph.sections.map((item) => item.id === entity2.id ? next2 : item)
+    });
+    return next2;
+  }
+  if (params.entityType === "feature") {
+    const entity2 = graph.features.find((item) => item.id === params.entityId);
+    if (!entity2) {
+      throw new Error(`Feature "${params.entityId}" not found.`);
+    }
+    const next2 = { ...entity2, order: params.order };
+    await writeProjectPlanFiles(params.root, {
+      ...graph,
+      features: graph.features.map((item) => item.id === entity2.id ? next2 : item)
+    });
+    return next2;
+  }
+  const entity = graph.tasks.find((item) => item.id === params.entityId);
+  if (!entity) {
+    throw new Error(`Task "${params.entityId}" not found.`);
+  }
+  const next = { ...entity, order: params.order };
+  await writeProjectPlanFiles(params.root, {
+    ...graph,
+    tasks: graph.tasks.map((item) => item.id === entity.id ? next : item)
+  });
+  return next;
+}
 
 // src/knowledge/hook.ts
 function hasWikiLinks(text3) {
@@ -150012,7 +150069,8 @@ function createProjectPlanCli(dependencies) {
       id: external_exports.string().optional().describe("Optional existing section id"),
       title: external_exports.string().min(1).describe("Section title"),
       slug: external_exports.string().optional().describe("Optional section slug"),
-      summary: external_exports.string().optional().describe("Section summary")
+      summary: external_exports.string().optional().describe("Section summary"),
+      order: external_exports.coerce.number().int().optional().describe("Optional display order (lower = first)")
     }),
     run: async (context) => {
       const section2 = await upsertProjectPlanSection({
@@ -150020,7 +150078,8 @@ function createProjectPlanCli(dependencies) {
         id: context.options.id,
         title: context.options.title,
         slug: context.options.slug,
-        summary: context.options.summary
+        summary: context.options.summary,
+        order: context.options.order
       });
       maybePrintHuman2(context, `Upserted section ${section2.id}`);
       return await wrapPayload(dependencies, section2);
@@ -150049,7 +150108,8 @@ function createProjectPlanCli(dependencies) {
       sectionId: external_exports.string().min(1).describe("Project plan section id"),
       title: external_exports.string().min(1).describe("Feature title"),
       slug: external_exports.string().optional().describe("Optional feature slug"),
-      summary: external_exports.string().optional().describe("Feature summary")
+      summary: external_exports.string().optional().describe("Feature summary"),
+      order: external_exports.coerce.number().int().optional().describe("Optional display order (lower = first)")
     }),
     run: async (context) => {
       const feature = await upsertProjectPlanFeature({
@@ -150058,7 +150118,8 @@ function createProjectPlanCli(dependencies) {
         sectionId: context.options.sectionId,
         title: context.options.title,
         slug: context.options.slug,
-        summary: context.options.summary
+        summary: context.options.summary,
+        order: context.options.order
       });
       maybePrintHuman2(context, `Upserted feature ${feature.id}`);
       return await wrapPayload(dependencies, feature);
@@ -150077,7 +150138,8 @@ function createProjectPlanCli(dependencies) {
       type: external_exports.enum(PROJECT_TASK_TYPES).describe("Task type"),
       assignee: external_exports.enum(PROJECT_TASK_ASSIGNEES).describe("Task assignee"),
       status: external_exports.enum(PROJECT_TASK_STATUSES).optional().describe("Task status"),
-      acceptanceCriteria: external_exports.string().optional().describe("JSON string array of acceptance criteria")
+      acceptanceCriteria: external_exports.string().optional().describe("JSON string array of acceptance criteria"),
+      order: external_exports.coerce.number().int().optional().describe("Optional display order (lower = first)")
     }),
     run: async (context) => {
       const task = await upsertProjectPlanTask({
@@ -150090,7 +150152,8 @@ function createProjectPlanCli(dependencies) {
         type: context.options.type,
         assignee: context.options.assignee,
         status: context.options.status,
-        acceptanceCriteria: parseOptionalStringArray(context.options.acceptanceCriteria, "--acceptanceCriteria")
+        acceptanceCriteria: parseOptionalStringArray(context.options.acceptanceCriteria, "--acceptanceCriteria"),
+        order: context.options.order
       });
       maybePrintHuman2(context, `Upserted task ${task.id}`);
       return await wrapPayload(dependencies, task);
@@ -150133,6 +150196,34 @@ function createProjectPlanCli(dependencies) {
       return await wrapPayload(dependencies, task);
     }
   });
+  projectPlanCli.command("set-order", {
+    description: "Set the display order of a section, feature, or task",
+    env: EnvSchema,
+    outputPolicy: "agent-only",
+    options: external_exports.object({
+      sectionId: external_exports.string().optional().describe("Section id"),
+      featureId: external_exports.string().optional().describe("Feature id"),
+      taskId: external_exports.string().optional().describe("Task id"),
+      order: external_exports.coerce.number().int().describe("Display order (lower = first)")
+    }),
+    run: async (context) => {
+      const { sectionId, featureId, taskId, order: order2 } = context.options;
+      const ids = [sectionId, featureId, taskId].filter(Boolean);
+      if (ids.length !== 1) {
+        throw new UserInputError("Exactly one of --sectionId, --featureId, or --taskId is required.");
+      }
+      const entityType = sectionId ? "section" : featureId ? "feature" : "task";
+      const entityId = sectionId ?? featureId ?? taskId;
+      const entity = await setProjectPlanOrder({
+        root: process.cwd(),
+        entityType,
+        entityId,
+        order: order2
+      });
+      maybePrintHuman2(context, `Set order ${order2} on ${entityType} ${entityId}`);
+      return await wrapPayload(dependencies, entity);
+    }
+  });
   projectPlanCli.command("create-linked-todo", {
     description: "Create a local .pi/todos subtask linked to a canonical task",
     env: EnvSchema,