@docyrus/docyrus 0.0.39 → 0.0.41

package/main.js

@@ -111,17 +111,17 @@ var require_visit = __commonJS({
     visit2.BREAK = BREAK;
     visit2.SKIP = SKIP2;
     visit2.REMOVE = REMOVE;
-    function visit_(key, node2, visitor, path3) {
-      const ctrl = callVisitor(key, node2, visitor, path3);
+    function visit_(key, node2, visitor, path7) {
+      const ctrl = callVisitor(key, node2, visitor, path7);
       if (identity3.isNode(ctrl) || identity3.isPair(ctrl)) {
-        replaceNode(key, path3, ctrl);
-        return visit_(key, ctrl, visitor, path3);
+        replaceNode(key, path7, ctrl);
+        return visit_(key, ctrl, visitor, path7);
       }
       if (typeof ctrl !== "symbol") {
         if (identity3.isCollection(node2)) {
-          path3 = Object.freeze(path3.concat(node2));
+          path7 = Object.freeze(path7.concat(node2));
           for (let i2 = 0; i2 < node2.items.length; ++i2) {
-            const ci = visit_(i2, node2.items[i2], visitor, path3);
+            const ci = visit_(i2, node2.items[i2], visitor, path7);
             if (typeof ci === "number")
               i2 = ci - 1;
             else if (ci === BREAK)
@@ -132,13 +132,13 @@ var require_visit = __commonJS({
             }
           }
         } else if (identity3.isPair(node2)) {
-          path3 = Object.freeze(path3.concat(node2));
-          const ck = visit_("key", node2.key, visitor, path3);
+          path7 = Object.freeze(path7.concat(node2));
+          const ck = visit_("key", node2.key, visitor, path7);
           if (ck === BREAK)
             return BREAK;
           else if (ck === REMOVE)
             node2.key = null;
-          const cv = visit_("value", node2.value, visitor, path3);
+          const cv = visit_("value", node2.value, visitor, path7);
           if (cv === BREAK)
             return BREAK;
           else if (cv === REMOVE)
@@ -159,17 +159,17 @@ var require_visit = __commonJS({
     visitAsync.BREAK = BREAK;
     visitAsync.SKIP = SKIP2;
     visitAsync.REMOVE = REMOVE;
-    async function visitAsync_(key, node2, visitor, path3) {
-      const ctrl = await callVisitor(key, node2, visitor, path3);
+    async function visitAsync_(key, node2, visitor, path7) {
+      const ctrl = await callVisitor(key, node2, visitor, path7);
       if (identity3.isNode(ctrl) || identity3.isPair(ctrl)) {
-        replaceNode(key, path3, ctrl);
-        return visitAsync_(key, ctrl, visitor, path3);
+        replaceNode(key, path7, ctrl);
+        return visitAsync_(key, ctrl, visitor, path7);
       }
       if (typeof ctrl !== "symbol") {
         if (identity3.isCollection(node2)) {
-          path3 = Object.freeze(path3.concat(node2));
+          path7 = Object.freeze(path7.concat(node2));
           for (let i2 = 0; i2 < node2.items.length; ++i2) {
-            const ci = await visitAsync_(i2, node2.items[i2], visitor, path3);
+            const ci = await visitAsync_(i2, node2.items[i2], visitor, path7);
             if (typeof ci === "number")
               i2 = ci - 1;
             else if (ci === BREAK)
@@ -180,13 +180,13 @@ var require_visit = __commonJS({
             }
           }
         } else if (identity3.isPair(node2)) {
-          path3 = Object.freeze(path3.concat(node2));
-          const ck = await visitAsync_("key", node2.key, visitor, path3);
+          path7 = Object.freeze(path7.concat(node2));
+          const ck = await visitAsync_("key", node2.key, visitor, path7);
           if (ck === BREAK)
             return BREAK;
           else if (ck === REMOVE)
             node2.key = null;
-          const cv = await visitAsync_("value", node2.value, visitor, path3);
+          const cv = await visitAsync_("value", node2.value, visitor, path7);
           if (cv === BREAK)
             return BREAK;
           else if (cv === REMOVE)
@@ -213,23 +213,23 @@ var require_visit = __commonJS({
       }
       return visitor;
     }
-    function callVisitor(key, node2, visitor, path3) {
+    function callVisitor(key, node2, visitor, path7) {
       if (typeof visitor === "function")
-        return visitor(key, node2, path3);
+        return visitor(key, node2, path7);
       if (identity3.isMap(node2))
-        return visitor.Map?.(key, node2, path3);
+        return visitor.Map?.(key, node2, path7);
       if (identity3.isSeq(node2))
-        return visitor.Seq?.(key, node2, path3);
+        return visitor.Seq?.(key, node2, path7);
       if (identity3.isPair(node2))
-        return visitor.Pair?.(key, node2, path3);
+        return visitor.Pair?.(key, node2, path7);
       if (identity3.isScalar(node2))
-        return visitor.Scalar?.(key, node2, path3);
+        return visitor.Scalar?.(key, node2, path7);
       if (identity3.isAlias(node2))
-        return visitor.Alias?.(key, node2, path3);
+        return visitor.Alias?.(key, node2, path7);
       return void 0;
     }
-    function replaceNode(key, path3, node2) {
-      const parent = path3[path3.length - 1];
+    function replaceNode(key, path7, node2) {
+      const parent = path7[path7.length - 1];
       if (identity3.isCollection(parent)) {
         parent.items[key] = node2;
       } else if (identity3.isPair(parent)) {
@@ -837,10 +837,10 @@ var require_Collection = __commonJS({
     var createNode = require_createNode();
     var identity3 = require_identity();
     var Node2 = require_Node();
-    function collectionFromPath(schema, path3, value2) {
+    function collectionFromPath(schema, path7, value2) {
       let v = value2;
-      for (let i2 = path3.length - 1; i2 >= 0; --i2) {
-        const k = path3[i2];
+      for (let i2 = path7.length - 1; i2 >= 0; --i2) {
+        const k = path7[i2];
         if (typeof k === "number" && Number.isInteger(k) && k >= 0) {
           const a = [];
           a[k] = v;
@@ -859,7 +859,7 @@ var require_Collection = __commonJS({
         sourceObjects: /* @__PURE__ */ new Map()
       });
     }
-    var isEmptyPath = (path3) => path3 == null || typeof path3 === "object" && !!path3[Symbol.iterator]().next().done;
+    var isEmptyPath = (path7) => path7 == null || typeof path7 === "object" && !!path7[Symbol.iterator]().next().done;
     var Collection = class extends Node2.NodeBase {
       constructor(type, schema) {
         super(type);
@@ -889,11 +889,11 @@ var require_Collection = __commonJS({
        * be a Pair instance or a `{ key, value }` object, which may not have a key
        * that already exists in the map.
        */
-      addIn(path3, value2) {
-        if (isEmptyPath(path3))
+      addIn(path7, value2) {
+        if (isEmptyPath(path7))
           this.add(value2);
         else {
-          const [key, ...rest] = path3;
+          const [key, ...rest] = path7;
           const node2 = this.get(key, true);
           if (identity3.isCollection(node2))
             node2.addIn(rest, value2);
@@ -907,8 +907,8 @@ var require_Collection = __commonJS({
        * Removes a value from the collection.
        * @returns `true` if the item was found and removed.
        */
-      deleteIn(path3) {
-        const [key, ...rest] = path3;
+      deleteIn(path7) {
+        const [key, ...rest] = path7;
         if (rest.length === 0)
           return this.delete(key);
         const node2 = this.get(key, true);
@@ -922,8 +922,8 @@ var require_Collection = __commonJS({
        * scalar values from their surrounding node; to disable set `keepScalar` to
        * `true` (collections are always returned intact).
        */
-      getIn(path3, keepScalar) {
-        const [key, ...rest] = path3;
+      getIn(path7, keepScalar) {
+        const [key, ...rest] = path7;
         const node2 = this.get(key, true);
         if (rest.length === 0)
           return !keepScalar && identity3.isScalar(node2) ? node2.value : node2;
@@ -941,8 +941,8 @@ var require_Collection = __commonJS({
       /**
        * Checks if the collection includes a value with the key `key`.
        */
-      hasIn(path3) {
-        const [key, ...rest] = path3;
+      hasIn(path7) {
+        const [key, ...rest] = path7;
         if (rest.length === 0)
           return this.has(key);
         const node2 = this.get(key, true);
@@ -952,8 +952,8 @@ var require_Collection = __commonJS({
        * Sets a value in this collection. For `!!set`, `value` needs to be a
        * boolean to add/remove the item from the set.
        */
-      setIn(path3, value2) {
-        const [key, ...rest] = path3;
+      setIn(path7, value2) {
+        const [key, ...rest] = path7;
         if (rest.length === 0) {
           this.set(key, value2);
         } else {
@@ -3465,9 +3465,9 @@ var require_Document = __commonJS({
           this.contents.add(value2);
       }
       /** Adds a value to the document. */
-      addIn(path3, value2) {
+      addIn(path7, value2) {
         if (assertCollection(this.contents))
-          this.contents.addIn(path3, value2);
+          this.contents.addIn(path7, value2);
       }
       /**
        * Create a new `Alias` node, ensuring that the target `node` has the required anchor.
@@ -3542,14 +3542,14 @@ var require_Document = __commonJS({
        * Removes a value from the document.
        * @returns `true` if the item was found and removed.
        */
-      deleteIn(path3) {
-        if (Collection.isEmptyPath(path3)) {
+      deleteIn(path7) {
+        if (Collection.isEmptyPath(path7)) {
           if (this.contents == null)
             return false;
           this.contents = null;
           return true;
         }
-        return assertCollection(this.contents) ? this.contents.deleteIn(path3) : false;
+        return assertCollection(this.contents) ? this.contents.deleteIn(path7) : false;
       }
       /**
        * Returns item at `key`, or `undefined` if not found. By default unwraps
@@ -3564,10 +3564,10 @@ var require_Document = __commonJS({
        * scalar values from their surrounding node; to disable set `keepScalar` to
        * `true` (collections are always returned intact).
        */
-      getIn(path3, keepScalar) {
-        if (Collection.isEmptyPath(path3))
+      getIn(path7, keepScalar) {
+        if (Collection.isEmptyPath(path7))
           return !keepScalar && identity3.isScalar(this.contents) ? this.contents.value : this.contents;
-        return identity3.isCollection(this.contents) ? this.contents.getIn(path3, keepScalar) : void 0;
+        return identity3.isCollection(this.contents) ? this.contents.getIn(path7, keepScalar) : void 0;
       }
       /**
        * Checks if the document includes a value with the key `key`.
@@ -3578,10 +3578,10 @@ var require_Document = __commonJS({
       /**
        * Checks if the document includes a value at `path`.
        */
-      hasIn(path3) {
-        if (Collection.isEmptyPath(path3))
+      hasIn(path7) {
+        if (Collection.isEmptyPath(path7))
           return this.contents !== void 0;
-        return identity3.isCollection(this.contents) ? this.contents.hasIn(path3) : false;
+        return identity3.isCollection(this.contents) ? this.contents.hasIn(path7) : false;
       }
       /**
        * Sets a value in this document. For `!!set`, `value` needs to be a
@@ -3598,13 +3598,13 @@ var require_Document = __commonJS({
        * Sets a value in this document. For `!!set`, `value` needs to be a
        * boolean to add/remove the item from the set.
        */
-      setIn(path3, value2) {
-        if (Collection.isEmptyPath(path3)) {
+      setIn(path7, value2) {
+        if (Collection.isEmptyPath(path7)) {
           this.contents = value2;
         } else if (this.contents == null) {
-          this.contents = Collection.collectionFromPath(this.schema, Array.from(path3), value2);
+          this.contents = Collection.collectionFromPath(this.schema, Array.from(path7), value2);
         } else if (assertCollection(this.contents)) {
-          this.contents.setIn(path3, value2);
+          this.contents.setIn(path7, value2);
         }
       }
       /**
@@ -5561,9 +5561,9 @@ var require_cst_visit = __commonJS({
     visit2.BREAK = BREAK;
     visit2.SKIP = SKIP2;
     visit2.REMOVE = REMOVE;
-    visit2.itemAtPath = (cst, path3) => {
+    visit2.itemAtPath = (cst, path7) => {
       let item = cst;
-      for (const [field, index2] of path3) {
+      for (const [field, index2] of path7) {
         const tok = item?.[field];
         if (tok && "items" in tok) {
           item = tok.items[index2];
@@ -5572,23 +5572,23 @@ var require_cst_visit = __commonJS({
       }
       return item;
     };
-    visit2.parentCollection = (cst, path3) => {
-      const parent = visit2.itemAtPath(cst, path3.slice(0, -1));
-      const field = path3[path3.length - 1][0];
+    visit2.parentCollection = (cst, path7) => {
+      const parent = visit2.itemAtPath(cst, path7.slice(0, -1));
+      const field = path7[path7.length - 1][0];
       const coll = parent?.[field];
       if (coll && "items" in coll)
         return coll;
       throw new Error("Parent collection not found");
     };
-    function _visit(path3, item, visitor) {
-      let ctrl = visitor(item, path3);
+    function _visit(path7, item, visitor) {
+      let ctrl = visitor(item, path7);
       if (typeof ctrl === "symbol")
         return ctrl;
       for (const field of ["key", "value"]) {
         const token = item[field];
         if (token && "items" in token) {
           for (let i2 = 0; i2 < token.items.length; ++i2) {
-            const ci = _visit(Object.freeze(path3.concat([[field, i2]])), token.items[i2], visitor);
+            const ci = _visit(Object.freeze(path7.concat([[field, i2]])), token.items[i2], visitor);
             if (typeof ci === "number")
               i2 = ci - 1;
             else if (ci === BREAK)
@@ -5599,10 +5599,10 @@ var require_cst_visit = __commonJS({
             }
           }
           if (typeof ctrl === "function" && field === "key")
-            ctrl = ctrl(item, path3);
+            ctrl = ctrl(item, path7);
         }
       }
-      return typeof ctrl === "function" ? ctrl(item, path3) : ctrl;
+      return typeof ctrl === "function" ? ctrl(item, path7) : ctrl;
     }
     exports2.visit = visit2;
   }
@@ -6887,14 +6887,14 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs4 = this.flowScalar(this.type);
+              const fs7 = this.flowScalar(this.type);
               if (atNextItem || it.value) {
-                map2.items.push({ start: start2, key: fs4, sep: [] });
+                map2.items.push({ start: start2, key: fs7, sep: [] });
                 this.onKeyLine = true;
               } else if (it.sep) {
-                this.stack.push(fs4);
+                this.stack.push(fs7);
               } else {
-                Object.assign(it, { key: fs4, sep: [] });
+                Object.assign(it, { key: fs7, sep: [] });
                 this.onKeyLine = true;
               }
               return;
@@ -7022,13 +7022,13 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs4 = this.flowScalar(this.type);
+              const fs7 = this.flowScalar(this.type);
               if (!it || it.value)
-                fc.items.push({ start: [], key: fs4, sep: [] });
+                fc.items.push({ start: [], key: fs7, sep: [] });
               else if (it.sep)
-                this.stack.push(fs4);
+                this.stack.push(fs7);
               else
-                Object.assign(it, { key: fs4, sep: [] });
+                Object.assign(it, { key: fs7, sep: [] });
               return;
             }
             case "flow-map-end":
@@ -10529,8 +10529,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path3) {
-      let input = path3;
+    function removeDotSegments(path7) {
+      let input = path7;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -10729,8 +10729,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path3, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path3 && path3 !== "/" ? path3 : void 0;
+        const [path7, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path7 && path7 !== "/" ? path7 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -14092,12 +14092,12 @@ var require_dist2 = __commonJS({
         throw new Error(`Unknown format "${name2}"`);
       return f;
     };
-    function addFormats(ajv, list4, fs4, exportName) {
+    function addFormats(ajv, list4, fs7, exportName) {
       var _a2;
       var _b;
       (_a2 = (_b = ajv.opts.code).formats) !== null && _a2 !== void 0 ? _a2 : _b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f of list4)
-        ajv.addFormat(f, fs4[f]);
+        ajv.addFormat(f, fs7[f]);
     }
     module2.exports = exports2 = formatsPlugin;
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -61639,15 +61639,15 @@ var require_route = __commonJS({
       };
     }
     function wrapConversion(toModel, graph) {
-      const path3 = [graph[toModel].parent, toModel];
+      const path7 = [graph[toModel].parent, toModel];
       let fn = conversions[graph[toModel].parent][toModel];
       let cur = graph[toModel].parent;
       while (graph[cur].parent) {
-        path3.unshift(graph[cur].parent);
+        path7.unshift(graph[cur].parent);
         fn = link3(conversions[graph[cur].parent][cur], fn);
         cur = graph[cur].parent;
       }
-      fn.conversion = path3;
+      fn.conversion = path7;
       return fn;
     }
     module2.exports = function(fromModel) {
@@ -76272,11 +76272,11 @@ var require_commonjs3 = __commonJS({
       return (f) => f.length === len && f !== "." && f !== "..";
     };
     var defaultPlatform = typeof process === "object" && process ? typeof process.env === "object" && process.env && process.env.__MINIMATCH_TESTING_PLATFORM__ || process.platform : "posix";
-    var path3 = {
+    var path7 = {
       win32: { sep: "\\" },
       posix: { sep: "/" }
     };
-    exports2.sep = defaultPlatform === "win32" ? path3.win32.sep : path3.posix.sep;
+    exports2.sep = defaultPlatform === "win32" ? path7.win32.sep : path7.posix.sep;
     exports2.minimatch.sep = exports2.sep;
     exports2.GLOBSTAR = /* @__PURE__ */ Symbol("globstar **");
     exports2.minimatch.GLOBSTAR = exports2.GLOBSTAR;
@@ -77046,8 +77046,8 @@ var require_commonjs3 = __commonJS({
 var require_lib4 = __commonJS({
   "../../node_modules/.pnpm/ignore-walk@8.0.0/node_modules/ignore-walk/lib/index.js"(exports2, module2) {
     "use strict";
-    var fs4 = require("fs");
-    var path3 = require("path");
+    var fs7 = require("fs");
+    var path7 = require("path");
     var EE = require("events").EventEmitter;
     var Minimatch = require_commonjs3().Minimatch;
     var Walker = class _Walker extends EE {
@@ -77056,7 +77056,7 @@ var require_lib4 = __commonJS({
         super(opts);
         this.isSymbolicLink = opts.isSymbolicLink;
         this.path = opts.path || process.cwd();
-        this.basename = path3.basename(this.path);
+        this.basename = path7.basename(this.path);
         this.ignoreFiles = opts.ignoreFiles || [".ignore"];
         this.ignoreRules = {};
         this.parent = opts.parent || null;
@@ -77089,7 +77089,7 @@ var require_lib4 = __commonJS({
         return ret;
       }
       start() {
-        fs4.readdir(this.path, (er, entries) => er ? this.emit("error", er) : this.onReaddir(entries));
+        fs7.readdir(this.path, (er, entries) => er ? this.emit("error", er) : this.onReaddir(entries));
         return this;
       }
       isIgnoreFile(e) {
@@ -77122,8 +77122,8 @@ var require_lib4 = __commonJS({
         newIg.forEach((e) => this.addIgnoreFile(e, then));
       }
       addIgnoreFile(file2, then) {
-        const ig = path3.resolve(this.path, file2);
-        fs4.readFile(ig, "utf8", (er, data) => er ? this.emit("error", er) : this.onReadIgnoreFile(file2, data, then));
+        const ig = path7.resolve(this.path, file2);
+        fs7.readFile(ig, "utf8", (er, data) => er ? this.emit("error", er) : this.onReadIgnoreFile(file2, data, then));
       }
       onReadIgnoreFile(file2, data, then) {
         const mmopt = {
@@ -77178,13 +77178,13 @@ var require_lib4 = __commonJS({
       }
       stat({ entry, file: file2, dir }, then) {
         const abs = this.path + "/" + entry;
-        fs4.lstat(abs, (lstatErr, lstatResult) => {
+        fs7.lstat(abs, (lstatErr, lstatResult) => {
           if (lstatErr) {
             this.emit("error", lstatErr);
           } else {
             const isSymbolicLink = lstatResult.isSymbolicLink();
             if (this.follow && isSymbolicLink) {
-              fs4.stat(abs, (statErr, statResult) => {
+              fs7.stat(abs, (statErr, statResult) => {
                 if (statErr) {
                   this.emit("error", statErr);
                 } else {
@@ -77240,19 +77240,19 @@ var require_lib4 = __commonJS({
     };
     var WalkerSync = class _WalkerSync extends Walker {
       start() {
-        this.onReaddir(fs4.readdirSync(this.path));
+        this.onReaddir(fs7.readdirSync(this.path));
         return this;
       }
       addIgnoreFile(file2, then) {
-        const ig = path3.resolve(this.path, file2);
-        this.onReadIgnoreFile(file2, fs4.readFileSync(ig, "utf8"), then);
+        const ig = path7.resolve(this.path, file2);
+        this.onReadIgnoreFile(file2, fs7.readFileSync(ig, "utf8"), then);
       }
       stat({ entry, file: file2, dir }, then) {
         const abs = this.path + "/" + entry;
-        let st = fs4.lstatSync(abs);
+        let st = fs7.lstatSync(abs);
         const isSymbolicLink = st.isSymbolicLink();
         if (this.follow && isSymbolicLink) {
-          st = fs4.statSync(abs);
+          st = fs7.statSync(abs);
         }
         this.onstat({ st, entry, file: file2, dir, isSymbolicLink }, then);
       }
@@ -85621,8 +85621,8 @@ function assertNonEmpty(part, name2) {
     throw new Error("`" + name2 + "` cannot be empty");
   }
 }
-function assertPath(path3, name2) {
-  if (!path3) {
+function assertPath(path7, name2) {
+  if (!path7) {
     throw new Error("Setting `" + name2 + "` requires `path` to be set too");
   }
 }
@@ -85808,13 +85808,13 @@ var init_lib10 = __esm({
        * @returns {undefined}
        *   Nothing.
        */
-      set path(path3) {
-        if (isUrl(path3)) {
-          path3 = (0, import_node_url.fileURLToPath)(path3);
+      set path(path7) {
+        if (isUrl(path7)) {
+          path7 = (0, import_node_url.fileURLToPath)(path7);
         }
-        assertNonEmpty(path3, "path");
-        if (this.path !== path3) {
-          this.history.push(path3);
+        assertNonEmpty(path7, "path");
+        if (this.path !== path7) {
+          this.history.push(path7);
         }
       }
       /**
@@ -88691,14 +88691,14 @@ var require_util3 = __commonJS({
         }
         const port = url2.port != null ? url2.port : url2.protocol === "https:" ? 443 : 80;
         let origin = url2.origin != null ? url2.origin : `${url2.protocol || ""}//${url2.hostname || ""}:${port}`;
-        let path3 = url2.path != null ? url2.path : `${url2.pathname || ""}${url2.search || ""}`;
+        let path7 = url2.path != null ? url2.path : `${url2.pathname || ""}${url2.search || ""}`;
         if (origin[origin.length - 1] === "/") {
           origin = origin.slice(0, origin.length - 1);
         }
-        if (path3 && path3[0] !== "/") {
-          path3 = `/${path3}`;
+        if (path7 && path7[0] !== "/") {
+          path7 = `/${path7}`;
         }
-        return new URL(`${origin}${path3}`);
+        return new URL(`${origin}${path7}`);
       }
       if (!isHttpOrHttpsPrefixed(url2.origin || url2.protocol)) {
         throw new InvalidArgumentError("Invalid URL protocol: the URL must start with `http:` or `https:`.");
@@ -89503,9 +89503,9 @@ var require_diagnostics = __commonJS({
         "undici:client:sendHeaders",
         (evt) => {
           const {
-            request: { method, path: path3, origin }
+            request: { method, path: path7, origin }
           } = evt;
-          debugLog("sending request to %s %s%s", method, origin, path3);
+          debugLog("sending request to %s %s%s", method, origin, path7);
         }
       );
     }
@@ -89523,14 +89523,14 @@ var require_diagnostics = __commonJS({
         "undici:request:headers",
         (evt) => {
           const {
-            request: { method, path: path3, origin },
+            request: { method, path: path7, origin },
             response: { statusCode }
           } = evt;
           debugLog(
             "received response to %s %s%s - HTTP %d",
             method,
             origin,
-            path3,
+            path7,
             statusCode
           );
         }
@@ -89539,23 +89539,23 @@ var require_diagnostics = __commonJS({
         "undici:request:trailers",
         (evt) => {
           const {
-            request: { method, path: path3, origin }
+            request: { method, path: path7, origin }
           } = evt;
-          debugLog("trailers received from %s %s%s", method, origin, path3);
+          debugLog("trailers received from %s %s%s", method, origin, path7);
         }
       );
       diagnosticsChannel.subscribe(
         "undici:request:error",
         (evt) => {
           const {
-            request: { method, path: path3, origin },
+            request: { method, path: path7, origin },
             error: error48
           } = evt;
           debugLog(
             "request to %s %s%s errored - %s",
             method,
             origin,
-            path3,
+            path7,
             error48.message
           );
         }
@@ -89655,7 +89655,7 @@ var require_request = __commonJS({
     var kHandler = /* @__PURE__ */ Symbol("handler");
     var Request = class {
       constructor(origin, {
-        path: path3,
+        path: path7,
         method,
         body: body2,
         headers,
@@ -89671,11 +89671,11 @@ var require_request = __commonJS({
         throwOnError,
         maxRedirections
       }, handler2) {
-        if (typeof path3 !== "string") {
+        if (typeof path7 !== "string") {
           throw new InvalidArgumentError("path must be a string");
-        } else if (path3[0] !== "/" && !(path3.startsWith("http://") || path3.startsWith("https://")) && method !== "CONNECT") {
+        } else if (path7[0] !== "/" && !(path7.startsWith("http://") || path7.startsWith("https://")) && method !== "CONNECT") {
           throw new InvalidArgumentError("path must be an absolute URL or start with a slash");
-        } else if (invalidPathRegex.test(path3)) {
+        } else if (invalidPathRegex.test(path7)) {
           throw new InvalidArgumentError("invalid request path");
         }
         if (typeof method !== "string") {
@@ -89743,7 +89743,7 @@ var require_request = __commonJS({
         this.completed = false;
         this.aborted = false;
         this.upgrade = upgrade || null;
-        this.path = query ? serializePathWithQuery(path3, query) : path3;
+        this.path = query ? serializePathWithQuery(path7, query) : path7;
         this.origin = origin;
         this.protocol = getProtocolFromUrlString(origin);
         this.idempotent = idempotent == null ? method === "HEAD" || method === "GET" : idempotent;
@@ -94760,7 +94760,7 @@ var require_client_h1 = __commonJS({
       return method !== "GET" && method !== "HEAD" && method !== "OPTIONS" && method !== "TRACE" && method !== "CONNECT";
     }
     function writeH1(client, request) {
-      const { method, path: path3, host, upgrade, blocking, reset } = request;
+      const { method, path: path7, host, upgrade, blocking, reset } = request;
       let { body: body2, headers, contentLength } = request;
       const expectsPayload = method === "PUT" || method === "POST" || method === "PATCH" || method === "QUERY" || method === "PROPFIND" || method === "PROPPATCH";
       if (util2.isFormDataLike(body2)) {
@@ -94826,7 +94826,7 @@ var require_client_h1 = __commonJS({
       if (blocking) {
         socket[kBlocking] = true;
       }
-      let header = `${method} ${path3} HTTP/1.1\r
+      let header = `${method} ${path7} HTTP/1.1\r
 `;
       if (typeof host === "string") {
         header += `host: ${host}\r
@@ -95479,7 +95479,7 @@ var require_client_h2 = __commonJS({
     function writeH2(client, request) {
       const requestTimeout = request.bodyTimeout ?? client[kBodyTimeout];
       const session = client[kHTTP2Session];
-      const { method, path: path3, host, upgrade, expectContinue, signal, protocol, headers: reqHeaders } = request;
+      const { method, path: path7, host, upgrade, expectContinue, signal, protocol, headers: reqHeaders } = request;
       let { body: body2 } = request;
       if (upgrade != null && upgrade !== "websocket") {
         util2.errorRequest(client, request, new InvalidArgumentError(`Custom upgrade "${upgrade}" not supported over HTTP/2`));
@@ -95547,7 +95547,7 @@ var require_client_h2 = __commonJS({
           }
           headers[HTTP2_HEADER_METHOD] = "CONNECT";
           headers[HTTP2_HEADER_PROTOCOL] = "websocket";
-          headers[HTTP2_HEADER_PATH] = path3;
+          headers[HTTP2_HEADER_PATH] = path7;
           if (protocol === "ws:" || protocol === "wss:") {
             headers[HTTP2_HEADER_SCHEME] = protocol === "ws:" ? "http" : "https";
           } else {
@@ -95588,7 +95588,7 @@ var require_client_h2 = __commonJS({
         stream.setTimeout(requestTimeout);
         return true;
       }
-      headers[HTTP2_HEADER_PATH] = path3;
+      headers[HTTP2_HEADER_PATH] = path7;
       headers[HTTP2_HEADER_SCHEME] = protocol === "http:" ? "http" : "https";
       const expectsPayload = method === "PUT" || method === "POST" || method === "PATCH";
       if (body2 && typeof body2.read === "function") {
@@ -97212,10 +97212,10 @@ var require_proxy_agent = __commonJS({
         };
         const {
           origin,
-          path: path3 = "/",
+          path: path7 = "/",
           headers = {}
         } = opts;
-        opts.path = origin + path3;
+        opts.path = origin + path7;
         if (!("host" in headers) && !("Host" in headers)) {
           const { host } = new URL(origin);
           headers.host = host;
@@ -99256,20 +99256,20 @@ var require_mock_utils = __commonJS({
       }
       return normalizedQp;
     }
-    function safeUrl(path3) {
-      if (typeof path3 !== "string") {
-        return path3;
+    function safeUrl(path7) {
+      if (typeof path7 !== "string") {
+        return path7;
       }
-      const pathSegments = path3.split("?", 3);
+      const pathSegments = path7.split("?", 3);
       if (pathSegments.length !== 2) {
-        return path3;
+        return path7;
       }
       const qp = new URLSearchParams(pathSegments.pop());
       qp.sort();
       return [...pathSegments, qp.toString()].join("?");
     }
-    function matchKey(mockDispatch2, { path: path3, method, body: body2, headers }) {
-      const pathMatch = matchValue(mockDispatch2.path, path3);
+    function matchKey(mockDispatch2, { path: path7, method, body: body2, headers }) {
+      const pathMatch = matchValue(mockDispatch2.path, path7);
       const methodMatch = matchValue(mockDispatch2.method, method);
       const bodyMatch = typeof mockDispatch2.body !== "undefined" ? matchValue(mockDispatch2.body, body2) : true;
       const headersMatch = matchHeaders(mockDispatch2, headers);
@@ -99294,8 +99294,8 @@ var require_mock_utils = __commonJS({
       const basePath = key.query ? serializePathWithQuery(key.path, key.query) : key.path;
       const resolvedPath = typeof basePath === "string" ? safeUrl(basePath) : basePath;
       const resolvedPathWithoutTrailingSlash = removeTrailingSlash(resolvedPath);
-      let matchedMockDispatches = mockDispatches.filter(({ consumed }) => !consumed).filter(({ path: path3, ignoreTrailingSlash }) => {
-        return ignoreTrailingSlash ? matchValue(removeTrailingSlash(safeUrl(path3)), resolvedPathWithoutTrailingSlash) : matchValue(safeUrl(path3), resolvedPath);
+      let matchedMockDispatches = mockDispatches.filter(({ consumed }) => !consumed).filter(({ path: path7, ignoreTrailingSlash }) => {
+        return ignoreTrailingSlash ? matchValue(removeTrailingSlash(safeUrl(path7)), resolvedPathWithoutTrailingSlash) : matchValue(safeUrl(path7), resolvedPath);
       });
       if (matchedMockDispatches.length === 0) {
         throw new MockNotMatchedError(`Mock dispatch not matched for path '${resolvedPath}'`);
@@ -99333,19 +99333,19 @@ var require_mock_utils = __commonJS({
         mockDispatches.splice(index2, 1);
       }
     }
-    function removeTrailingSlash(path3) {
-      while (path3.endsWith("/")) {
-        path3 = path3.slice(0, -1);
+    function removeTrailingSlash(path7) {
+      while (path7.endsWith("/")) {
+        path7 = path7.slice(0, -1);
       }
-      if (path3.length === 0) {
-        path3 = "/";
+      if (path7.length === 0) {
+        path7 = "/";
       }
-      return path3;
+      return path7;
     }
     function buildKey(opts) {
-      const { path: path3, method, body: body2, headers, query } = opts;
+      const { path: path7, method, body: body2, headers, query } = opts;
       return {
-        path: path3,
+        path: path7,
         method,
         body: body2,
         headers,
@@ -100032,10 +100032,10 @@ var require_pending_interceptors_formatter = __commonJS({
       }
       format(pendingInterceptors) {
         const withPrettyHeaders = pendingInterceptors.map(
-          ({ method, path: path3, data: { statusCode }, persist, times, timesInvoked, origin }) => ({
+          ({ method, path: path7, data: { statusCode }, persist, times, timesInvoked, origin }) => ({
             Method: method,
             Origin: origin,
-            Path: path3,
+            Path: path7,
             "Status code": statusCode,
             Persistent: persist ? PERSISTENT : NOT_PERSISTENT,
             Invocations: timesInvoked,
@@ -100117,9 +100117,9 @@ var require_mock_agent = __commonJS({
         const acceptNonStandardSearchParameters = this[kMockAgentAcceptsNonStandardSearchParameters];
         const dispatchOpts = { ...opts };
         if (acceptNonStandardSearchParameters && dispatchOpts.path) {
-          const [path3, searchParams] = dispatchOpts.path.split("?");
+          const [path7, searchParams] = dispatchOpts.path.split("?");
           const normalizedSearchParams = normalizeSearchParams(searchParams, acceptNonStandardSearchParameters);
-          dispatchOpts.path = `${path3}?${normalizedSearchParams}`;
+          dispatchOpts.path = `${path7}?${normalizedSearchParams}`;
         }
         return this[kAgent].dispatch(dispatchOpts, handler2);
       }
@@ -100247,8 +100247,8 @@ var require_snapshot_utils = __commonJS({
         match: new Set(matchHeaders.map((header) => caseSensitive ? header : header.toLowerCase()))
       };
     }
-    var crypto = runtimeFeatures.has("crypto") ? require("node:crypto") : null;
-    var hashId = crypto?.hash ? (value2) => crypto.hash("sha256", value2, "base64url") : (value2) => Buffer.from(value2).toString("base64url");
+    var crypto2 = runtimeFeatures.has("crypto") ? require("node:crypto") : null;
+    var hashId = crypto2?.hash ? (value2) => crypto2.hash("sha256", value2, "base64url") : (value2) => Buffer.from(value2).toString("base64url");
     function isUndiciHeaders(headers) {
       return Array.isArray(headers) && (headers.length & 1) === 0;
     }
@@ -100323,7 +100323,7 @@ var require_snapshot_utils = __commonJS({
 var require_snapshot_recorder = __commonJS({
   "../../node_modules/.pnpm/undici@7.22.0/node_modules/undici/lib/mock/snapshot-recorder.js"(exports2, module2) {
     "use strict";
-    var { writeFile: writeFile9, readFile: readFile16, mkdir: mkdir10 } = require("node:fs/promises");
+    var { writeFile: writeFile9, readFile: readFile17, mkdir: mkdir10 } = require("node:fs/promises");
     var { dirname: dirname13, resolve: resolve2 } = require("node:path");
     var { setTimeout: setTimeout2, clearTimeout: clearTimeout2 } = require("node:timers");
     var { InvalidArgumentError, UndiciError } = require_errors3();
@@ -100520,12 +100520,12 @@ var require_snapshot_recorder = __commonJS({
        * @return {Promise<void>} - Resolves when snapshots are loaded
        */
       async loadSnapshots(filePath) {
-        const path3 = filePath || this.#snapshotPath;
-        if (!path3) {
+        const path7 = filePath || this.#snapshotPath;
+        if (!path7) {
           throw new InvalidArgumentError("Snapshot path is required");
         }
         try {
-          const data = await readFile16(resolve2(path3), "utf8");
+          const data = await readFile17(resolve2(path7), "utf8");
           const parsed = JSON.parse(data);
           if (Array.isArray(parsed)) {
             this.#snapshots.clear();
@@ -100539,7 +100539,7 @@ var require_snapshot_recorder = __commonJS({
           if (error48.code === "ENOENT") {
             this.#snapshots.clear();
           } else {
-            throw new UndiciError(`Failed to load snapshots from ${path3}`, { cause: error48 });
+            throw new UndiciError(`Failed to load snapshots from ${path7}`, { cause: error48 });
           }
         }
       }
@@ -100550,11 +100550,11 @@ var require_snapshot_recorder = __commonJS({
        * @returns {Promise<void>} - Resolves when snapshots are saved
        */
       async saveSnapshots(filePath) {
-        const path3 = filePath || this.#snapshotPath;
-        if (!path3) {
+        const path7 = filePath || this.#snapshotPath;
+        if (!path7) {
           throw new InvalidArgumentError("Snapshot path is required");
         }
-        const resolvedPath = resolve2(path3);
+        const resolvedPath = resolve2(path7);
         await mkdir10(dirname13(resolvedPath), { recursive: true });
         const data = Array.from(this.#snapshots.entries()).map(([hash3, snapshot]) => ({
           hash: hash3,
@@ -101179,15 +101179,15 @@ var require_redirect_handler = __commonJS({
           return;
         }
         const { origin, pathname, search: search2 } = util2.parseURL(new URL(this.location, this.opts.origin && new URL(this.opts.path, this.opts.origin)));
-        const path3 = search2 ? `${pathname}${search2}` : pathname;
-        const redirectUrlString = `${origin}${path3}`;
+        const path7 = search2 ? `${pathname}${search2}` : pathname;
+        const redirectUrlString = `${origin}${path7}`;
         for (const historyUrl of this.history) {
           if (historyUrl.toString() === redirectUrlString) {
             throw new InvalidArgumentError(`Redirect loop detected. Cannot redirect to ${origin}. This typically happens when using a Client or Pool with cross-origin redirects. Use an Agent for cross-origin redirects.`);
           }
         }
         this.opts.headers = cleanRequestHeaders(this.opts.headers, statusCode === 303, this.opts.origin !== origin);
-        this.opts.path = path3;
+        this.opts.path = path7;
         this.opts.origin = origin;
         this.opts.query = null;
       }
@@ -106050,10 +106050,10 @@ var require_subresource_integrity = __commonJS({
     var assert4 = require("node:assert");
     var { runtimeFeatures } = require_runtime_features();
     var validSRIHashAlgorithmTokenSet = /* @__PURE__ */ new Map([["sha256", 0], ["sha384", 1], ["sha512", 2]]);
-    var crypto;
+    var crypto2;
     if (runtimeFeatures.has("crypto")) {
-      crypto = require("node:crypto");
-      const cryptoHashes = crypto.getHashes();
+      crypto2 = require("node:crypto");
+      const cryptoHashes = crypto2.getHashes();
       if (cryptoHashes.length === 0) {
         validSRIHashAlgorithmTokenSet.clear();
       }
@@ -106143,7 +106143,7 @@ var require_subresource_integrity = __commonJS({
       return result;
     }
     var applyAlgorithmToBytes = (algorithm, bytes) => {
-      return crypto.hash(algorithm, bytes, "base64");
+      return crypto2.hash(algorithm, bytes, "base64");
     };
     function caseSensitiveMatch(actualValue, expectedValue) {
       let actualValueLength = actualValue.length;
@@ -108064,9 +108064,9 @@ var require_util6 = __commonJS({
         }
       }
     }
-    function validateCookiePath(path3) {
-      for (let i2 = 0; i2 < path3.length; ++i2) {
-        const code = path3.charCodeAt(i2);
+    function validateCookiePath(path7) {
+      for (let i2 = 0; i2 < path7.length; ++i2) {
+        const code = path7.charCodeAt(i2);
         if (code < 32 || // exclude CTLs (0-31)
         code === 127 || // DEL
         code === 59) {
@@ -109064,7 +109064,7 @@ var require_connection = __commonJS({
     var { WebsocketFrameSend } = require_frame();
     var assert4 = require("node:assert");
     var { runtimeFeatures } = require_runtime_features();
-    var crypto = runtimeFeatures.has("crypto") ? require("node:crypto") : null;
+    var crypto2 = runtimeFeatures.has("crypto") ? require("node:crypto") : null;
     var warningEmitted = false;
     function establishWebSocketConnection(url2, protocols, client, handler2, options2) {
       const requestURL = url2;
@@ -109084,7 +109084,7 @@ var require_connection = __commonJS({
         const headersList = getHeadersList(new Headers(options2.headers));
         request.headersList = headersList;
       }
-      const keyValue = crypto.randomBytes(16).toString("base64");
+      const keyValue = crypto2.randomBytes(16).toString("base64");
       request.headersList.append("sec-websocket-key", keyValue, true);
       request.headersList.append("sec-websocket-version", "13", true);
       for (const protocol of protocols) {
@@ -109124,7 +109124,7 @@ var require_connection = __commonJS({
             return;
           }
           const secWSAccept = response.headersList.get("Sec-WebSocket-Accept");
-          const digest = crypto.hash("sha1", keyValue + uid, "base64");
+          const digest = crypto2.hash("sha1", keyValue + uid, "base64");
           if (secWSAccept !== digest) {
             failWebsocketConnection(handler2, 1002, "Incorrect hash received in Sec-WebSocket-Accept header.");
             return;
@@ -111177,11 +111177,11 @@ var require_undici = __commonJS({
           if (typeof opts.path !== "string") {
             throw new InvalidArgumentError("invalid opts.path");
           }
-          let path3 = opts.path;
+          let path7 = opts.path;
           if (!opts.path.startsWith("/")) {
-            path3 = `/${path3}`;
+            path7 = `/${path7}`;
           }
-          url2 = new URL(util2.parseOrigin(url2).origin + path3);
+          url2 = new URL(util2.parseOrigin(url2).origin + path7);
         } else {
           if (!opts) {
             opts = typeof url2 === "object" ? url2 : {};
@@ -112065,10 +112065,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path3) {
-  if (!path3)
+function getElementAtPath(obj, path7) {
+  if (!path7)
     return obj;
-  return path3.reduce((acc, key) => acc?.[key], obj);
+  return path7.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -112451,11 +112451,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path3, issues) {
+function prefixIssues(path7, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path3);
+    iss.path.unshift(path7);
     return iss;
   });
 }
@@ -112638,7 +112638,7 @@ function formatError(error48, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error48, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error49, path3 = []) => {
+  const processError = (error49, path7 = []) => {
     var _a2, _b;
     for (const issue2 of error49.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -112648,7 +112648,7 @@ function treeifyError(error48, mapper = (issue2) => issue2.message) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path3, ...issue2.path];
+        const fullpath = [...path7, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -112680,8 +112680,8 @@ function treeifyError(error48, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path3 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path3) {
+  const path7 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path7) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -124658,13 +124658,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path3 = ref.slice(1).split("/").filter(Boolean);
-  if (path3.length === 0) {
+  const path7 = ref.slice(1).split("/").filter(Boolean);
+  if (path7.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path3[0] === defsKey) {
-    const key = path3[1];
+  if (path7[0] === defsKey) {
+    const key = path7[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -125504,26 +125504,26 @@ function applyReplacer(root, replacer) {
   if (replacedRoot === void 0) return transformChildren(root, replacer, []);
   return transformChildren(normalizeValue(replacedRoot), replacer, []);
 }
-function transformChildren(value2, replacer, path3) {
-  if (isJsonObject(value2)) return transformObject(value2, replacer, path3);
-  if (isJsonArray(value2)) return transformArray(value2, replacer, path3);
+function transformChildren(value2, replacer, path7) {
+  if (isJsonObject(value2)) return transformObject(value2, replacer, path7);
+  if (isJsonArray(value2)) return transformArray(value2, replacer, path7);
   return value2;
 }
-function transformObject(obj, replacer, path3) {
+function transformObject(obj, replacer, path7) {
   const result = {};
   for (const [key, value2] of Object.entries(obj)) {
-    const childPath = [...path3, key];
+    const childPath = [...path7, key];
     const replacedValue = replacer(key, value2, childPath);
     if (replacedValue === void 0) continue;
     result[key] = transformChildren(normalizeValue(replacedValue), replacer, childPath);
   }
   return result;
 }
-function transformArray(arr, replacer, path3) {
+function transformArray(arr, replacer, path7) {
   const result = [];
   for (let i2 = 0; i2 < arr.length; i2++) {
     const value2 = arr[i2];
-    const childPath = [...path3, i2];
+    const childPath = [...path7, i2];
     const replacedValue = replacer(String(i2), value2, childPath);
     if (replacedValue === void 0) continue;
     const normalizedValue = normalizeValue(replacedValue);
@@ -125591,33 +125591,33 @@ function columnarTable(items) {
   const keys = [...new Set(items.flatMap(Object.keys))];
   return table(keys, items.map((item) => keys.map((k) => String(item[k] ?? ""))));
 }
-function formatMarkdown(value2, path3 = []) {
+function formatMarkdown(value2, path7 = []) {
   if (isScalar(value2)) {
-    if (path3.length === 0)
+    if (path7.length === 0)
       return String(value2);
-    return `## ${path3.join(".")}
+    return `## ${path7.join(".")}
 
 ${String(value2)}`;
   }
   if (Array.isArray(value2)) {
     if (isArrayOfObjects2(value2)) {
       const table2 = columnarTable(value2);
-      if (path3.length === 0)
+      if (path7.length === 0)
         return table2;
-      return `## ${path3.join(".")}
+      return `## ${path7.join(".")}
 
 ${table2}`;
     }
-    return formatMarkdown(String(value2), path3);
+    return formatMarkdown(String(value2), path7);
   }
   const obj = value2;
   const entries = Object.entries(obj);
-  if (path3.length === 0 && isFlat(obj))
+  if (path7.length === 0 && isFlat(obj))
     return kvTable(obj);
-  const needsHeadings = path3.length > 0 || entries.length > 1 || entries.some(([, v]) => !isScalar(v));
+  const needsHeadings = path7.length > 0 || entries.length > 1 || entries.some(([, v]) => !isScalar(v));
   if (needsHeadings) {
     const sections = entries.map(([key, val]) => {
-      const childPath = [...path3, key];
+      const childPath = [...path7, key];
       if (isScalar(val))
         return `## ${childPath.join(".")}
 
@@ -126231,8 +126231,8 @@ function getErrorMap2() {
 
 // ../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path3, errorMaps, issueData } = params;
-  const fullPath = [...path3, ...issueData.path || []];
+  const { data, path: path7, errorMaps, issueData } = params;
+  const fullPath = [...path7, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -126347,11 +126347,11 @@ var errorUtil;
 
 // ../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value2, path3, key) {
+  constructor(parent, value2, path7, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value2;
-    this._path = path3;
+    this._path = path7;
     this._key = key;
   }
   get path() {
@@ -135486,12 +135486,12 @@ function isAsyncGenerator(value2) {
 function collectTools(commands, prefix) {
   const result = [];
   for (const [name2, entry] of commands) {
-    const path3 = [...prefix, name2];
+    const path7 = [...prefix, name2];
     if ("_group" in entry && entry._group)
-      result.push(...collectTools(entry.commands, path3));
+      result.push(...collectTools(entry.commands, path7));
     else {
       result.push({
-        name: path3.join("_"),
+        name: path7.join("_"),
         description: entry.description,
         inputSchema: buildToolSchema(entry.args, entry.options),
         command: entry
@@ -136636,7 +136636,7 @@ async function serveImpl(name2, commands, argv, options2 = {}) {
     exit2(1);
     return;
   }
-  const { command, path: path3, rest } = effective;
+  const { command, path: path7, rest } = effective;
   try {
     const { args: args2, options: parsedOptions } = parse3(rest, {
       alias: command.alias,
@@ -136662,7 +136662,7 @@ async function serveImpl(name2, commands, argv, options2 = {}) {
     if (isAsyncGenerator2(result)) {
       await handleStreaming(result, {
         name: name2,
-        path: path3,
+        path: path7,
         start: start2,
         format: format2,
         formatExplicit,
@@ -136683,7 +136683,7 @@ async function serveImpl(name2, commands, argv, options2 = {}) {
           ok: true,
           data: awaited.data,
           meta: {
-            command: path3,
+            command: path7,
             duration: `${Math.round(performance.now() - start2)}ms`,
             ...cta ? { cta } : void 0
           }
@@ -136697,7 +136697,7 @@ async function serveImpl(name2, commands, argv, options2 = {}) {
             ...awaited.retryable !== void 0 ? { retryable: awaited.retryable } : void 0
           },
           meta: {
-            command: path3,
+            command: path7,
             duration: `${Math.round(performance.now() - start2)}ms`,
             ...cta ? { cta } : void 0
           }
@@ -136709,7 +136709,7 @@ async function serveImpl(name2, commands, argv, options2 = {}) {
         ok: true,
         data: awaited,
         meta: {
-          command: path3,
+          command: path7,
           duration: `${Math.round(performance.now() - start2)}ms`
         }
       });
@@ -136724,12 +136724,12 @@ async function serveImpl(name2, commands, argv, options2 = {}) {
         ...error48 instanceof ValidationError ? { fieldErrors: error48.fieldErrors } : void 0
       },
       meta: {
-        command: path3,
+        command: path7,
         duration: `${Math.round(performance.now() - start2)}ms`
       }
     };
     if (human && !formatExplicit && error48 instanceof ValidationError) {
-      writeln(formatHumanValidationError(name2, path3, command, error48));
+      writeln(formatHumanValidationError(name2, path7, command, error48));
       exit2(1);
       return;
     }
@@ -136737,13 +136737,13 @@ async function serveImpl(name2, commands, argv, options2 = {}) {
     exit2(1);
   }
 }
-function formatHumanValidationError(cli2, path3, command, error48) {
+function formatHumanValidationError(cli2, path7, command, error48) {
   const lines = [];
   for (const fe of error48.fieldErrors)
     lines.push(`Error: missing required argument <${fe.path}>`);
   lines.push("See below for usage.");
   lines.push("");
-  lines.push(formatCommand(path3 === cli2 ? cli2 : `${cli2} ${path3}`, {
+  lines.push(formatCommand(path7 === cli2 ? cli2 : `${cli2} ${path7}`, {
     alias: command.alias,
     description: command.description,
     args: command.args,
@@ -136760,7 +136760,7 @@ function resolveCommand(commands, tokens) {
   if (!first || !commands.has(first))
     return { error: first ?? "(none)", path: "" };
   let entry = commands.get(first);
-  const path3 = [first];
+  const path7 = [first];
   let remaining = rest;
   let inheritedOutputPolicy;
   while (isGroup(entry)) {
@@ -136770,22 +136770,22 @@ function resolveCommand(commands, tokens) {
     if (!next)
       return {
         help: true,
-        path: path3.join(" "),
+        path: path7.join(" "),
         description: entry.description,
         commands: entry.commands
       };
     const child = entry.commands.get(next);
     if (!child) {
-      return { error: next, path: path3.join(" ") };
+      return { error: next, path: path7.join(" ") };
     }
-    path3.push(next);
+    path7.push(next);
     remaining = remaining.slice(1);
     entry = child;
   }
   const outputPolicy = entry.outputPolicy ?? inheritedOutputPolicy;
   return {
     command: entry,
-    path: path3.join(" "),
+    path: path7.join(" "),
     rest: remaining,
     ...outputPolicy ? { outputPolicy } : void 0
   };
@@ -137050,11 +137050,11 @@ function buildManifest(commands, prefix = []) {
 function collectCommands(commands, prefix) {
   const result = [];
   for (const [name2, entry] of commands) {
-    const path3 = [...prefix, name2];
+    const path7 = [...prefix, name2];
     if (isGroup(entry)) {
-      result.push(...collectCommands(entry.commands, path3));
+      result.push(...collectCommands(entry.commands, path7));
     } else {
-      const cmd = { name: path3.join(" ") };
+      const cmd = { name: path7.join(" ") };
       if (entry.description)
         cmd.description = entry.description;
       const inputSchema = buildInputSchema(entry.args, entry.env, entry.options);
@@ -137072,7 +137072,7 @@ function collectCommands(commands, prefix) {
       }
       const examples = formatExamples(entry.examples);
       if (examples) {
-        const cmdName = path3.join(" ");
+        const cmdName = path7.join(" ");
         cmd.examples = examples.map((e) => ({
           ...e,
           command: e.command ? `${cmdName} ${e.command}` : cmdName
@@ -137086,13 +137086,13 @@ function collectCommands(commands, prefix) {
 function collectSkillCommands(commands, prefix, groups) {
   const result = [];
   for (const [name2, entry] of commands) {
-    const path3 = [...prefix, name2];
+    const path7 = [...prefix, name2];
     if (isGroup(entry)) {
       if (entry.description)
-        groups.set(path3.join(" "), entry.description);
-      result.push(...collectSkillCommands(entry.commands, path3, groups));
+        groups.set(path7.join(" "), entry.description);
+      result.push(...collectSkillCommands(entry.commands, path7, groups));
     } else {
-      const cmd = { name: path3.join(" ") };
+      const cmd = { name: path7.join(" ") };
       if (entry.description)
         cmd.description = entry.description;
       if (entry.args)
@@ -137107,7 +137107,7 @@ function collectSkillCommands(commands, prefix, groups) {
         cmd.output = entry.output;
       const examples = formatExamples(entry.examples);
       if (examples) {
-        const cmdName = path3.join(" ");
+        const cmdName = path7.join(" ");
         cmd.examples = examples.map((e) => ({
           ...e,
           command: e.command ? `${cmdName} ${e.command}` : cmdName
@@ -137151,13 +137151,16 @@ function buildInputSchema(args2, env2, options2) {
 // package.json
 var package_default = {
   name: "@docyrus/docyrus",
-  version: "0.0.39",
+  version: "0.0.41",
   private: false,
   description: "Docyrus API CLI",
   main: "./main.js",
   bin: {
     docyrus: "main.js"
   },
+  scripts: {
+    postinstall: "node ./resources/officecli/install.mjs"
+  },
   dependencies: {
     "@clack/prompts": "^0.11.0",
     "@hono/node-server": "^1.14.1",
@@ -137393,7 +137396,7 @@ function createActionCli(dependencies) {
       const apiClient = dependencies.createApiClient(apiBaseUrl);
       const { appSlug, actionKey } = context.args;
       const body2 = context.options.params ? parseJsonParams(context.options.params) : {};
-      const path3 = `/v1/apps/${encodeURIComponent(appSlug)}/actions/${encodeURIComponent(actionKey)}/run`;
+      const path7 = `/v1/apps/${encodeURIComponent(appSlug)}/actions/${encodeURIComponent(actionKey)}/run`;
       const headers = {};
       if (context.options.connectionId) {
         headers["x-connection-id"] = context.options.connectionId;
@@ -137408,7 +137411,7 @@ function createActionCli(dependencies) {
           payload: {
             dryRun: true,
             method: "POST",
-            path: path3,
+            path: path7,
             headers: Object.keys(headers).length > 0 ? headers : void 0,
             body: body2
           }
@@ -137416,7 +137419,7 @@ function createActionCli(dependencies) {
       }
       const response = await apiClient.request({
         method: "POST",
-        path: path3,
+        path: path7,
         headers: Object.keys(headers).length > 0 ? headers : void 0,
         body: body2
       });
@@ -137638,10 +137641,10 @@ function createAiCli(dependencies) {
       const deploymentId = context.options.deploymentId?.trim() || void 0;
       const apiBaseUrl = await dependencies.environmentConfigService.getActiveApiBaseUrl();
       const apiClient = dependencies.createApiClient(apiBaseUrl);
-      const path3 = deploymentId ? `/ai/agents/${agentId}/deployments/${deploymentId}/chat` : `/ai/agents/${agentId}/chat`;
+      const path7 = deploymentId ? `/ai/agents/${agentId}/deployments/${deploymentId}/chat` : `/ai/agents/${agentId}/chat`;
       const response = await apiClient.request({
         method: "POST",
-        path: path3,
+        path: path7,
         body: {
           messages: [
             {
@@ -138621,7 +138624,7 @@ async function readDataInput(params) {
     data,
     fromFile,
     readStdin: readStdin2 = readStdinText,
-    readFileFn = async (path3, encoding) => await (0, import_promises2.readFile)(path3, encoding)
+    readFileFn = async (path7, encoding) => await (0, import_promises2.readFile)(path7, encoding)
   } = params;
   const trimmedData = data?.trim();
   const trimmedFromFile = fromFile?.trim();
@@ -139318,8 +139321,8 @@ function getEntities(document4) {
 }
 function extractNamespaces(paths) {
   const namespaces = /* @__PURE__ */ new Set();
-  for (const path3 of Object.keys(paths)) {
-    const segments = path3.split("/").map((item) => item.trim()).filter((item) => item.length > 0);
+  for (const path7 of Object.keys(paths)) {
+    const segments = path7.split("/").map((item) => item.trim()).filter((item) => item.length > 0);
     if (segments.length === 0) {
       continue;
     }
@@ -139341,8 +139344,8 @@ function getPathOperation(pathItem, method) {
 function toEndpointMethodEntries(paths, pathFilter) {
   const entries = [];
   const sortedPaths = Object.keys(paths).filter(pathFilter).sort((left, right) => left.localeCompare(right));
-  for (const path3 of sortedPaths) {
-    const pathItem = paths[path3];
+  for (const path7 of sortedPaths) {
+    const pathItem = paths[path7];
     if (!isRecord2(pathItem)) {
       continue;
     }
@@ -139355,7 +139358,7 @@ function toEndpointMethodEntries(paths, pathFilter) {
       const summaryValue = operation.summary;
       const description = typeof descriptionValue === "string" ? descriptionValue : typeof summaryValue === "string" ? summaryValue : void 0;
       entries.push({
-        path: toOutputPath(path3),
+        path: toOutputPath(path7),
         method,
         description
       });
@@ -139481,7 +139484,7 @@ function createDiscoverCli(dependencies) {
       const candidates = buildPathCandidates(context.args.prefix);
       const endpoints = toEndpointMethodEntries(
         paths,
-        (path3) => candidates.some((candidate) => path3.startsWith(candidate))
+        (path7) => candidates.some((candidate) => path7.startsWith(candidate))
       );
       return await injectContext({
         apiBaseUrl,
@@ -139578,7 +139581,7 @@ function createDiscoverCli(dependencies) {
         const loweredTerm = term.toLowerCase();
         const matchingEndpoints = toEndpointMethodEntries(
           pathMap,
-          (path3) => path3.toLowerCase().includes(loweredTerm)
+          (path7) => path7.toLowerCase().includes(loweredTerm)
         );
         const matchingEntities = entityNames.filter((entityName) => entityName.toLowerCase().includes(loweredTerm));
         return {
@@ -139792,8 +139795,8 @@ function createEnvCli(dependencies) {
 }
 
 // src/commands/knowledgeCommands.ts
-var import_node_crypto4 = require("node:crypto");
-var import_node_path18 = require("node:path");
+var import_node_crypto6 = require("node:crypto");
+var import_node_path20 = require("node:path");
 init_graph();
 
 // src/knowledge/query.ts
@@ -142097,11 +142100,11 @@ var Module2 = (() => {
       throw toThrow;
     }, "quit_");
     var scriptDirectory = "";
-    function locateFile(path3) {
+    function locateFile(path7) {
       if (Module["locateFile"]) {
-        return Module["locateFile"](path3, scriptDirectory);
+        return Module["locateFile"](path7, scriptDirectory);
       }
-      return scriptDirectory + path3;
+      return scriptDirectory + path7;
     }
     __name(locateFile, "locateFile");
     var readAsync, readBinary;
@@ -144016,6 +144019,9 @@ function extractName(node2) {
   const nameNode = node2.childForFieldName("name");
   return nameNode ? nameNode.text : null;
 }
+function isSyntaxNode(node2) {
+  return node2 !== null;
+}
 function firstLine(text3) {
   const newLineIndex = text3.indexOf("\n");
   return newLineIndex === -1 ? text3 : text3.slice(0, newLineIndex);
@@ -144049,7 +144055,7 @@ function extractTsSymbols(tree) {
       continue;
     }
     if (node2.type === "export_statement") {
-      node2 = node2.namedChildren.find((child) => child.type === "function_declaration" || child.type === "generator_function_declaration" || child.type === "class_declaration" || child.type === "abstract_class_declaration" || child.type === "lexical_declaration" || child.type === "type_alias_declaration" || child.type === "interface_declaration") || node2;
+      node2 = node2.namedChildren.find((child) => isSyntaxNode(child) && (child.type === "function_declaration" || child.type === "generator_function_declaration" || child.type === "class_declaration" || child.type === "abstract_class_declaration" || child.type === "lexical_declaration" || child.type === "type_alias_declaration" || child.type === "interface_declaration")) || node2;
     }
     const startLine = node2.startPosition.row + 1;
     const endLine = node2.endPosition.row + 1;
@@ -144085,6 +144091,9 @@ function extractTsSymbols(tree) {
     }
     if (node2.type === "lexical_declaration") {
       for (const declaration of node2.namedChildren) {
+        if (!declaration) {
+          continue;
+        }
         if (declaration.type !== "variable_declarator") {
           continue;
         }
@@ -144461,6 +144470,9 @@ function cFieldName(declarator) {
 }
 function collectFieldsFromList(fieldList, structName, symbols) {
   for (const field of fieldList.namedChildren) {
+    if (!field) {
+      continue;
+    }
     if (field.type !== "field_declaration") {
       continue;
     }
@@ -144480,8 +144492,14 @@ function collectFieldsFromList(fieldList, structName, symbols) {
       continue;
     }
     for (const inner of field.namedChildren) {
+      if (!inner) {
+        continue;
+      }
       if ((inner.type === "union_specifier" || inner.type === "struct_specifier") && !extractName(inner)) {
         for (const nested of inner.namedChildren) {
+          if (!nested) {
+            continue;
+          }
           if (nested.type === "field_declaration_list") {
             collectFieldsFromList(nested, structName, symbols);
           }
@@ -144492,6 +144510,9 @@ function collectFieldsFromList(fieldList, structName, symbols) {
 }
 function collectCStructFields(structNode, structName, symbols) {
   for (const child of structNode.namedChildren) {
+    if (!child) {
+      continue;
+    }
     if (child.type === "field_declaration_list") {
       collectFieldsFromList(child, structName, symbols);
     }
@@ -144499,10 +144520,16 @@ function collectCStructFields(structNode, structName, symbols) {
 }
 function collectCEnumMembers(enumSpecifier, symbols, enumName) {
   for (const child of enumSpecifier.namedChildren) {
+    if (!child) {
+      continue;
+    }
     if (child.type !== "enumerator_list") {
       continue;
     }
     for (const enumerator of child.namedChildren) {
+      if (!enumerator) {
+        continue;
+      }
       if (enumerator.type !== "enumerator") {
         continue;
       }
@@ -144568,6 +144595,9 @@ function collectCNodes(parent, symbols) {
         symbols.push({ name: name2, kind: "type", startLine, endLine, signature: firstLine(node2.text) });
       }
       for (const child of node2.namedChildren) {
+        if (!child) {
+          continue;
+        }
         if (child.type === "enum_specifier") {
           collectCEnumMembers(child, symbols, name2 || extractName(child) || void 0);
         } else if (child.type === "struct_specifier" && name2) {
@@ -145547,9 +145577,9 @@ function shouldUseKnowledgeColors() {
 }
 
 // src/knowledge/init.ts
-var import_node_fs8 = require("node:fs");
-var import_promises12 = require("node:fs/promises");
-var import_node_path16 = require("node:path");
+var import_node_fs10 = require("node:fs");
+var import_promises14 = require("node:fs/promises");
+var import_node_path18 = require("node:path");
 init_graph();
 
 // src/knowledge/bootstrap.ts
@@ -145961,6 +145991,754 @@ async function generateInitialKnowledge(params) {
   };
 }
 
+// src/project-plan/graph.ts
+var import_node_crypto5 = require("node:crypto");
+var import_node_fs9 = require("node:fs");
+var import_promises13 = __toESM(require("node:fs/promises"));
+var import_node_path17 = __toESM(require("node:path"));
+init_graph();
+
+// src/project-plan/localTodos.ts
+var import_node_crypto4 = __toESM(require("node:crypto"));
+var import_node_fs8 = require("node:fs");
+var import_promises12 = __toESM(require("node:fs/promises"));
+var import_node_path16 = __toESM(require("node:path"));
+var TODO_DIR_NAME = ".pi/todos";
+var TODO_PATH_ENV = "PI_TODO_PATH";
+function resolveTodosDirectory(root) {
+  const overridePath = process.env[TODO_PATH_ENV]?.trim();
+  if (overridePath) {
+    return import_node_path16.default.resolve(root, overridePath);
+  }
+  return import_node_path16.default.resolve(root, TODO_DIR_NAME);
+}
+function getTodoFilePath(todosDir, id) {
+  return import_node_path16.default.join(todosDir, `${id}.md`);
+}
+function splitFrontMatter(content3) {
+  if (!content3.startsWith("{")) {
+    return {
+      frontMatter: "",
+      body: content3
+    };
+  }
+  let depth = 0;
+  let inString = false;
+  let escaped = false;
+  let endIndex = -1;
+  for (let index2 = 0; index2 < content3.length; index2 += 1) {
+    const char = content3[index2];
+    if (inString) {
+      if (escaped) {
+        escaped = false;
+        continue;
+      }
+      if (char === "\\") {
+        escaped = true;
+        continue;
+      }
+      if (char === '"') {
+        inString = false;
+      }
+      continue;
+    }
+    if (char === '"') {
+      inString = true;
+      continue;
+    }
+    if (char === "{") {
+      depth += 1;
+      continue;
+    }
+    if (char === "}") {
+      depth -= 1;
+      if (depth === 0) {
+        endIndex = index2;
+        break;
+      }
+    }
+  }
+  if (endIndex === -1) {
+    return {
+      frontMatter: "",
+      body: content3
+    };
+  }
+  return {
+    frontMatter: content3.slice(0, endIndex + 1),
+    body: content3.slice(endIndex + 1).replace(/^\r?\n+/u, "")
+  };
+}
+function parseLocalTodoFrontMatter(frontMatter, idFallback) {
+  const base = {
+    id: idFallback,
+    title: "",
+    tags: [],
+    status: "open",
+    created_at: ""
+  };
+  if (!frontMatter.trim()) {
+    return base;
+  }
+  try {
+    const parsed = JSON.parse(frontMatter);
+    return {
+      id: typeof parsed.id === "string" && parsed.id.trim() ? parsed.id.trim() : idFallback,
+      title: typeof parsed.title === "string" ? parsed.title : "",
+      tags: Array.isArray(parsed.tags) ? parsed.tags.filter((value2) => typeof value2 === "string") : [],
+      status: typeof parsed.status === "string" && parsed.status.trim() ? parsed.status.trim() : "open",
+      created_at: typeof parsed.created_at === "string" ? parsed.created_at : "",
+      assigned_to_session: typeof parsed.assigned_to_session === "string" && parsed.assigned_to_session.trim() ? parsed.assigned_to_session.trim() : void 0,
+      parent_task_id: typeof parsed.parent_task_id === "string" && parsed.parent_task_id.trim() ? parsed.parent_task_id.trim() : void 0
+    };
+  } catch {
+    return base;
+  }
+}
+function serializeLocalTodo(record2) {
+  const frontMatter = JSON.stringify(
+    {
+      id: record2.id,
+      title: record2.title,
+      tags: record2.tags,
+      status: record2.status,
+      created_at: record2.created_at,
+      assigned_to_session: record2.assigned_to_session || void 0,
+      parent_task_id: record2.parent_task_id || void 0
+    },
+    null,
+    2
+  );
+  const trimmedBody = record2.body.trim();
+  return trimmedBody ? `${frontMatter}
+
+${trimmedBody}
+` : `${frontMatter}
+`;
+}
+async function generateTodoId(todosDir) {
+  for (let attempt = 0; attempt < 10; attempt += 1) {
+    const id = import_node_crypto4.default.randomBytes(4).toString("hex");
+    if (!(0, import_node_fs8.existsSync)(getTodoFilePath(todosDir, id))) {
+      return id;
+    }
+  }
+  throw new Error("Failed to generate linked todo id.");
+}
+async function listLinkedTodosByTask(root) {
+  const todosDir = resolveTodosDirectory(root);
+  const result = /* @__PURE__ */ new Map();
+  let entries = [];
+  try {
+    entries = await import_promises12.default.readdir(todosDir);
+  } catch {
+    return result;
+  }
+  for (const entry of entries) {
+    if (!entry.endsWith(".md")) {
+      continue;
+    }
+    const id = entry.slice(0, -3);
+    const filePath = getTodoFilePath(todosDir, id);
+    try {
+      const raw = await import_promises12.default.readFile(filePath, "utf8");
+      const { frontMatter } = splitFrontMatter(raw);
+      const parsed = parseLocalTodoFrontMatter(frontMatter, id);
+      if (!parsed.parent_task_id) {
+        continue;
+      }
+      const existing = result.get(parsed.parent_task_id) || [];
+      existing.push({
+        id,
+        title: parsed.title,
+        status: parsed.status,
+        filePath: import_node_path16.default.relative(root, filePath),
+        parentTaskId: parsed.parent_task_id
+      });
+      result.set(parsed.parent_task_id, existing);
+    } catch {
+    }
+  }
+  for (const linkedTodos of result.values()) {
+    linkedTodos.sort((left, right) => left.title.localeCompare(right.title) || left.id.localeCompare(right.id));
+  }
+  return result;
+}
+async function createLinkedTodo(params) {
+  const todosDir = resolveTodosDirectory(params.root);
+  await import_promises12.default.mkdir(todosDir, {
+    recursive: true
+  });
+  const id = await generateTodoId(todosDir);
+  const filePath = getTodoFilePath(todosDir, id);
+  const todo = {
+    id,
+    title: params.title,
+    tags: [],
+    status: "open",
+    created_at: (/* @__PURE__ */ new Date()).toISOString(),
+    parent_task_id: params.parentTaskId,
+    body: params.body ?? ""
+  };
+  await import_promises12.default.writeFile(filePath, serializeLocalTodo(todo), "utf8");
+  return {
+    id,
+    title: todo.title,
+    status: todo.status,
+    filePath: import_node_path16.default.relative(params.root, filePath),
+    parentTaskId: params.parentTaskId
+  };
+}
+
+// src/project-plan/types.ts
+var PROJECT_TASK_TYPES = [
+  "bug-fix",
+  "new-implementation",
+  "api-test",
+  "browser-automation-test",
+  "work"
+];
+var PROJECT_TASK_ASSIGNEES = [
+  "agent",
+  "user"
+];
+var PROJECT_TASK_STATUSES = [
+  "planned",
+  "in_progress",
+  "blocked",
+  "done"
+];
+
+// src/project-plan/graph.ts
+var PROJECT_PLAN_DIR_SEGMENTS = ["docyrus", "project-plan"];
+var PROJECT_PLAN_JSON_FILE_NAME = "project-plan.json";
+var PROJECT_PLAN_MARKDOWN_FILE_NAME = "PROJECT_PLAN.md";
+var DEFAULT_ROUTE_TARGETS = {
+  features: {
+    heading: "Features",
+    filePathSuffix: "docyrus/knowledge/features/features.md"
+  },
+  testing: {
+    heading: "Testing",
+    filePathSuffix: "docyrus/knowledge/testing/testing.md"
+  },
+  architecture: {
+    heading: "Architecture",
+    filePathSuffix: "docyrus/knowledge/architecture/architecture.md"
+  },
+  workflows: {
+    heading: "Workflows",
+    filePathSuffix: "docyrus/knowledge/workflows/workflows.md"
+  }
+};
+function isRecord3(value2) {
+  return typeof value2 === "object" && value2 !== null && !Array.isArray(value2);
+}
+function isNonEmptyString(value2) {
+  return typeof value2 === "string" && value2.trim().length > 0;
+}
+function normalizeStringArray(value2) {
+  if (!Array.isArray(value2)) {
+    return [];
+  }
+  return value2.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean);
+}
+function slugify2(value2) {
+  const slug = value2.toLowerCase().replace(/[^a-z0-9]+/gu, "-").replace(/^-+|-+$/gu, "").slice(0, 80);
+  return slug || "item";
+}
+function hashParts(parts2) {
+  return (0, import_node_crypto5.createHash)("sha1").update(parts2.join("::")).digest("hex").slice(0, 12);
+}
+function normalizeFeatureId(sectionId, slug) {
+  return `feature-${hashParts([sectionId, slug])}`;
+}
+function normalizeTaskId(featureId, type, title) {
+  return `task-${hashParts([featureId, type, slugify2(title)])}`;
+}
+function compareStrings(left, right) {
+  return left.localeCompare(right);
+}
+function sortGraph(graph) {
+  return {
+    version: 1,
+    sections: [...graph.sections].sort((left, right) => compareStrings(left.sectionId, right.sectionId)),
+    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);
+    })
+  };
+}
+function resolveProjectPlanDirectory(root) {
+  return import_node_path17.default.join(root, ...PROJECT_PLAN_DIR_SEGMENTS);
+}
+function resolveProjectPlanGraphPath(root) {
+  return import_node_path17.default.join(resolveProjectPlanDirectory(root), PROJECT_PLAN_JSON_FILE_NAME);
+}
+function resolveProjectPlanMarkdownPath(root) {
+  return import_node_path17.default.join(resolveProjectPlanDirectory(root), PROJECT_PLAN_MARKDOWN_FILE_NAME);
+}
+function createEmptyProjectPlanGraph() {
+  return {
+    version: 1,
+    sections: [],
+    features: [],
+    tasks: []
+  };
+}
+async function readKnowledgeSections(root) {
+  const knowledgeDir = import_node_path17.default.join(root, "docyrus", "knowledge");
+  if (!(0, import_node_fs9.existsSync)(knowledgeDir)) {
+    return [];
+  }
+  return flattenSections(await loadAllSections(knowledgeDir));
+}
+function parseProjectPlanGraph(rawValue) {
+  if (!isRecord3(rawValue)) {
+    return createEmptyProjectPlanGraph();
+  }
+  const sections = Array.isArray(rawValue.sections) ? rawValue.sections.filter((value2) => isRecord3(value2)).map((value2) => ({
+    sectionId: isNonEmptyString(value2.sectionId) ? value2.sectionId.trim() : ""
+  })).filter((value2) => value2.sectionId.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() : ""
+  })).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() : "",
+    title: isNonEmptyString(value2.title) ? value2.title.trim() : "",
+    summary: typeof value2.summary === "string" ? value2.summary.trim() : "",
+    type: typeof value2.type === "string" ? value2.type : "work",
+    assignee: typeof value2.assignee === "string" ? value2.assignee : "agent",
+    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() : ""
+  })).filter((value2) => value2.id.length > 0) : [];
+  return sortGraph({
+    version: 1,
+    sections,
+    features,
+    tasks
+  });
+}
+async function readProjectPlanGraph(root) {
+  const graphPath = resolveProjectPlanGraphPath(root);
+  if (!(0, import_node_fs9.existsSync)(graphPath)) {
+    return createEmptyProjectPlanGraph();
+  }
+  const raw = await import_promises13.default.readFile(graphPath, "utf8");
+  return parseProjectPlanGraph(JSON.parse(raw));
+}
+function deriveFeatureStatus(tasks) {
+  if (tasks.length === 0) {
+    return "planned";
+  }
+  if (tasks.every((task) => task.status === "done")) {
+    return "done";
+  }
+  if (tasks.some((task) => task.status === "in_progress")) {
+    return "in_progress";
+  }
+  if (tasks.some((task) => task.status === "blocked")) {
+    return "blocked";
+  }
+  return "planned";
+}
+function deriveSectionStatus(features) {
+  if (features.length === 0) {
+    return "planned";
+  }
+  if (features.every((feature) => feature.status === "done")) {
+    return "done";
+  }
+  if (features.some((feature) => feature.status === "in_progress")) {
+    return "in_progress";
+  }
+  if (features.some((feature) => feature.status === "blocked")) {
+    return "blocked";
+  }
+  return "planned";
+}
+function findKnowledgeSectionTitle(knowledgeSections, sectionId) {
+  const section2 = knowledgeSections.find((item) => item.id === sectionId);
+  if (!section2) {
+    return {
+      heading: sectionId,
+      filePath: ""
+    };
+  }
+  return {
+    heading: section2.heading,
+    filePath: section2.filePath
+  };
+}
+async function buildProjectPlanHierarchy(root, graph) {
+  const knowledgeSections = await readKnowledgeSections(root);
+  const currentGraph = graph ?? await readProjectPlanGraph(root);
+  const linkedTodos = await listLinkedTodosByTask(root);
+  const featureMap = /* @__PURE__ */ new Map();
+  for (const feature of currentGraph.features) {
+    const featureTasks = currentGraph.tasks.filter((task) => task.featureId === feature.id).map((task) => {
+      const taskLinkedTodos = linkedTodos.get(task.id) || [];
+      return {
+        ...task,
+        linkedTodos: taskLinkedTodos,
+        linkedTodoCount: taskLinkedTodos.length
+      };
+    });
+    featureMap.set(feature.id, {
+      ...feature,
+      status: deriveFeatureStatus(featureTasks),
+      taskCount: featureTasks.length,
+      tasks: featureTasks
+    });
+  }
+  const sections = currentGraph.sections.map((section2) => {
+    const features = currentGraph.features.filter((feature) => feature.sectionId === section2.sectionId).map((feature) => featureMap.get(feature.id)).filter((feature) => Boolean(feature));
+    const knowledgeMetadata = findKnowledgeSectionTitle(knowledgeSections, section2.sectionId);
+    const taskCount = features.reduce((count, feature) => count + feature.taskCount, 0);
+    return {
+      sectionId: section2.sectionId,
+      heading: knowledgeMetadata.heading,
+      filePath: knowledgeMetadata.filePath,
+      status: deriveSectionStatus(features),
+      featureCount: features.length,
+      taskCount,
+      features
+    };
+  });
+  return {
+    sections
+  };
+}
+function formatAcceptanceCriteria(criteria) {
+  if (criteria.length === 0) {
+    return ["- None yet"];
+  }
+  return criteria.map((item) => `- ${item}`);
+}
+async function renderProjectPlanMarkdown(root, graph) {
+  const hierarchy = await buildProjectPlanHierarchy(root, graph);
+  const lines = [
+    "# Project Plan",
+    "",
+    "This file is derived from `docyrus/project-plan/project-plan.json`.",
+    ""
+  ];
+  const populatedSections = hierarchy.sections.filter((section2) => section2.features.length > 0);
+  if (populatedSections.length === 0) {
+    lines.push("No planned features or tasks yet.");
+    lines.push("");
+    return `${lines.join("\n")}`;
+  }
+  for (const section2 of populatedSections) {
+    lines.push(`## ${section2.heading}`);
+    lines.push("");
+    lines.push(`- Section ID: \`${section2.sectionId}\``);
+    lines.push(`- Status: \`${section2.status}\``);
+    lines.push(`- Features: ${section2.featureCount}`);
+    lines.push(`- Tasks: ${section2.taskCount}`);
+    lines.push("");
+    for (const feature of section2.features) {
+      lines.push(`### ${feature.title}`);
+      lines.push("");
+      lines.push(`- Feature ID: \`${feature.id}\``);
+      lines.push(`- Status: \`${feature.status}\``);
+      lines.push(`- Slug: \`${feature.slug}\``);
+      if (feature.summary) {
+        lines.push(`- Summary: ${feature.summary}`);
+      }
+      lines.push("");
+      for (const task of feature.tasks) {
+        lines.push(`#### ${task.title}`);
+        lines.push("");
+        lines.push(`- Task ID: \`${task.id}\``);
+        lines.push(`- Type: \`${task.type}\``);
+        lines.push(`- Assignee: \`${task.assignee}\``);
+        lines.push(`- Status: \`${task.status}\``);
+        if (task.summary) {
+          lines.push(`- Summary: ${task.summary}`);
+        }
+        lines.push("- Acceptance Criteria:");
+        lines.push(...formatAcceptanceCriteria(task.acceptanceCriteria));
+        lines.push("");
+      }
+    }
+  }
+  return `${lines.join("\n").trimEnd()}
+`;
+}
+async function writeProjectPlanFiles(root, graph) {
+  const graphPath = resolveProjectPlanGraphPath(root);
+  const markdownPath = resolveProjectPlanMarkdownPath(root);
+  await import_promises13.default.mkdir(import_node_path17.default.dirname(graphPath), {
+    recursive: true
+  });
+  const sortedGraph = sortGraph(graph);
+  await import_promises13.default.writeFile(graphPath, `${JSON.stringify(sortedGraph, null, 2)}
+`, "utf8");
+  await import_promises13.default.writeFile(markdownPath, await renderProjectPlanMarkdown(root, sortedGraph), "utf8");
+  return {
+    graph: sortedGraph,
+    graphPath,
+    markdownPath
+  };
+}
+function buildProjectPlanCheckError(code, message, target) {
+  return {
+    code,
+    message,
+    target
+  };
+}
+async function validateProjectPlanGraph(root, graph) {
+  const currentGraph = graph ?? await readProjectPlanGraph(root);
+  const errors = [];
+  const knowledgeSections = await readKnowledgeSections(root);
+  const knowledgeSectionIds = new Set(knowledgeSections.map((section2) => section2.id));
+  const sectionIds = /* @__PURE__ */ new Set();
+  const featureIds = /* @__PURE__ */ new Set();
+  const featureMap = /* @__PURE__ */ new Map();
+  for (const section2 of currentGraph.sections) {
+    if (!section2.sectionId) {
+      errors.push(buildProjectPlanCheckError("section_missing_id", "Project plan section is missing `sectionId`."));
+      continue;
+    }
+    if (sectionIds.has(section2.sectionId)) {
+      errors.push(buildProjectPlanCheckError("duplicate_section", `Duplicate section id "${section2.sectionId}"`, section2.sectionId));
+      continue;
+    }
+    sectionIds.add(section2.sectionId);
+    if (!knowledgeSectionIds.has(section2.sectionId)) {
+      errors.push(buildProjectPlanCheckError(
+        "unknown_knowledge_section",
+        `Project plan section "${section2.sectionId}" does not exist in docyrus/knowledge.`,
+        section2.sectionId
+      ));
+    }
+  }
+  const allowedTypes = new Set(PROJECT_TASK_TYPES);
+  const allowedAssignees = new Set(PROJECT_TASK_ASSIGNEES);
+  const allowedStatuses = new Set(PROJECT_TASK_STATUSES);
+  for (const feature of currentGraph.features) {
+    if (!feature.id) {
+      errors.push(buildProjectPlanCheckError("feature_missing_id", "Project plan feature is missing `id`."));
+      continue;
+    }
+    if (featureIds.has(feature.id)) {
+      errors.push(buildProjectPlanCheckError("duplicate_feature", `Duplicate feature id "${feature.id}"`, feature.id));
+      continue;
+    }
+    featureIds.add(feature.id);
+    featureMap.set(feature.id, feature);
+    if (!feature.sectionId) {
+      errors.push(buildProjectPlanCheckError("feature_missing_section", `Feature "${feature.id}" is missing \`sectionId\`.`, feature.id));
+      continue;
+    }
+    if (!sectionIds.has(feature.sectionId)) {
+      errors.push(buildProjectPlanCheckError(
+        "feature_unknown_section",
+        `Feature "${feature.id}" references unknown section "${feature.sectionId}".`,
+        feature.id
+      ));
+    }
+    if (!feature.title.trim()) {
+      errors.push(buildProjectPlanCheckError("feature_missing_title", `Feature "${feature.id}" is missing a title.`, feature.id));
+    }
+    if (!feature.slug.trim()) {
+      errors.push(buildProjectPlanCheckError("feature_missing_slug", `Feature "${feature.id}" is missing a slug.`, feature.id));
+    }
+  }
+  const taskIds = /* @__PURE__ */ new Set();
+  for (const task of currentGraph.tasks) {
+    if (!task.id) {
+      errors.push(buildProjectPlanCheckError("task_missing_id", "Project plan task is missing `id`."));
+      continue;
+    }
+    if (taskIds.has(task.id)) {
+      errors.push(buildProjectPlanCheckError("duplicate_task", `Duplicate task id "${task.id}"`, task.id));
+      continue;
+    }
+    taskIds.add(task.id);
+    const feature = featureMap.get(task.featureId);
+    if (!feature) {
+      errors.push(buildProjectPlanCheckError(
+        "task_unknown_feature",
+        `Task "${task.id}" references unknown feature "${task.featureId}".`,
+        task.id
+      ));
+      continue;
+    }
+    if (!task.title.trim()) {
+      errors.push(buildProjectPlanCheckError("task_missing_title", `Task "${task.id}" is missing a title.`, task.id));
+    }
+    if (!allowedTypes.has(task.type)) {
+      errors.push(buildProjectPlanCheckError(
+        "task_invalid_type",
+        `Task "${task.id}" has invalid type "${task.type}".`,
+        task.id
+      ));
+    }
+    if (!allowedAssignees.has(task.assignee)) {
+      errors.push(buildProjectPlanCheckError(
+        "task_invalid_assignee",
+        `Task "${task.id}" has invalid assignee "${task.assignee}".`,
+        task.id
+      ));
+    }
+    if (!allowedStatuses.has(task.status)) {
+      errors.push(buildProjectPlanCheckError(
+        "task_invalid_status",
+        `Task "${task.id}" has invalid status "${task.status}".`,
+        task.id
+      ));
+    }
+    if (!sectionIds.has(task.sectionId)) {
+      errors.push(buildProjectPlanCheckError(
+        "task_unknown_section",
+        `Task "${task.id}" references unknown section "${task.sectionId}".`,
+        task.id
+      ));
+    }
+    if (task.sectionId !== feature.sectionId) {
+      errors.push(buildProjectPlanCheckError(
+        "task_section_mismatch",
+        `Task "${task.id}" section "${task.sectionId}" does not match feature "${feature.id}" section "${feature.sectionId}".`,
+        task.id
+      ));
+    }
+  }
+  return {
+    ok: errors.length === 0,
+    errors
+  };
+}
+async function resolveKnowledgeSectionIds(root) {
+  const sections = await readKnowledgeSections(root);
+  return sections.map((section2) => section2.id).sort(compareStrings);
+}
+async function syncProjectPlanSectionsFromKnowledge(root) {
+  const currentGraph = await readProjectPlanGraph(root);
+  const knowledgeSectionIds = await resolveKnowledgeSectionIds(root);
+  const syncedGraph = {
+    ...currentGraph,
+    sections: knowledgeSectionIds.map((sectionId) => ({
+      sectionId
+    }))
+  };
+  return writeProjectPlanFiles(root, syncedGraph);
+}
+async function ensureProjectPlanGraph(root) {
+  const graphPath = resolveProjectPlanGraphPath(root);
+  if (!(0, import_node_fs9.existsSync)(graphPath)) {
+    return syncProjectPlanSectionsFromKnowledge(root);
+  }
+  const graph = await readProjectPlanGraph(root);
+  return writeProjectPlanFiles(root, graph);
+}
+async function upsertProjectPlanFeature(params) {
+  const state = await ensureProjectPlanGraph(params.root);
+  const slug = slugify2(params.slug?.trim() || params.title);
+  const featureId = params.featureId?.trim() || normalizeFeatureId(params.sectionId, slug);
+  const graph = state.graph;
+  const existing = graph.features.find((feature) => feature.id === featureId) || graph.features.find((feature) => feature.sectionId === params.sectionId && feature.slug === slug);
+  const nextFeature = {
+    id: existing?.id || featureId,
+    title: params.title.trim(),
+    slug,
+    summary: params.summary?.trim() || "",
+    sectionId: params.sectionId
+  };
+  const nextFeatures = existing ? graph.features.map((feature) => feature.id === existing.id ? nextFeature : feature) : [...graph.features, nextFeature];
+  await writeProjectPlanFiles(params.root, {
+    ...graph,
+    features: nextFeatures
+  });
+  return nextFeature;
+}
+async function getProjectPlanTask(params) {
+  const graph = await readProjectPlanGraph(params.root);
+  const linkedTodos = await listLinkedTodosByTask(params.root);
+  const task = graph.tasks.find((item) => item.id === params.taskId);
+  if (!task) {
+    return null;
+  }
+  const taskLinkedTodos = linkedTodos.get(task.id) || [];
+  return {
+    ...task,
+    linkedTodos: taskLinkedTodos,
+    linkedTodoCount: taskLinkedTodos.length
+  };
+}
+async function upsertProjectPlanTask(params) {
+  const state = await ensureProjectPlanGraph(params.root);
+  const graph = state.graph;
+  const feature = graph.features.find((item) => item.id === params.featureId);
+  if (!feature) {
+    throw new Error(`Feature "${params.featureId}" not found.`);
+  }
+  const sectionId = params.sectionId?.trim() || feature.sectionId;
+  const taskId = params.taskId?.trim() || normalizeTaskId(feature.id, params.type, params.title);
+  const existing = graph.tasks.find((task) => task.id === taskId) || graph.tasks.find((task) => task.featureId === feature.id && task.type === params.type && task.title === params.title.trim());
+  const nextTask = {
+    id: existing?.id || taskId,
+    title: params.title.trim(),
+    summary: params.summary?.trim() || "",
+    type: params.type,
+    assignee: params.assignee,
+    status: params.status || "planned",
+    acceptanceCriteria: [...new Set((params.acceptanceCriteria || []).map((item) => item.trim()).filter(Boolean))],
+    featureId: feature.id,
+    sectionId
+  };
+  const nextTasks = existing ? graph.tasks.map((task) => task.id === existing.id ? nextTask : task) : [...graph.tasks, nextTask];
+  await writeProjectPlanFiles(params.root, {
+    ...graph,
+    tasks: nextTasks
+  });
+  return nextTask;
+}
+async function updateProjectPlanTaskStatus(params) {
+  const graph = await readProjectPlanGraph(params.root);
+  const task = graph.tasks.find((item) => item.id === params.taskId);
+  if (!task) {
+    throw new Error(`Task "${params.taskId}" not found.`);
+  }
+  const nextTask = {
+    ...task,
+    status: params.status
+  };
+  await writeProjectPlanFiles(params.root, {
+    ...graph,
+    tasks: graph.tasks.map((item) => item.id === task.id ? nextTask : item)
+  });
+  return nextTask;
+}
+async function resolveDefaultProjectPlanRoutes(root) {
+  const sections = await readKnowledgeSections(root);
+  const resolveRoute = (key) => {
+    const candidate = sections.find((section2) => {
+      return section2.heading === DEFAULT_ROUTE_TARGETS[key].heading && section2.filePath === DEFAULT_ROUTE_TARGETS[key].filePathSuffix && section2.depth === 1;
+    }) || sections.find((section2) => section2.heading === DEFAULT_ROUTE_TARGETS[key].heading);
+    if (!candidate) {
+      throw new Error(`Unable to resolve the default knowledge section for ${key}.`);
+    }
+    return candidate.id;
+  };
+  return {
+    featuresSectionId: resolveRoute("features"),
+    testingSectionId: resolveRoute("testing"),
+    architectureSectionId: resolveRoute("architecture"),
+    workflowsSectionId: resolveRoute("workflows")
+  };
+}
+
 // src/knowledge/init.ts
 var MARKER_BEGIN = "%% docyrus-knowledge:begin %%";
 var MARKER_END = "%% docyrus-knowledge:end %%";
@@ -145972,60 +146750,60 @@ ${content3}${content3.endsWith("\n") ? "" : "\n"}${MARKER_END}
 `;
 }
 async function ensureDirectory(pathValue) {
-  await (0, import_promises12.mkdir)(pathValue, {
+  await (0, import_promises14.mkdir)(pathValue, {
     recursive: true,
     mode: 493
   });
 }
 async function writeIfMissing(filePath, content3) {
-  if ((0, import_node_fs8.existsSync)(filePath)) {
+  if ((0, import_node_fs10.existsSync)(filePath)) {
     return "kept";
   }
-  await ensureDirectory((0, import_node_path16.dirname)(filePath));
-  await (0, import_promises12.writeFile)(filePath, content3, "utf8");
+  await ensureDirectory((0, import_node_path18.dirname)(filePath));
+  await (0, import_promises14.writeFile)(filePath, content3, "utf8");
   return "created";
 }
 async function writeOrUpdate(filePath, content3) {
-  if (!(0, import_node_fs8.existsSync)(filePath)) {
-    await ensureDirectory((0, import_node_path16.dirname)(filePath));
-    await (0, import_promises12.writeFile)(filePath, content3, "utf8");
+  if (!(0, import_node_fs10.existsSync)(filePath)) {
+    await ensureDirectory((0, import_node_path18.dirname)(filePath));
+    await (0, import_promises14.writeFile)(filePath, content3, "utf8");
     return "created";
   }
-  const current = await (0, import_promises12.readFile)(filePath, "utf8");
+  const current = await (0, import_promises14.readFile)(filePath, "utf8");
   if (current === content3) {
     return "kept";
   }
-  await ensureDirectory((0, import_node_path16.dirname)(filePath));
-  await (0, import_promises12.writeFile)(filePath, content3, "utf8");
+  await ensureDirectory((0, import_node_path18.dirname)(filePath));
+  await (0, import_promises14.writeFile)(filePath, content3, "utf8");
   return "updated";
 }
 async function upsertManagedBlock(filePath, content3) {
   const wrapped = wrapManagedBlock(content3);
-  if (!(0, import_node_fs8.existsSync)(filePath)) {
-    await ensureDirectory((0, import_node_path16.dirname)(filePath));
-    await (0, import_promises12.writeFile)(filePath, wrapped, "utf8");
+  if (!(0, import_node_fs10.existsSync)(filePath)) {
+    await ensureDirectory((0, import_node_path18.dirname)(filePath));
+    await (0, import_promises14.writeFile)(filePath, wrapped, "utf8");
     return "created";
   }
-  const current = await (0, import_promises12.readFile)(filePath, "utf8");
+  const current = await (0, import_promises14.readFile)(filePath, "utf8");
   const beginIndex = current.indexOf(MARKER_BEGIN);
   const endIndex = current.indexOf(MARKER_END);
   if (beginIndex !== -1 && endIndex !== -1 && endIndex > beginIndex) {
     const replaceEnd = current[endIndex + MARKER_END.length] === "\n" ? endIndex + MARKER_END.length + 1 : endIndex + MARKER_END.length;
     const updated = `${current.slice(0, beginIndex)}${wrapped}${current.slice(replaceEnd)}`;
-    await (0, import_promises12.writeFile)(filePath, updated, "utf8");
+    await (0, import_promises14.writeFile)(filePath, updated, "utf8");
     return "updated";
   }
   const separator = current.endsWith("\n") ? "\n" : "\n\n";
-  await (0, import_promises12.writeFile)(filePath, `${current}${separator}${wrapped}`, "utf8");
+  await (0, import_promises14.writeFile)(filePath, `${current}${separator}${wrapped}`, "utf8");
   return "appended";
 }
 function normalizeObject(value2) {
   return typeof value2 === "object" && value2 !== null && !Array.isArray(value2) ? { ...value2 } : {};
 }
 async function updateJsonFile(filePath, updater) {
-  const current = (0, import_node_fs8.existsSync)(filePath) ? normalizeObject(JSON.parse((0, import_node_fs8.readFileSync)(filePath, "utf8"))) : {};
-  await ensureDirectory((0, import_node_path16.dirname)(filePath));
-  await (0, import_promises12.writeFile)(filePath, `${JSON.stringify(updater(current), null, 2)}
+  const current = (0, import_node_fs10.existsSync)(filePath) ? normalizeObject(JSON.parse((0, import_node_fs10.readFileSync)(filePath, "utf8"))) : {};
+  await ensureDirectory((0, import_node_path18.dirname)(filePath));
+  await (0, import_promises14.writeFile)(filePath, `${JSON.stringify(updater(current), null, 2)}
 `, "utf8");
 }
 function wrapHookBlock(content3) {
@@ -146035,17 +146813,17 @@ ${content3}${content3.endsWith("\n") ? "" : "\n"}${HOOK_MARKER_END}
 }
 async function upsertShellHook(filePath, content3, shellHeader) {
   const wrapped = wrapHookBlock(content3);
-  if (!(0, import_node_fs8.existsSync)(filePath)) {
-    await ensureDirectory((0, import_node_path16.dirname)(filePath));
+  if (!(0, import_node_fs10.existsSync)(filePath)) {
+    await ensureDirectory((0, import_node_path18.dirname)(filePath));
     const initial = `${shellHeader || ""}${wrapped}`;
-    await (0, import_promises12.writeFile)(filePath, initial, {
+    await (0, import_promises14.writeFile)(filePath, initial, {
       encoding: "utf8",
       mode: 493
     });
-    await (0, import_promises12.chmod)(filePath, 493);
+    await (0, import_promises14.chmod)(filePath, 493);
     return "created";
   }
-  const current = await (0, import_promises12.readFile)(filePath, "utf8");
+  const current = await (0, import_promises14.readFile)(filePath, "utf8");
   const beginIndex = current.indexOf(HOOK_MARKER_BEGIN);
   const endIndex = current.indexOf(HOOK_MARKER_END);
   if (beginIndex !== -1 && endIndex !== -1 && endIndex > beginIndex) {
@@ -146054,13 +146832,13 @@ async function upsertShellHook(filePath, content3, shellHeader) {
     if (nextContent === current) {
       return "kept";
     }
-    await (0, import_promises12.writeFile)(filePath, nextContent, "utf8");
-    await (0, import_promises12.chmod)(filePath, 493);
+    await (0, import_promises14.writeFile)(filePath, nextContent, "utf8");
+    await (0, import_promises14.chmod)(filePath, 493);
     return "updated";
   }
   const separator = current.endsWith("\n") ? "\n" : "\n\n";
-  await (0, import_promises12.writeFile)(filePath, `${current}${separator}${wrapped}`, "utf8");
-  await (0, import_promises12.chmod)(filePath, 493);
+  await (0, import_promises14.writeFile)(filePath, `${current}${separator}${wrapped}`, "utf8");
+  await (0, import_promises14.chmod)(filePath, 493);
   return "appended";
 }
 function buildKnowledgeDocumentTemplate() {
@@ -146154,33 +146932,34 @@ function syncCursorHooks(settings, commandPrefix) {
   };
 }
 async function initializeKnowledgeRepo(params) {
-  const root = (0, import_node_path16.resolve)(params.root || process.cwd());
+  const root = (0, import_node_path18.resolve)(params.root || process.cwd());
   const knowledgeDir = getKnowledgeDirectory(root);
-  const knowledgeFile = (0, import_node_path16.join)(knowledgeDir, "knowledge.md");
+  const knowledgeFile = (0, import_node_path18.join)(knowledgeDir, "knowledge.md");
   await ensureDirectory(knowledgeDir);
   const knowledgeFileStatus = await writeIfMissing(knowledgeFile, `${buildKnowledgeDocumentTemplate()}
 `);
-  const agentsStatus = await upsertManagedBlock((0, import_node_path16.join)(root, "AGENTS.md"), buildAgentsTemplate(params.commandPrefix));
-  const claudeStatus = await upsertManagedBlock((0, import_node_path16.join)(root, "CLAUDE.md"), buildAgentsTemplate(params.commandPrefix));
-  const cursorRulesStatus = await writeOrUpdate((0, import_node_path16.join)(root, ".cursor", "rules", "docyrus-knowledge.md"), `${buildCursorRulesTemplate(params.commandPrefix)}
+  const agentsStatus = await upsertManagedBlock((0, import_node_path18.join)(root, "AGENTS.md"), buildAgentsTemplate(params.commandPrefix));
+  const claudeStatus = await upsertManagedBlock((0, import_node_path18.join)(root, "CLAUDE.md"), buildAgentsTemplate(params.commandPrefix));
+  const cursorRulesStatus = await writeOrUpdate((0, import_node_path18.join)(root, ".cursor", "rules", "docyrus-knowledge.md"), `${buildCursorRulesTemplate(params.commandPrefix)}
 `);
   const bootstrap = (await generateInitialKnowledge({
     root,
     brief: params.brief
   })).files;
-  await updateJsonFile((0, import_node_path16.join)(root, ".claude", "settings.json"), (value2) => syncClaudeHooks(value2, params.commandPrefix));
-  await updateJsonFile((0, import_node_path16.join)(root, ".cursor", "hooks.json"), (value2) => syncCursorHooks(value2, params.commandPrefix));
+  const projectPlan = await syncProjectPlanSectionsFromKnowledge(root);
+  await updateJsonFile((0, import_node_path18.join)(root, ".claude", "settings.json"), (value2) => syncClaudeHooks(value2, params.commandPrefix));
+  await updateJsonFile((0, import_node_path18.join)(root, ".cursor", "hooks.json"), (value2) => syncCursorHooks(value2, params.commandPrefix));
   let huskyHookStatus;
-  const huskyDir = (0, import_node_path16.join)(root, ".husky");
-  if ((0, import_node_fs8.existsSync)(huskyDir)) {
-    const huskyHookPath = (0, import_node_path16.join)(huskyDir, "pre-commit");
-    const huskyHeader = (0, import_node_fs8.existsSync)((0, import_node_path16.join)(huskyDir, "_", "h")) ? '#!/usr/bin/env sh\n. "$(dirname -- "$0")/_/h"\n\n' : void 0;
+  const huskyDir = (0, import_node_path18.join)(root, ".husky");
+  if ((0, import_node_fs10.existsSync)(huskyDir)) {
+    const huskyHookPath = (0, import_node_path18.join)(huskyDir, "pre-commit");
+    const huskyHeader = (0, import_node_fs10.existsSync)((0, import_node_path18.join)(huskyDir, "_", "h")) ? '#!/usr/bin/env sh\n. "$(dirname -- "$0")/_/h"\n\n' : void 0;
     huskyHookStatus = await upsertShellHook(huskyHookPath, `${params.commandPrefix} knowledge pre-commit
 `, huskyHeader);
   }
   let gitHookStatus;
   if (!huskyHookStatus && params.installGitHook) {
-    const gitHookPath = (0, import_node_path16.join)(root, ".git", "hooks", "pre-commit");
+    const gitHookPath = (0, import_node_path18.join)(root, ".git", "hooks", "pre-commit");
     gitHookStatus = await upsertShellHook(gitHookPath, `${params.commandPrefix} knowledge pre-commit
 `, "#!/usr/bin/env sh\n\n");
   }
@@ -146188,6 +146967,8 @@ async function initializeKnowledgeRepo(params) {
     root,
     knowledgeDir,
     knowledgeFile,
+    projectPlanGraphPath: projectPlan.graphPath,
+    projectPlanMarkdownPath: projectPlan.markdownPath,
     agentsStatus,
     claudeStatus,
     cursorRulesStatus,
@@ -146202,9 +146983,9 @@ async function initializeKnowledgeRepo(params) {
 init_graph();
 
 // src/knowledge/validation.ts
-var import_node_fs9 = require("node:fs");
-var import_promises13 = require("node:fs/promises");
-var import_node_path17 = require("node:path");
+var import_node_fs11 = require("node:fs");
+var import_promises15 = require("node:fs/promises");
+var import_node_path19 = require("node:path");
 init_graph();
 var MAX_BODY_LENGTH = 250;
 function bodyTextLength(body2) {
@@ -146237,15 +147018,15 @@ async function tryResolveSourceRef(target, projectRoot) {
   const hashIndex = target.indexOf("#");
   const filePart = hashIndex === -1 ? target : target.slice(0, hashIndex);
   const symbolPart = hashIndex === -1 ? "" : target.slice(hashIndex + 1);
-  const extension2 = (0, import_node_path17.extname)(filePart);
+  const extension2 = (0, import_node_path19.extname)(filePart);
   if (!SOURCE_EXTENSIONS.has(extension2)) {
     if (extension2 && hashIndex !== -1) {
       return `broken link [[${target}]] - unsupported file extension "${extension2}"`;
     }
     return `broken link [[${target}]] - no matching section found`;
   }
-  const absolutePath = (0, import_node_path17.join)(projectRoot, filePart);
-  if (!(0, import_node_fs9.existsSync)(absolutePath)) {
+  const absolutePath = (0, import_node_path19.join)(projectRoot, filePart);
+  if (!(0, import_node_fs11.existsSync)(absolutePath)) {
     return `broken link [[${target}]] - file "${filePart}" not found`;
   }
   if (!symbolPart) {
@@ -146262,7 +147043,7 @@ async function tryResolveSourceRef(target, projectRoot) {
 }
 async function checkKnowledgeMarkdown(knowledgeDir) {
   clearSymbolCache();
-  const projectRoot = (0, import_node_path17.dirname)((0, import_node_path17.dirname)(knowledgeDir));
+  const projectRoot = (0, import_node_path19.dirname)((0, import_node_path19.dirname)(knowledgeDir));
   const files = await listKnowledgeFiles(knowledgeDir);
   const sections = await loadAllSections(knowledgeDir);
   const flat = flattenSections(sections);
@@ -146271,9 +147052,9 @@ async function checkKnowledgeMarkdown(knowledgeDir) {
   const fileIndex = buildFileIndex(sections);
   const errors = [];
   for (const filePath of files) {
-    const content3 = await (0, import_promises13.readFile)(filePath, "utf8");
+    const content3 = await (0, import_promises15.readFile)(filePath, "utf8");
     const refs = extractRefs(filePath, content3, projectRoot);
-    const displayPath = (0, import_node_path17.relative)(process.cwd(), filePath);
+    const displayPath = (0, import_node_path19.relative)(process.cwd(), filePath);
     for (const ref of refs) {
       const resolved = resolveRef2(ref.target, sectionIds, fileIndex, canonicalSectionIds);
       if (resolved.ambiguous) {
@@ -146305,7 +147086,7 @@ async function checkKnowledgeMarkdown(knowledgeDir) {
   };
 }
 async function checkKnowledgeCodeRefs(knowledgeDir) {
-  const projectRoot = (0, import_node_path17.dirname)((0, import_node_path17.dirname)(knowledgeDir));
+  const projectRoot = (0, import_node_path19.dirname)((0, import_node_path19.dirname)(knowledgeDir));
   const sections = await loadAllSections(knowledgeDir);
   const flat = flattenSections(sections);
   const sectionIds = new Set(flat.map((section2) => section2.id.toLowerCase()));
@@ -146317,7 +147098,7 @@ async function checkKnowledgeCodeRefs(knowledgeDir) {
   for (const ref of scan.refs) {
     const resolved = resolveRef2(ref.target, sectionIds, fileIndex, canonicalSectionIds);
     mentionedSections.add(resolved.resolved.toLowerCase());
-    const displayPath = (0, import_node_path17.relative)(process.cwd(), (0, import_node_path17.join)(projectRoot, ref.file));
+    const displayPath = (0, import_node_path19.relative)(process.cwd(), (0, import_node_path19.join)(projectRoot, ref.file));
     if (resolved.ambiguous) {
       errors.push({
         file: displayPath,
@@ -146337,12 +147118,12 @@ async function checkKnowledgeCodeRefs(knowledgeDir) {
     }
   }
   for (const filePath of await listKnowledgeFiles(knowledgeDir)) {
-    const content3 = await (0, import_promises13.readFile)(filePath, "utf8");
+    const content3 = await (0, import_promises15.readFile)(filePath, "utf8");
     if (!parseFrontmatter(content3).requireCodeMention) {
       continue;
     }
     const leafSections = flattenSections(parseSections(filePath, content3, projectRoot)).filter((section2) => section2.children.length === 0);
-    const displayPath = (0, import_node_path17.relative)(process.cwd(), filePath);
+    const displayPath = (0, import_node_path19.relative)(process.cwd(), filePath);
     for (const section2 of leafSections) {
       if (!mentionedSections.has(section2.id.toLowerCase())) {
         errors.push({
@@ -146366,7 +147147,7 @@ async function checkKnowledgeIndex(knowledgeDir) {
     const name2 = pathValue.includes("/") ? pathValue.slice(pathValue.lastIndexOf("/") + 1) : pathValue;
     if (!name2.endsWith(".md")) {
       errors.push({
-        dir: `${(0, import_node_path17.basename)(knowledgeDir)}/`,
+        dir: `${(0, import_node_path19.basename)(knowledgeDir)}/`,
         message: `"${pathValue}" is not a .md file - only markdown files belong in docyrus/knowledge/`
       });
     }
@@ -146380,7 +147161,7 @@ async function checkKnowledgeIndex(knowledgeDir) {
     }
   }
   for (const dir of dirs) {
-    const dirName = dir === "" ? (0, import_node_path17.basename)(knowledgeDir) : dir.split("/").pop() || (0, import_node_path17.basename)(knowledgeDir);
+    const dirName = dir === "" ? (0, import_node_path19.basename)(knowledgeDir) : dir.split("/").pop() || (0, import_node_path19.basename)(knowledgeDir);
     const indexFileName = dirName.endsWith(".md") ? dirName : `${dirName}.md`;
     const indexRelPath = dir === "" ? indexFileName : `${dir}/${indexFileName}`;
     const prefix = dir === "" ? "" : `${dir}/`;
@@ -146389,11 +147170,11 @@ async function checkKnowledgeIndex(knowledgeDir) {
     if (children.length === 0) {
       continue;
     }
-    const indexFullPath = (0, import_node_path17.join)(knowledgeDir, indexRelPath);
-    const displayDir = dir === "" ? `${(0, import_node_path17.basename)(knowledgeDir)}/` : `${dir}/`;
+    const indexFullPath = (0, import_node_path19.join)(knowledgeDir, indexRelPath);
+    const displayDir = dir === "" ? `${(0, import_node_path19.basename)(knowledgeDir)}/` : `${dir}/`;
     let content3;
     try {
-      content3 = await (0, import_promises13.readFile)(indexFullPath, "utf8");
+      content3 = await (0, import_promises15.readFile)(indexFullPath, "utf8");
     } catch {
       errors.push({
         dir: displayDir,
@@ -146429,12 +147210,12 @@ ${indexSnippet(missing)}`,
   return errors;
 }
 async function checkKnowledgeSections(knowledgeDir) {
-  const projectRoot = (0, import_node_path17.dirname)((0, import_node_path17.dirname)(knowledgeDir));
+  const projectRoot = (0, import_node_path19.dirname)((0, import_node_path19.dirname)(knowledgeDir));
   const errors = [];
   for (const filePath of await listKnowledgeFiles(knowledgeDir)) {
-    const content3 = await (0, import_promises13.readFile)(filePath, "utf8");
+    const content3 = await (0, import_promises15.readFile)(filePath, "utf8");
     const sections = flattenSections(parseSections(filePath, content3, projectRoot));
-    const displayPath = (0, import_node_path17.relative)(process.cwd(), filePath);
+    const displayPath = (0, import_node_path19.relative)(process.cwd(), filePath);
     for (const section2 of sections) {
       if (!section2.firstParagraph) {
         errors.push({
@@ -146489,7 +147270,7 @@ function formatKnowledgeIndexErrors(errors, styler) {
 
 // src/knowledge/audit.ts
 var import_node_child_process4 = require("node:child_process");
-var import_node_fs10 = require("node:fs");
+var import_node_fs12 = require("node:fs");
 init_graph();
 function runGit(projectRoot, args2) {
   return new Promise((resolve2) => {
@@ -146624,7 +147405,7 @@ async function analyzeKnowledgeImpacts(params) {
   const changedFiles = await getChangedFiles(params.projectRoot, params.mode);
   const knowledgeChangedFiles = changedFiles.filter((filePath) => filePath.startsWith("docyrus/knowledge/"));
   const diffStats = await getDiffStats(params.projectRoot, params.mode);
-  if (!params.knowledgeDir || !(0, import_node_fs10.existsSync)(params.knowledgeDir)) {
+  if (!params.knowledgeDir || !(0, import_node_fs12.existsSync)(params.knowledgeDir)) {
     return {
       ok: true,
       mode: params.mode,
@@ -146730,7 +147511,7 @@ async function analyzeKnowledgeImpacts(params) {
   };
 }
 async function analyzeKnowledgeDoctor(params) {
-  if (!params.knowledgeDir || !(0, import_node_fs10.existsSync)(params.knowledgeDir)) {
+  if (!params.knowledgeDir || !(0, import_node_fs12.existsSync)(params.knowledgeDir)) {
     return {
       ok: false,
       warnings: [{
@@ -146890,7 +147671,8 @@ async function getStopReason(knowledgeDir) {
   const code = await checkKnowledgeCodeRefs(knowledgeDir);
   const indexErrors = await checkKnowledgeIndex(knowledgeDir);
   const sectionErrors = await checkKnowledgeSections(knowledgeDir);
-  const totalErrors = markdown.errors.length + code.errors.length + indexErrors.length + sectionErrors.length;
+  const projectPlanErrors = await validateProjectPlanGraph(process.cwd());
+  const totalErrors = markdown.errors.length + code.errors.length + indexErrors.length + sectionErrors.length + projectPlanErrors.errors.length;
   const audit = await analyzeKnowledgeImpacts({
     projectRoot: process.cwd(),
     knowledgeDir,
@@ -146903,6 +147685,9 @@ async function getStopReason(knowledgeDir) {
   if (totalErrors > 0) {
     parts2.push(`docyrus knowledge check failed with ${totalErrors} error${totalErrors === 1 ? "" : "s"}.`);
   }
+  for (const error48 of projectPlanErrors.errors) {
+    parts2.push(error48.message);
+  }
   for (const error48 of audit.blockingErrors) {
     parts2.push(error48.message);
   }
@@ -147052,6 +147837,7 @@ function createKnowledgeCli(dependencies) {
       maybePrintHuman(context, [
         `Knowledge graph ready at ${result.knowledgeDir}`,
         `knowledge.md: ${result.knowledgeFileStatus}`,
+        `project-plan: ${result.projectPlanGraphPath}`,
         `AGENTS.md: ${result.agentsStatus}`,
         `CLAUDE.md: ${result.claudeStatus}`,
         `.cursor/rules/docyrus-knowledge.md: ${result.cursorRulesStatus}`,
@@ -147079,8 +147865,10 @@ function createKnowledgeCli(dependencies) {
         root: process.cwd(),
         brief: context.args.brief
       });
+      const projectPlan = await syncProjectPlanSectionsFromKnowledge(process.cwd());
       maybePrintHuman(context, [
-        `Generated starter knowledge under ${(0, import_node_path18.join)(process.cwd(), "docyrus", "knowledge")}`,
+        `Generated starter knowledge under ${(0, import_node_path20.join)(process.cwd(), "docyrus", "knowledge")}`,
+        `project-plan: ${projectPlan.graphPath}`,
         `root: ${result.files.rootKnowledgeStatus}`,
         `architecture: ${result.files.architectureStatus}`,
         `features: ${result.files.featuresStatus}`,
@@ -147105,17 +147893,19 @@ function createKnowledgeCli(dependencies) {
       const codeRefs = await checkKnowledgeCodeRefs(knowledgeContext.knowledgeDir);
       const indexErrors = await checkKnowledgeIndex(knowledgeContext.knowledgeDir);
       const sectionErrors = await checkKnowledgeSections(knowledgeContext.knowledgeDir);
+      const projectPlan = await validateProjectPlanGraph(process.cwd());
       const fileStats = { ...markdown.files };
       for (const [extension2, count] of Object.entries(codeRefs.files)) {
         fileStats[extension2] = (fileStats[extension2] || 0) + count;
       }
-      const totalErrors = markdown.errors.length + codeRefs.errors.length + indexErrors.length + sectionErrors.length;
+      const totalErrors = markdown.errors.length + codeRefs.errors.length + indexErrors.length + sectionErrors.length + projectPlan.errors.length;
       const human = [
         formatKnowledgeFileStats(fileStats, knowledgeContext.styler),
         ...formatKnowledgeCheckErrors(markdown.errors, knowledgeContext.styler),
         ...formatKnowledgeCheckErrors(codeRefs.errors, knowledgeContext.styler),
         ...formatKnowledgeIndexErrors(indexErrors, knowledgeContext.styler),
         ...formatKnowledgeCheckErrors(sectionErrors, knowledgeContext.styler),
+        ...projectPlan.errors.map((error48) => `- ${knowledgeContext.styler.cyan("docyrus/project-plan/project-plan.json")}: ${knowledgeContext.styler.red(error48.message)}`),
         totalErrors === 0 ? knowledgeContext.styler.green("All knowledge checks passed") : knowledgeContext.styler.red(`${totalErrors} error${totalErrors === 1 ? "" : "s"} found`)
       ].join("\n");
       maybePrintHuman(context, human);
@@ -147128,7 +147918,8 @@ function createKnowledgeCli(dependencies) {
             markdown: markdown.errors,
             codeRefs: codeRefs.errors,
             index: indexErrors,
-            sections: sectionErrors
+            sections: sectionErrors,
+            projectPlan: projectPlan.errors
           },
           files: fileStats,
           ok: totalErrors === 0
@@ -147453,9 +148244,10 @@ function createKnowledgeCli(dependencies) {
         markdown: await checkKnowledgeMarkdown(knowledgeContext.knowledgeDir),
         codeRefs: await checkKnowledgeCodeRefs(knowledgeContext.knowledgeDir),
         index: await checkKnowledgeIndex(knowledgeContext.knowledgeDir),
-        sections: await checkKnowledgeSections(knowledgeContext.knowledgeDir)
+        sections: await checkKnowledgeSections(knowledgeContext.knowledgeDir),
+        projectPlan: await validateProjectPlanGraph(process.cwd())
       } : null;
-      const blockingCheckErrors = checkResult ? checkResult.markdown.errors.length + checkResult.codeRefs.errors.length + checkResult.index.length + checkResult.sections.length : 0;
+      const blockingCheckErrors = checkResult ? checkResult.markdown.errors.length + checkResult.codeRefs.errors.length + checkResult.index.length + checkResult.sections.length + checkResult.projectPlan.errors.length : 0;
       const ok3 = blockingCheckErrors === 0 && audit.blockingErrors.length === 0;
       const payload = {
         ok: ok3,
@@ -147463,7 +148255,8 @@ function createKnowledgeCli(dependencies) {
           markdown: checkResult.markdown.errors,
           codeRefs: checkResult.codeRefs.errors,
           index: checkResult.index,
-          sections: checkResult.sections
+          sections: checkResult.sections,
+          projectPlan: checkResult.projectPlan.errors
         } : null,
         audit
       };
@@ -147537,8 +148330,10 @@ function createKnowledgeCli(dependencies) {
         brief: context.args.brief,
         targetSectionIds: sectionIds
       });
+      const projectPlan = await syncProjectPlanSectionsFromKnowledge(process.cwd());
       maybePrintHuman(context, [
         `Refreshed managed knowledge files.`,
+        `project-plan: ${projectPlan.graphPath}`,
         `Targets: ${sectionIds.length > 0 ? sectionIds.join(", ") : "all starter files"}`,
         `root: ${result.files.rootKnowledgeStatus}`,
         `architecture: ${result.files.architectureStatus}`,
@@ -147552,6 +148347,8 @@ function createKnowledgeCli(dependencies) {
         authStore: dependencies.authStore,
         payload: {
           ...result,
+          projectPlanGraphPath: projectPlan.graphPath,
+          projectPlanMarkdownPath: projectPlan.markdownPath,
           targetSectionIds: sectionIds
         }
       });
@@ -147599,7 +148396,7 @@ function createKnowledgeCli(dependencies) {
         settingsRootPath: dependencies.settingsPaths.rootPath
       });
       const payload = {
-        id: (0, import_node_crypto4.randomUUID)(),
+        id: (0, import_node_crypto6.randomUUID)(),
         projectRoot,
         knowledgeDir,
         settingsScope: dependencies.settingsPaths.scope,
@@ -147644,9 +148441,617 @@ function createKnowledgeCli(dependencies) {
   return knowledgeCli;
 }
 
+// src/commands/projectPlanCommands.ts
+var import_node_fs14 = require("node:fs");
+var import_node_path22 = __toESM(require("node:path"));
+init_graph();
+
+// src/project-plan/artifactSync.ts
+var import_node_fs13 = require("node:fs");
+var import_promises16 = __toESM(require("node:fs/promises"));
+var import_node_path21 = __toESM(require("node:path"));
+var PLAN_FILE_NAME = "PLAN.md";
+var ARCHITECT_PLAN_JSON_FILE_NAME = "data-sources.plan.json";
+function normalizeMarkdownSectionName(value2) {
+  return value2.trim().toLowerCase().replace(/\s+/gu, " ");
+}
+function parseBulletValue(line) {
+  const trimmed = line.trim();
+  if (!trimmed) {
+    return null;
+  }
+  if (/^[-*]\s+/u.test(trimmed)) {
+    return trimmed.replace(/^[-*]\s+/u, "").trim() || null;
+  }
+  if (/^\d+\.\s+/u.test(trimmed)) {
+    return trimmed.replace(/^\d+\.\s+/u, "").trim() || null;
+  }
+  return null;
+}
+function parseMarkdownPlan(markdown) {
+  const buckets = {
+    summary: [],
+    implementationChanges: [],
+    testPlan: [],
+    assumptions: []
+  };
+  let current = null;
+  for (const rawLine of markdown.split(/\r?\n/gu)) {
+    const line = rawLine.trim();
+    if (!line) {
+      continue;
+    }
+    if (line.startsWith("## ")) {
+      const heading2 = normalizeMarkdownSectionName(line.slice(3));
+      current = heading2 === "summary" ? "summary" : heading2 === "implementation changes" ? "implementationChanges" : heading2 === "test plan" ? "testPlan" : heading2 === "assumptions" ? "assumptions" : null;
+      continue;
+    }
+    if (!current) {
+      continue;
+    }
+    const parsedBullet = parseBulletValue(line);
+    buckets[current].push(parsedBullet || line);
+  }
+  return buckets;
+}
+function classifyImplementationTaskType(taskText, fallbackTitle) {
+  const text3 = `${fallbackTitle} ${taskText}`.toLowerCase();
+  if (/(bug|fix|issue|regression|error|failure)/u.test(text3)) {
+    return "bug-fix";
+  }
+  if (/(crud|query|list|create|update|delete|docyrus|api)/u.test(text3)) {
+    return "work";
+  }
+  return "new-implementation";
+}
+function classifyTestTaskType(taskText) {
+  const text3 = taskText.toLowerCase();
+  if (/(browser|playwright|page|ui|journey|flow|automation)/u.test(text3)) {
+    return "browser-automation-test";
+  }
+  return "api-test";
+}
+function isLikelyUserTask(taskText) {
+  return /(manual|user|approval|credential|login|physical|real world|install locally|access)/u.test(taskText.toLowerCase());
+}
+function uniqueNonEmpty(values) {
+  return [...new Set(values.map((value2) => value2.trim()).filter(Boolean))];
+}
+async function readArchitectPlanMarkdown(artifactDir) {
+  const planPath = import_node_path21.default.join(artifactDir, PLAN_FILE_NAME);
+  if (!(0, import_node_fs13.existsSync)(planPath)) {
+    return null;
+  }
+  return await import_promises16.default.readFile(planPath, "utf8");
+}
+async function readArchitectPlanJson(artifactDir) {
+  const jsonPath = import_node_path21.default.join(artifactDir, ARCHITECT_PLAN_JSON_FILE_NAME);
+  if (!(0, import_node_fs13.existsSync)(jsonPath)) {
+    return null;
+  }
+  return JSON.parse(await import_promises16.default.readFile(jsonPath, "utf8"));
+}
+async function upsertProjectPlanFromPlanArtifact(params) {
+  const routes = await resolveDefaultProjectPlanRoutes(params.root);
+  if (!(0, import_node_fs13.existsSync)(params.artifactPath)) {
+    return {
+      ok: false,
+      updatedFeatureIds: [],
+      updatedTaskIds: [],
+      warnings: [`Plan artifact ${params.artifactPath} does not exist.`]
+    };
+  }
+  const markdown = await import_promises16.default.readFile(params.artifactPath, "utf8");
+  const parsed = parseMarkdownPlan(markdown);
+  const title = params.task?.trim() || parsed.summary[0] || "Planned work";
+  const warnings = [];
+  const updatedFeatureIds = [];
+  const updatedTaskIds = [];
+  const deliveryFeature = await upsertProjectPlanFeature({
+    root: params.root,
+    sectionId: routes.featuresSectionId,
+    title,
+    summary: parsed.summary[0] || ""
+  });
+  updatedFeatureIds.push(deliveryFeature.id);
+  const implementationItems = uniqueNonEmpty(parsed.implementationChanges);
+  const implementationTaskSource = implementationItems.length > 0 ? implementationItems : [title];
+  for (const item of implementationTaskSource) {
+    const task = await upsertProjectPlanTask({
+      root: params.root,
+      featureId: deliveryFeature.id,
+      title: item,
+      summary: item,
+      type: classifyImplementationTaskType(item, title),
+      assignee: isLikelyUserTask(item) ? "user" : "agent",
+      status: "planned",
+      acceptanceCriteria: []
+    });
+    updatedTaskIds.push(task.id);
+  }
+  const testItems = uniqueNonEmpty(parsed.testPlan);
+  if (testItems.length > 0) {
+    const testingFeature = await upsertProjectPlanFeature({
+      root: params.root,
+      sectionId: routes.testingSectionId,
+      title: `${title} tests`,
+      summary: parsed.testPlan[0] || ""
+    });
+    updatedFeatureIds.push(testingFeature.id);
+    for (const item of testItems) {
+      const task = await upsertProjectPlanTask({
+        root: params.root,
+        featureId: testingFeature.id,
+        title: item,
+        summary: item,
+        type: classifyTestTaskType(item),
+        assignee: "agent",
+        status: "planned",
+        acceptanceCriteria: []
+      });
+      updatedTaskIds.push(task.id);
+    }
+  }
+  const userFollowUps = uniqueNonEmpty(parsed.assumptions.filter((item) => isLikelyUserTask(item)));
+  if (userFollowUps.length > 0) {
+    const workflowsFeature = await upsertProjectPlanFeature({
+      root: params.root,
+      sectionId: routes.workflowsSectionId,
+      title: `${title} follow-ups`,
+      summary: userFollowUps[0] || ""
+    });
+    updatedFeatureIds.push(workflowsFeature.id);
+    for (const item of userFollowUps) {
+      const task = await upsertProjectPlanTask({
+        root: params.root,
+        featureId: workflowsFeature.id,
+        title: item,
+        summary: item,
+        type: "work",
+        assignee: "user",
+        status: "planned",
+        acceptanceCriteria: []
+      });
+      updatedTaskIds.push(task.id);
+    }
+  }
+  if (implementationItems.length === 0) {
+    warnings.push("Plan artifact did not include explicit Implementation Changes bullets; created a single delivery task from the plan title.");
+  }
+  return {
+    ok: true,
+    updatedFeatureIds: uniqueNonEmpty(updatedFeatureIds),
+    updatedTaskIds: uniqueNonEmpty(updatedTaskIds),
+    warnings
+  };
+}
+function normalizeArchitectPhaseTitle(phase, fallbackIndex) {
+  if (typeof phase === "string") {
+    return {
+      title: phase,
+      summary: phase
+    };
+  }
+  return {
+    title: phase.title?.trim() || `Architect phase ${fallbackIndex + 1}`,
+    summary: phase.summary?.trim() || phase.title?.trim() || `Architect phase ${fallbackIndex + 1}`
+  };
+}
+async function upsertProjectPlanFromArchitectArtifact(params) {
+  const routes = await resolveDefaultProjectPlanRoutes(params.root);
+  const warnings = [];
+  const updatedFeatureIds = [];
+  const updatedTaskIds = [];
+  const architectJson = await readArchitectPlanJson(params.artifactDir);
+  const architectMarkdown = await readArchitectPlanMarkdown(params.artifactDir);
+  const parsedMarkdown = architectMarkdown ? parseMarkdownPlan(architectMarkdown) : null;
+  const title = params.brief?.trim() || architectJson?.brief?.trim() || "Architected work";
+  const architectureFeature = await upsertProjectPlanFeature({
+    root: params.root,
+    sectionId: routes.architectureSectionId,
+    title,
+    summary: parsedMarkdown?.summary[0] || ""
+  });
+  updatedFeatureIds.push(architectureFeature.id);
+  if (architectJson?.newDataSources && architectJson.newDataSources.length > 0) {
+    const dataSourceNames = architectJson.newDataSources.map((item) => item.title || item.name || item.slug).filter((value2) => typeof value2 === "string" && value2.trim().length > 0);
+    if (dataSourceNames.length > 0) {
+      const task = await upsertProjectPlanTask({
+        root: params.root,
+        featureId: architectureFeature.id,
+        title: `Design and apply data source changes: ${dataSourceNames.join(", ")}`,
+        summary: `Architected data sources: ${dataSourceNames.join(", ")}`,
+        type: "new-implementation",
+        assignee: "agent",
+        status: "planned",
+        acceptanceCriteria: []
+      });
+      updatedTaskIds.push(task.id);
+    }
+  }
+  const phases = architectJson?.applyPhases || [];
+  if (phases.length > 0) {
+    for (const [index2, phase] of phases.entries()) {
+      const normalized = normalizeArchitectPhaseTitle(phase, index2);
+      const isVerification = /verification/u.test(normalized.title.toLowerCase());
+      const task = await upsertProjectPlanTask({
+        root: params.root,
+        featureId: architectureFeature.id,
+        title: normalized.title,
+        summary: normalized.summary,
+        type: isVerification ? "api-test" : "new-implementation",
+        assignee: "agent",
+        status: "planned",
+        acceptanceCriteria: []
+      });
+      updatedTaskIds.push(task.id);
+    }
+  }
+  const architectureItems = uniqueNonEmpty(parsedMarkdown?.implementationChanges || []);
+  if (architectureItems.length > 0) {
+    for (const item of architectureItems) {
+      const task = await upsertProjectPlanTask({
+        root: params.root,
+        featureId: architectureFeature.id,
+        title: item,
+        summary: item,
+        type: /crud|query|docyrus|api/u.test(item.toLowerCase()) ? "work" : "new-implementation",
+        assignee: isLikelyUserTask(item) ? "user" : "agent",
+        status: "planned",
+        acceptanceCriteria: []
+      });
+      updatedTaskIds.push(task.id);
+    }
+  }
+  if (architectMarkdown) {
+    const testItems = uniqueNonEmpty(parsedMarkdown?.testPlan || []);
+    if (testItems.length > 0) {
+      const testingFeature = await upsertProjectPlanFeature({
+        root: params.root,
+        sectionId: routes.testingSectionId,
+        title: `${title} verification`,
+        summary: testItems[0] || ""
+      });
+      updatedFeatureIds.push(testingFeature.id);
+      for (const item of testItems) {
+        const task = await upsertProjectPlanTask({
+          root: params.root,
+          featureId: testingFeature.id,
+          title: item,
+          summary: item,
+          type: classifyTestTaskType(item),
+          assignee: "agent",
+          status: "planned",
+          acceptanceCriteria: []
+        });
+        updatedTaskIds.push(task.id);
+      }
+    }
+    const followUps = uniqueNonEmpty((parsedMarkdown?.assumptions || []).filter((item) => isLikelyUserTask(item)));
+    if (followUps.length > 0) {
+      const workflowsFeature = await upsertProjectPlanFeature({
+        root: params.root,
+        sectionId: routes.workflowsSectionId,
+        title: `${title} manual follow-ups`,
+        summary: followUps[0] || ""
+      });
+      updatedFeatureIds.push(workflowsFeature.id);
+      for (const item of followUps) {
+        const task = await upsertProjectPlanTask({
+          root: params.root,
+          featureId: workflowsFeature.id,
+          title: item,
+          summary: item,
+          type: "work",
+          assignee: "user",
+          status: "planned",
+          acceptanceCriteria: []
+        });
+        updatedTaskIds.push(task.id);
+      }
+    }
+  } else {
+    warnings.push(`Architect artifact ${import_node_path21.default.join(params.artifactDir, PLAN_FILE_NAME)} was not found; project plan sync used JSON-only inputs.`);
+  }
+  return {
+    ok: true,
+    updatedFeatureIds: uniqueNonEmpty(updatedFeatureIds),
+    updatedTaskIds: uniqueNonEmpty(updatedTaskIds),
+    warnings
+  };
+}
+
+// src/commands/projectPlanCommands.ts
+function hasStructuredOutputOverride3(argv) {
+  return argv.some((token) => token === "--json" || token === "--verbose" || token === "--format");
+}
+function maybePrintHuman2(context, text3) {
+  if (context.agent || hasStructuredOutputOverride3(process.argv.slice(2)) || !text3) {
+    return;
+  }
+  process.stdout.write(text3.endsWith("\n") ? text3 : `${text3}
+`);
+}
+function formatProjectPlanErrors(errors) {
+  if (errors.length === 0) {
+    return "Project plan check passed.";
+  }
+  return errors.map((error48) => `- [${error48.code}] ${error48.message}${error48.target ? ` (${error48.target})` : ""}`).join("\n");
+}
+function parseOptionalStringArray(raw, source) {
+  if (!raw?.trim()) {
+    return [];
+  }
+  const parsed = parseJsonData(raw, source);
+  if (!Array.isArray(parsed) || parsed.some((value2) => typeof value2 !== "string")) {
+    throw new UserInputError(`${source} must be a JSON string array.`);
+  }
+  return parsed.map((value2) => value2.trim()).filter(Boolean);
+}
+async function wrapPayload(dependencies, payload) {
+  const apiBaseUrl = await dependencies.environmentConfigService.getActiveApiBaseUrl();
+  return await injectContext({
+    apiBaseUrl,
+    authStore: dependencies.authStore,
+    payload
+  });
+}
+function createProjectPlanCli(dependencies) {
+  const projectPlanCli = Cli_exports.create("project-plan", {
+    description: "Repo-tracked project plan graph commands",
+    env: EnvSchema
+  });
+  projectPlanCli.command("show", {
+    description: "Show the current project plan hierarchy",
+    env: EnvSchema,
+    outputPolicy: "agent-only",
+    run: async (context) => {
+      const root = process.cwd();
+      const graph = await readProjectPlanGraph(root);
+      const hierarchy = await buildProjectPlanHierarchy(root, graph);
+      maybePrintHuman2(context, [
+        `projectPlanDir: ${resolveProjectPlanDirectory(root)}`,
+        `sections: ${hierarchy.sections.length}`,
+        `features: ${graph.features.length}`,
+        `tasks: ${graph.tasks.length}`
+      ].join("\n"));
+      return await wrapPayload(dependencies, {
+        graph,
+        hierarchy,
+        graphPath: resolveProjectPlanGraphPath(root),
+        markdownPath: resolveProjectPlanMarkdownPath(root)
+      });
+    }
+  });
+  projectPlanCli.command("check", {
+    description: "Validate the canonical project plan graph against the knowledge graph",
+    env: EnvSchema,
+    outputPolicy: "agent-only",
+    run: async (context) => {
+      const result = await validateProjectPlanGraph(process.cwd());
+      maybePrintHuman2(context, formatProjectPlanErrors(result.errors));
+      return await wrapPayload(dependencies, result);
+    }
+  });
+  projectPlanCli.command("sync-sections", {
+    description: "Seed or re-sync project plan sections from current knowledge section ids",
+    env: EnvSchema,
+    outputPolicy: "agent-only",
+    run: async (context) => {
+      const result = await syncProjectPlanSectionsFromKnowledge(process.cwd());
+      maybePrintHuman2(context, `Synced project plan sections to ${result.graph.sections.length} knowledge section ids.`);
+      return await wrapPayload(dependencies, {
+        graphPath: result.graphPath,
+        markdownPath: result.markdownPath,
+        sectionCount: result.graph.sections.length
+      });
+    }
+  });
+  projectPlanCli.command("ensure", {
+    description: "Ensure the canonical project plan graph exists",
+    env: EnvSchema,
+    outputPolicy: "agent-only",
+    run: async (context) => {
+      const result = await ensureProjectPlanGraph(process.cwd());
+      maybePrintHuman2(context, `Project plan ready at ${result.graphPath}`);
+      return await wrapPayload(dependencies, {
+        graphPath: result.graphPath,
+        markdownPath: result.markdownPath,
+        graph: result.graph
+      });
+    }
+  });
+  projectPlanCli.command("upsert-feature", {
+    description: "Create or update a canonical feature",
+    env: EnvSchema,
+    outputPolicy: "agent-only",
+    options: external_exports.object({
+      featureId: external_exports.string().optional().describe("Optional existing feature id"),
+      sectionId: external_exports.string().min(1).describe("Knowledge 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")
+    }),
+    run: async (context) => {
+      const feature = await upsertProjectPlanFeature({
+        root: process.cwd(),
+        featureId: context.options.featureId,
+        sectionId: context.options.sectionId,
+        title: context.options.title,
+        slug: context.options.slug,
+        summary: context.options.summary
+      });
+      maybePrintHuman2(context, `Upserted feature ${feature.id}`);
+      return await wrapPayload(dependencies, feature);
+    }
+  });
+  projectPlanCli.command("upsert-task", {
+    description: "Create or update a canonical task",
+    env: EnvSchema,
+    outputPolicy: "agent-only",
+    options: external_exports.object({
+      taskId: external_exports.string().optional().describe("Optional existing task id"),
+      featureId: external_exports.string().min(1).describe("Owning feature id"),
+      sectionId: external_exports.string().optional().describe("Optional explicit section id; defaults to feature section"),
+      title: external_exports.string().min(1).describe("Task title"),
+      summary: external_exports.string().optional().describe("Task summary"),
+      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")
+    }),
+    run: async (context) => {
+      const task = await upsertProjectPlanTask({
+        root: process.cwd(),
+        taskId: context.options.taskId,
+        featureId: context.options.featureId,
+        sectionId: context.options.sectionId,
+        title: context.options.title,
+        summary: context.options.summary,
+        type: context.options.type,
+        assignee: context.options.assignee,
+        status: context.options.status,
+        acceptanceCriteria: parseOptionalStringArray(context.options.acceptanceCriteria, "--acceptanceCriteria")
+      });
+      maybePrintHuman2(context, `Upserted task ${task.id}`);
+      return await wrapPayload(dependencies, task);
+    }
+  });
+  projectPlanCli.command("get-task", {
+    description: "Get a task with linked local subtasks",
+    env: EnvSchema,
+    outputPolicy: "agent-only",
+    options: external_exports.object({
+      taskId: external_exports.string().min(1).describe("Task id")
+    }),
+    run: async (context) => {
+      const task = await getProjectPlanTask({
+        root: process.cwd(),
+        taskId: context.options.taskId
+      });
+      if (!task) {
+        throw new UserInputError(`Task "${context.options.taskId}" not found.`);
+      }
+      maybePrintHuman2(context, `${task.id}: ${task.title}`);
+      return await wrapPayload(dependencies, task);
+    }
+  });
+  projectPlanCli.command("set-task-status", {
+    description: "Update a canonical task status",
+    env: EnvSchema,
+    outputPolicy: "agent-only",
+    options: external_exports.object({
+      taskId: external_exports.string().min(1).describe("Task id"),
+      status: external_exports.enum(PROJECT_TASK_STATUSES).describe("Next status")
+    }),
+    run: async (context) => {
+      const task = await updateProjectPlanTaskStatus({
+        root: process.cwd(),
+        taskId: context.options.taskId,
+        status: context.options.status
+      });
+      maybePrintHuman2(context, `Updated ${task.id} to ${task.status}`);
+      return await wrapPayload(dependencies, task);
+    }
+  });
+  projectPlanCli.command("create-linked-todo", {
+    description: "Create a local .pi/todos subtask linked to a canonical task",
+    env: EnvSchema,
+    outputPolicy: "agent-only",
+    options: external_exports.object({
+      taskId: external_exports.string().min(1).describe("Canonical task id"),
+      title: external_exports.string().optional().describe("Optional todo title; defaults to task title"),
+      body: external_exports.string().optional().describe("Optional todo body")
+    }),
+    run: async (context) => {
+      const task = await getProjectPlanTask({
+        root: process.cwd(),
+        taskId: context.options.taskId
+      });
+      if (!task) {
+        throw new UserInputError(`Task "${context.options.taskId}" not found.`);
+      }
+      if (task.assignee !== "agent") {
+        throw new UserInputError(`Task "${task.id}" is assigned to "${task.assignee}" and cannot own local agent subtasks.`);
+      }
+      const linkedTodo = await createLinkedTodo({
+        root: process.cwd(),
+        parentTaskId: task.id,
+        title: context.options.title?.trim() || task.title,
+        body: context.options.body?.trim() || task.summary
+      });
+      maybePrintHuman2(context, `Created linked todo ${linkedTodo.id} for task ${task.id}`);
+      return await wrapPayload(dependencies, linkedTodo);
+    }
+  });
+  projectPlanCli.command("upsert-from-plan", {
+    description: "Internal command used by /plan to sync an ended planning artifact into the canonical graph",
+    env: EnvSchema,
+    outputPolicy: "agent-only",
+    options: external_exports.object({
+      artifactPath: external_exports.string().min(1).describe("Path to the saved plan markdown artifact"),
+      task: external_exports.string().optional().describe("Original planning task")
+    }),
+    run: async (context) => {
+      const result = await upsertProjectPlanFromPlanArtifact({
+        root: process.cwd(),
+        artifactPath: context.options.artifactPath,
+        task: context.options.task
+      });
+      maybePrintHuman2(context, `Synced plan artifact with ${result.updatedTaskIds.length} task updates.`);
+      return await wrapPayload(dependencies, result);
+    }
+  });
+  projectPlanCli.command("upsert-from-architect", {
+    description: "Internal command used by /architect to sync architect artifacts into the canonical graph",
+    env: EnvSchema,
+    outputPolicy: "agent-only",
+    options: external_exports.object({
+      artifactDir: external_exports.string().min(1).describe("Architect artifact directory"),
+      brief: external_exports.string().optional().describe("Original architect brief")
+    }),
+    run: async (context) => {
+      const result = await upsertProjectPlanFromArchitectArtifact({
+        root: process.cwd(),
+        artifactDir: context.options.artifactDir,
+        brief: context.options.brief
+      });
+      maybePrintHuman2(context, `Synced architect artifact with ${result.updatedTaskIds.length} task updates.`);
+      return await wrapPayload(dependencies, result);
+    }
+  });
+  projectPlanCli.command("config", {
+    description: "Show resolved project-plan and knowledge graph paths",
+    env: EnvSchema,
+    outputPolicy: "agent-only",
+    run: async (context) => {
+      const root = process.cwd();
+      const knowledgeDir = import_node_path22.default.join(root, "docyrus", "knowledge");
+      const knowledgeSectionCount = (0, import_node_fs14.existsSync)(knowledgeDir) ? flattenSections(await loadAllSections(knowledgeDir)).length : 0;
+      const payload = {
+        projectRoot: root,
+        knowledgeDir: (0, import_node_fs14.existsSync)(knowledgeDir) ? knowledgeDir : null,
+        projectPlanDir: resolveProjectPlanDirectory(root),
+        graphPath: resolveProjectPlanGraphPath(root),
+        markdownPath: resolveProjectPlanMarkdownPath(root),
+        knowledgeSectionCount
+      };
+      maybePrintHuman2(context, [
+        `knowledgeDir: ${payload.knowledgeDir || "(not found)"}`,
+        `projectPlanDir: ${payload.projectPlanDir}`,
+        `graphPath: ${payload.graphPath}`,
+        `markdownPath: ${payload.markdownPath}`,
+        `knowledgeSections: ${payload.knowledgeSectionCount}`
+      ].join("\n"));
+      return await wrapPayload(dependencies, payload);
+    }
+  });
+  return projectPlanCli;
+}
+
 // src/services/studioPayload.ts
-var import_promises14 = require("node:fs/promises");
-var import_node_path19 = require("node:path");
+var import_promises17 = require("node:fs/promises");
+var import_node_path23 = require("node:path");
 async function readStdinText3() {
   if (process.stdin.isTTY) {
     return "";
@@ -147661,7 +149066,7 @@ async function readStdinText3() {
   }
   return Buffer.concat(chunks).toString("utf8").trim();
 }
-function isRecord3(value2) {
+function isRecord4(value2) {
   return typeof value2 === "object" && value2 !== null && !Array.isArray(value2);
 }
 async function readStudioWriteInput(params) {
@@ -147669,7 +149074,7 @@ async function readStudioWriteInput(params) {
     data,
     fromFile,
     readStdin: readStdin2 = readStdinText3,
-    readFileFn = async (path3, encoding) => await (0, import_promises14.readFile)(path3, encoding)
+    readFileFn = async (path7, encoding) => await (0, import_promises17.readFile)(path7, encoding)
   } = params;
   const trimmedData = data?.trim();
   const trimmedFromFile = fromFile?.trim();
@@ -147677,7 +149082,7 @@ async function readStudioWriteInput(params) {
     throw new UserInputError("Provide either --data or --from-file, not both.");
   }
   if (trimmedFromFile) {
-    const extension2 = (0, import_node_path19.extname)(trimmedFromFile).toLowerCase();
+    const extension2 = (0, import_node_path23.extname)(trimmedFromFile).toLowerCase();
     if (extension2 && extension2 !== ".json") {
       throw new UserInputError("Studio commands support only JSON files in --from-file.");
     }
@@ -147701,7 +149106,7 @@ async function readStudioWriteInput(params) {
   return parseJsonData(stdinContent, "stdin");
 }
 function ensureObjectPayload(payload, label) {
-  if (!isRecord3(payload)) {
+  if (!isRecord4(payload)) {
     throw new UserInputError(`${label} expects a JSON object payload.`);
   }
   return payload;
@@ -147724,7 +149129,7 @@ function normalizeBatchPayload(payload, key) {
       [key]: payload
     };
   }
-  if (isRecord3(payload)) {
+  if (isRecord4(payload)) {
     if (key in payload) {
       return payload;
     }
@@ -147736,7 +149141,7 @@ function normalizeBatchPayload(payload, key) {
 }
 
 // src/services/studioResolver.ts
-function isRecord4(value2) {
+function isRecord5(value2) {
   return typeof value2 === "object" && value2 !== null;
 }
 function extractString2(record2, key) {
@@ -147745,10 +149150,10 @@ function extractString2(record2, key) {
 }
 function extractArray(payload) {
   if (Array.isArray(payload)) {
-    return payload.filter((item) => isRecord4(item));
+    return payload.filter((item) => isRecord5(item));
   }
-  if (isRecord4(payload) && Array.isArray(payload.data)) {
-    return payload.data.filter((item) => isRecord4(item));
+  if (isRecord5(payload) && Array.isArray(payload.data)) {
+    return payload.data.filter((item) => isRecord5(item));
   }
   return [];
 }
@@ -147916,11 +149321,11 @@ function requireNonEmptyObject(payload, label) {
     throw new UserInputError(`${label} payload is empty. Provide flags, --data, or --from-file.`);
   }
 }
-function isRecord5(value2) {
+function isRecord6(value2) {
   return typeof value2 === "object" && value2 !== null && !Array.isArray(value2);
 }
 function normalizeBatchUpdateFieldItem(item) {
-  if (!isRecord5(item)) {
+  if (!isRecord6(item)) {
     return item;
   }
   const normalized = {
@@ -147954,7 +149359,7 @@ function normalizeBatchUpdateFieldsPayload(payload) {
   };
 }
 function normalizeUpdateEnumItem(item) {
-  if (!isRecord5(item)) {
+  if (!isRecord6(item)) {
     return item;
   }
   if (!("enumId" in item) && typeof item.id === "string") {
@@ -148682,8 +150087,8 @@ function createStudioCli(dependencies) {
 
 // src/commands/tuiCommand.ts
 var import_node_child_process5 = require("node:child_process");
-var import_node_fs11 = require("node:fs");
-var import_node_path20 = require("node:path");
+var import_node_fs15 = require("node:fs");
+var import_node_path24 = require("node:path");
 function summarizeFailure2(result) {
   const stderr = result.stderr?.toString().trim();
   if (stderr && stderr.length > 0) {
@@ -148700,23 +150105,23 @@ function summarizeFailure2(result) {
 function resolveCliScriptPath() {
   const argvScript = process.argv[1];
   if (argvScript && argvScript.trim().length > 0) {
-    return (0, import_node_path20.isAbsolute)(argvScript) ? argvScript : (0, import_node_path20.resolve)(process.cwd(), argvScript);
+    return (0, import_node_path24.isAbsolute)(argvScript) ? argvScript : (0, import_node_path24.resolve)(process.cwd(), argvScript);
   }
   return __filename;
 }
 function resolveOpenTuiEntryPath(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
   const dirname13 = options2.dirname ?? __dirname;
-  const fileExists = options2.existsSyncFn ?? import_node_fs11.existsSync;
+  const fileExists = options2.existsSyncFn ?? import_node_fs15.existsSync;
   const candidates = [
     // Source/dev mode in monorepo. Prefer this first so Bun resolves deps via
     // apps/api-cli/node_modules in workspace runs (e.g. `pnpm docyrus tui`).
-    (0, import_node_path20.resolve)(cwd, "apps/api-cli/src/tui/opentuiMain.tsx"),
-    (0, import_node_path20.resolve)(dirname13, "../tui/opentuiMain.tsx"),
+    (0, import_node_path24.resolve)(cwd, "apps/api-cli/src/tui/opentuiMain.tsx"),
+    (0, import_node_path24.resolve)(dirname13, "../tui/opentuiMain.tsx"),
     // Dist mode (bundled command runtime)
-    (0, import_node_path20.resolve)(dirname13, "tui.mjs"),
-    (0, import_node_path20.resolve)(dirname13, "../tui.mjs"),
-    (0, import_node_path20.resolve)(cwd, "dist/apps/api-cli/tui.mjs")
+    (0, import_node_path24.resolve)(dirname13, "tui.mjs"),
+    (0, import_node_path24.resolve)(dirname13, "../tui.mjs"),
+    (0, import_node_path24.resolve)(cwd, "dist/apps/api-cli/tui.mjs")
   ];
   const resolved = candidates.find((candidate) => fileExists(candidate));
   if (!resolved) {
@@ -148857,7 +150262,7 @@ async function parseResponseBody(response) {
   }
 }
 function normalizeErrorResponse(params) {
-  const { status, path: path3, headers, body: body2 } = params;
+  const { status, path: path7, headers, body: body2 } = params;
   const bodyObject = typeof body2 === "object" && body2 !== null ? body2 : null;
   const errorCodeValue = bodyObject?.error;
   const errorDescriptionValue = bodyObject?.error_description ?? bodyObject?.message;
@@ -148867,7 +150272,7 @@ function normalizeErrorResponse(params) {
     status,
     error: errorCode,
     error_description: errorDescription,
-    path: path3,
+    path: path7,
     rate_limit_limit: headers.get("ratelimit-limit") || void 0,
     rate_limit_remaining: headers.get("ratelimit-remaining") || void 0,
     rate_limit_reset: headers.get("ratelimit-reset") || void 0,
@@ -148875,13 +150280,13 @@ function normalizeErrorResponse(params) {
     raw: body2
   };
 }
-function normalizePathForUrl(path3) {
-  return normalizeApiPath(path3);
+function normalizePathForUrl(path7) {
+  return normalizeApiPath(path7);
 }
 async function requestDocyrusApi(options2) {
   const {
     baseUrl,
-    path: path3,
+    path: path7,
     method = "GET",
     headers,
     query,
@@ -148890,7 +150295,7 @@ async function requestDocyrusApi(options2) {
     fetchFn = fetch
   } = options2;
   const normalizedBaseUrl = normalizeApiBaseUrl(baseUrl);
-  const normalizedPath = normalizePathForUrl(path3);
+  const normalizedPath = normalizePathForUrl(path7);
   const url2 = `${normalizedBaseUrl}${normalizedPath}${toQueryString(query)}`;
   const requestHeaders = {
     Accept: "application/json",
@@ -148950,12 +150355,12 @@ var ApiClient = class {
     const {
       authRequired = true,
       method = "GET",
-      path: path3,
+      path: path7,
       headers,
       query,
       body: body2
     } = options2;
-    if (!path3) {
+    if (!path7) {
       throw new UserInputError("Request path is required.");
     }
     let authToken;
@@ -148965,7 +150370,7 @@ var ApiClient = class {
     return await requestDocyrusApi({
       baseUrl: this.#apiBaseUrl,
       method,
-      path: path3,
+      path: path7,
       headers,
       query,
       body: body2,
@@ -148977,7 +150382,7 @@ var ApiClient = class {
 
 // src/services/authSession.ts
 var DEFAULT_MANUAL_ACCESS_TOKEN_EXPIRY_SECONDS = 3600;
-function isRecord6(value2) {
+function isRecord7(value2) {
   return typeof value2 === "object" && value2 !== null;
 }
 function extractRecordValue(record2, keys) {
@@ -149291,11 +150696,11 @@ var AuthSessionService = class {
       fetchFn: this.params.fetchFn
     });
     const payload = response.data;
-    const dataCandidate = isRecord6(payload) && isRecord6(payload.data) ? payload.data : payload;
-    if (!isRecord6(dataCandidate)) {
+    const dataCandidate = isRecord7(payload) && isRecord7(payload.data) ? payload.data : payload;
+    if (!isRecord7(dataCandidate)) {
       throw new AuthSessionError("Unable to parse /users/me response.");
     }
-    const tenantCandidate = isRecord6(dataCandidate.tenant) ? dataCandidate.tenant : void 0;
+    const tenantCandidate = isRecord7(dataCandidate.tenant) ? dataCandidate.tenant : void 0;
     const userId = extractString3(dataCandidate, ["id", "user_id"]);
     const email3 = extractString3(dataCandidate, ["email"]);
     const tenantId = tenantCandidate ? extractString3(tenantCandidate, ["id"]) : extractString3(dataCandidate, ["tenant_id", "tenantId"]);
@@ -149321,13 +150726,13 @@ var AuthSessionService = class {
       fetchFn: this.params.fetchFn
     });
     const payload = response.data;
-    const listCandidate = Array.isArray(payload) ? payload : isRecord6(payload) && Array.isArray(payload.data) ? payload.data : null;
+    const listCandidate = Array.isArray(payload) ? payload : isRecord7(payload) && Array.isArray(payload.data) ? payload.data : null;
     if (!listCandidate) {
       throw new AuthSessionError("Unable to parse tenant catalog response.");
     }
     const mapped = [];
     for (const item of listCandidate) {
-      if (!isRecord6(item)) {
+      if (!isRecord7(item)) {
         continue;
       }
       const tenantId = extractString3(item, ["id", "tenant_id"]);
@@ -149517,8 +150922,8 @@ var AuthSessionService = class {
 };
 
 // src/services/authStore.ts
-var import_promises15 = require("node:fs/promises");
-var import_node_path21 = require("node:path");
+var import_promises18 = require("node:fs/promises");
+var import_node_path25 = require("node:path");
 function createEmptyState() {
   return {
     version: 2,
@@ -149558,7 +150963,7 @@ var AuthStore = class {
   }
   async readState() {
     try {
-      const raw = await (0, import_promises15.readFile)(this.authFilePath, "utf8");
+      const raw = await (0, import_promises18.readFile)(this.authFilePath, "utf8");
       const parsed = JSON.parse(raw);
       const legacy = LegacyAuthSessionSchema.safeParse(parsed);
       if (legacy.success) {
@@ -149594,17 +150999,17 @@ var AuthStore = class {
       });
     }
     const normalized = normalizeState2(validated.data);
-    const directory = (0, import_node_path21.dirname)(this.authFilePath);
-    await (0, import_promises15.mkdir)(directory, {
+    const directory = (0, import_node_path25.dirname)(this.authFilePath);
+    await (0, import_promises18.mkdir)(directory, {
       recursive: true,
       mode: 448
     });
-    await (0, import_promises15.writeFile)(this.authFilePath, `${JSON.stringify(normalized, null, 2)}
+    await (0, import_promises18.writeFile)(this.authFilePath, `${JSON.stringify(normalized, null, 2)}
 `, {
       encoding: "utf8",
       mode: 384
     });
-    await (0, import_promises15.chmod)(this.authFilePath, 384);
+    await (0, import_promises18.chmod)(this.authFilePath, 384);
   }
   async getActiveProfile(apiBaseUrl) {
     const normalizedApiBaseUrl = normalizeApiBaseUrl(apiBaseUrl);
@@ -149801,15 +151206,15 @@ var AuthStore = class {
     await this.writeState(state);
   }
   async clear() {
-    await (0, import_promises15.rm)(this.authFilePath, {
+    await (0, import_promises18.rm)(this.authFilePath, {
       force: true
     });
   }
 };
 
 // src/services/environmentConfig.ts
-var import_promises16 = require("node:fs/promises");
-var import_node_path22 = require("node:path");
+var import_promises19 = require("node:fs/promises");
+var import_node_path26 = require("node:path");
 var ENVIRONMENT_ID_ALIASES = {
   "local-development": "dev",
   prod: "live"
@@ -149896,7 +151301,7 @@ var EnvironmentConfigService = class {
   configFilePath;
   async readState() {
     try {
-      const raw = await (0, import_promises16.readFile)(this.configFilePath, "utf8");
+      const raw = await (0, import_promises19.readFile)(this.configFilePath, "utf8");
       const parsed = JSON.parse(raw);
       const validated = EnvironmentConfigStateSchema.safeParse(parsed);
       if (!validated.success) {
@@ -149930,17 +151335,17 @@ var EnvironmentConfigService = class {
       });
     }
     const normalized = normalizeState3(validated.data);
-    const directory = (0, import_node_path22.dirname)(this.configFilePath);
-    await (0, import_promises16.mkdir)(directory, {
+    const directory = (0, import_node_path26.dirname)(this.configFilePath);
+    await (0, import_promises19.mkdir)(directory, {
       recursive: true,
       mode: 448
     });
-    await (0, import_promises16.writeFile)(this.configFilePath, `${JSON.stringify(normalized, null, 2)}
+    await (0, import_promises19.writeFile)(this.configFilePath, `${JSON.stringify(normalized, null, 2)}
 `, {
       encoding: "utf8",
       mode: 384
     });
-    await (0, import_promises16.chmod)(this.configFilePath, 384);
+    await (0, import_promises19.chmod)(this.configFilePath, 384);
   }
   async getActiveEnvironment() {
     const state = await this.#readStateWithDefaults();
@@ -150007,9 +151412,9 @@ var EnvironmentConfigService = class {
 
 // src/services/piAgentLauncher.ts
 var import_node_child_process6 = require("node:child_process");
-var import_node_fs12 = require("node:fs");
-var import_promises17 = require("node:fs/promises");
-var import_node_path23 = require("node:path");
+var import_node_fs16 = require("node:fs");
+var import_promises20 = require("node:fs/promises");
+var import_node_path27 = require("node:path");
 
 // src/services/spinner.ts
 var import_picocolors2 = __toESM(require_picocolors());
@@ -150055,7 +151460,7 @@ var DOCYRUS_EXTERNAL_SKILL_AGENT_IDS = [
 ];
 var DOCYRUS_EXTERNAL_SKILL_MARKER_FILE = ".docyrus-external-skills-installed.json";
 var DOCYRUS_DIFFITY_PACKAGE_SPEC = "diffity@0.9.0";
-var DOCYRUS_OFFICECLI_RELEASES_BASE_URL = "https://github.com/iOfficeAI/OfficeCli/releases/latest/download";
+var DOCYRUS_OFFICECLI_MANIFEST_FILE_NAME = "manifest.json";
 function summarizeFailure3(result, commandLabel = "Command") {
   const stderr = result.stderr?.toString().trim();
   if (stderr && stderr.length > 0) {
@@ -150072,12 +151477,12 @@ function summarizeFailure3(result, commandLabel = "Command") {
 function resolvePackagedPiResourceRoot(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
   const dirname13 = options2.dirname ?? __dirname;
-  const fileExists = options2.existsSyncFn ?? import_node_fs12.existsSync;
+  const fileExists = options2.existsSyncFn ?? import_node_fs16.existsSync;
   const candidates = [
-    (0, import_node_path23.resolve)(cwd, "apps/api-cli/resources/pi-agent"),
-    (0, import_node_path23.resolve)(dirname13, "../resources/pi-agent"),
-    (0, import_node_path23.resolve)(dirname13, "resources/pi-agent"),
-    (0, import_node_path23.resolve)(cwd, "dist/apps/api-cli/resources/pi-agent")
+    (0, import_node_path27.resolve)(cwd, "apps/api-cli/resources/pi-agent"),
+    (0, import_node_path27.resolve)(dirname13, "../resources/pi-agent"),
+    (0, import_node_path27.resolve)(dirname13, "resources/pi-agent"),
+    (0, import_node_path27.resolve)(cwd, "dist/apps/api-cli/resources/pi-agent")
   ];
   const resolved = candidates.find((candidate) => fileExists(candidate));
   if (!resolved) {
@@ -150088,7 +151493,7 @@ function resolvePackagedPiResourceRoot(options2 = {}) {
 function resolveDocyrusPiLoaderEntryPath(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
   const dirname13 = options2.dirname ?? __dirname;
-  const fileExists = options2.existsSyncFn ?? import_node_fs12.existsSync;
+  const fileExists = options2.existsSyncFn ?? import_node_fs16.existsSync;
   const seen = /* @__PURE__ */ new Set();
   const candidates = options2.candidatePaths ?? [];
   const addCandidate = (candidate) => {
@@ -150098,23 +151503,23 @@ function resolveDocyrusPiLoaderEntryPath(options2 = {}) {
     }
   };
   const collectAncestorCandidates = (startDir) => {
-    let currentDir = (0, import_node_path23.resolve)(startDir);
+    let currentDir = (0, import_node_path27.resolve)(startDir);
     while (true) {
-      addCandidate((0, import_node_path23.join)(currentDir, "dist", "apps", "api-cli", "agent-loader.js"));
-      addCandidate((0, import_node_path23.join)(currentDir, "agent-loader.js"));
-      if ((0, import_node_path23.basename)(currentDir) === "dist") {
-        addCandidate((0, import_node_path23.join)(currentDir, "apps", "api-cli", "agent-loader.js"));
+      addCandidate((0, import_node_path27.join)(currentDir, "dist", "apps", "api-cli", "agent-loader.js"));
+      addCandidate((0, import_node_path27.join)(currentDir, "agent-loader.js"));
+      if ((0, import_node_path27.basename)(currentDir) === "dist") {
+        addCandidate((0, import_node_path27.join)(currentDir, "apps", "api-cli", "agent-loader.js"));
       }
-      const parentDir = (0, import_node_path23.resolve)(currentDir, "..");
+      const parentDir = (0, import_node_path27.resolve)(currentDir, "..");
       if (parentDir === currentDir) {
         break;
       }
       currentDir = parentDir;
     }
   };
-  addCandidate((0, import_node_path23.resolve)(cwd, "dist/apps/api-cli/agent-loader.js"));
-  addCandidate((0, import_node_path23.resolve)(dirname13, "../agent-loader.js"));
-  addCandidate((0, import_node_path23.resolve)(dirname13, "agent-loader.js"));
+  addCandidate((0, import_node_path27.resolve)(cwd, "dist/apps/api-cli/agent-loader.js"));
+  addCandidate((0, import_node_path27.resolve)(dirname13, "../agent-loader.js"));
+  addCandidate((0, import_node_path27.resolve)(dirname13, "agent-loader.js"));
   collectAncestorCandidates(cwd);
   collectAncestorCandidates(dirname13);
   const resolved = candidates.find((candidate) => fileExists(candidate));
@@ -150127,27 +151532,27 @@ function resolveDocyrusCliEntryPath(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
   const dirname13 = options2.dirname ?? __dirname;
   const argv = options2.argv ?? process.argv;
-  const fileExists = options2.existsSyncFn ?? import_node_fs12.existsSync;
+  const fileExists = options2.existsSyncFn ?? import_node_fs16.existsSync;
   const seen = /* @__PURE__ */ new Set();
   const candidates = options2.candidatePaths ?? [];
   const addCandidate = (candidate) => {
     if (!candidate) {
       return;
     }
-    const resolvedCandidate = (0, import_node_path23.resolve)(candidate);
+    const resolvedCandidate = (0, import_node_path27.resolve)(candidate);
     if (!seen.has(resolvedCandidate)) {
       seen.add(resolvedCandidate);
       candidates.push(resolvedCandidate);
     }
   };
   const argvScript = argv[1]?.trim();
-  const normalizedArgvScript = argvScript ? argvScript.startsWith("/") ? argvScript : (0, import_node_path23.resolve)(cwd, argvScript) : void 0;
+  const normalizedArgvScript = argvScript ? argvScript.startsWith("/") ? argvScript : (0, import_node_path27.resolve)(cwd, argvScript) : void 0;
   if (normalizedArgvScript && normalizedArgvScript.endsWith(".js")) {
     addCandidate(normalizedArgvScript);
   }
-  addCandidate((0, import_node_path23.resolve)(cwd, "dist/apps/api-cli/main.js"));
-  addCandidate((0, import_node_path23.resolve)(dirname13, "../main.js"));
-  addCandidate((0, import_node_path23.resolve)(dirname13, "main.js"));
+  addCandidate((0, import_node_path27.resolve)(cwd, "dist/apps/api-cli/main.js"));
+  addCandidate((0, import_node_path27.resolve)(dirname13, "../main.js"));
+  addCandidate((0, import_node_path27.resolve)(dirname13, "main.js"));
   if (normalizedArgvScript) {
     addCandidate(normalizedArgvScript);
   }
@@ -150160,7 +151565,7 @@ function resolveDocyrusCliEntryPath(options2 = {}) {
 function resolveInstalledPiPackageRootPath(options2 = {}) {
   const cwd = options2.cwd ?? process.cwd();
   const dirname13 = options2.dirname ?? __dirname;
-  const fileExists = options2.existsSyncFn ?? import_node_fs12.existsSync;
+  const fileExists = options2.existsSyncFn ?? import_node_fs16.existsSync;
   const seen = /* @__PURE__ */ new Set();
   const candidates = options2.candidatePaths ?? [];
   const addCandidate = (candidate) => {
@@ -150170,33 +151575,33 @@ function resolveInstalledPiPackageRootPath(options2 = {}) {
     }
   };
   const collectAncestorCandidates = (startDir) => {
-    let currentDir = (0, import_node_path23.resolve)(startDir);
+    let currentDir = (0, import_node_path27.resolve)(startDir);
     while (true) {
-      addCandidate((0, import_node_path23.join)(currentDir, "node_modules", "@mariozechner", "pi-coding-agent", "package.json"));
-      if ((0, import_node_path23.basename)(currentDir) === "node_modules") {
-        addCandidate((0, import_node_path23.join)(currentDir, "@mariozechner", "pi-coding-agent", "package.json"));
+      addCandidate((0, import_node_path27.join)(currentDir, "node_modules", "@mariozechner", "pi-coding-agent", "package.json"));
+      if ((0, import_node_path27.basename)(currentDir) === "node_modules") {
+        addCandidate((0, import_node_path27.join)(currentDir, "@mariozechner", "pi-coding-agent", "package.json"));
       }
-      const parentDir = (0, import_node_path23.resolve)(currentDir, "..");
+      const parentDir = (0, import_node_path27.resolve)(currentDir, "..");
       if (parentDir === currentDir) {
         break;
       }
       currentDir = parentDir;
     }
   };
-  addCandidate((0, import_node_path23.resolve)(cwd, "apps/api-cli/node_modules/@mariozechner/pi-coding-agent/package.json"));
-  addCandidate((0, import_node_path23.resolve)(dirname13, "../../../apps/api-cli/node_modules/@mariozechner/pi-coding-agent/package.json"));
+  addCandidate((0, import_node_path27.resolve)(cwd, "apps/api-cli/node_modules/@mariozechner/pi-coding-agent/package.json"));
+  addCandidate((0, import_node_path27.resolve)(dirname13, "../../../apps/api-cli/node_modules/@mariozechner/pi-coding-agent/package.json"));
   collectAncestorCandidates(cwd);
   collectAncestorCandidates(dirname13);
   const resolvedPackageJson = candidates.find((candidate) => fileExists(candidate));
   if (!resolvedPackageJson) {
     throw new UserInputError(`Unable to locate the installed pi package root. Checked: ${candidates.join(", ")}`);
   }
-  return (0, import_node_path23.resolve)(resolvedPackageJson, "..");
+  return (0, import_node_path27.resolve)(resolvedPackageJson, "..");
 }
 function createPiAgentRuntimeSkill(params) {
   const commandPrefix = params.scope === "global" ? "docyrus -g" : "docyrus";
-  const knowledgeDir = (0, import_node_path23.join)(params.cwd, "docyrus", "knowledge");
-  const hasKnowledgeGraph = (0, import_node_fs12.existsSync)(knowledgeDir);
+  const knowledgeDir = (0, import_node_path27.join)(params.cwd, "docyrus", "knowledge");
+  const hasKnowledgeGraph = (0, import_node_fs16.existsSync)(knowledgeDir);
   const authLines = params.activeProfile ? [
     `- email: \`${params.activeProfile.email}\``,
     `- tenant: \`${params.activeProfile.tenantName} (${params.activeProfile.tenantNo})\``,
@@ -150249,35 +151654,35 @@ function createPiAgentRuntimeSkill(params) {
   ].join("\n");
 }
 async function syncPackagedSkills(params) {
-  const sourceSkillsRoot = (0, import_node_path23.join)(params.resourceRoot, "skills");
-  const targetSkillsRoot = (0, import_node_path23.join)(params.agentRootPath, "skills");
-  await (0, import_promises17.mkdir)(targetSkillsRoot, {
+  const sourceSkillsRoot = (0, import_node_path27.join)(params.resourceRoot, "skills");
+  const targetSkillsRoot = (0, import_node_path27.join)(params.agentRootPath, "skills");
+  await (0, import_promises20.mkdir)(targetSkillsRoot, {
     recursive: true,
     mode: 448
   });
-  const entries = await (0, import_promises17.readdir)(sourceSkillsRoot, {
+  const entries = await (0, import_promises20.readdir)(sourceSkillsRoot, {
     withFileTypes: true
   });
   await Promise.all(DOCYRUS_MIGRATED_SKILL_NAMES.map(async (skillName) => {
-    await (0, import_promises17.rm)((0, import_node_path23.join)(targetSkillsRoot, skillName), {
+    await (0, import_promises20.rm)((0, import_node_path27.join)(targetSkillsRoot, skillName), {
       recursive: true,
       force: true
     });
   }));
   await Promise.all(entries.map(async (entry) => {
-    await (0, import_promises17.cp)((0, import_node_path23.join)(sourceSkillsRoot, entry.name), (0, import_node_path23.join)(targetSkillsRoot, entry.name), {
+    await (0, import_promises20.cp)((0, import_node_path27.join)(sourceSkillsRoot, entry.name), (0, import_node_path27.join)(targetSkillsRoot, entry.name), {
       recursive: true,
       force: true
     });
   }));
 }
 async function writeRuntimeSkill(params) {
-  const runtimeSkillDir = (0, import_node_path23.join)(params.agentRootPath, "skills", "docyrus-runtime-context");
-  await (0, import_promises17.mkdir)(runtimeSkillDir, {
+  const runtimeSkillDir = (0, import_node_path27.join)(params.agentRootPath, "skills", "docyrus-runtime-context");
+  await (0, import_promises20.mkdir)(runtimeSkillDir, {
     recursive: true,
     mode: 448
   });
-  await (0, import_promises17.writeFile)((0, import_node_path23.join)(runtimeSkillDir, "SKILL.md"), `${params.content}
+  await (0, import_promises20.writeFile)((0, import_node_path27.join)(runtimeSkillDir, "SKILL.md"), `${params.content}
 `, {
     encoding: "utf8",
     mode: 384
@@ -150290,10 +151695,10 @@ function resolveNpmCommand() {
   return process.platform === "win32" ? "npm.cmd" : "npm";
 }
 function resolveManagedDiffityInstallRoot(agentRootPath) {
-  return (0, import_node_path23.join)(agentRootPath, "tools", "diffity");
+  return (0, import_node_path27.join)(agentRootPath, "tools", "diffity");
 }
 function resolveManagedDiffityExecutablePath(agentRootPath) {
-  return (0, import_node_path23.join)(
+  return (0, import_node_path27.join)(
     resolveManagedDiffityInstallRoot(agentRootPath),
     "node_modules",
     ".bin",
@@ -150301,10 +151706,10 @@ function resolveManagedDiffityExecutablePath(agentRootPath) {
   );
 }
 function prependPathEntry(entry, existingPath) {
-  const values = existingPath ? existingPath.split(import_node_path23.delimiter).filter((value2) => value2.trim().length > 0) : [];
+  const values = existingPath ? existingPath.split(import_node_path27.delimiter).filter((value2) => value2.trim().length > 0) : [];
   const normalizedEntry = entry.trim();
   const remaining = values.filter((value2) => value2 !== normalizedEntry);
-  return [normalizedEntry, ...remaining].join(import_node_path23.delimiter);
+  return [normalizedEntry, ...remaining].join(import_node_path27.delimiter);
 }
 function createDocyrusSkillsInstallArgs(scope) {
   const args2 = [
@@ -150342,8 +151747,8 @@ function createPackagedDocyrusPlatformInstallArgs(params) {
   return args2;
 }
 async function installExternalDocyrusSkillsOnce(params) {
-  const markerPath = (0, import_node_path23.join)(params.agentRootPath, DOCYRUS_EXTERNAL_SKILL_MARKER_FILE);
-  if ((0, import_node_fs12.existsSync)(markerPath)) {
+  const markerPath = (0, import_node_path27.join)(params.agentRootPath, DOCYRUS_EXTERNAL_SKILL_MARKER_FILE);
+  if ((0, import_node_fs16.existsSync)(markerPath)) {
     return;
   }
   const result = params.spawnCommand(resolveNpxCommand(), createDocyrusSkillsInstallArgs(params.scope), {
@@ -150361,7 +151766,7 @@ async function installExternalDocyrusSkillsOnce(params) {
     );
     return;
   }
-  await (0, import_promises17.writeFile)(markerPath, `${JSON.stringify({
+  await (0, import_promises20.writeFile)(markerPath, `${JSON.stringify({
     source: DOCYRUS_EXTERNAL_SKILL_SOURCE,
     skills: DOCYRUS_MIGRATED_SKILL_NAMES,
     agents: DOCYRUS_EXTERNAL_SKILL_AGENT_IDS,
@@ -150375,8 +151780,8 @@ async function installExternalDocyrusSkillsOnce(params) {
 }
 async function ensureManagedDiffityInstalled(params) {
   const executablePath = resolveManagedDiffityExecutablePath(params.agentRootPath);
-  const binDir = (0, import_node_path23.dirname)(executablePath);
-  if ((0, import_node_fs12.existsSync)(executablePath)) {
+  const binDir = (0, import_node_path27.dirname)(executablePath);
+  if ((0, import_node_fs16.existsSync)(executablePath)) {
     return {
       available: true,
       executablePath,
@@ -150414,54 +151819,129 @@ async function ensureManagedDiffityInstalled(params) {
   };
 }
 function resolvePackagedDocyrusPlatformSkillPath(resourceRoot) {
-  return (0, import_node_path23.join)(resourceRoot, "skills", DOCYRUS_PACKAGED_PLATFORM_SKILL_NAME);
+  return (0, import_node_path27.join)(resourceRoot, "skills", DOCYRUS_PACKAGED_PLATFORM_SKILL_NAME);
+}
+function resolvePackagedOfficeCliRootPath(resourceRoot) {
+  return (0, import_node_path27.join)((0, import_node_path27.resolve)(resourceRoot, ".."), "officecli");
+}
+function resolvePackagedOfficeCliManifestPath(resourceRoot) {
+  return (0, import_node_path27.join)(resolvePackagedOfficeCliRootPath(resourceRoot), DOCYRUS_OFFICECLI_MANIFEST_FILE_NAME);
 }
 function resolveManagedOfficeCliInstallRoot(agentRootPath) {
-  return (0, import_node_path23.join)(agentRootPath, "tools", "officecli");
+  return (0, import_node_path27.join)(agentRootPath, "tools", "officecli");
 }
 function resolveManagedOfficeCliExecutablePath(agentRootPath) {
-  return (0, import_node_path23.join)(
+  return (0, import_node_path27.join)(
     resolveManagedOfficeCliInstallRoot(agentRootPath),
     process.platform === "win32" ? "officecli.exe" : "officecli"
   );
 }
-function resolveOfficeCliReleaseAssetName() {
-  switch (process.platform) {
+function resolveOfficeCliReleaseAssetName(options2 = {}) {
+  const platform2 = options2.platform ?? process.platform;
+  const arch = options2.arch ?? process.arch;
+  const isAlpine = options2.isAlpine ?? (0, import_node_fs16.existsSync)("/etc/alpine-release");
+  switch (platform2) {
     case "darwin":
-      if (process.arch === "arm64") {
+      if (arch === "arm64") {
         return "officecli-mac-arm64";
       }
-      if (process.arch === "x64") {
+      if (arch === "x64") {
         return "officecli-mac-x64";
       }
       break;
     case "linux": {
-      const alpineSuffix = (0, import_node_fs12.existsSync)("/etc/alpine-release") ? "-alpine" : "";
-      if (process.arch === "arm64") {
+      const alpineSuffix = isAlpine ? "-alpine" : "";
+      if (arch === "arm64") {
         return `officecli-linux${alpineSuffix}-arm64`;
       }
-      if (process.arch === "x64") {
+      if (arch === "x64") {
         return `officecli-linux${alpineSuffix}-x64`;
       }
       break;
     }
     case "win32":
-      if (process.arch === "arm64") {
+      if (arch === "arm64") {
         return "officecli-win-arm64.exe";
       }
-      if (process.arch === "x64") {
+      if (arch === "x64") {
         return "officecli-win-x64.exe";
       }
       break;
     default:
       break;
   }
-  throw new UserInputError(`OfficeCLI is not supported on ${process.platform}/${process.arch}.`);
+  throw new UserInputError(`OfficeCLI is not supported on ${platform2}/${arch}.`);
+}
+function resolvePackagedOfficeCliExecutablePath(resourceRoot, options2) {
+  return (0, import_node_path27.join)(
+    resolvePackagedOfficeCliRootPath(resourceRoot),
+    "bundled",
+    resolveOfficeCliReleaseAssetName(options2)
+  );
+}
+async function readPackagedOfficeCliVersion(resourceRoot) {
+  const manifestRaw = await (0, import_promises20.readFile)(resolvePackagedOfficeCliManifestPath(resourceRoot), "utf8");
+  const manifest = JSON.parse(manifestRaw);
+  const version2 = typeof manifest.version === "string" ? manifest.version.trim() : "";
+  if (version2.length === 0) {
+    throw new UserInputError("OfficeCLI manifest is missing a valid version.");
+  }
+  return version2;
+}
+async function downloadOfficeCliBinary(params) {
+  const assetName = resolveOfficeCliReleaseAssetName();
+  const version2 = await readPackagedOfficeCliVersion(params.resourceRoot);
+  const response = await fetch(`https://github.com/iOfficeAI/OfficeCLI/releases/download/v${version2}/${assetName}`);
+  if (!response.ok) {
+    throw new UserInputError(`OfficeCLI download failed with status ${response.status}.`);
+  }
+  const binary2 = Buffer.from(await response.arrayBuffer());
+  await (0, import_promises20.writeFile)(params.destinationPath, binary2, {
+    mode: process.platform === "win32" ? 384 : 448
+  });
+}
+function resolveManagedOfficeCliConfigMarkerPath(agentRootPath) {
+  return (0, import_node_path27.join)(resolveManagedOfficeCliInstallRoot(agentRootPath), ".docyrus-officecli-configured.json");
+}
+async function disableManagedOfficeCliAutoUpdate(params) {
+  const markerPath = resolveManagedOfficeCliConfigMarkerPath(params.agentRootPath);
+  if ((0, import_node_fs16.existsSync)(markerPath)) {
+    return;
+  }
+  const result = params.spawnCommand(params.executablePath, ["config", "autoUpdate", "false"], {
+    stdio: ["ignore", "pipe", "pipe"],
+    encoding: "utf8",
+    cwd: params.cwd,
+    env: {
+      ...process.env,
+      OFFICECLI_SKIP_UPDATE: "1"
+    }
+  });
+  if (result.error || result.status !== 0) {
+    process.stderr.write(
+      `[docyrus] OfficeCLI auto-update disable failed. Continuing with env override only: ${result.error?.message || summarizeFailure3(result, "officecli config autoUpdate false")}
+`
+    );
+    return;
+  }
+  await (0, import_promises20.writeFile)(markerPath, `${JSON.stringify({
+    configuredAt: (/* @__PURE__ */ new Date()).toISOString()
+  }, null, 2)}
+`, {
+    encoding: "utf8",
+    mode: 384
+  });
 }
 async function ensureManagedOfficeCliInstalled(params) {
   const executablePath = resolveManagedOfficeCliExecutablePath(params.agentRootPath);
-  const binDir = (0, import_node_path23.dirname)(executablePath);
-  if ((0, import_node_fs12.existsSync)(executablePath)) {
+  const binDir = (0, import_node_path27.dirname)(executablePath);
+  if ((0, import_node_fs16.existsSync)(executablePath)) {
+    await disableManagedOfficeCliAutoUpdate({
+      agentRootPath: params.agentRootPath,
+      executablePath,
+      cwd: params.cwd,
+      spawnCommand: params.spawnCommand
+    });
     return {
       available: true,
       executablePath,
@@ -150470,21 +151950,23 @@ async function ensureManagedOfficeCliInstalled(params) {
   }
   const tempPath = `${executablePath}.download${process.platform === "win32" ? ".exe" : ""}`;
   try {
-    await (0, import_promises17.mkdir)(binDir, {
+    await (0, import_promises20.mkdir)(binDir, {
       recursive: true,
       mode: 448
     });
-    const assetName = resolveOfficeCliReleaseAssetName();
-    const response = await fetch(`${DOCYRUS_OFFICECLI_RELEASES_BASE_URL}/${assetName}`);
-    if (!response.ok) {
-      throw new UserInputError(`OfficeCLI download failed with status ${response.status}.`);
+    const bundledExecutablePath = resolvePackagedOfficeCliExecutablePath(params.resourceRoot);
+    if ((0, import_node_fs16.existsSync)(bundledExecutablePath)) {
+      await (0, import_promises20.cp)(bundledExecutablePath, tempPath, {
+        force: true
+      });
+    } else {
+      await downloadOfficeCliBinary({
+        resourceRoot: params.resourceRoot,
+        destinationPath: tempPath
+      });
     }
-    const binary2 = Buffer.from(await response.arrayBuffer());
-    await (0, import_promises17.writeFile)(tempPath, binary2, {
-      mode: process.platform === "win32" ? 384 : 448
-    });
     if (process.platform !== "win32") {
-      await (0, import_promises17.chmod)(tempPath, 448);
+      await (0, import_promises20.chmod)(tempPath, 448);
     }
     const verificationResult = params.spawnCommand(tempPath, ["--version"], {
       stdio: ["ignore", "pipe", "pipe"],
@@ -150500,17 +151982,23 @@ async function ensureManagedOfficeCliInstalled(params) {
         verificationResult.error?.message || summarizeFailure3(verificationResult, "officecli --version")
       );
     }
-    await (0, import_promises17.rename)(tempPath, executablePath);
+    await (0, import_promises20.rename)(tempPath, executablePath);
     if (process.platform !== "win32") {
-      await (0, import_promises17.chmod)(executablePath, 448);
+      await (0, import_promises20.chmod)(executablePath, 448);
     }
+    await disableManagedOfficeCliAutoUpdate({
+      agentRootPath: params.agentRootPath,
+      executablePath,
+      cwd: params.cwd,
+      spawnCommand: params.spawnCommand
+    });
     return {
       available: true,
       executablePath,
       binDir
     };
   } catch (error48) {
-    await (0, import_promises17.rm)(tempPath, {
+    await (0, import_promises20.rm)(tempPath, {
       force: true
     });
     process.stderr.write(
@@ -150526,7 +152014,7 @@ async function ensureManagedOfficeCliInstalled(params) {
 }
 function installPackagedDocyrusPlatformSkill(params) {
   const skillSourcePath = resolvePackagedDocyrusPlatformSkillPath(params.resourceRoot);
-  if (!(0, import_node_fs12.existsSync)(skillSourcePath)) {
+  if (!(0, import_node_fs16.existsSync)(skillSourcePath)) {
     process.stderr.write("[docyrus] Packaged docyrus-platform skill is missing. Continuing without agent sync.\n");
     return;
   }
@@ -150616,6 +152104,7 @@ function createPiAgentLauncher(options2) {
     });
     const officeCli = await ensureManagedOfficeCliInstalled({
       agentRootPath,
+      resourceRoot,
       cwd,
       spawnCommand
     });
@@ -150654,8 +152143,8 @@ function createPiAgentLauncher(options2) {
 
 // src/services/piAgentServerLauncher.ts
 var import_node_child_process7 = require("node:child_process");
-var import_node_fs13 = require("node:fs");
-var import_node_path24 = require("node:path");
+var import_node_fs17 = require("node:fs");
+var import_node_path28 = require("node:path");
 function serializePiAgentServerRequest(request) {
   return JSON.stringify(request);
 }
@@ -150669,26 +152158,26 @@ function resolveServerLoaderEntryPath(cwd, dirname13) {
     }
   };
   const collectAncestorCandidates = (startDir) => {
-    let currentDir = (0, import_node_path24.resolve)(startDir);
+    let currentDir = (0, import_node_path28.resolve)(startDir);
     while (true) {
-      addCandidate((0, import_node_path24.join)(currentDir, "dist", "apps", "api-cli", "server-loader.js"));
-      addCandidate((0, import_node_path24.join)(currentDir, "server-loader.js"));
-      if ((0, import_node_path24.basename)(currentDir) === "dist") {
-        addCandidate((0, import_node_path24.join)(currentDir, "apps", "api-cli", "server-loader.js"));
+      addCandidate((0, import_node_path28.join)(currentDir, "dist", "apps", "api-cli", "server-loader.js"));
+      addCandidate((0, import_node_path28.join)(currentDir, "server-loader.js"));
+      if ((0, import_node_path28.basename)(currentDir) === "dist") {
+        addCandidate((0, import_node_path28.join)(currentDir, "apps", "api-cli", "server-loader.js"));
       }
-      const parentDir = (0, import_node_path24.resolve)(currentDir, "..");
+      const parentDir = (0, import_node_path28.resolve)(currentDir, "..");
       if (parentDir === currentDir) {
         break;
       }
       currentDir = parentDir;
     }
   };
-  addCandidate((0, import_node_path24.resolve)(cwd, "dist/apps/api-cli/server-loader.js"));
-  addCandidate((0, import_node_path24.resolve)(dirname13, "../server-loader.js"));
-  addCandidate((0, import_node_path24.resolve)(dirname13, "server-loader.js"));
+  addCandidate((0, import_node_path28.resolve)(cwd, "dist/apps/api-cli/server-loader.js"));
+  addCandidate((0, import_node_path28.resolve)(dirname13, "../server-loader.js"));
+  addCandidate((0, import_node_path28.resolve)(dirname13, "server-loader.js"));
   collectAncestorCandidates(cwd);
   collectAncestorCandidates(dirname13);
-  const resolved = candidates.find((candidate) => (0, import_node_fs13.existsSync)(candidate));
+  const resolved = candidates.find((candidate) => (0, import_node_fs17.existsSync)(candidate));
   if (!resolved) {
     throw new UserInputError(`Unable to locate Docyrus pi server loader entry file. Checked: ${candidates.join(", ")}`);
   }
@@ -150734,6 +152223,7 @@ function createPiAgentServerLauncher(options2) {
     spinner.update("Installing tools...");
     const officeCli = await ensureManagedOfficeCliInstalled({
       agentRootPath,
+      resourceRoot,
       cwd,
       spawnCommand: import_node_child_process7.spawnSync
     });
@@ -150804,8 +152294,8 @@ async function runWithIncurSkillsOutOfDateWarningSuppressed(params) {
 }
 
 // src/services/tenantOpenApi.ts
-var import_promises18 = require("node:fs/promises");
-var import_node_path25 = require("node:path");
+var import_promises21 = require("node:fs/promises");
+var import_node_path29 = require("node:path");
 function resolveSourceUrl(tenantId, template) {
   return template.replace("{tenantId}", encodeURIComponent(tenantId));
 }
@@ -150830,16 +152320,16 @@ var TenantOpenApiService = class {
   params;
   async #writeOpenApiFile(tenantId, parsedContent) {
     const filePath = this.getTenantOpenApiFilePath(tenantId);
-    await (0, import_promises18.mkdir)((0, import_node_path25.dirname)(filePath), {
+    await (0, import_promises21.mkdir)((0, import_node_path29.dirname)(filePath), {
       recursive: true,
       mode: 448
     });
-    await (0, import_promises18.writeFile)(filePath, `${JSON.stringify(parsedContent, null, 2)}
+    await (0, import_promises21.writeFile)(filePath, `${JSON.stringify(parsedContent, null, 2)}
 `, {
       encoding: "utf8",
       mode: 384
     });
-    await (0, import_promises18.chmod)(filePath, 384);
+    await (0, import_promises21.chmod)(filePath, 384);
     return filePath;
   }
   async #generateTenantOpenApiViaAuthenticatedEndpoint(tenantId, options2) {
@@ -150876,7 +152366,7 @@ var TenantOpenApiService = class {
       throw new AuthSessionError("Tenant ID is required to resolve OpenAPI spec path.");
     }
     const rootPath = this.params?.rootPath || TENANT_OPENAPI_ROOT_PATH;
-    return (0, import_node_path25.join)(rootPath, normalizedTenantId, "openapi.json");
+    return (0, import_node_path29.join)(rootPath, normalizedTenantId, "openapi.json");
   }
   async downloadTenantOpenApi(tenantId, options2 = {}) {
     const normalizedTenantId = tenantId.trim();
@@ -150957,6 +152447,8 @@ var ROOT_HELP_COMMANDS = [
   { command: "knowledge search <query>", description: "Semantic search across docyrus/knowledge" },
   { command: "knowledge section <query>", description: "Show a knowledge section with refs and backlinks" },
   { command: "knowledge check", description: "Validate docyrus/knowledge links and backlinks" },
+  { command: "project-plan show", description: "Show the canonical project plan graph and hierarchy" },
+  { command: "project-plan check", description: "Validate the canonical project plan graph" },
   { command: "action <appSlug> <actionKey> --params '{...}'", description: "Run a connector or app action" },
   { command: "ds list <appSlug> <dataSourceSlug>", description: "List data source items" },
   { command: "apps list", description: "List apps" },
@@ -151072,6 +152564,11 @@ function createDocyrusCli(params) {
     authStore,
     settingsPaths
   }));
+  cli2.command(createProjectPlanCli({
+    environmentConfigService,
+    authStore,
+    settingsPaths
+  }));
   cli2.command(createAppsCli({
     createApiClient,
     environmentConfigService,