@antoneeo/course-creator 0.1.0-beta.2 → 0.1.0-beta.4

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.1.0-beta.4] - 2026-10-17
+
+### Changed
+- F-068 (shared doctrine with kb-agentic): the supersession cascade runs at the unit's closure, once for every supersession since the last one, instead of at each supersession.
+- F1: closing the last open workstream now empties the generated registry `audit/handoff.md` instead of leaving its stale row behind: with zero `HANDOFF_*.md` sources `index` rewrites it empty (keeping `project_notes.md`), and `validate` reports a generated registry that still has rows but no sources as an error.
+- F-069: `graph`, `check`, `stale` and the session-start count are faster on a mature knowledge base, with byte-identical output. Citations of superseded claim ids are found with one pass per living document instead of one scan per (document, id) pair, and one check run reads and resolves each cited extraction once instead of once per claim row. On a synthetic ledger of 2183 rows and 1000 living documents, `graph` drops from 14 s to 4 s. No new flag.
+
+## [0.1.0-beta.3] - 2026-10-13
+
+### Changed
+- F-067: every L3 unit now keeps a verbatim, append-only request record `audit/requests/REQUEST_course_<slug>.md`, started before the Vision Gate: the owner's opening words and every later statement that settles something (answers, approvals, costs, rulings). Artifacts cite its entries instead of paraphrasing; the shared `review.md` asks for the record and makes an owner statement with no resolving entry a finding. Secrets, personal data and confidential third-party or employer information are redacted.
+
 ## [0.1.0-beta.2] - 2026-10-08
 
 ### Changed

package/README.md

@@ -2,7 +2,7 @@
 
 `course-creator` helps an AI agent create a course for a defined learner. It maps what the learner already knows, orders concepts by prerequisite, writes explanations in progressive modules, and links factual statements to reopenable sources. Independent fresh learner agents can expose confusing steps; their results are diagnostic. The course is labeled **efficacy not verified** until enough evidence from real learners supports a narrower claim.
 
-The package is the fourth lens of the Agentic SDLC family. It uses the shared `ai_docs/` project memory and governance. Version 0.1.0-beta.2 supports Standalone mode. This is an experimental beta: the authoring method and artifact contracts may change; human learning efficacy has not been established. Its course artifacts remain readable without the skill.
+The package is the fourth lens of the Agentic SDLC family. It uses the shared `ai_docs/` project memory and governance. Version 0.1.0-beta.4 supports Standalone mode. This is an experimental beta: the authoring method and artifact contracts may change; human learning efficacy has not been established. Its course artifacts remain readable without the skill. Each new course keeps a verbatim, append-only record of the requester's own words and decisions in `audit/requests/`, cited by the analysis and checked by its reviews.
 
 ## Install and initialize
 

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "course-creator",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.4",
   "description": "Course creation for defined learners, with progressive explanations, sourced facts and diagnostic independent testing.",
   "author": "Antonio Pinto (https://github.com/Antoneeo)"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antoneeo/course-creator",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.4",
   "description": "Design sourced, progressive courses for a defined learner with Agentic SDLC governance and diagnostic learner simulations.",
   "keywords": ["claude-code", "gemini-cli", "codex", "course-design", "skill", "ai-agent"],
   "author": "Antonio Pinto (https://github.com/Antoneeo)",

package/scripts/init.js

