feat(ms-ai-architect): C3 (3) — --courses-flagg i write-schedule-config.mjs (TDD) + live-probe-doc

Eier-CLI kan nå sette include_course_detection uten å hand-edite den gitignored
local.md: `write-schedule-config.mjs --enabled true --cadence daily --courses true`.
Flagget er VALGFRITT (opt-in inni opt-in) — utelates det, bevares en verdi satt
andre steder gjennom onboarding-rewriten (samme merge-semantikk som
interval_days / include_skill_lifecycle).

Tester (+3): --courses true setter nøkkelen, string-coercion (CLI-args er
strenger), og non-clobbering når flagget utelates. kb-update 313→316.

docs/development.md: C3-workflow peker nå på CLI-flagget framfor manuell local.md.

Live-probe (2) kjørt mot ekte Learn Platform API: baseline-registry etablert
(1093 kurs: 843 modules + 250 learning-paths), 0 leads (korrekt baseline §8 b).
Registry/report er detektorens gitignored private state — ingen filer committet.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs/development.md

@@ -79,7 +79,13 @@ Et parallelt, uavhengig spor fra sitemap-discoveren: oppdage at Microsoft har pu
    node scripts/kb-update/detect-courses.mjs --data-dir DIR  # omdiriger IO (tester)
    ```
 
-   Fail-soft: mangler creds → `status:"skipped"` + exit 0; vedvarende nettverksfeil → `status:"error"` + exit 0. Opt-in inni opt-in: steget kjøres kun av scheduleren når `include_course_detection: true` (default `false`) — sett nøkkelen manuelt i `~/.claude/ms-ai-architect/ms-ai-architect.local.md`.
+   Fail-soft: mangler creds → `status:"skipped"` + exit 0; vedvarende nettverksfeil → `status:"error"` + exit 0. Opt-in inni opt-in: steget kjøres kun av scheduleren når `include_course_detection: true` (default `false`). Sett flagget via eier-CLI (skriver den gitignored local.md atomisk, bevarer øvrige nøkler):
+
+   ```bash
+   node scripts/kb-update/write-schedule-config.mjs --enabled true --cadence daily --courses true
+   ```
+
+   `--courses` er valgfritt — utelat det for å la en verdi satt andre steder stå urørt.
 
 2. **SessionStart-surfacing (read-only).** `session-start-context.mjs` leser `course-detection-report.json` og viser en one-liner via `summarizeCourses` («Kurs-signaler: N nye / M endrede kurs i dekkede produkter. Kjør /architect:kb-update») — speiler skill-signaler-blokka. `removed` er kun et informasjonssignal i rapporten, aldri en surfacet lead (spec §4.2). Hooken spawner ingenting for kurs-sporet.
 

scripts/kb-update/write-schedule-config.mjs

@@ -18,8 +18,11 @@
 //
 //   node scripts/kb-update/write-schedule-config.mjs --enabled true --cadence daily
 //   node scripts/kb-update/write-schedule-config.mjs --enabled false --cadence interval
+//   node scripts/kb-update/write-schedule-config.mjs --enabled true --cadence daily --courses true
 //
-// --home <dir> overrides the home dir (tests). Prints the resolved config path.
+// --courses true|false toggles include_course_detection (Spor C / C3 opt-in);
+// OPTIONAL — omit it to leave a value set elsewhere untouched. --home <dir>
+// overrides the home dir (tests). Prints the resolved config path.
 
 import { existsSync, readFileSync, mkdirSync } from 'node:fs';
 import { join } from 'node:path';
@@ -34,6 +37,7 @@ function parseArgs(argv) {
   for (let i = 0; i < argv.length; i++) {
     if (argv[i] === '--enabled') out.enabled = argv[++i];
     else if (argv[i] === '--cadence') out.cadence = argv[++i];
+    else if (argv[i] === '--courses') out.courses = argv[++i];
     else if (argv[i] === '--home') out.home = argv[++i];
   }
   return out;
@@ -41,10 +45,10 @@ function parseArgs(argv) {
 
 /**
  * Write (merge onto) the user-owned scheduler config from onboarding answers.
- * @param {{enabled: boolean|string, cadence: string, home?: string}} args
+ * @param {{enabled: boolean|string, cadence: string, courses?: boolean|string, home?: string}} args
  * @returns {{configPath: string, config: object}}
  */
-export function writeScheduleConfig({ enabled, cadence, home = homedir() }) {
+export function writeScheduleConfig({ enabled, cadence, courses, home = homedir() }) {
   const configPath = resolveConfigPath(home);
   const existing = existsSync(configPath) ? readFileSync(configPath, 'utf8') : '';
   const parsed = parseScheduleConfig(existing); // existing values (or OFF defaults)
@@ -58,6 +62,13 @@ export function writeScheduleConfig({ enabled, cadence, home = homedir() }) {
     os_scheduler_cadence: cadence === 'interval' ? 'interval' : 'daily',
   };
 
+  // --courses is OPTIONAL (opt-in inside opt-in): only override
+  // include_course_detection when the flag was explicitly supplied, so a value
+  // set elsewhere survives an onboarding rewrite that omits it.
+  if (courses !== undefined) {
+    merged.include_course_detection = courses === true || courses === 'true';
+  }
+
   mkdirSync(resolveUserDataDir(home), { recursive: true });
   backupFile(configPath, join(resolveUserDataDir(home), '.backups')); // no-op if absent
   atomicWriteSync(configPath, serializeScheduleConfig(merged));
@@ -66,10 +77,11 @@ export function writeScheduleConfig({ enabled, cadence, home = homedir() }) {
 
 // CLI entry — only when run directly (not when imported by tests).
 if (import.meta.url === `file://${process.argv[1]}`) {
