@graspful/cli 0.2.5 → 0.2.7

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/@graspful/cli)](https://www.npmjs.com/package/@graspful/cli)
 [![license](https://img.shields.io/npm/l/@graspful/cli)](https://github.com/willwearing/graspful/blob/main/LICENSE)
 
-CLI for creating adaptive learning courses from YAML knowledge graphs. Designed for AI agents and humans. Two YAML files in, live course product out -- with adaptive learning, spaced repetition, and Stripe billing.
+CLI for creating adaptive learning academies and courses from YAML knowledge graphs. Designed for AI agents and humans. Academy manifest + course YAMLs + brand YAML in, live adaptive product out.
 
 ## Quick Start
 
@@ -11,15 +11,16 @@ CLI for creating adaptive learning courses from YAML knowledge graphs. Designed
 # 1. Create an account (opens browser auth, then saves an API key locally)
 npx @graspful/cli register
 
-# 2. Scaffold a course
-npx @graspful/cli create course --topic "CKA Exam" -o cka.yaml
+# 2. Scaffold the academy plan and first course
+npx @graspful/cli create academy --topic "CKA Exam" -o cka-academy.yaml
+npx @graspful/cli create course --topic "CKA Exam Foundations" -o cka.yaml
 
 # 3. Validate and review
 npx @graspful/cli validate cka.yaml
 npx @graspful/cli review cka.yaml
 
 # 4. Import and publish
-npx @graspful/cli import cka.yaml --org <your-org> --publish
+npx @graspful/cli import cka-academy.yaml --org <your-org> --course-dir . --publish
 ```
 
 Steps 2-3 work offline — no account needed. You only need to authenticate before importing or publishing.
@@ -45,13 +46,13 @@ bun add -g @graspful/cli
 
 ## The Two-YAML Workflow
 
-Graspful turns two YAML files into a live learning product:
+Graspful turns an academy manifest, course YAMLs, and a brand YAML into a live learning product:
 
 ```
-course.yaml  ──┐
-                ├──▶  graspful import  ──▶  Live adaptive course
+academy.yaml ──┐
+course.yaml  ──┼──▶  graspful import  ──▶  Live adaptive academy
 brand.yaml   ──┘                           with billing, analytics,
-                                           and spaced repetition
+                                           spaced repetition, and a landing page
 ```
 
 **Course YAML** defines what learners study: concepts, prerequisite graph, knowledge points, practice problems, section exams.
@@ -62,6 +63,7 @@ brand.yaml   ──┘                           with billing, analytics,
 
 | Command | Description |
 |---------|-------------|
+| `graspful create academy` | Generate an academy plan and manifest scaffold |
 | `graspful create course` | Generate a course YAML skeleton with knowledge graph structure |
 | `graspful create brand` | Generate a brand YAML with theme presets |
 | `graspful fill concept` | Add knowledge points and practice problems to a concept |
@@ -91,12 +93,26 @@ graspful create course \
 | `--source` | Source document reference | -- |
 | `-o, --output` | Output file path | stdout |
 
+### `graspful create academy`
+
+Generate an academy plan and manifest scaffold. Every Graspful product should be modeled as an academy, even if it starts with a single course.
+
+If you do not pass `--course`, the scaffold starts with the four default planning layers: foundations, core structures, operational flows, and applied judgment. It also includes authoring gates for the source material, learner promise, landing-page proof, graph checks, and review before publishing.
+
+```bash
+graspful create academy \
+  --topic "PostHog TAM" \
+  --course "Data Models" \
+  --course "Pipeline Reading and Solution Design" \
+  -o posthog-tam-academy.yaml
+```
+
 ### `graspful create brand`
 
 Generate a brand YAML scaffold. Niche presets: `education`, `healthcare`, `finance`, `tech`, `legal`.
 
 ```bash
-graspful create brand --niche tech --name "DevOps Academy" --org devops-co
+graspful create brand --niche tech --topic "PostHog TAM" --name "TAM Academy" --org tam-academy
 ```
 
 ### `graspful fill concept`
@@ -109,7 +125,7 @@ graspful fill concept course.yaml networking --kps 3 --problems 4
 
 | Flag | Description | Default |
 |------|-------------|---------|
-| `--kps` | Number of KP stubs | `2` |
+| `--kps` | Number of KP stubs (starting point, not a cap) | `3` |
 | `--problems` | Problems per KP | `3` |
 
 Fails if the concept already has KPs (prevents accidental overwrites).
@@ -144,7 +160,7 @@ The 10 checks:
 | 3 | `prerequisites_valid` | All prerequisite refs point to real concepts |
 | 4 | `question_deduplication` | No near-duplicate questions at same difficulty |
 | 5 | `difficulty_staircase` | Each concept has problems at 2+ difficulty levels |
-| 6 | `cross_concept_coverage` | No single term dominates too many concepts |
+| 6 | `problem_teaching_alignment` | Problems only assess material introduced in the lesson path |
 | 7 | `problem_variant_depth` | Each KP has 3+ problems |
 | 8 | `instruction_formatting` | Long instructions (100+ words) use content blocks |
 | 9 | `worked_example_coverage` | 50%+ of authored concepts have worked examples |
@@ -160,17 +176,19 @@ graspful describe course.yaml
 
 ### `graspful import`
 
-Push a course or brand YAML to a Graspful instance. Requires authentication.
+Push a course, academy, or brand YAML to a Graspful instance. Requires authentication.
 
 ```bash
 graspful import course.yaml --org acme-learning
 graspful import course.yaml --org acme-learning --publish
+graspful import academy.yaml --org acme-learning --course-dir . --publish
 ```
 
 | Flag | Description | Default |
 |------|-------------|---------|
 | `--org` | Organization slug (required for courses) | -- |
 | `--publish` | Publish immediately (runs review gate) | `false` |
+| `--course-dir` | Base directory for academy course files | manifest directory |
 
 ### `graspful publish`
 
@@ -212,13 +230,16 @@ graspful validate course.yaml --format json
 
 The typical agent loop:
 
-1. **Scaffold** -- `graspful create course --topic "X"` to generate the graph skeleton
-2. **Edit** -- modify the YAML to add concepts, adjust prerequisites and difficulty levels
-3. **Fill** -- `graspful fill concept` for each concept to add KP/problem stubs
-4. **Author** -- replace TODO placeholders with real instructions, worked examples, and problems
-5. **Validate** -- `graspful validate` after each edit (offline, fast)
-6. **Review** -- `graspful review` to run all 10 quality checks
-7. **Import** -- `graspful import --org <org> --publish` when review passes 10/10
+1. **Define the academy** -- `graspful create academy --topic "X"` to establish the academy plan
+2. **Decompose the topic** -- break it into foundations, structures, operations, and applied judgment
+3. **Scaffold each course** -- `graspful create course` for every course in the academy
+4. **Edit** -- modify YAML to add concepts, adjust prerequisites, and keep the graph layered
+5. **Fill** -- `graspful fill concept` for each concept to add KP/problem stubs
+6. **Author** -- replace TODO placeholders with real instructions, worked examples, and problems
+7. **Build the landing page** -- use `graspful create brand --topic "X"` as a starting point, then replace generic copy with academy-specific proof and outcomes
+8. **Validate** -- `graspful validate` after each edit (offline, fast)
+9. **Review** -- `graspful review` to run all 10 quality checks
+10. **Import** -- `graspful import academy.yaml --org <org> --course-dir . --publish` when review passes 10/10
 
 ## MCP Server
 
@@ -308,6 +329,10 @@ graspful import course.yaml --org my-org
 |----------|-------------|
 | `GRASPFUL_API_KEY` | API key for authenticated commands (`import`, `publish`) |
 | `GRASPFUL_API_URL` | API base URL (default: `https://api.graspful.ai`) |
+| `GRASPFUL_USER_ID` | Optional Graspful user ID for analytics identity continuity |
+| `GRASPFUL_TELEMETRY_DISABLED` | Set to `1` to disable anonymous product analytics |
+
+The CLI sends command usage and outcome metadata to help improve Graspful. It never sends API keys or YAML course bodies. Set `GRASPFUL_TELEMETRY_DISABLED=1` to disable this data collection.
 
 ## Links
 

package/dist/commands/create-academy.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerCreateAcademyCommand(createCmd: Command): void;
+//# sourceMappingURL=create-academy.d.ts.map

package/dist/commands/create-academy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-academy.d.ts","sourceRoot":"","sources":["../../src/commands/create-academy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,OAAO,QA0C9D"}

package/dist/commands/create-academy.js

@@ -0,0 +1,73 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCreateAcademyCommand = registerCreateAcademyCommand;
+const fs = __importStar(require("fs"));
+const yaml = __importStar(require("js-yaml"));
+const shared_1 = require("@graspful/shared");
+const output_1 = require("../lib/output");
+const analytics_1 = require("../lib/analytics");
+function collect(value, previous) {
+    previous.push(value);
+    return previous;
+}
+function registerCreateAcademyCommand(createCmd) {
+    createCmd
+        .command('academy')
+        .description('Generate an academy plan and manifest scaffold')
+        .requiredOption('--topic <topic>', 'Academy topic name')
+        .option('--course <name>', 'Course name to include in the academy manifest (repeatable). Defaults to the four academy planning layers.', collect, [])
+        .option('--version <version>', 'Academy version', '2026.1')
+        .option('-o, --output <file>', 'Output file path (defaults to stdout)')
+        .action(async (opts) => {
+        const obj = (0, shared_1.scaffoldAcademyObject)(opts.topic, {
+            courseNames: opts.course,
+            version: opts.version,
+        });
+        const yamlContent = yaml.dump(obj, { lineWidth: 120, noRefs: true });
+        (0, analytics_1.cliCapture)('academy scaffolded', {
+            topic: opts.topic,
+            course_count: obj.courses.length,
+        });
+        if (opts.output) {
+            fs.writeFileSync(opts.output, yamlContent);
+            (0, output_1.output)({ file: opts.output, topic: opts.topic, courses: obj.courses.length }, `Academy plan scaffold written to ${opts.output}`);
+        }
+        else {
+            console.log(yamlContent);
+        }
+    });
+}
+//# sourceMappingURL=create-academy.js.map

package/dist/commands/create-academy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-academy.js","sourceRoot":"","sources":["../../src/commands/create-academy.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,oEA0CC;AArDD,uCAAyB;AACzB,8CAAgC;AAChC,6CAAyD;AACzD,0CAAuC;AACvC,gDAA8C;AAE9C,SAAS,OAAO,CAAC,KAAa,EAAE,QAAkB;IAChD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,4BAA4B,CAAC,SAAkB;IAC7D,SAAS;SACN,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,gDAAgD,CAAC;SAC7D,cAAc,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;SACvD,MAAM,CACL,iBAAiB,EACjB,4GAA4G,EAC5G,OAAO,EACP,EAAc,CACf;SACA,MAAM,CAAC,qBAAqB,EAAE,iBAAiB,EAAE,QAAQ,CAAC;SAC1D,MAAM,CAAC,qBAAqB,EAAE,uCAAuC,CAAC;SACtE,MAAM,CACL,KAAK,EAAE,IAKN,EAAE,EAAE;QACH,MAAM,GAAG,GAAG,IAAA,8BAAqB,EAAC,IAAI,CAAC,KAAK,EAAE;YAC5C,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAErE,IAAA,sBAAU,EAAC,oBAAoB,EAAE;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM;SACjC,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAC3C,IAAA,eAAM,EACJ,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EACrE,oCAAoC,IAAI,CAAC,MAAM,EAAE,CAClD,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CACF,CAAC;AACN,CAAC"}

package/dist/commands/create-brand.d.ts

@@ -1,8 +1,3 @@
 import { Command } from 'commander';
-export declare function scaffoldBrand(niche: string, options: {
-    name?: string;
-    domain?: string;
-    orgSlug?: string;
-}): string;
 export declare function registerCreateBrandCommand(createCmd: Command): void;
 //# sourceMappingURL=create-brand.d.ts.map

package/dist/commands/create-brand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-brand.d.ts","sourceRoot":"","sources":["../../src/commands/create-brand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAsDlH;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,OAAO,QA2B5D"}
+{"version":3,"file":"create-brand.d.ts","sourceRoot":"","sources":["../../src/commands/create-brand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,OAAO,QA8B5D"}

package/dist/commands/create-brand.js

@@ -33,89 +33,30 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.scaffoldBrand = scaffoldBrand;
 exports.registerCreateBrandCommand = registerCreateBrandCommand;
 const fs = __importStar(require("fs"));
 const yaml = __importStar(require("js-yaml"));
+const shared_1 = require("@graspful/shared");
 const output_1 = require("../lib/output");
 const analytics_1 = require("../lib/analytics");
-const NICHE_PRESETS = {
-    education: { preset: 'blue', tagline: 'Learn smarter, not harder', headline: 'Master any subject with adaptive learning' },
-    healthcare: { preset: 'emerald', tagline: 'Training that saves lives', headline: 'Adaptive healthcare education for professionals' },
-    finance: { preset: 'slate', tagline: 'Build financial expertise', headline: 'Master finance with adaptive learning' },
-    tech: { preset: 'indigo', tagline: 'Level up your skills', headline: 'Adaptive tech training that meets you where you are' },
-    legal: { preset: 'amber', tagline: 'Know the law, pass the exam', headline: 'Adaptive legal education for exam success' },
-    default: { preset: 'blue', tagline: 'Learn adaptively', headline: 'Personalized learning that works' },
-};
-function scaffoldBrand(niche, options) {
-    const config = NICHE_PRESETS[niche] || NICHE_PRESETS['default'];
-    const slug = (options.name || niche).toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
-    const name = options.name || `${niche.charAt(0).toUpperCase() + niche.slice(1)} Academy`;
-    const domain = options.domain || `${slug}.graspful.ai`;
-    return yaml.dump({
-        brand: {
-            id: slug,
-            name,
-            domain,
-            tagline: config.tagline,
-            logoUrl: '/icon.svg',
-            orgSlug: options.orgSlug || 'TODO: your-org-slug',
-        },
-        theme: {
-            preset: config.preset,
-            radius: '0.5rem',
-        },
-        landing: {
-            hero: {
-                headline: config.headline,
-                subheadline: `${name} uses adaptive learning to help you master concepts faster.`,
-                ctaText: 'Start Learning',
-            },
-            features: {
-                heading: 'Why choose us?',
-                items: [
-                    { title: 'Adaptive Learning', description: 'Content adapts to your knowledge level', icon: 'brain' },
-                    { title: 'Spaced Repetition', description: 'Review at optimal intervals for lasting memory', icon: 'clock' },
-                    { title: 'Progress Tracking', description: 'See exactly where you stand', icon: 'chart' },
-                ],
-            },
-            howItWorks: {
-                heading: 'How it works',
-                items: [
-                    { title: 'Take a diagnostic', description: 'We assess what you already know' },
-                    { title: 'Learn adaptively', description: 'Focus on gaps, skip what you know' },
-                    { title: 'Master the material', description: 'Prove mastery through progressive challenges' },
-                ],
-            },
-            faq: [],
-        },
-        pricing: {
-            monthly: 0,
-            currency: 'usd',
-            trialDays: 0,
-        },
-        seo: {
-            title: `${name} — Adaptive Learning`,
-            description: config.tagline,
-            keywords: [niche, 'learning', 'adaptive', 'education'],
-        },
-    }, { lineWidth: 120, noRefs: true });
-}
 function registerCreateBrandCommand(createCmd) {
     createCmd
         .command('brand')
         .description('Generate a brand YAML scaffold')
         .requiredOption('--niche <niche>', 'Brand niche (education, healthcare, finance, tech, legal)')
         .option('--name <name>', 'Brand name')
+        .option('--topic <topic>', 'Academy topic for more specific landing-page copy')
         .option('--domain <domain>', 'Custom domain')
         .option('--org <slug>', 'Organization slug')
         .option('-o, --output <file>', 'Output file path (defaults to stdout)')
         .action(async (opts) => {
-        const yamlContent = scaffoldBrand(opts.niche, {
+        const obj = (0, shared_1.scaffoldBrandObject)(opts.niche, {
             name: opts.name,
+            topic: opts.topic,
             domain: opts.domain,
             orgSlug: opts.org,
         });
+        const yamlContent = yaml.dump(obj, { lineWidth: 120, noRefs: true });
         (0, analytics_1.cliCapture)('brand scaffolded', { niche: opts.niche });
         if (opts.output) {
             fs.writeFileSync(opts.output, yamlContent);

package/dist/commands/create-brand.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-brand.js","sourceRoot":"","sources":["../../src/commands/create-brand.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create-brand.js","sourceRoot":"","sources":["../../src/commands/create-brand.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,gEA8BC;AApCD,uCAAyB;AACzB,8CAAgC;AAChC,6CAAuD;AACvD,0CAAuC;AACvC,gDAA8C;AAE9C,SAAgB,0BAA0B,CAAC,SAAkB;IAC3D,SAAS;SACN,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,gCAAgC,CAAC;SAC7C,cAAc,CAAC,iBAAiB,EAAE,2DAA2D,CAAC;SAC9F,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC;SACrC,MAAM,CAAC,iBAAiB,EAAE,mDAAmD,CAAC;SAC9E,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC;SAC5C,MAAM,CAAC,cAAc,EAAE,mBAAmB,CAAC;SAC3C,MAAM,CAAC,qBAAqB,EAAE,uCAAuC,CAAC;SACtE,MAAM,CAAC,KAAK,EAAE,IAAsG,EAAE,EAAE;QACvH,MAAM,GAAG,GAAG,IAAA,4BAAmB,EAAC,IAAI,CAAC,KAAK,EAAE;YAC1C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,GAAG;SAClB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAErE,IAAA,sBAAU,EAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAC3C,IAAA,eAAM,EACJ,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EACxC,6BAA6B,IAAI,CAAC,MAAM,EAAE,CAC3C,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/create-course.d.ts

@@ -1,7 +1,3 @@
 import { Command } from 'commander';
-export declare function scaffoldCourse(topic: string, options: {
-    hours?: number;
-    source?: string;
-}): string;
 export declare function registerCreateCourseCommand(program: Command): Command;
 //# sourceMappingURL=create-course.d.ts.map

package/dist/commands/create-course.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-course.d.ts","sourceRoot":"","sources":["../../src/commands/create-course.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA4BlG;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,WAkC3D"}
+{"version":3,"file":"create-course.d.ts","sourceRoot":"","sources":["../../src/commands/create-course.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,WAkC3D"}

package/dist/commands/create-course.js

@@ -33,41 +33,12 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.scaffoldCourse = scaffoldCourse;
 exports.registerCreateCourseCommand = registerCreateCourseCommand;
 const fs = __importStar(require("fs"));
 const yaml = __importStar(require("js-yaml"));
+const shared_1 = require("@graspful/shared");
 const output_1 = require("../lib/output");
 const analytics_1 = require("../lib/analytics");
-function scaffoldCourse(topic, options) {
-    const slug = topic.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
-    return yaml.dump({
-        course: {
-            id: slug,
-            name: topic,
-            description: `Adaptive course on ${topic}`,
-            estimatedHours: options.hours || 10,
-            version: '2026.1',
-            sourceDocument: options.source || 'TODO: Add source document',
-        },
-        sections: [
-            { id: 'foundations', name: 'Foundations', description: 'Core concepts' },
-            { id: 'application', name: 'Application', description: 'Applied concepts' },
-        ],
-        concepts: [
-            {
-                id: `${slug}-intro`,
-                name: `Introduction to ${topic}`,
-                section: 'foundations',
-                difficulty: 2,
-                estimatedMinutes: 15,
-                tags: ['foundational'],
-                prerequisites: [],
-                knowledgePoints: [],
-            },
-        ],
-    }, { lineWidth: 120, noRefs: true });
-}
 function registerCreateCourseCommand(program) {
     const create = program
         .command('create')
@@ -81,17 +52,17 @@ function registerCreateCourseCommand(program) {
         .option('-o, --output <file>', 'Output file path (defaults to stdout)')
         .option('--scaffold-only', 'Generate scaffold without AI enrichment', true)
         .action(async (opts) => {
-        const yamlContent = scaffoldCourse(opts.topic, {
+        const obj = (0, shared_1.scaffoldCourseObject)(opts.topic, {
             hours: parseInt(opts.hours, 10),
             source: opts.source,
         });
+        const yamlContent = yaml.dump(obj, { lineWidth: 120, noRefs: true });
         (0, analytics_1.cliCapture)('course scaffolded', { topic: opts.topic, estimated_hours: parseInt(opts.hours, 10) });
         if (opts.output) {
             fs.writeFileSync(opts.output, yamlContent);
             (0, output_1.output)({ file: opts.output, topic: opts.topic }, `Scaffold written to ${opts.output}`);
         }
         else {
-            // Output raw YAML to stdout (not wrapped in JSON even in json mode for piping)
             console.log(yamlContent);
         }
     });

package/dist/commands/create-course.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-course.js","sourceRoot":"","sources":["../../src/commands/create-course.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create-course.js","sourceRoot":"","sources":["../../src/commands/create-course.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,kEAkCC;AAxCD,uCAAyB;AACzB,8CAAgC;AAChC,6CAAwD;AACxD,0CAAuC;AACvC,gDAA8C;AAE9C,SAAgB,2BAA2B,CAAC,OAAgB;IAC1D,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,yBAAyB,CAAC,CAAC;IAE1C,MAAM;SACH,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,iCAAiC,CAAC;SAC9C,cAAc,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;SACtD,MAAM,CAAC,iBAAiB,EAAE,wBAAwB,EAAE,IAAI,CAAC;SACzD,MAAM,CAAC,mBAAmB,EAAE,2BAA2B,CAAC;SACxD,MAAM,CAAC,qBAAqB,EAAE,uCAAuC,CAAC;SACtE,MAAM,CAAC,iBAAiB,EAAE,yCAAyC,EAAE,IAAI,CAAC;SAC1E,MAAM,CAAC,KAAK,EAAE,IAA+F,EAAE,EAAE;QAChH,MAAM,GAAG,GAAG,IAAA,6BAAoB,EAAC,IAAI,CAAC,KAAK,EAAE;YAC3C,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAErE,IAAA,sBAAU,EAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QAElG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAC3C,IAAA,eAAM,EACJ,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EACxC,uBAAuB,IAAI,CAAC,MAAM,EAAE,CACrC,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/commands/describe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/commands/describe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyCpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QA8GvD"}
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/commands/describe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QA8CvD"}

package/dist/commands/describe.js

@@ -39,35 +39,6 @@ const yaml = __importStar(require("js-yaml"));
 const shared_1 = require("@graspful/shared");
 const output_1 = require("../lib/output");
 const analytics_1 = require("../lib/analytics");
-function computeGraphDepth(concepts) {
-    const graph = new Map();
-    for (const c of concepts) {
-        graph.set(c.id, c.prerequisites);
-    }
-    const memo = new Map();
-    function depth(id, visited) {
-        if (memo.has(id))
-            return memo.get(id);
-        if (visited.has(id))
-            return 0; // cycle, avoid infinite loop
-        visited.add(id);
-        const prereqs = graph.get(id) ?? [];
-        let maxPrereqDepth = 0;
-        for (const prereq of prereqs) {
-            if (graph.has(prereq)) {
-                maxPrereqDepth = Math.max(maxPrereqDepth, depth(prereq, visited));
-            }
-        }
-        const d = maxPrereqDepth + 1;
-        memo.set(id, d);
-        return d;
-    }
-    let maxDepth = 0;
-    for (const c of concepts) {
-        maxDepth = Math.max(maxDepth, depth(c.id, new Set()));
-    }
-    return maxDepth;
-}
 function registerDescribeCommand(program) {
     program
         .command('describe <file>')
@@ -91,70 +62,22 @@ function registerDescribeCommand(program) {
             (0, output_1.outputError)(`Invalid course YAML: ${result.error.issues[0]?.message ?? 'unknown error'}`);
             process.exit(1);
         }
-        const data = result.data;
-        const concepts = data.concepts;
-        const sections = data.sections;
-        const authoredConcepts = concepts.filter((c) => c.knowledgePoints.length > 0);
-        const stubConcepts = concepts.filter((c) => c.knowledgePoints.length === 0);
-        const kpCount = concepts.reduce((sum, c) => sum + c.knowledgePoints.length, 0);
-        const problemCount = concepts.reduce((sum, c) => sum + c.knowledgePoints.reduce((s, kp) => s + kp.problems.length, 0), 0);
-        const graphDepth = computeGraphDepth(concepts);
-        const conceptsWithoutKps = stubConcepts.map((c) => c.id);
-        const kpsWithoutProblems = [];
-        for (const c of concepts) {
-            for (const kp of c.knowledgePoints) {
-                if (kp.problems.length === 0) {
-                    kpsWithoutProblems.push(`${c.id}/${kp.id}`);
-                }
-            }
-        }
-        // Section breakdown
-        const sectionBreakdown = [];
-        if (sections.length > 0) {
-            for (const section of sections) {
-                const sectionConcepts = concepts.filter((c) => c.section === section.id);
-                const sKps = sectionConcepts.reduce((sum, c) => sum + c.knowledgePoints.length, 0);
-                const sProblems = sectionConcepts.reduce((sum, c) => sum + c.knowledgePoints.reduce((s, kp) => s + kp.problems.length, 0), 0);
-                sectionBreakdown.push({ section: section.id, concepts: sectionConcepts.length, kps: sKps, problems: sProblems });
-            }
-            // Concepts without a section
-            const unsectioned = concepts.filter((c) => !c.section);
-            if (unsectioned.length > 0) {
-                const uKps = unsectioned.reduce((sum, c) => sum + c.knowledgePoints.length, 0);
-                const uProblems = unsectioned.reduce((sum, c) => sum + c.knowledgePoints.reduce((s, kp) => s + kp.problems.length, 0), 0);
-                sectionBreakdown.push({ section: '(unsectioned)', concepts: unsectioned.length, kps: uKps, problems: uProblems });
-            }
-        }
-        const stats = {
-            courseName: data.course.name,
-            courseId: data.course.id,
-            version: data.course.version,
-            estimatedHours: data.course.estimatedHours,
-            concepts: concepts.length,
-            authoredConcepts: authoredConcepts.length,
-            stubConcepts: stubConcepts.length,
-            knowledgePoints: kpCount,
-            problems: problemCount,
-            graphDepth,
-            conceptsWithoutKps: conceptsWithoutKps.length,
-            kpsWithoutProblems: kpsWithoutProblems.length,
-            sections: sectionBreakdown,
-        };
+        const stats = (0, shared_1.describeCourse)(result.data);
         const humanLines = [
-            `Course: "${data.course.name}" (v${data.course.version})`,
-            `Concepts: ${concepts.length} (${authoredConcepts.length} authored, ${stubConcepts.length} stubs)`,
-            `KPs: ${kpCount}, Problems: ${problemCount}`,
-            `Graph depth: ${graphDepth}`,
-            `Missing: ${conceptsWithoutKps.length} concepts need KPs, ${kpsWithoutProblems.length} KPs need problems`,
+            `Course: "${stats.courseName}" (v${stats.version})`,
+            `Concepts: ${stats.concepts} (${stats.authoredConcepts} authored, ${stats.stubConcepts} stubs)`,
+            `KPs: ${stats.knowledgePoints}, Problems: ${stats.problems}`,
+            `Graph depth: ${stats.graphDepth}`,
+            `Missing: ${stats.conceptsWithoutKps} concepts need KPs, ${stats.kpsWithoutProblems} KPs need problems`,
         ];
-        if (sectionBreakdown.length > 0) {
+        if (stats.sections.length > 0) {
             humanLines.push('');
             humanLines.push('Sections:');
-            for (const s of sectionBreakdown) {
+            for (const s of stats.sections) {
                 humanLines.push(`  ${s.section}: ${s.concepts} concepts, ${s.kps} KPs, ${s.problems} problems`);
             }
         }
-        (0, analytics_1.cliCapture)('course described', { concept_count: concepts.length, kp_count: kpCount, problem_count: problemCount });
+        (0, analytics_1.cliCapture)('course described', { concept_count: stats.concepts, kp_count: stats.knowledgePoints, problem_count: stats.problems });
         (0, output_1.output)(stats, humanLines.join('\n'));
     });
 }

package/dist/commands/describe.js.map

@@ -1 +1 @@
-{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../src/commands/describe.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../src/commands/describe.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,0DA8CC;AApDD,uCAAyB;AACzB,8CAAgC;AAChC,6CAAoE;AACpE,0CAAoD;AACpD,gDAA8C;AAE9C,SAAgB,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,IAAA,oBAAW,EAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,GAAY,CAAC;QACjB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,IAAA,oBAAW,EAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,yBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,IAAA,oBAAW,EAAC,wBAAwB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,eAAe,EAAE,CAAC,CAAC;YAC1F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,KAAK,GAAG,IAAA,uBAAc,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE1C,MAAM,UAAU,GAAG;YACjB,YAAY,KAAK,CAAC,UAAU,OAAO,KAAK,CAAC,OAAO,GAAG;YACnD,aAAa,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,gBAAgB,cAAc,KAAK,CAAC,YAAY,SAAS;YAC/F,QAAQ,KAAK,CAAC,eAAe,eAAe,KAAK,CAAC,QAAQ,EAAE;YAC5D,gBAAgB,KAAK,CAAC,UAAU,EAAE;YAClC,YAAY,KAAK,CAAC,kBAAkB,uBAAuB,KAAK,CAAC,kBAAkB,oBAAoB;SACxG,CAAC;QAEF,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpB,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC7B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC/B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,QAAQ,cAAc,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,QAAQ,WAAW,CAAC,CAAC;YAClG,CAAC;QACH,CAAC;QAED,IAAA,sBAAU,EAAC,kBAAkB,EAAE,EAAE,aAAa,EAAE,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,eAAe,EAAE,aAAa,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClI,IAAA,eAAM,EAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/fill-concept.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fill-concept.d.ts","sourceRoot":"","sources":["../../src/commands/fill-concept.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,WA4F1D"}
+{"version":3,"file":"fill-concept.d.ts","sourceRoot":"","sources":["../../src/commands/fill-concept.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,WA+C1D"}