@@ -1,62 +1,62 @@
-#!/usr/bin/env node
-"use strict";
-const fs = require('fs');
-const path = require('path');
-const { execFileSync } = require('child_process');
-const { SKILL_SOURCE, INSTALLED_SKILL_NAME, SELF_LENS, SIBLING_LENSES,
-  CLIENTS, clientDetected, skillTarget, wireOrientHook, detectPython } = require('./lib');
-
-const root = process.cwd();
-const seed = new Map([
-  ['ai_docs/README.md', `---\ndefault_domain: course\n---\n# Project knowledge and course work\n\nRead vision/project_vision.md, INDEX.md and reference/INDEX.md first.\n`],
-  ['ai_docs/vision/project_vision.md', `---\ndescription: Project benefit and boundaries.\nstatus: DRAFT\n---\n# Project Vision\nStatus: DRAFT\n\n## Expected Benefit\n<Discuss with the owner.>\n`],
-  ['ai_docs/vision/roadmap.md', `---\ndescription: Project learning and delivery roadmap.\nstatus: DRAFT\n---\n# Roadmap\nStatus: DRAFT\n`],
-  ['ai_docs/vision/principles.md', `---\ndescription: Decisions that constrain project work.\nstatus: DRAFT\n---\n# Principles\nStatus: DRAFT\n`],
-  ['ai_docs/strategic/architecture.md', `---\ndescription: Verified component inventory.\nstatus: CURRENT\n---\n# Architecture\n\n## Component Map\n| Component | Capability it owns | Contract | Where |\n|---|---|---|---|\n\n## Architectural Patterns\n<Add only verified patterns.>\n`],
-  ['ai_docs/strategic/existing_features.md', `---\ndescription: Existing capabilities verified in this project.\nstatus: CURRENT\n---\n# Existing Features\n`],
-  ['ai_docs/audit/audit_plan.md', `# Audit Plan\n\n| Area | State | Reference | Notes |\n|---|---|---|---|\n| . | PENDING | - | Initial analysis |\n`],
-]);
-function writeIfAbsent(rel, content) {
-  const dest = path.join(root, rel);
-  if (fs.existsSync(dest)) return false;
-  fs.mkdirSync(path.dirname(dest), { recursive: true });
-  fs.writeFileSync(dest, content, 'utf8');
-  console.log(`Created ${rel}`);
-  return true;
-}
-for (const [rel, content] of seed) writeIfAbsent(rel, content);
-for (const dir of ['ai_docs/vision/features', 'ai_docs/reference', 'ai_docs/solutions/courses',
-  'ai_docs/audit/reviews']) fs.mkdirSync(path.join(root, dir), { recursive: true });
-
-const pointer = `# Course Creator project protocol\n\nUse the installed \`course-creator\` skill when the deliverable teaches a defined learner. It applies Agentic SDLC in Standalone mode: triage, project and course Vision, ANALYSIS, progressive explanations, sourced facts, independent diagnostic testing and a truthful efficacy label. Course files live in \`ai_docs/solutions/courses/<slug>/\`. Read \`ai_docs/README.md\` and the skill before working.\n\nInstall if missing: \`npm i -g @antoneeo/course-creator@beta && course-creator-install-skill\`.\n`;
-const pointers = { claude: 'CLAUDE.md', gemini: 'GEMINI.md', codex: 'AGENTS.md',
-  antigravity: 'AGENTS.md' };
-const detected = CLIENTS.filter(clientDetected);
-for (const client of detected) writeIfAbsent(pointers[client.key], pointer);
-writeIfAbsent('.cursorrules', pointer);
-const siblings = new Map();
-for (const client of detected) {
-  const parent = path.dirname(skillTarget(client));
-  for (const [name, lens] of Object.entries(SIBLING_LENSES)) {
-    if (fs.existsSync(path.join(parent, name))) siblings.set(name, lens);
-  }
-}
-if (siblings.size) {
-  const rows = [`- \`${INSTALLED_SKILL_NAME}\` — the **${SELF_LENS}** lens`,
-    ...[...siblings].map(([name, lens]) => `- \`${name}\` — the **${lens}** lens`)];
-  writeIfAbsent('AGENTIC_MULTI_LENS.md',
-    `# Agentic SDLC family routing\n\nRead \`routing.md\` to choose the owner of each deliverable; \`memory.md\` is shared.\n\n${rows.join('\n')}\n`);
-}
-const python = detectPython();
-for (const client of detected.filter(c => c.key === 'claude')) {
-  const result = wireOrientHook({ cwd: root, client, python, docsLabel: 'ai_docs' });
-  console.log(`Claude SessionStart orientation: ${result.code}`);
-}
-if (python) {
-  try {
-    execFileSync(python, [path.join(SKILL_SOURCE, 'scripts/sdlc_check.py'),
-      'index', '--root', root], { stdio: 'ignore' });
-    console.log('Generated ai_docs indexes.');
-  } catch (e) { console.log('Run sdlc_check.py index when Python is available.'); }
-}
-console.log('Course Creator initialization complete.');
+#!/usr/bin/env node
+"use strict";
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
+const { SKILL_SOURCE, INSTALLED_SKILL_NAME, SELF_LENS, SIBLING_LENSES,
+  CLIENTS, clientDetected, skillTarget, wireOrientHook, detectPython } = require('./lib');
+
+const root = process.cwd();
+const seed = new Map([
+  ['ai_docs/README.md', `---\ndefault_domain: course\n---\n# Project knowledge and course work\n\nRead vision/project_vision.md, INDEX.md and reference/INDEX.md first.\n`],
+  ['ai_docs/vision/project_vision.md', `---\ndescription: Project benefit and boundaries.\nstatus: DRAFT\n---\n# Project Vision\nStatus: DRAFT\n\n## Expected Benefit\n<Discuss with the owner.>\n`],
+  ['ai_docs/vision/roadmap.md', `---\ndescription: Project learning and delivery roadmap.\nstatus: DRAFT\n---\n# Roadmap\nStatus: DRAFT\n`],
+  ['ai_docs/vision/principles.md', `---\ndescription: Decisions that constrain project work.\nstatus: DRAFT\n---\n# Principles\nStatus: DRAFT\n`],
+  ['ai_docs/strategic/architecture.md', `---\ndescription: Verified component inventory.\nstatus: CURRENT\n---\n# Architecture\n\n## Component Map\n| Component | Capability it owns | Contract | Where |\n|---|---|---|---|\n\n## Architectural Patterns\n<Add only verified patterns.>\n`],
+  ['ai_docs/strategic/existing_features.md', `---\ndescription: Existing capabilities verified in this project.\nstatus: CURRENT\n---\n# Existing Features\n`],
+  ['ai_docs/audit/audit_plan.md', `# Audit Plan\n\n| Area | State | Reference | Notes |\n|---|---|---|---|\n| . | PENDING | - | Initial analysis |\n`],
+]);
+function writeIfAbsent(rel, content) {
+  const dest = path.join(root, rel);
+  if (fs.existsSync(dest)) return false;
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.writeFileSync(dest, content, 'utf8');
+  console.log(`Created ${rel}`);
+  return true;
+}
+for (const [rel, content] of seed) writeIfAbsent(rel, content);
+for (const dir of ['ai_docs/vision/features', 'ai_docs/reference', 'ai_docs/solutions/courses',
+  'ai_docs/audit/reviews']) fs.mkdirSync(path.join(root, dir), { recursive: true });
+
+const pointer = `# Course Creator project protocol\n\nUse the installed \`course-creator\` skill when the deliverable teaches a defined learner. It applies Agentic SDLC in Standalone mode: triage, project and course Vision, ANALYSIS, progressive explanations, sourced facts, independent diagnostic testing and a truthful efficacy label. Course files live in \`ai_docs/solutions/courses/<slug>/\`. Read \`ai_docs/README.md\` and the skill before working.\n\nInstall if missing: \`npm i -g @antoneeo/course-creator@beta && course-creator-install-skill\`.\n`;
+const pointers = { claude: 'CLAUDE.md', gemini: 'GEMINI.md', codex: 'AGENTS.md',
+  antigravity: 'AGENTS.md' };
+const detected = CLIENTS.filter(clientDetected);
+for (const client of detected) writeIfAbsent(pointers[client.key], pointer);
+writeIfAbsent('.cursorrules', pointer);
+const siblings = new Map();
+for (const client of detected) {
+  const parent = path.dirname(skillTarget(client));
+  for (const [name, lens] of Object.entries(SIBLING_LENSES)) {
+    if (fs.existsSync(path.join(parent, name))) siblings.set(name, lens);
+  }
+}
+if (siblings.size) {
+  const rows = [`- \`${INSTALLED_SKILL_NAME}\` — the **${SELF_LENS}** lens`,
+    ...[...siblings].map(([name, lens]) => `- \`${name}\` — the **${lens}** lens`)];
+  writeIfAbsent('AGENTIC_MULTI_LENS.md',
+    `# Agentic SDLC family routing\n\nRead \`routing.md\` to choose the owner of each deliverable; \`memory.md\` is shared.\n\n${rows.join('\n')}\n`);
+}
+const python = detectPython();
+for (const client of detected.filter(c => c.key === 'claude')) {
+  const result = wireOrientHook({ cwd: root, client, python, docsLabel: 'ai_docs' });
+  console.log(`Claude SessionStart orientation: ${result.code}`);
+}
+if (python) {
+  try {
+    execFileSync(python, [path.join(SKILL_SOURCE, 'scripts/sdlc_check.py'),
+      'index', '--root', root], { stdio: 'ignore' });
+    console.log('Generated ai_docs indexes.');
+  } catch (e) { console.log('Run sdlc_check.py index when Python is available.'); }
+}
+console.log('Course Creator initialization complete.');

