Prefs

1#!/usr/bin/env node
2/**
3 * Remembered defaults CLI — the lightweight tier of HyperFrames user memory.
4 *
5 *   node prefs.mjs get --hyperframes . [--json]
6 *     Print the merged view (project `.media/preferences.json` over user
7 *     `~/.media/preferences.json`), each key with its source and the receipt
8 *     material (confirmed_in, updated_at).
9 *
10 *   node prefs.mjs record --hyperframes . --key destination --value x-feed [--workflow <w>]
11 *     Record one confirmed brief answer into the project tier; the same value
12 *     confirmed in two different projects promotes the key to the user tier.
13 *
14 * Consumption rules live in hyperframes/references/brief-contract.md § 2
15 * (Remembered defaults): a remembered value becomes the recommended option
16 * with a receipt — it never skips a question.
17 */
18import { parseArgs } from "node:util";
19import { mergedPreferences, recordPreference } from "./lib/prefs-store.mjs";
20
21const { values: args, positionals } = parseArgs({
22  options: {
23    hyperframes: { type: "string", default: "." },
24    key: { type: "string" },
25    value: { type: "string" },
26    workflow: { type: "string" },
27    json: { type: "boolean", default: false },
28  },
29  allowPositionals: true,
30});
31
32const verb = positionals[0];
33
34function fail(message) {
35  console.error(message);
36  process.exit(1);
37}
38
39if (verb === "get") {
40  const merged = mergedPreferences(args.hyperframes);
41  if (args.json) {
42    console.log(JSON.stringify(merged, null, 2));
43  } else if (Object.keys(merged).length === 0) {
44    console.log("no remembered preferences yet");
45  } else {
46    for (const [key, entry] of Object.entries(merged)) {
47      console.log(
48        `${key} = ${entry.value}  (${entry.source}; confirmed in ${entry.confirmed_in.join(", ")})`,
49      );
50    }
51  }
52} else if (verb === "record") {
53  if (!args.key || !args.value) fail("record needs --key and --value");
54  try {
55    const result = recordPreference({
56      projectDir: args.hyperframes,
57      key: args.key,
58      value: args.value,
59      workflow: args.workflow,
60    });
61    const promotion = result.promoted ? "; promoted to user tier" : "";
62    console.log(`recorded ${result.key} = ${result.value} (project${promotion})`);
63  } catch (err) {
64    fail(err instanceof Error ? err.message : String(err));
65  }
66} else {
67  fail(
68    "usage: prefs.mjs <get|record> --hyperframes . [--key <k> --value <v> --workflow <w>] [--json]",
69  );
70}