learn-anything-cli 0.3.0 → 0.4.0

package/dist/scripts/utils.mjs

@@ -0,0 +1,124 @@
+/**
+ * utils.mts — shared types, validation, and helpers for scripts.
+ *
+ * This file is compiled from src/scripts/utils.mts via tsc and
+ * copied into each skill's scripts/ directory by init/update.
+ * It MUST NOT import any project modules — only Node.js built-ins.
+ */
+/* ------------------------------------------------------------------ */
+/*  Status display helpers                                            */
+/* ------------------------------------------------------------------ */
+export const STATUS_ICON = {
+    mastered: '🟢',
+    in_progress: '🔵',
+    needs_practice: '🟠',
+    unexplored: '⚪',
+};
+export const STATUS_LABEL = {
+    mastered: 'mastered',
+    in_progress: 'in progress',
+    needs_practice: 'needs practice',
+    unexplored: 'unexplored',
+};
+/* ------------------------------------------------------------------ */
+/*  Text helpers                                                      */
+/* ------------------------------------------------------------------ */
+/** Escape underscores in text destined for Markdown output. */
+export const esc = (s) => s.replace(/_/g, '\\_');
+// ── Checker factories ────────────────────────────────────────────────
+const literal = (expected) => (v) => v !== expected ? `Must be ${JSON.stringify(expected)}` : null;
+const str = (min = 1) => (v) => typeof v !== 'string' || v.length < min
+    ? `Must be a non-empty string`
+    : null;
+const num = (opts) => (v) => {
+    if (typeof v !== 'number')
+        return 'Must be a number';
+    if (opts?.min !== undefined && v < opts.min)
+        return `Must be >= ${opts.min}`;
+    if (opts?.max !== undefined && v > opts.max)
+        return `Must be <= ${opts.max}`;
+    if (opts?.int && !Number.isInteger(v))
+        return 'Must be an integer';
+    return null;
+};
+const DATE_RE = /^\d{4}-\d{2}-\d{2}( \d{2}:\d{2}:\d{2})?$/;
+const dateStr = (v) => typeof v !== 'string' || !DATE_RE.test(v)
+    ? 'Must match YYYY-MM-DD or YYYY-MM-DD HH:mm:ss'
+    : null;
+const nullable = (inner) => (v) => v === null ? null : inner(v);
+const arr = (itemChecker) => (v) => {
+    if (!Array.isArray(v))
+        return 'Must be an array';
+    if (itemChecker)
+        for (const item of v) {
+            const err = itemChecker(item);
+            if (err)
+                return err;
+        }
+    return null;
+};
+const oneOf = (...values) => (v) => !values.includes(v) ? `Must be one of: ${values.join(', ')}` : null;
+// ── Validation schemas ───────────────────────────────────────────────
+const STATE_RULES = {
+    version: literal(1),
+    topic: str(),
+    slug: str(),
+    created: dateStr,
+    domains: arr(),
+};
+const DOMAIN_RULES = {
+    name: str(),
+    slug: str(),
+    concepts: arr(),
+};
+const CONCEPT_RULES = {
+    name: str(),
+    slug: str(),
+    status: oneOf('unexplored', 'in_progress', 'needs_practice', 'mastered'),
+    confidence: num({ min: 0, max: 1 }),
+    practice_count: num({ min: 0, int: true }),
+    explain_count: num({ min: 0, int: true }),
+    last_explained: nullable(dateStr),
+    last_practiced: nullable(dateStr),
+    details: arr(str()),
+};
+// ── Core engine ──────────────────────────────────────────────────────
+function checkFields(obj, rules, prefix, errors) {
+    if (obj === null || typeof obj !== 'object')
+        return;
+    const record = obj;
+    for (const [key, checker] of Object.entries(rules)) {
+        const msg = checker(record[key]);
+        if (msg)
+            errors.push({ path: prefix ? `${prefix}.${key}` : key, message: msg });
+    }
+}
+export function validateStateV1(data) {
+    if (data === null || typeof data !== 'object' || Array.isArray(data))
+        return [{ path: '', message: 'Expected a non-null object' }];
+    const errors = [];
+    checkFields(data, STATE_RULES, '', errors);
+    if (Array.isArray(data.domains)) {
+        const domains = data.domains;
+        for (const [di, domain] of domains.entries()) {
+            const dp = `domains[${di}]`;
+            checkFields(domain, DOMAIN_RULES, dp, errors);
+            if (Array.isArray(domain.concepts)) {
+                const concepts = domain.concepts;
+                for (const [ci, concept] of concepts.entries())
+                    checkFields(concept, CONCEPT_RULES, `${dp}.concepts[${ci}]`, errors);
+            }
+        }
+    }
+    return errors;
+}
+/* ------------------------------------------------------------------ */
+/*  Helpers                                                           */
+/* ------------------------------------------------------------------ */
+export function totalCount(state) {
+    return state.domains.reduce((sum, d) => sum + d.concepts.length, 0);
+}
+export function masteredCount(state) {
+    return state.domains.reduce((sum, d) => sum + d.concepts.filter((c) => c.status === 'mastered').length, 0);
+}
+//# sourceMappingURL=utils.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "learn-anything-cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "AI-powered recursive learning system with Socratic method and TDD practice",
   "keywords": [
     "learn-anything-cli",
@@ -58,6 +58,7 @@
     "@commitlint/cli": "^21.0.2",
     "@commitlint/config-conventional": "^21.0.2",
     "@eslint/js": "^10.0.1",
+    "@types/mdast": "^4.0.4",
     "@types/node": "^24.2.0",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
@@ -73,6 +74,8 @@
     "chalk": "^5.5.0",
     "commander": "^14.0.0",
     "fast-glob": "^3.3.3",
+    "remark-parse": "^11.0.0",
+    "unified": "^11.0.5",
     "yaml": "^2.8.2",
     "zod": "^4.0.17"
   },