-  const { enabled, cadence, home } = parseArgs(process.argv.slice(2));
-  const { configPath, config } = writeScheduleConfig({ enabled, cadence, home });
+  const { enabled, cadence, courses, home } = parseArgs(process.argv.slice(2));
+  const { configPath, config } = writeScheduleConfig({ enabled, cadence, courses, home });
   console.log(configPath);
   console.error(
-    `scheduled_detection: enabled=${config.enabled} os_scheduler_cadence=${config.os_scheduler_cadence} (interval_days=${config.interval_days})`,
+    `scheduled_detection: enabled=${config.enabled} os_scheduler_cadence=${config.os_scheduler_cadence} ` +
+      `(interval_days=${config.interval_days} include_course_detection=${config.include_course_detection})`,
   );
 }

tests/kb-update/test-detection-schedule.test.mjs

@@ -201,6 +201,46 @@ test('writeScheduleConfig — merge preserves pre-existing keys (interval_days)
   }
 });
 
+// --- C3 (3): --courses flag wires include_course_detection from the CLI ---
+test('writeScheduleConfig — --courses true sets include_course_detection (opt-in inside opt-in)', () => {
+  const home = mkdtempSync(join(tmpdir(), 'home-'));
+  try {
+    writeScheduleConfig({ enabled: true, cadence: 'daily', courses: true, home });
+    const cfg = parseScheduleConfig(readFileSync(resolveConfigPath(home), 'utf8'));
+    assert.equal(cfg.include_course_detection, true);
+  } finally {
+    rmSync(home, { recursive: true, force: true });
+  }
+});
+
+test('writeScheduleConfig — coerces the --courses string flag (CLI args arrive as strings)', () => {
+  const home = mkdtempSync(join(tmpdir(), 'home-'));
+  try {
+    writeScheduleConfig({ enabled: true, cadence: 'daily', courses: 'true', home });
+    assert.equal(parseScheduleConfig(readFileSync(resolveConfigPath(home), 'utf8')).include_course_detection, true);
+    writeScheduleConfig({ enabled: true, cadence: 'daily', courses: 'false', home });
+    assert.equal(parseScheduleConfig(readFileSync(resolveConfigPath(home), 'utf8')).include_course_detection, false);
+  } finally {
+    rmSync(home, { recursive: true, force: true });
+  }
+});
+
+test('writeScheduleConfig — omitting --courses preserves a pre-existing include_course_detection', () => {
+  const home = mkdtempSync(join(tmpdir(), 'home-'));
+  try {
+    mkdirSync(resolveUserDataDir(home), { recursive: true });
+    writeFileSync(
+      resolveConfigPath(home),
+      'scheduled_detection:\n  enabled: true\n  include_course_detection: true\n',
+    );
+    writeScheduleConfig({ enabled: false, cadence: 'interval', home }); // no `courses` arg
+    const cfg = parseScheduleConfig(readFileSync(resolveConfigPath(home), 'utf8'));
+    assert.equal(cfg.include_course_detection, true, 'non-owned key preserved when --courses is omitted');
+  } finally {
+    rmSync(home, { recursive: true, force: true });
+  }
+});
+
 test('writeScheduleConfig — backs up an existing config before overwriting it', () => {
   const home = mkdtempSync(join(tmpdir(), 'home-'));
   try {