package/scripts/lib.js

@@ -3,8 +3,8 @@
 
 const fs = require('fs');
 const path = require('path');
-const os = require('os');
-const crypto = require('crypto');
+const os = require('os');
+const crypto = require('crypto');
 const { execSync } = require('child_process');
 
 const PACKAGE_ROOT = path.resolve(__dirname, '..');
@@ -449,104 +449,104 @@ function pathsEqual(a, b) {
     return false;
   }
 }
-function pathInside(child, parent) {
+function pathInside(child, parent) {
   try {
     const rel = path.relative(String(parent), String(child));
     return rel !== '' && !rel.startsWith('..') && !path.isAbsolute(rel);
   } catch (e) {
     return false;
   }
-}
-
-// Ownership is per file. An existing directory without our marker belongs to its
-// owner, and a file edited after installation is retained on uninstall.
-const INSTALL_MARKER = '.course-creator-install.json';
-function hashFile(file) {
-  return crypto.createHash('sha256').update(fs.readFileSync(file)).digest('hex');
-}
-function sourceFiles(dir = SKILL_SOURCE, prefix = '') {
-  const found = [];
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    if (entry.isSymbolicLink()) continue;
-    const rel = path.join(prefix, entry.name);
-    if (entry.isDirectory()) found.push(...sourceFiles(path.join(dir, entry.name), rel));
-    else if (entry.isFile()) found.push(rel);
-  }
-  return found;
-}
-function safeOwnedPath(target, rel) {
-  if (path.isAbsolute(rel) || rel.split(/[\\/]/).includes('..')) return null;
-  const full = path.resolve(target, rel);
-  if (!pathInside(full, target)) return null;
-  let cur = path.resolve(target);
-  for (const part of path.relative(cur, full).split(path.sep)) {
-    cur = path.join(cur, part);
-    if (fs.existsSync(cur) && fs.lstatSync(cur).isSymbolicLink()) return null;
-  }
-  return full;
-}
-function ownedMarker(target) {
-  const marker = path.join(target, INSTALL_MARKER);
-  if (!fs.existsSync(marker)) return null;
-  try {
-    if (!fs.lstatSync(marker).isFile() || fs.lstatSync(marker).isSymbolicLink()) return null;
-    const data = JSON.parse(fs.readFileSync(marker, 'utf8'));
-    return data.skill === INSTALLED_SKILL_NAME && data.files &&
-      typeof data.files === 'object' ? data : null;
-  } catch (e) { return null; }
-}
-function installOwned(target) {
-  if (!fs.existsSync(SKILL_SOURCE)) return { code: 'missing-source' };
-  if (fs.existsSync(target) && (!fs.lstatSync(target).isDirectory() ||
-      fs.lstatSync(target).isSymbolicLink())) return { code: 'unowned' };
-  const existing = fs.existsSync(target) ? fs.readdirSync(target) : [];
-  const prior = ownedMarker(target);
-  if (existing.length && !prior) return { code: 'unowned' };
-  fs.mkdirSync(target, { recursive: true });
-  const owned = { ...(prior ? prior.files : {}) };
-  let copied = 0, preserved = 0;
-  for (const rel of sourceFiles()) {
-    const dest = safeOwnedPath(target, rel);
-    if (!dest) { preserved++; continue; }
-    if (fs.existsSync(dest)) {
-      if (!Object.hasOwn(owned, rel) || hashFile(dest) !== owned[rel]) {
-        preserved++; continue;
-      }
-    }
-    fs.mkdirSync(path.dirname(dest), { recursive: true });
-    fs.copyFileSync(path.join(SKILL_SOURCE, rel), dest);
-    owned[rel] = hashFile(dest);
-    copied++;
-  }
-  fs.writeFileSync(path.join(target, INSTALL_MARKER),
-    JSON.stringify({ skill: INSTALLED_SKILL_NAME, files: owned }, null, 2) + '\n');
-  return { code: 'installed', copied, preserved };
-}
-function uninstallOwned(target) {
-  if (!fs.existsSync(target) || fs.lstatSync(target).isSymbolicLink()) {
-    return { code: 'unowned' };
-  }
-  const prior = ownedMarker(target);
-  if (!prior) return { code: 'unowned' };
-  let removed = 0, preserved = 0;
-  for (const [rel, hash] of Object.entries(prior.files)) {
-    const dest = safeOwnedPath(target, rel);
-    if (!dest || !fs.existsSync(dest) || !fs.lstatSync(dest).isFile() ||
-        hashFile(dest) !== hash) { preserved++; continue; }
-    fs.unlinkSync(dest);
-    removed++;
-  }
-  fs.unlinkSync(path.join(target, INSTALL_MARKER));
-  // Remove only empty directories; a user-owned file keeps its parent.
-  const dirs = new Set(Object.keys(prior.files).map(rel => path.dirname(rel)));
-  for (const rel of [...dirs].sort((a, b) => b.length - a.length)) {
-    const dir = path.resolve(target, rel);
-    if (!pathInside(dir, target)) continue;
-    try { fs.rmdirSync(dir); } catch (e) { /* non-empty or absent */ }
-  }
-  try { fs.rmdirSync(target); } catch (e) { /* user files remain */ }
-  return { code: 'removed', removed, preserved };
-}
+}
+
+// Ownership is per file. An existing directory without our marker belongs to its
+// owner, and a file edited after installation is retained on uninstall.
+const INSTALL_MARKER = '.course-creator-install.json';
+function hashFile(file) {
+  return crypto.createHash('sha256').update(fs.readFileSync(file)).digest('hex');
+}
+function sourceFiles(dir = SKILL_SOURCE, prefix = '') {
+  const found = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isSymbolicLink()) continue;
+    const rel = path.join(prefix, entry.name);
+    if (entry.isDirectory()) found.push(...sourceFiles(path.join(dir, entry.name), rel));
+    else if (entry.isFile()) found.push(rel);
+  }
+  return found;
+}
+function safeOwnedPath(target, rel) {
+  if (path.isAbsolute(rel) || rel.split(/[\\/]/).includes('..')) return null;
+  const full = path.resolve(target, rel);
+  if (!pathInside(full, target)) return null;
+  let cur = path.resolve(target);
+  for (const part of path.relative(cur, full).split(path.sep)) {
+    cur = path.join(cur, part);
+    if (fs.existsSync(cur) && fs.lstatSync(cur).isSymbolicLink()) return null;
+  }
+  return full;
+}
+function ownedMarker(target) {
+  const marker = path.join(target, INSTALL_MARKER);
+  if (!fs.existsSync(marker)) return null;
+  try {
+    if (!fs.lstatSync(marker).isFile() || fs.lstatSync(marker).isSymbolicLink()) return null;
+    const data = JSON.parse(fs.readFileSync(marker, 'utf8'));
+    return data.skill === INSTALLED_SKILL_NAME && data.files &&
+      typeof data.files === 'object' ? data : null;
+  } catch (e) { return null; }
+}
+function installOwned(target) {
+  if (!fs.existsSync(SKILL_SOURCE)) return { code: 'missing-source' };
+  if (fs.existsSync(target) && (!fs.lstatSync(target).isDirectory() ||
+      fs.lstatSync(target).isSymbolicLink())) return { code: 'unowned' };
+  const existing = fs.existsSync(target) ? fs.readdirSync(target) : [];
+  const prior = ownedMarker(target);
+  if (existing.length && !prior) return { code: 'unowned' };
+  fs.mkdirSync(target, { recursive: true });
+  const owned = { ...(prior ? prior.files : {}) };
+  let copied = 0, preserved = 0;
+  for (const rel of sourceFiles()) {
+    const dest = safeOwnedPath(target, rel);
+    if (!dest) { preserved++; continue; }
+    if (fs.existsSync(dest)) {
+      if (!Object.hasOwn(owned, rel) || hashFile(dest) !== owned[rel]) {
+        preserved++; continue;
+      }
+    }
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.copyFileSync(path.join(SKILL_SOURCE, rel), dest);
+    owned[rel] = hashFile(dest);
+    copied++;
+  }
+  fs.writeFileSync(path.join(target, INSTALL_MARKER),
+    JSON.stringify({ skill: INSTALLED_SKILL_NAME, files: owned }, null, 2) + '\n');
+  return { code: 'installed', copied, preserved };
+}
+function uninstallOwned(target) {
+  if (!fs.existsSync(target) || fs.lstatSync(target).isSymbolicLink()) {
+    return { code: 'unowned' };
+  }
+  const prior = ownedMarker(target);
+  if (!prior) return { code: 'unowned' };
+  let removed = 0, preserved = 0;
+  for (const [rel, hash] of Object.entries(prior.files)) {
+    const dest = safeOwnedPath(target, rel);
+    if (!dest || !fs.existsSync(dest) || !fs.lstatSync(dest).isFile() ||
+        hashFile(dest) !== hash) { preserved++; continue; }
+    fs.unlinkSync(dest);
+    removed++;
+  }
+  fs.unlinkSync(path.join(target, INSTALL_MARKER));
+  // Remove only empty directories; a user-owned file keeps its parent.
+  const dirs = new Set(Object.keys(prior.files).map(rel => path.dirname(rel)));
+  for (const rel of [...dirs].sort((a, b) => b.length - a.length)) {
+    const dir = path.resolve(target, rel);
+    if (!pathInside(dir, target)) continue;
+    try { fs.rmdirSync(dir); } catch (e) { /* non-empty or absent */ }
+  }
+  try { fs.rmdirSync(target); } catch (e) { /* user files remain */ }
+  return { code: 'removed', removed, preserved };
+}
 
 // The marker lives under the family's agent-global root (the same root the
 // validator's AGENTIC_SDLC_KB_ROOT seam names), read at call time so the test
