@sun-asterisk/sungen 3.2.34-beta.1 → 3.3.0-alpha.1

package/src/orchestrator/templates/claude-hooks/sungen-hook.cjs

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+'use strict';
+/**
+ * sungen — Claude Code hook launcher. Written by `sungen init` / `sungen update`; edits are
+ * overwritten. `.claude/settings.json` runs it in exec form (no shell):
+ *   { "command": "node", "args": ["${CLAUDE_PROJECT_DIR}/.claude/hooks/sungen-hook.cjs", "<hook>"] }
+ *
+ * Finds the installed sungen and runs one hook IN-PROCESS (node on dist — no npx — so a hook costs
+ * one Node start). Lookup: $SUNGEN_HOOK_ENTRY when set (exactly that file), else the project's own
+ * dependency, else the global npm prefix.
+ *
+ * FAILS OPEN: kill-switch set, sungen not found, or any error → prints `{}` and exits 0. A hook can
+ * never block or derail a session.
+ *
+ * Off switches: SUNGEN_HOOKS=off (all) · SUNGEN_HOOK_<NAME>=off (one) · qa/sungen.config.yaml `hooks:`.
+ */
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const ENTRY = ['@sun-asterisk', 'sungen', 'dist', 'hooks', 'claude-hook-entry.js'];
+
+function noop() {
+  process.stdout.write('{}\n', () => process.exit(0));
+}
+
+function npmrcPrefix() {
+  try {
+    const m = fs.readFileSync(path.join(os.homedir(), '.npmrc'), 'utf8').match(/^\s*prefix\s*=\s*(.+?)\s*$/m);
+    return m ? m[1].replace(/^~(?=$|[\\/])/, os.homedir()) : null;
+  } catch (_) {
+    return null;
+  }
+}
+
+function findEntry() {
+  const override = process.env.SUNGEN_HOOK_ENTRY;
+  if (override) return fs.existsSync(override) ? override : null;
+  const project = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+  try {
+    return require.resolve(ENTRY.join('/'), { paths: [project] });
+  } catch (_) { /* not a project dependency — try the global install */ }
+  const bin = path.dirname(process.execPath);
+  const prefixes = [process.env.npm_config_prefix, npmrcPrefix(), path.join(bin, '..'), bin].filter(Boolean);
+  for (const prefix of prefixes) {
+    for (const lib of [path.join(prefix, 'lib', 'node_modules'), path.join(prefix, 'node_modules')]) {
+      const candidate = path.join(lib, ...ENTRY);
+      if (fs.existsSync(candidate)) return candidate;
+    }
+  }
+  return null;
+}
+
+try {
+  if (/^(?:off|0|false|no|disabled?)$/i.test(String(process.env.SUNGEN_HOOKS || '').trim())) {
+    noop();
+  } else {
+    const entry = findEntry();
+    if (!entry) noop();
+    else Promise.resolve(require(entry).main(process.argv[2] || '')).then(() => process.exit(0), noop);
+  }
+} catch (_) {
+  noop();
+}

package/src/orchestrator/viewpoint-pattern-catalog.ts

@@ -50,12 +50,9 @@ export const VIEWPOINT_PATTERNS: readonly ViewpointPattern[] = [
   { n: 32, name: 'App Lifecycle & Orientation', mobile: true },
 ];
 
-/**
- * The scaffold's pattern-table rows: 1–17 for every screen, plus Group F on a mobile project.
- * `Áp dụng?` is left empty for the QA to mark ✅ / ❌, as the QA template does.
- */
+/** The scaffold's pattern-table rows: 1–17 for every screen, plus Group F on a mobile project. */
 export function uiPatternRows(isMobile: boolean): string[] {
   return VIEWPOINT_PATTERNS
     .filter((p) => isMobile || !p.mobile)
-    .map((p) => `| ${p.n} | ${p.name} | | |`);
+    .map((p) => `| ${p.n} | ${p.name} | ☐ | |`);
 }

package/src/utils/safe-yaml-parse.ts

