renma 0.15.1 → 0.16.0

package/dist/yaml-frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-frontmatter.d.ts","sourceRoot":"","sources":["../src/yaml-frontmatter.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,cAAc,EAAE,oBAAoB,EAAE,CAAC;IACvC,eAAe,EAAE,oBAAoB,EAAE,CAAC;IACxC,qBAAqB,EAAE,oBAAoB,EAAE,CAAC;IAC9C,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAED,2FAA2F;AAC3F,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,GACd,qBAAqB,CAsDvB"}

package/dist/yaml-frontmatter.js

@@ -0,0 +1,114 @@
+import { isMap, isNode, isScalar, LineCounter, parseDocument as parseYamlDocument, } from "yaml";
+/** Parse a focused YAML 1.2 frontmatter document without replacing the Markdown parser. */
+export function parseAgentSkillFrontmatter(content) {
+    const lines = content.split(/\r?\n/);
+    const firstLine = lines[0]?.replace(/^\uFEFF/, "").trim();
+    if (firstLine !== "---")
+        return emptyResult(false, false, 1);
+    const closingIndex = lines.findIndex((line, index) => index > 0 && /^---\s*$/.test(line));
+    if (closingIndex < 0)
+        return emptyResult(true, false, lines.length + 1);
+    const source = lines.slice(1, closingIndex).join("\n");
+    const lineCounter = new LineCounter();
+    const yaml = parseYamlDocument(source, {
+        lineCounter,
+        prettyErrors: false,
+        strict: true,
+        stringKeys: true,
+        uniqueKeys: false,
+        version: "1.2",
+    });
+    const errors = yaml.errors.map((error) => ({
+        code: error.code,
+        message: error.message,
+        line: (error.linePos?.[0].line ?? lineCounter.linePos(error.pos[0]).line) + 1,
+    }));
+    if (!isMap(yaml.contents)) {
+        return {
+            ...emptyResult(true, true, closingIndex + 2),
+            errors,
+        };
+    }
+    const fields = mapFields(yaml, yaml.contents.items, lineCounter);
+    const metadataPair = yaml.contents.items.find((pair) => scalarString(pair.key) === "metadata");
+    const metadataFields = isMap(metadataPair?.value)
+        ? mapFields(yaml, metadataPair.value.items, lineCounter)
+        : [];
+    return {
+        present: true,
+        closed: true,
+        mapping: true,
+        bodyStartLine: closingIndex + 2,
+        values: Object.fromEntries(fields.map((field) => [field.key, field.value])),
+        fields,
+        metadataFields,
+        duplicateFields: findDuplicates(fields),
+        duplicateMetadataKeys: findDuplicates(metadataFields),
+        errors,
+    };
+}
+function emptyResult(present, closed, bodyStartLine) {
+    return {
+        present,
+        closed,
+        mapping: false,
+        bodyStartLine,
+        values: {},
+        fields: [],
+        metadataFields: [],
+        duplicateFields: [],
+        duplicateMetadataKeys: [],
+        errors: [],
+    };
+}
+function mapFields(document, pairs, lineCounter) {
+    return pairs.flatMap((pair) => {
+        const key = scalarString(pair.key);
+        if (key === undefined)
+            return [];
+        const keyRange = nodeRange(pair.key);
+        const valueRange = nodeRange(pair.value);
+        const startOffset = keyRange?.[0] ?? valueRange?.[0];
+        const endOffset = valueRange?.[2] ?? keyRange?.[2];
+        const startLine = (startOffset === undefined ? 1 : lineCounter.linePos(startOffset).line) +
+            1;
+        // YAML node ranges use an exclusive end offset. Pointing at that offset
+        // can advance evidence to the following field, so locate the final byte
+        // belonging to this pair instead.
+        const endLine = (endOffset === undefined
+            ? startLine - 1
+            : lineCounter.linePos(Math.max(startOffset ?? 0, endOffset - 1)).line) +
+            1;
+        return [
+            {
+                key,
+                value: nodeValue(document, pair.value),
+                startLine,
+                endLine,
+            },
+        ];
+    });
+}
+function scalarString(value) {
+    return isScalar(value) && typeof value.value === "string"
+        ? value.value
+        : undefined;
+}
+function nodeValue(document, value) {
+    if (value === null || value === undefined)
+        return null;
+    return isNode(value) ? value.toJS(document) : value;
+}
+function nodeRange(value) {
+    return isNode(value) ? (value.range ?? undefined) : undefined;
+}
+function findDuplicates(fields) {
+    const seen = new Set();
+    return fields.filter((field) => {
+        if (seen.has(field.key))
+            return true;
+        seen.add(field.key);
+        return false;
+    });
+}
+//# sourceMappingURL=yaml-frontmatter.js.map