@@ -720,10 +720,10 @@ module.exports = {
   detectPython,
   pathsEqual,
   orientHookCommand,
-  copyRecursive,
-  installOwned,
-  uninstallOwned,
-  ownedMarker,
+  copyRecursive,
+  installOwned,
+  uninstallOwned,
+  ownedMarker,
   loadTemplates,
   templateFor,
 };

package/scripts/postinstall.js

@@ -1,16 +1,16 @@
-#!/usr/bin/env node
-"use strict";
-const { CLIENTS, clientDetected, skillTarget, installOwned,
-  wireGlobalOrientHook, detectPython } = require('./lib');
-
-for (const client of CLIENTS) {
-  if (!clientDetected(client)) continue;
-  const target = skillTarget(client);
-  const result = installOwned(target);
-  console.log(`${client.label}: ${result.code} (${target})`);
-  if (client.key === 'claude' && result.code === 'installed') {
-    try { wireGlobalOrientHook({ client, python: detectPython() }); }
-    catch (e) { console.log('Session orientation can be wired from ENFORCEMENT.md.'); }
-  }
-}
-console.log('Initialize a project with course-creator-init.');
+#!/usr/bin/env node
+"use strict";
+const { CLIENTS, clientDetected, skillTarget, installOwned,
+  wireGlobalOrientHook, detectPython } = require('./lib');
+
+for (const client of CLIENTS) {
+  if (!clientDetected(client)) continue;
+  const target = skillTarget(client);
+  const result = installOwned(target);
+  console.log(`${client.label}: ${result.code} (${target})`);
+  if (client.key === 'claude' && result.code === 'installed') {
+    try { wireGlobalOrientHook({ client, python: detectPython() }); }
+    catch (e) { console.log('Session orientation can be wired from ENFORCEMENT.md.'); }
+  }
+}
+console.log('Initialize a project with course-creator-init.');

