@lernapps/tooling 0.1.2 → 0.1.3

package/dist/cli.mjs

@@ -1527,7 +1527,7 @@ function contents(dir) {
 		if (name === ".git" || name === "skills-lock.json" && skills.size > 0) return [];
 		if (name === "node_modules" || name === "package-lock.json") return [];
 		if (name === "package.json" && readJson(join(dir, name)).lernapps?.init === true) return [];
-		if (name === ".vibe") return within(name, (file) => file === "plan.md" || file === "plans").concat(existsSync(join(dir, ".vibe/plans")) ? within(PLANS, (file) => PLAN_NAME.test(file)) : []);
+		if (name === ".vibe") return existsSync(join(dir, ".vibe/plans")) ? within(PLANS, (file) => PLAN_NAME.test(file)) : [];
 		if ((name === ".agents" || name === ".claude") && skills.size > 0) return within(name, (folder) => folder === "skills").concat(existsSync(join(dir, name, "skills")) ? within(`${name}/skills`, (skill) => skills.has(skill)) : []);
 		return [name];
 	});
@@ -1691,7 +1691,7 @@ function create(args) {
 	if (positionals.length > 1) throw new UsageError(`one <dir> at most, not ${positionals.join(" ")}`);
 	const dir = resolve(positionals[0] ?? ".");
 	const found = contents(dir);
-	if (found.length > 0) throw new CreateError(`${dir} is not empty (${found.slice(0, 5).join(", ")}${found.length > 5 ? ", ..." : ""}): create the app in an empty folder; only .git, the first version's plan .vibe/plans/01-<short name>.md and what lernapps init wrote (its skills, package.json, package-lock.json and node_modules) may be there`);
+	if (found.length > 0) throw new CreateError(`${dir} is not empty (${found.slice(0, 5).join(", ")}${found.length > 5 ? ", ..." : ""}): create the app in an empty folder; only .git, .vibe/ (the first version's plan .vibe/plans/01-<short name>.md, and its sketches) and what lernapps init wrote (its skills, package.json, package-lock.json and node_modules) may be there`);
 	const plan = confirmedPlan(dir, archetype, values.plan);
 	const architecture = ARCHITECTURE_ARCHETYPES.includes(archetype);
 	if (!existsSync(join(templates.root, archetype, "package.json"))) throw new CreateError(`${templates.root} has no template ${archetype}/ (version ${templates.version})`);

package/dist/skills/lernapps-content-questions/references/question-types.md

@@ -7,7 +7,7 @@
 | `true-false` | `answer` (true or false) |
 | `number` | `answer`, `tolerance` (0 = exact), `unit` if any; the learner may type a comma or a point |
 | `ordering` | `items` in the right order; the page mixes them |
-| `matching` | `pairs` as they belong; the page mixes the right side. `distractors` (1 to 4): wrong right entries that match no left one. `pairsFrom: material` instead of `pairs` takes them from the `labelled-figure` in `material` (marker left, text right; the figure needs `legend: false`) |
+| `matching` | `pairs` as they belong, each pair an object `{ left, right }`; the page mixes the right side. `distractors` (1 to 4): wrong right entries that match no left one. `pairsFrom: material` instead of `pairs` takes them from the `labelled-figure` in `material` (marker left, text right; the figure needs `legend: false`) |
 
 - Every question: `id`, `text`, `explanation`, at least one link in `links`. Optional quiz `sources`.
 - Types without options carry their background in `explanation`.

package/dist/skills/lernapps-explainer/SKILL.md

@@ -28,6 +28,8 @@ license: MIT
 
 - A build problem is one line `file:line: place (language): what to do`. Fix where it points.
 - Headings are `section` blocks, never Markdown headings.
+- YAML: quote a text that has `: ` in it or looks like a number (`"8."`, `"01000001"`, `"0"`). Unquoted, YAML reads a map or a
+  number: the build stops, or the digits change. A table cell, a header cell too, is a text and never empty.
 - A new chapter: a folder with `chapter.yaml`, listed in `src/app.yaml`, each page listed in `chapter.yaml`.
 - `selfAssessment` in a `chapter.yaml`: written in Commit, skill
   `lernapps-explainer-self-assessment`. An exercise it names renamed or moved → change the reference too.

package/generator/create.ts

@@ -174,9 +174,9 @@ function contents(dir: string): string[] {
     if (name === "node_modules" || name === "package-lock.json") return [];
     if (name === "package.json" && readJson(join(dir, name)).lernapps?.init === true) return [];
     if (name === ".vibe") {
-      return within(name, (file) => file === "plan.md" || file === "plans").concat(
-        existsSync(join(dir, PLANS)) ? within(PLANS, (file) => PLAN_NAME.test(file)) : [],
-      );
+      // the planning folder: the plans are checked (a first version has one), what the planning leaves beside them stays
+      // (the sketches of the plan, .vibe/sketches/)
+      return existsSync(join(dir, PLANS)) ? within(PLANS, (file) => PLAN_NAME.test(file)) : [];
     }
     if ((name === ".agents" || name === ".claude") && skills.size > 0) {
       return within(name, (folder) => folder === "skills").concat(
@@ -384,7 +384,7 @@ export function create(args: string[]): number {
   const found = contents(dir);
   if (found.length > 0) {
     throw new CreateError(
-      `${dir} is not empty (${found.slice(0, 5).join(", ")}${found.length > 5 ? ", ..." : ""}): create the app in an empty folder; only .git, the first version's plan .vibe/plans/01-<short name>.md and what lernapps init wrote (its skills, package.json, package-lock.json and node_modules) may be there`,
+      `${dir} is not empty (${found.slice(0, 5).join(", ")}${found.length > 5 ? ", ..." : ""}): create the app in an empty folder; only .git, .vibe/ (the first version's plan .vibe/plans/01-<short name>.md, and its sketches) and what lernapps init wrote (its skills, package.json, package-lock.json and node_modules) may be there`,
     );
   }
   const plan = confirmedPlan(dir, archetype, values.plan);

package/guidance/increment-template.md

@@ -100,7 +100,7 @@ questions. -->
       `lernapps-<archetype>-design` says, choose its pattern with skill `lernapps-exercise-patterns` (both loaded
       in Explore), and say why the guide's patterns do not fit.
 - [ ] Each new component or interactive exercise: a sketch (static SVG or image, or the steps). Words alone are not
-      enough.
+      enough. Keep sketch files in `.vibe/sketches/`.
 - [ ] Show the creator, short: goal, new competencies by chapter, slices; in plain words what learners see and do,
       what is new. At most 2 questions.
 - [ ] **Checkpoint:** confirm the plan and the content method. Stop and wait for an explicit yes. Changes → change,

package/guidance/plan-template.md

@@ -133,7 +133,7 @@ questions. -->
 - [ ] Write the Code tasks under "Code": pages or screens, their content, what each shows. Each ends in a commit.
       After the first task that shows real content: the task "Show the creator a first look (`early-preview`)".
 - [ ] Each screen, component or interactive exercise: a sketch (static SVG or image, or the steps with what
-      learners see after each). Words alone are not enough.
+      learners see after each). Words alone are not enough. Keep sketch files in `.vibe/sketches/`, which `create` leaves alone.
 - [ ] Show the creator, short: goal, competencies by chapter, entry draft, tasks, sketches; the content method in
       plain words (what learners see and do, what it cannot do). At most 2 questions.
 - [ ] **Checkpoint:** confirm the plan and the content method, with the sketches shown. Stop and wait for an

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lernapps/tooling",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Shared tooling of the lernapps.net apps and sites: the CLI lernapps, site actions, Renovate preset, guidance for building apps; documentation at https://lernapps.net/tooling/",
   "license": "MIT",
   "repository": {

package/skills/archetypes/lernapps-explainer/SKILL.md

@@ -28,6 +28,8 @@ license: MIT
 
 - A build problem is one line `file:line: place (language): what to do`. Fix where it points.
 - Headings are `section` blocks, never Markdown headings.
+- YAML: quote a text that has `: ` in it or looks like a number (`"8."`, `"01000001"`, `"0"`). Unquoted, YAML reads a map or a
+  number: the build stops, or the digits change. A table cell, a header cell too, is a text and never empty.
 - A new chapter: a folder with `chapter.yaml`, listed in `src/app.yaml`, each page listed in `chapter.yaml`.
 - `selfAssessment` in a `chapter.yaml`: written in Commit, skill
   `lernapps-explainer-self-assessment`. An exercise it names renamed or moved → change the reference too.

package/skills/content/lernapps-content-questions/references/question-types.md

@@ -7,7 +7,7 @@
 | `true-false` | `answer` (true or false) |
 | `number` | `answer`, `tolerance` (0 = exact), `unit` if any; the learner may type a comma or a point |
 | `ordering` | `items` in the right order; the page mixes them |
-| `matching` | `pairs` as they belong; the page mixes the right side. `distractors` (1 to 4): wrong right entries that match no left one. `pairsFrom: material` instead of `pairs` takes them from the `labelled-figure` in `material` (marker left, text right; the figure needs `legend: false`) |
+| `matching` | `pairs` as they belong, each pair an object `{ left, right }`; the page mixes the right side. `distractors` (1 to 4): wrong right entries that match no left one. `pairsFrom: material` instead of `pairs` takes them from the `labelled-figure` in `material` (marker left, text right; the figure needs `legend: false`) |
 
 - Every question: `id`, `text`, `explanation`, at least one link in `links`. Optional quiz `sources`.
 - Types without options carry their background in `explanation`.