@@ -0,0 +1,44 @@
+/**
+ * Parse YAML that a person or an agent wrote into `qa/` — decisions, test-basis, locks — without
+ * letting the file attack the reader (red-team #14, DOS-13.8).
+ *
+ * - `maxAliasCount` small: a "billion laughs" document that multiplies one anchor through nested
+ *   aliases is refused instead of expanding to gigabytes. None of these files has a reason to
+ *   alias at all; a handful is allowed so a hand-written file with one shared block still reads.
+ * - YAML **core** schema and nothing else: `!!binary`, `!!timestamp`, `!!js/…` or any custom tag is
+ *   an error (the library would otherwise resolve "known" extra tags even under core), and yaml-1.1
+ *   merge keys (`<<`) are not merged. `2026-10-21` stays the string it was written as, so a hash
+ *   over the parsed value equals a hash over the text's intent.
+ * - duplicate keys are an error: two `reason:` lines must not let the second silently win.
+ * - a byte cap: these files are a few hundred bytes; a 100 MB one is an attack or an accident.
+ */
+import { parseDocument } from 'yaml';
+
+export const SAFE_YAML_MAX_ALIAS_COUNT = 10;
+export const SAFE_YAML_MAX_BYTES = 1024 * 1024;
+
+export class UnsafeYamlError extends Error {
+  constructor(public readonly source: string, detail: string) {
+    super(`${source}: ${detail}`);
+    this.name = 'UnsafeYamlError';
+  }
+}
+
+export function safeYamlParse(text: string, source = '<yaml>'): unknown {
+  if (Buffer.byteLength(text, 'utf8') > SAFE_YAML_MAX_BYTES) {
+    throw new UnsafeYamlError(source, `larger than ${SAFE_YAML_MAX_BYTES} bytes`);
+  }
+  let doc: ReturnType<typeof parseDocument>;
+  try {
+    doc = parseDocument(text, { schema: 'core', resolveKnownTags: false, merge: false, uniqueKeys: true, strict: true, prettyErrors: false });
+  } catch (err) {
+    throw new UnsafeYamlError(source, err instanceof Error ? err.message : String(err));
+  }
+  const problem = doc.errors[0] ?? doc.warnings[0];   // an unresolved tag is only a warning to the library
+  if (problem) throw new UnsafeYamlError(source, problem.message);
+  try {
+    return doc.toJS({ maxAliasCount: SAFE_YAML_MAX_ALIAS_COUNT });
+  } catch (err) {
+    throw new UnsafeYamlError(source, err instanceof Error ? err.message : String(err));
+  }
+}

package/dist/cli/commands/viewpoint.d.ts

@@ -1,7 +0,0 @@
-import { Command } from 'commander';
-/**
- * `sungen viewpoint scan` — ids and item refs only. Read-only: no audit finding, no score, no
- * baseline effect; the file is never edited. What the rows MEAN is the review skill's job.
- */
-export declare function registerViewpointCommand(program: Command): void;
-//# sourceMappingURL=viewpoint.d.ts.map

package/dist/cli/commands/viewpoint.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"viewpoint.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/viewpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyBpC;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4B/D"}

package/dist/cli/commands/viewpoint.js