package/dist/yaml-frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-frontmatter.js","sourceRoot":"","sources":["../src/yaml-frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,MAAM,EACN,QAAQ,EACR,WAAW,EACX,aAAa,IAAI,iBAAiB,GAInC,MAAM,MAAM,CAAC;AA4Bd,2FAA2F;AAC3F,MAAM,UAAU,0BAA0B,CACxC,OAAe;IAEf,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,SAAS,KAAK,KAAK;QAAE,OAAO,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAE7D,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS,CAClC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CACpD,CAAC;IACF,IAAI,YAAY,GAAG,CAAC;QAAE,OAAO,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAExE,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,EAAE;QACrC,WAAW;QACX,YAAY,EAAE,KAAK;QACnB,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACzC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EACF,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;KAC1E,CAAC,CAAC,CAAC;IAEJ,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,GAAG,CAAC,CAAC;YAC5C,MAAM;SACP,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAC3C,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,UAAU,CAChD,CAAC;IACF,MAAM,cAAc,GAAG,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC;QAC/C,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC;QACxD,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,IAAI;QACb,aAAa,EAAE,YAAY,GAAG,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3E,MAAM;QACN,cAAc;QACd,eAAe,EAAE,cAAc,CAAC,MAAM,CAAC;QACvC,qBAAqB,EAAE,cAAc,CAAC,cAAc,CAAC;QACrD,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,OAAgB,EAChB,MAAe,EACf,aAAqB;IAErB,OAAO;QACL,OAAO;QACP,MAAM;QACN,OAAO,EAAE,KAAK;QACd,aAAa;QACb,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,EAAE;QACV,cAAc,EAAE,EAAE;QAClB,eAAe,EAAE,EAAE;QACnB,qBAAqB,EAAE,EAAE;QACzB,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAChB,QAAyB,EACzB,KAAa,EACb,WAAwB;IAExB,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,WAAW,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,SAAS,GACb,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;YACvE,CAAC,CAAC;QACJ,wEAAwE;QACxE,wEAAwE;QACxE,kCAAkC;QAClC,MAAM,OAAO,GACX,CAAC,SAAS,KAAK,SAAS;YACtB,CAAC,CAAC,SAAS,GAAG,CAAC;YACf,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACxE,CAAC,CAAC;QACJ,OAAO;YACL;gBACE,GAAG;gBACH,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC;gBACtC,SAAS;gBACT,OAAO;aACR;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QACvD,CAAC,CAAC,KAAK,CAAC,KAAK;QACb,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,QAAyB,EAAE,KAAc;IAC1D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACtD,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAChE,CAAC;AAED,SAAS,cAAc,CACrB,MAA8B;IAE9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAC7B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACrC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "renma",
-  "version": "0.15.1",
+  "version": "0.16.0",
   "description": "Manage human-curated context assets for LLMs and agents in Git.",
   "license": "MIT",
   "repository": {
@@ -55,5 +55,8 @@
     "prettier": "^3.5.3",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.61.0"
+  },
+  "dependencies": {
+    "yaml": "^2.9.0"
   }
 }