package/scripts/preuninstall.js

@@ -1,12 +1,12 @@
-#!/usr/bin/env node
-"use strict";
-const { CLIENTS, skillTarget, ownedMarker, uninstallOwned,
-  removeGlobalOrientHooks } = require('./lib');
-
-const ownedTargets = CLIENTS.map(skillTarget).filter(ownedMarker);
-try { removeGlobalOrientHooks(ownedTargets); } catch (e) { /* convenience only */ }
-for (const target of ownedTargets) {
-  const result = uninstallOwned(target);
-  console.log(`${result.code}: ${target} (${result.removed} owned files removed; ` +
-    `${result.preserved} retained)`);
-}
+#!/usr/bin/env node
+"use strict";
+const { CLIENTS, skillTarget, ownedMarker, uninstallOwned,
+  removeGlobalOrientHooks } = require('./lib');
+
+const ownedTargets = CLIENTS.map(skillTarget).filter(ownedMarker);
+try { removeGlobalOrientHooks(ownedTargets); } catch (e) { /* convenience only */ }
+for (const target of ownedTargets) {
+  const result = uninstallOwned(target);
+  console.log(`${result.code}: ${target} (${result.removed} owned files removed; ` +
+    `${result.preserved} retained)`);
+}

package/skills/course-creator/ENFORCEMENT.md