@@ -1,70 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerViewpointCommand = registerViewpointCommand;
-const resolve_unit_1 = require("../resolve-unit");
-const viewpoint_scan_1 = require("../../harness/viewpoint-scan");
-const SHOWN = 10;
-/** `a, b, c … +N more` — a list long enough to scroll past is a count plus a sample. */
-const sample = (xs) => (xs.length <= SHOWN ? xs.join(', ') : `${xs.slice(0, SHOWN).join(', ')} … +${xs.length - SHOWN} more`);
-function printScan(name, s) {
-    const L = console.log;
-    L(`\n━━━ Viewpoint scan: ${name} ━━━`);
-    L(`  mode ${s.mode} (${s.modeReason}) — ${s.mode === 2 ? 'the AI drafts / revises its own draft' : 'review only, the file is never edited'}`);
-    L(`  ${s.vpRows.length} rows (${s.distinctIds} distinct ids)   without Kỳ vọng: ${s.rowsWithoutExpected.length}   manual: ${s.manualRows.length}`);
-    if (s.note)
-        L(`  ⚠ ${s.note}`);
-    if (s.rowsWithoutExpected.length)
-        L(`    no Kỳ vọng: ${sample(s.rowsWithoutExpected)}`);
-    if (s.manualRows.length)
-        L(`    manual: ${sample(s.manualRows)}`);
-    if (s.itemSource === 'none')
-        L('  item source: none (the viewpoint cites no spec id, spec item or UI-NNN)');
-    else
-        L(`  item source: ${s.itemSource}   uncited items: ${s.uncitedItems.length}`);
-    if (s.uncitedItems.length)
-        L(`    ${sample(s.uncitedItems.map((i) => (i.name ? `${i.ref} (${i.name})` : i.ref)))}`);
-    if (s.withoutScenario === null)
-        L('  scenarios: no feature file yet');
-    else
-        L(`  VP ids with no scenario: ${s.withoutScenario.length}${s.withoutScenario.length ? `\n    ${sample(s.withoutScenario)}` : ''}`);
-    L('');
-}
-/**
- * `sungen viewpoint scan` — ids and item refs only. Read-only: no audit finding, no score, no
- * baseline effect; the file is never edited. What the rows MEAN is the review skill's job.
- */
-function registerViewpointCommand(program) {
-    const viewpoint = program
-        .command('viewpoint')
-        .description('Read a unit\'s requirements/test-viewpoint.md');
-    viewpoint
-        .command('scan')
-        .description('List VP rows (full-id first cell), the item numbers they cite, uncited spec items and VP ids no scenario carries — read-only')
-        .option('-s, --screen <name>', 'Screen (or flow) name')
-        .option('--flow <name>', 'Flow name (qa/flows/<name>)')
-        .option('--json', 'Output the scan as JSON')
-        .action((o) => {
-        try {
-            if (o.screen && o.flow)
-                throw new Error('Provide --screen <name> or --flow <name>, not both');
-            const name = o.screen || o.flow;
-            if (!name)
-                throw new Error('Provide --screen <name> or --flow <name>');
-            const unit = (0, resolve_unit_1.resolveUnit)(name);
-            if (!unit)
-                throw new Error(`Not found: qa/screens/${name} or qa/flows/${name}`);
-            if (o.flow && unit.kind !== 'flow')
-                throw new Error(`Not a flow: ${name} resolves to qa/${unit.unitId} (use --screen)`);
-            const scan = (0, viewpoint_scan_1.scanViewpointUnit)(unit.dir, name);
-            if (o.json)
-                console.log(JSON.stringify(scan, null, 2));
-            else
-                printScan(name, scan);
-        }
-        catch (e) {
-            console.error('Error:', e instanceof Error ? e.message : e);
-            process.exit(1);
-        }
-    });
-}
-//# sourceMappingURL=viewpoint.js.map

package/dist/cli/commands/viewpoint.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"viewpoint.js","sourceRoot":"","sources":["../../../src/cli/commands/viewpoint.ts"],"names":[],"mappings":"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"}

package/dist/harness/viewpoint-draft-header.d.ts

@@ -1,7 +0,0 @@
-export declare function isAiDraft(text: string): boolean;
-/** `raw` without the one draft line; every other byte is untouched. A file with no draft line comes back as is. */
-export declare function removeDraftLine(raw: string): string;
-export declare function viewpointFileIsAiDraft(viewpointPath: string): boolean;
-/** Remove the draft line from the file, atomically. True when a line was removed; throws a clear error when the write fails. */
-export declare function removeDraftLineFromFile(viewpointPath: string): boolean;
-//# sourceMappingURL=viewpoint-draft-header.d.ts.map

package/dist/harness/viewpoint-draft-header.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"viewpoint-draft-header.d.ts","sourceRoot":"","sources":["../../src/harness/viewpoint-draft-header.ts"],"names":[],"mappings":"AA+BA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,mHAAmH;AACnH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAInD;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAErE;AAED,gIAAgI;AAChI,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAOtE"}

package/dist/harness/viewpoint-draft-header.js

@@ -1,100 +0,0 @@
-"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.isAiDraft = isAiDraft;
-exports.removeDraftLine = removeDraftLine;
-exports.viewpointFileIsAiDraft = viewpointFileIsAiDraft;
-exports.removeDraftLineFromFile = removeDraftLineFromFile;
-const fs = __importStar(require("fs"));
-const read_text_1 = require("./read-text");
-const write_atomic_1 = require("./write-atomic");
-/**
- * `drafted-by: ai` — provenance, not acceptance. The AI writes it as the first header line of a
- * viewpoint it drafted; while it is there the file is an unreviewed draft: the audit records no
- * baseline for it and holds the two axes measured against it. `--accept-viewpoint` removes it.
- *
- * Read by a line scan, not by the viewpoint parser: the key must be found in a file the parser
- * judges nothing about, and in a QA-written file it simply is not there.
- */
-const DRAFT_KEY = /^\s*drafted-by:\s*ai\b/i;
-/** The key is a header line: looking further down would read prose that merely mentions it. */
-const HEADER_LINES = 15;
-/** A line with its own terminator, so a removal keeps CRLF and a lone `\r` exactly as written. */
-const withTerminator = (raw) => raw.match(/[^\r\n]*(?:\r\n|\r|\n)|[^\r\n]+$/g) ?? [];
-/** Index of the draft line in `raw`, or -1. Comments are blanked line-for-line, so indexes agree with the raw file. */
-function draftLineIndex(raw) {
-    const visible = (0, read_text_1.stripHtmlComments)(raw.replace(/\r\n?/g, '\n')).split('\n');
-    let seen = 0;
-    for (let i = 0; i < visible.length && seen < HEADER_LINES; i++) {
-        if (visible[i].trim() === '')
-            continue;
-        if (DRAFT_KEY.test(visible[i]))
-            return i;
-        seen++;
-    }
-    return -1;
-}
-function isAiDraft(text) {
-    return draftLineIndex(text) >= 0;
-}
-/** `raw` without the one draft line; every other byte is untouched. A file with no draft line comes back as is. */
-function removeDraftLine(raw) {
-    const at = draftLineIndex(raw);
-    if (at < 0)
-        return raw;
-    return withTerminator(raw).filter((_, i) => i !== at).join('');
-}
-function viewpointFileIsAiDraft(viewpointPath) {
-    try {
-        return isAiDraft(fs.readFileSync(viewpointPath, 'utf-8'));
-    }
-    catch {
-        return false;
-    }
-}
-/** Remove the draft line from the file, atomically. True when a line was removed; throws a clear error when the write fails. */
-function removeDraftLineFromFile(viewpointPath) {
-    const raw = fs.readFileSync(viewpointPath, 'utf-8');
-    if (!isAiDraft(raw))
-        return false;
-    try {
-        (0, write_atomic_1.writeFileAtomic)(viewpointPath, removeDraftLine(raw));
-    }
-    catch (err) {
-        throw new Error(`could not remove the \`drafted-by: ai\` line from ${viewpointPath} (${err instanceof Error ? err.message : err}) — the file is unchanged; remove the line by hand`);
-    }
-    return true;
-}
-//# sourceMappingURL=viewpoint-draft-header.js.map