@@ -47,8 +47,8 @@ The consolidated view is `sdlc_check.py stale` (the overlay intercepts
 the spine command, preserves its output, flags and exit code --
 `--hybrid` included -- and appends `## claims` only when nonempty). The
 orient append prints one count line at session start, only when dirty
-and always fail-open. Event-driven by design: reconciliation §2 runs
-`stale` after recording a supersession; nothing polls per turn.
+and always fail-open. Event-driven by design: reconciliation §2 runs `stale` at the unit's
+closure, once for every supersession since the last one; nothing polls per turn.
 
 ## 2. Check in CI (recommended for teams)
 

package/skills/course-creator/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: course-creator
-version: 0.1.0-beta.2
+version: 0.1.0-beta.4
 description: Design and improve courses that teach a defined learner through sourced, progressive explanations. Use when the deliverable is instruction or a learning path; route corpus intake to kb-agentic and persuasive campaigns to marketing-agentic.
 author: Antonio Pinto (https://github.com/Antoneeo)
 copyright: (c) 2026 Antonio Pinto
@@ -38,6 +38,7 @@ Before authoring a governed artifact, know which tier is authoring and follow `r
 
 | When | Write or update |
 |---|---|
+| New L3 unit, the moment the level is declared | `audit/requests/REQUEST_course_<slug>.md`: R1 quotes the requester's opening words verbatim, before the Vision Gate and the first question; every later statement of theirs that settles something (answer, approval, cost, ruling) is appended before acting on it. Append-only, never deleted; artifacts cite its entries. |
 | New L3 course | `vision/features/VISION_course_<slug>.md` with explicit `domain: course`; approve it before design. |
 | Approved Vision and a design need | `solutions/ANALYSIS_course_<slug>.md` with course risks; `D-UC.md`, `D-IC.md`, `P-TM.md`, graph and plan detail its IDs. |
 | New production or substantial revision | Deliver the complete textual source in `slide_content.md`; declare its versioned content contract in COURSE_PLAN. |
@@ -58,7 +59,7 @@ Read `ai_docs/README.md`, `ai_docs/INDEX.md`, and `ai_docs/reference/INDEX.md` (
 
 ### 2. Vision Gate
 
-Draft the course Vision with benefit, named learner groups, what they should be able to understand and do, and signals that would count as useful learning. Read `vision.md`, run its blind check, and obtain the person's approval before writing the course design. Project Vision remains above the course Vision. A course may be delivered before human evaluation, visibly labeled **efficacy not verified**.
+Draft from the request as recorded in `audit/requests/REQUEST_course_<slug>.md`, not from a paraphrase of it. Draft the course Vision with benefit, named learner groups, what they should be able to understand and do, and signals that would count as useful learning. Read `vision.md`, run its blind check, and obtain the person's approval before writing the course design. Project Vision remains above the course Vision. A course may be delivered before human evaluation, visibly labeled **efficacy not verified**.
 
 ### 3. Course Design
 

package/skills/course-creator/elicitation.md

@@ -67,14 +67,17 @@ Ask it before the first write that would embed its answer, grouped with every
 doubt open at that point, in one numbered set, with the client's
 structured-question facility where it has one. Never defer a doubt to the
 deliverable, where the practitioner must find it inside the document; never drip
-one question per turn. Fold every answer into the artifact, citing the reply; an
+one question per turn. At L3 record every answer verbatim in the request record
+(`audit/requests/REQUEST_course_<slug>.md`) and fold it into the artifact citing that
+entry; an
 intent choice with neither a source nor a weighing is a finding (`review.md`
 §Reviewing).
 
 **Declared assumptions exist only where no question can be asked:**
 
 - **Unattended** — the practitioner is not reachable (the Unattended path above).
-- **Delegated** — their own words handed you this choice; quote them. A general
+- **Delegated** — their own words handed you this choice; cite their entry in the
+  request record, or quote them where the unit has none (below L3). A general
   "go ahead" is not a delegation.
 
 Each states **what it is taken from** and **the alternative it excludes**, and is
@@ -170,7 +173,8 @@ round). Cover:
 
 ## Reflect
 
-Fold the answers into the ANALYSIS `## Objective` / `## Vision-Alignment`
+At L3, append the answers verbatim to the request record first
+(`audit/requests/REQUEST_course_<slug>.md`, template in `templates.md`). Then fold them into the ANALYSIS `## Objective` / `## Vision-Alignment`
 sections (Standalone) or into the D-UC/E-ISP (Hybrid) — do not leave them
 sitting only in the chat transcript. The written document, not the
 conversation, is what the next session and the next reviewer will read.

package/skills/course-creator/review.md

@@ -270,6 +270,10 @@ The binding inputs, by review type:
   **against** them, not only for internal consistency.
 - **For a closure review, the diff and the test evidence**: the run output that
   backs every completion claim, dated after the final relevant change.
+- **For a design or closure review of an L3/E3 unit, the request record**
+  (`audit/requests/REQUEST_[unit].md`): the owner's own words, verbatim, that the
+  artifact's owner statements must resolve to. Without it, every such statement is
+  a CANNOT VERIFY.
 - **For a design review, the threat model too** (same sources as above). Why this
   one and not the whole set: file coverage crosses the impact-analysis→design hop on
   a mechanical gate (every impacted file needs a design block), so a dropped file is
@@ -398,7 +402,11 @@ When you are the reviewer:
   intent choice written with no owner-authored source and no weighing, a weighing
   that names no rejected option or turns on an owner priority not on record, and a
   fact or owner-held datum settled by a weighing instead of evidence are findings;
-  so is a cited source that does not say what the line claims. What makes a ground
+  so is a cited source that does not say what the line claims. An owner statement
+  the artifact relies on — an answer, an approval, a cost acceptance, a ruling, a
+  delegation — that resolves to no entry of the unit's request record, or that the
+  record contradicts, is a finding; so is a quotation in the record carrying what
+  its template says to redact. What makes a ground
   or an assumption legal is each lens's `elicitation.md` §The question discipline —
   cite it, never restate it. The fix is the question, not a better justification.
 - **Restated facts (cite, never copy).** Every governance slot has ONE owning document