package/dist/harness/viewpoint-draft-header.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"viewpoint-draft-header.js","sourceRoot":"","sources":["../../src/harness/viewpoint-draft-header.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,8BAEC;AAGD,0CAIC;AAED,wDAEC;AAGD,0DAOC;AAtDD,uCAAyB;AACzB,2CAAgD;AAChD,iDAAiD;AAEjD;;;;;;;GAOG;AACH,MAAM,SAAS,GAAG,yBAAyB,CAAC;AAC5C,+FAA+F;AAC/F,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB,kGAAkG;AAClG,MAAM,cAAc,GAAG,CAAC,GAAW,EAAY,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,mCAAmC,CAAC,IAAI,EAAE,CAAC;AAEvG,uHAAuH;AACvH,SAAS,cAAc,CAAC,GAAW;IACjC,MAAM,OAAO,GAAG,IAAA,6BAAiB,EAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3E,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/D,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QACvC,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;QACzC,IAAI,EAAE,CAAC;IACT,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAED,SAAgB,SAAS,CAAC,IAAY;IACpC,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,mHAAmH;AACnH,SAAgB,eAAe,CAAC,GAAW;IACzC,MAAM,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACvB,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,SAAgB,sBAAsB,CAAC,aAAqB;IAC1D,IAAI,CAAC;QAAC,OAAO,SAAS,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AAC5F,CAAC;AAED,gIAAgI;AAChI,SAAgB,uBAAuB,CAAC,aAAqB;IAC3D,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,CAAC;QAAC,IAAA,8BAAe,EAAC,aAAa,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,qDAAqD,aAAa,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,oDAAoD,CAAC,CAAC;IACvL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/harness/viewpoint-mode.d.ts

@@ -1,9 +0,0 @@
-export type ViewpointMode = 1 | 2;
-/** `raw` is the file as written (null when missing); `rows` are its VP rows from the scan. */
-export declare function viewpointMode(raw: string | null, rows: {
-    hasExpected: boolean;
-}[]): {
-    mode: ViewpointMode;
-    reason: string;
-};
-//# sourceMappingURL=viewpoint-mode.d.ts.map

package/dist/harness/viewpoint-mode.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"viewpoint-mode.d.ts","sourceRoot":"","sources":["../../src/harness/viewpoint-mode.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,CAAC,CAAC;AAuBlC,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,EAAE,GAAG;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAO3H"}

package/dist/harness/viewpoint-mode.js

@@ -1,52 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.viewpointMode = viewpointMode;
-/**
- * Which create-test mode a unit's test-viewpoint.md calls for — the table in create-test.md,
- * computed so the agent reads it from `sungen viewpoint scan` instead of inferring it.
- *
- *   mode 2 (AI drafts / re-reviews its draft): file missing · untouched scaffold · first line
- *          `drafted-by: ai` · VP rows exist but none has a Kỳ vọng
- *   mode 1 (review only, never edit): anything else — a QA-written file, with or without VP ids
- *
- * "Untouched scaffold" is checked on RAW lines against the template the scaffold is written from:
- * apart from the first `# ` line (the title), every non-blank line must be a template line —
- * comments included, so a QA note inside `<!-- -->` or under its own `# ` heading makes the file
- * the QA's (owner decision 2026-10-14: a QA file is never overwritten). Every doubt falls to
- * mode 1: a scaffold from an older sungen (other template lines) or an unreadable template.
- */
-const viewpoint_draft_header_1 = require("./viewpoint-draft-header");
-const viewpoint_scaffold_1 = require("../orchestrator/viewpoint-scaffold");
-/** Trimmed non-blank lines without the title (the first `# ` line), BOM and CRLF ignored. */
-function bodyLines(text) {
-    const lines = text.replace(/^/, '').replace(/\r\n?/g, '\n').split('\n').map((l) => l.trim()).filter(Boolean);
-    const title = lines.findIndex((l) => l.startsWith('# '));
-    if (title >= 0)
-        lines.splice(title, 1);
-    return lines;
-}
-let templateLines = null;
-function isUntouchedScaffold(raw) {
-    if (!templateLines) {
-        try {
-            templateLines = new Set([false, true].flatMap((mobile) => bodyLines((0, viewpoint_scaffold_1.viewpointScaffold)('', mobile))));
-        }
-        catch {
-            return false; // no template to compare with → treat the file as the QA's
-        }
-    }
-    const known = templateLines;
-    return bodyLines(raw).every((l) => known.has(l));
-}
-/** `raw` is the file as written (null when missing); `rows` are its VP rows from the scan. */
-function viewpointMode(raw, rows) {
-    if (raw === null)
-        return { mode: 2, reason: 'file missing' };
-    if ((0, viewpoint_draft_header_1.isAiDraft)(raw))
-        return { mode: 2, reason: 'drafted-by: ai (re-review)' };
-    if (rows.length > 0) {
-        return rows.some((r) => r.hasExpected) ? { mode: 1, reason: 'QA-written' } : { mode: 2, reason: 'VP rows without Kỳ vọng' };
-    }
-    return isUntouchedScaffold(raw) ? { mode: 2, reason: 'untouched scaffold' } : { mode: 1, reason: 'QA-written, no VP ids' };
-}
-//# sourceMappingURL=viewpoint-mode.js.map

package/dist/harness/viewpoint-mode.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"viewpoint-mode.js","sourceRoot":"","sources":["../../src/harness/viewpoint-mode.ts"],"names":[],"mappings":";;AAyCA,sCAOC;AAhDD;;;;;;;;;;;;;GAaG;AACH,qEAAqD;AACrD,2EAAuE;AAIvE,6FAA6F;AAC7F,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9G,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,IAAI,KAAK,IAAI,CAAC;QAAE,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,IAAI,aAAa,GAAuB,IAAI,CAAC;AAC7C,SAAS,mBAAmB,CAAC,GAAW;IACtC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,IAAA,sCAAiB,EAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACvG,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC,CAAG,2DAA2D;QAC7E,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,aAAa,CAAC;IAC5B,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,8FAA8F;AAC9F,SAAgB,aAAa,CAAC,GAAkB,EAAE,IAAgC;IAChF,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAC7D,IAAI,IAAA,kCAAS,EAAC,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;IAC7E,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC;IAC9H,CAAC;IACD,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;AAC7H,CAAC"}

package/dist/harness/viewpoint-priority.d.ts

@@ -1,19 +0,0 @@
-/**
- * One reading of a priority — a viewpoint row's cell or a scenario's tag.
- *
- * The overview parser, the ledger's uniform-priority check and PRIORITY-CONTRADICTED each read a
- * priority their own way (`/high/i` substrings, raw words, a one-off medium→normal), so the same
- * row could be `Medium` to one and `Unknown` to another — `Med`, which QA writes, was `Unknown`.
- * The vocabulary is `high | normal | low`; `critical`, `medium` and `med` are read as aliases.
- */
-export type PriorityLevel = 'high' | 'normal' | 'low' | 'deferred' | 'skip' | 'unknown';
-/**
- * A priority cell or tag → its level. The whole cell being a word is the clean case; otherwise the
- * overview has always read prose by SUBSTRING in precedence order (`High — complex form`,
- * `Medium-High`), and keeps doing so. The substring words stay unbounded for `high|medium|low`
- * (existing behaviour); the newer `critical|normal|med` need word boundaries (`Medical` is not `Med`).
- */
-export declare function parsePriority(cell: string): PriorityLevel;
-/** The public `ViewpointEntry.priority` spelling of a level — the exported type is unchanged. */
-export declare function toEntryPriority(level: PriorityLevel): 'High' | 'Medium' | 'Low' | 'Unknown';
-//# sourceMappingURL=viewpoint-priority.d.ts.map

package/dist/harness/viewpoint-priority.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"viewpoint-priority.d.ts","sourceRoot":"","sources":["../../src/harness/viewpoint-priority.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAUxF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAQzD;AAED,iGAAiG;AACjG,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAE3F"}

package/dist/harness/viewpoint-priority.js

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parsePriority = parsePriority;
-exports.toEntryPriority = toEntryPriority;
-const WORD = {
-    critical: 'high', high: 'high',
-    medium: 'normal', med: 'normal', normal: 'normal',
-    low: 'low', deferred: 'deferred',
-};
-/** "Declared not applicable" — one level, so every consumer checks one word. */
-const NOT_APPLICABLE = /^(?:skip(?:ped)?|n\/a|none|not applicable)$/;
-/**
- * A priority cell or tag → its level. The whole cell being a word is the clean case; otherwise the
- * overview has always read prose by SUBSTRING in precedence order (`High — complex form`,
- * `Medium-High`), and keeps doing so. The substring words stay unbounded for `high|medium|low`
- * (existing behaviour); the newer `critical|normal|med` need word boundaries (`Medical` is not `Med`).
- */
-function parsePriority(cell) {
-    const w = cell.replace(/[*_`]/g, '').replace(/\.+$/, '').trim().toLowerCase();
-    if (WORD[w])
-        return WORD[w];
-    if (NOT_APPLICABLE.test(w))
-        return 'skip';
-    if (/high|\bcritical\b/.test(w))
-        return 'high';
-    if (/medium|\bnormal\b|\bmed\b/.test(w))
-        return 'normal';
-    if (/low/.test(w))
-        return 'low';
-    return 'unknown';
-}
-/** The public `ViewpointEntry.priority` spelling of a level — the exported type is unchanged. */
-function toEntryPriority(level) {
-    return level === 'high' ? 'High' : level === 'normal' ? 'Medium' : level === 'low' ? 'Low' : 'Unknown';
-}
-//# sourceMappingURL=viewpoint-priority.js.map

package/dist/harness/viewpoint-priority.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"viewpoint-priority.js","sourceRoot":"","sources":["../../src/harness/viewpoint-priority.ts"],"names":[],"mappings":";;AAwBA,sCAQC;AAGD,0CAEC;AA3BD,MAAM,IAAI,GAAkC;IAC1C,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAC9B,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ;IACjD,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU;CACjC,CAAC;AACF,gFAAgF;AAChF,MAAM,cAAc,GAAG,6CAA6C,CAAC;AAErE;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9E,IAAI,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAC1C,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAC/C,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzD,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAChC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,iGAAiG;AACjG,SAAgB,eAAe,CAAC,KAAoB;IAClD,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACzG,CAAC"}

package/dist/harness/viewpoint-review-open.d.ts

@@ -1,6 +0,0 @@
-export declare const VIEWPOINT_REVIEW_FILE = "viewpoint-review.md";
-/** Body rows whose last cell is `[ ]`. The header row (`… | [ ] |` above `|---|`) is not a point. */
-export declare function openReviewPoints(text: string): number;
-/** The info finding for one unit's `requirements/` directory; empty when nothing is open. */
-export declare function viewpointReviewOpenFindings(requirementsDir: string): string[];
-//# sourceMappingURL=viewpoint-review-open.d.ts.map

package/dist/harness/viewpoint-review-open.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"viewpoint-review-open.d.ts","sourceRoot":"","sources":["../../src/harness/viewpoint-review-open.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AAe3D,qGAAqG;AACrG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASrD;AAED,6FAA6F;AAC7F,wBAAgB,2BAA2B,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,CAU7E"}

package/dist/harness/viewpoint-review-open.js

@@ -1,90 +0,0 @@
-"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.VIEWPOINT_REVIEW_FILE = void 0;
-exports.openReviewPoints = openReviewPoints;
-exports.viewpointReviewOpenFindings = viewpointReviewOpenFindings;
-/**
- * VIEWPOINT-REVIEW-OPEN (info) — the audit's one line about `requirements/viewpoint-review.md`.
- *
- * create-test reviews test-viewpoint.md with the sungen-viewpoint checklist and writes each point a
- * QA should look at as a table row whose last cell is `[ ]`; the QA ticks it `[x]` or deletes the
- * row. While rows stay unticked the audit says how many, once. Advisory only: no score, no gate, no
- * baseline effect. A missing or unreadable file says nothing — the review is optional input.
- */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const read_text_1 = require("./read-text");
-exports.VIEWPOINT_REVIEW_FILE = 'viewpoint-review.md';
-const SEPARATOR = /^\s*\|?\s*:?-{2,}:?\s*(\|\s*:?-{2,}:?\s*)*\|?\s*$/;
-/** A table separator, not a `---` rule under a row. */
-const isSeparator = (line) => SEPARATOR.test(line) && line.includes('|');
-const UNTICKED = /^\[\s?\]$/;
-/** The last cell of a markdown table row, or null for a line that is not one. */
-function lastCell(line) {
-    const t = line.trim();
-    if (!t.startsWith('|') || !t.endsWith('|') || t.length < 2)
-        return null;
-    const cells = t.slice(1, -1).split(/(?<!\\)\|/);
-    return cells[cells.length - 1].trim();
-}
-/** Body rows whose last cell is `[ ]`. The header row (`… | [ ] |` above `|---|`) is not a point. */
-function openReviewPoints(text) {
-    const lines = (0, read_text_1.stripHtmlComments)(text.replace(/\r\n?/g, '\n')).split('\n');
-    let open = 0;
-    for (let i = 0; i < lines.length; i++) {
-        if (isSeparator(lines[i]) || isSeparator(lines[i + 1] ?? ''))
-            continue;
-        const last = lastCell(lines[i]);
-        if (last !== null && UNTICKED.test(last))
-            open++;
-    }
-    return open;
-}
-/** The info finding for one unit's `requirements/` directory; empty when nothing is open. */
-function viewpointReviewOpenFindings(requirementsDir) {
-    let text;
-    try {
-        text = fs.readFileSync(path.join(requirementsDir, exports.VIEWPOINT_REVIEW_FILE), 'utf-8');
-    }
-    catch {
-        return [];
-    }
-    const open = openReviewPoints(text);
-    if (open === 0)
-        return [];
-    return [`VIEWPOINT-REVIEW-OPEN (info): ${open} open point(s) in requirements/${exports.VIEWPOINT_REVIEW_FILE} — the checklist review of test-viewpoint.md is waiting for QA. QA: fix the viewpoint where you agree, then tick the row \`[x]\` or delete it. Not scored; an agent does not tick rows for the QA.`];
-}
-//# sourceMappingURL=viewpoint-review-open.js.map

package/dist/harness/viewpoint-review-open.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"viewpoint-review-open.js","sourceRoot":"","sources":["../../src/harness/viewpoint-review-open.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,4CASC;AAGD,kEAUC;AAlDD;;;;;;;GAOG;AACH,uCAAyB;AACzB,2CAA6B;AAC7B,2CAAgD;AAEnC,QAAA,qBAAqB,GAAG,qBAAqB,CAAC;AAE3D,MAAM,SAAS,GAAG,mDAAmD,CAAC;AACtE,uDAAuD;AACvD,MAAM,WAAW,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC1F,MAAM,QAAQ,GAAG,WAAW,CAAC;AAE7B,iFAAiF;AACjF,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACxC,CAAC;AAED,qGAAqG;AACrG,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,IAAA,6BAAiB,EAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1E,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAAE,SAAS;QACvE,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,IAAI,EAAE,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6FAA6F;AAC7F,SAAgB,2BAA2B,CAAC,eAAuB;IACjE,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,6BAAqB,CAAC,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1B,OAAO,CAAC,iCAAiC,IAAI,kCAAkC,6BAAqB,oMAAoM,CAAC,CAAC;AAC5S,CAAC"}

package/dist/harness/viewpoint-scan-refs.d.ts

@@ -1,50 +0,0 @@
-export interface TableRow {
-    /** 1-based line in the (comment-stripped, newline-preserving) text. */
-    line: number;
-    raw: string;
-    /** Cells with `**`, backticks and edge spaces removed. */
-    cells: string[];
-    /** The table's header cells; null for a table with no separator line. */
-    header: string[] | null;
-    /** Text of every heading enclosing the row (outermost first) — where a `# MANUAL/ENV` mark may sit. */
-    section: string;
-}
-/** Every body row of every markdown table, with its header and enclosing headings. */
-export declare function tableRows(text: string): TableRow[];
-/** `009` → `9`, `4.03` → `4.3`; null when the text is not a plain (dotted) number. */
-export declare function normRef(s: string): string | null;
-/**
- * Item numbers a cell cites: `item 9`, `item 2, 3, 7`, `item 4–6`, `item 5.4–5.8`, `項目 4.3〜4.6`, `UI #9`,
- * `UI-009`, `[9]`, `§4.3.2`. Prose (`Auth guard`), message codes (`M02`) and question ids
- * (`Q-01`) are not refs.
- */
-export declare function extractRefs(text: string): string[];
-export type ItemSource = 'spec-ids' | 'spec-table' | 'spec-ids+spec-table' | 'ui-inventory' | 'none';
-export interface UniverseItem {
-    ref: string;
-    name: string;
-}
-/** Every list a citation could point at, each in its own notation. */
-export interface ItemUniverses {
-    specIds: UniverseItem[];
-    specTable: UniverseItem[];
-    inventory: UniverseItem[];
-}
-/**
- * The unit's lists, by where each id is DECLARED: requirement ids spec.md declares (`**FR-BC-03**:`),
- * the spec's item table (`No` + name + type columns), and ui-inventory ids (`UI-NNN`). An id's shape
- * says nothing about which list it belongs to — `item 9` on a mockup and `UI-009` in the inventory
- * number different things.
- */
-export declare function itemUniverses(reqDir: string): ItemUniverses;
-/**
- * The list(s) the viewpoint actually cites — a list nobody cites says nothing about gaps. The spec's
- * ids and its item table, each when cited (both when both are: the notations cannot collide, and
- * dropping one would under-report); the table also when nothing is cited at all (then every item is
- * uncited, which is true); the inventory only when the viewpoint writes `UI-NNN`; else none.
- */
-export declare function citedUniverse(u: ItemUniverses, cited: ReadonlySet<string>, writesInventoryIds: boolean): {
-    source: ItemSource;
-    items: UniverseItem[];
-};
-//# sourceMappingURL=viewpoint-scan-refs.d.ts.map

package/dist/harness/viewpoint-scan-refs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"viewpoint-scan-refs.d.ts","sourceRoot":"","sources":["../../src/harness/viewpoint-scan-refs.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,QAAQ;IACvB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yEAAyE;IACzE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,uGAAuG;IACvG,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAelD;AAKD,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhD;AAkBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBlD;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,qBAAqB,GAAG,cAAc,GAAG,MAAM,CAAC;AACrG,MAAM,WAAW,YAAY;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC3D,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAAG,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,SAAS,EAAE,YAAY,EAAE,CAAC;IAAC,SAAS,EAAE,YAAY,EAAE,CAAA;CAAE;AAMhH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CA2B3D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,OAAO,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,YAAY,EAAE,CAAA;CAAE,CAStJ"}