@wirecat/cli-memo 0.23.0 → 0.24.0

package/dist/examples.js

@@ -0,0 +1,128 @@
+import { annotate } from "@wirecat/cli-base/commands";
+export const EXAMPLES = {
+    context: ["memo context telegram:'Kai Sample'", "memo context email:kai@example.com --limit 5 --json"],
+    "notes show": ["memo notes show note:12", "memo notes show ~/notes/People/Kai.md --json"],
+    "notes list": [
+        "memo notes list --about telegram:'Kai Sample'",
+        "memo notes list --about project:2 --search budget --json",
+        "memo notes list --source internal --limit 50",
+    ],
+    "notes add": [
+        "memo notes add 'Prefers calls in the morning' --about telegram:'Kai Sample'",
+        "memo notes add --file draft.md --title 'Harbour kickoff' --about project:2 --about organization:1",
+    ],
+    "notes edit": ["memo notes edit note:12 --revision 2 --text 'Prefers calls after ten'"],
+    "notes remove": ["memo notes remove note:12"],
+    "notes export": ["memo notes export --to ~/notes/memo --format obsidian"],
+    "folders add": ["memo folders add ~/notes"],
+    "folders attach": ["memo folders attach 1 ~/notes"],
+    "folders list": ["memo folders list --json"],
+    "messages show": ["memo messages show 'msg:email/me%40example.com/thread/42' --before-n 2 --after-n 2"],
+    note: ["memo note telegram:'Kai Sample' People/Kai.md", "memo note telegram:'Kai Sample' --clear"],
+    "tags add": ["memo tags add follow-up --note note:12", "memo tags add harbour --project HRB"],
+    "tags remove": ["memo tags remove follow-up --note note:12"],
+    "tags list": ["memo tags list --tag follow-up", "memo tags list --provider email --account me@example.com --json"],
+    "tasks link": ["memo tasks link HRB-2 HRB-1 --kind blocked-by"],
+    "tasks unlink": ["memo tasks unlink HRB-2 HRB-1 --kind blocked-by"],
+    "tasks relations": ["memo tasks relations HRB-2 --json"],
+    "tasks status": ["memo tasks status HRB-2"],
+    "tasks add": [
+        "memo tasks add 'msg:telegram/1/77/42' --provider telegram --account 1 --type request",
+        "memo tasks add --project HRB --title 'Draft the budget' --type feature",
+    ],
+    "tasks list": ["memo tasks list --provider telegram --account 1", "memo tasks list --project HRB --ready --json"],
+    "tasks close": ["memo tasks close 7 --provider telegram --account 1 --as dismissed --reason 'answered by phone'"],
+    "tasks update": ["memo tasks update 7 --title 'Send the budget' --priority 1"],
+    "tasks assign": ["memo tasks assign 7 person:3"],
+    "organizations add": ["memo organizations add 'Harbour Studio' --kind company --scope work"],
+    "organizations list": ["memo organizations list --json"],
+    "organizations context": ["memo organizations context organization:1"],
+    "projects meetings list": ["memo projects meetings list HRB --provider zoom --account me@example.com"],
+    "projects meetings link": ["memo projects meetings link HRB 31 --provider zoom --account me@example.com"],
+    "projects add": ["memo projects add 'Harbour' --key HRB --type client --organization 1"],
+    "projects list": ["memo projects list"],
+    "projects context": ["memo projects context HRB", "memo projects context project:2 --json"],
+    "projects key-documents add": ["memo projects key-documents add HRB note:12 --reason 'the brief'"],
+    "projects key-documents remove": ["memo projects key-documents remove HRB note:12"],
+    "projects key-documents list": ["memo projects key-documents list HRB"],
+    "relationships add": [
+        "memo relationships add person:3 organization:1 --role cto",
+        "memo relationships add project:2 organization:1 --kind related-to --reason 'same client'",
+    ],
+    "relationships list": ["memo relationships list --reference person:3"],
+    "relationships remove": ["memo relationships remove 4"],
+    "relationships confirm": ["memo relationships confirm 4"],
+    "relationships suggest": ["memo relationships suggest --provider email --account me@example.com --limit 10"],
+    "reminders add": [
+        "memo reminders add 7 --at-time 2026-10-20T09:00:00+02:00 --timezone Europe/Madrid --provider telegram --account 1",
+    ],
+    "reminders list": ["memo reminders list --provider telegram --account 1"],
+    "reminders poll": ["memo reminders poll --provider telegram --account 1 --json"],
+    "reminders ack": ["memo reminders ack 3 3:1 --provider telegram --account 1"],
+    "reminders cancel": ["memo reminders cancel 3 --provider telegram --account 1"],
+    "reminders update": [
+        "memo reminders update 3 --revision 1 --at-time 2026-10-21T09:00:00+02:00 --provider telegram --account 1",
+    ],
+    "vocabulary list": ["memo vocabulary list --kind tag"],
+    "vocabulary show": ["memo vocabulary show Harbour --kind project"],
+    "vocabulary check": ["memo vocabulary check on-boarding --kind tag", "memo vocabulary check --limit 20 --json"],
+    "vocabulary create": ["memo vocabulary create onboarding --kind tag --expected 3f9a"],
+    "vocabulary aliases add": ["memo vocabulary aliases add project:2 Harbor --expected 3f9a"],
+    "vocabulary aliases remove": ["memo vocabulary aliases remove project:2 5 --expected 3f9a"],
+    "memories add": ["memo memories add 'Kai prefers Friday meetings' --kind preference --scope work --evidence note:12"],
+    "memories list": ["memo memories list --status proposed"],
+    "memories show": ["memo memories show memory:4"],
+    "memories confirm": ["memo memories confirm memory:4"],
+    "memories stale": ["memo memories stale memory:4"],
+    "facts add": [
+        "memo facts add 'We moved the launch to spring' --type decision --evidence 'msg:telegram/1/77/42' --project HRB",
+    ],
+    "facts list": ["memo facts list --type decision --project HRB"],
+    "facts show": ["memo facts show fact:4"],
+    "facts confirm": ["memo facts confirm fact:4"],
+    "facts reverse": ["memo facts reverse fact:4"],
+    "actions add": [
+        "memo actions add reply --reason 'Kai asked twice' --provider telegram --target 'msg:telegram/1/77/42' --payload '{\"text\":\"Friday works\"}'",
+    ],
+    "actions list": ["memo actions list --status proposed"],
+    "actions show": ["memo actions show 5"],
+    "actions confirm": ["memo actions confirm 5"],
+    "actions reject": ["memo actions reject 5"],
+    "agents log": ["memo agents log --agent claude-code --limit 20"],
+    mcp: ["memo mcp"],
+    "search all": ["memo search all 'budget harbour'", "memo search all 'content:invoice' --only mail,notes --json"],
+    "search messages": ["memo search messages 'friday meeting' --type voice"],
+    "search mail": ["memo search mail 'mailbox:important budget' --account me@example.com"],
+    "search notes": ["memo search notes budget --folder ~/notes", "memo search notes kickoff --project HRB --json"],
+    "search memories": ["memo search memories friday meetings --scope work"],
+    ask: [
+        "memo ask 'what did Kai say about the budget?' --all",
+        "memo ask 'when is the launch?' --provider telegram --account 1",
+    ],
+    sync: [
+        "memo sync",
+        "memo sync --account work --since-time 2026-09-01",
+        "memo sync --notes --folder ~/notes --no-embed",
+    ],
+    "auto start": ["memo auto start --every 10m"],
+    "auto stop": ["memo auto stop"],
+    "auto status": ["memo auto status --json"],
+    commands: ["memo commands --json", "memo commands tags add --json"],
+    "skill show": ["memo skill show"],
+    "skill install": ["memo skill install --for all"],
+};
+const leaves = (command, path = []) => command.commands.flatMap((child) => {
+    const at = [...path, child.name()];
+    return child.commands.length ? leaves(child, at) : [[at.join(" "), child]];
+});
+/** Puts each leaf's examples in `commands --json` and at the end of its `--help`. */
+export const addExamples = (program) => {
+    for (const [path, command] of leaves(program)) {
+        const examples = EXAMPLES[path];
+        if (!examples)
+            continue;
+        annotate(command, { examples });
+        command.addHelpText("after", `\nExamples:\n${examples.map((example) => `  ${example}`).join("\n")}`);
+    }
+};
+//# sourceMappingURL=examples.js.map

package/dist/examples.js.map

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

package/dist/facts/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/facts/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAyBxC,eAAO,MAAM,YAAY,YAAa,OAAO,WAAW,OAAO,OAAO,MAAM,CAAC,UAAU,KAAG,IAmEzF,CAAA"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/facts/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA4BxC,eAAO,MAAM,YAAY,YAAa,OAAO,WAAW,OAAO,OAAO,MAAM,CAAC,UAAU,KAAG,IAoEzF,CAAA"}

package/dist/facts/command.js

@@ -1,30 +1,28 @@
 import { FACT_STATUSES, FACT_TYPES, MEMORY_SCOPES } from "@wirecat/cli-messaging/store";
+import { authorOf, byOption } from "../author.js";
 import { oneOf, positive } from "../options.js";
 import { pageOf } from "../page.js";
 import { answering } from "../records/run.js";
+import { canonicalProject } from "../vocabulary/project.js";
 export const factsCommand = (program, streams, env) => {
     const run = answering(streams, env);
-    const facts = program
-        .command("facts")
-        .description("What happened — said, asked, decided, promised — with its evidence: agents propose, you accept");
-    facts
-        .command("add")
-        .description("Record a fact of your own; it is accepted at once")
+    const facts = program.command("facts").description("what happened — said, asked, decided, promised — with evidence");
+    byOption(facts.command("add").description("record a fact; an agent's waits as proposed until you confirm it"))
         .argument("<statement...>", "what happened, in one sentence")
         .requiredOption("--type <type>", FACT_TYPES.join(", "), oneOf(FACT_TYPES))
         .option("--evidence <ref...>", "what shows it: msg:, note:, meeting:, person: or another reference")
-        .option("--project <ref>", "the project it belongs to, project:<id>")
+        .option("--project <project>", "the project it belongs to: its key or project:<id>")
         .option("--subject <ref>", "what it is about, as a reference")
         .option("--occurred <iso>", "when it happened, as the evidence shows")
         .option("--scope <scope>", MEMORY_SCOPES.join(" or "), oneOf(MEMORY_SCOPES))
         .option("--supersedes <ref>", "a decision only: the decision this one replaces")
         .option("--json", "print JSON")
-        .action((words, options) => run(options.json, (store) => store.facts.add({
+        .action((words, options) => run(options.json, async (store) => store.facts.add({
         type: options.type,
         statement: words.join(" "),
-        by: "owner",
+        by: authorOf(env, options.asOwner),
         ...(options.evidence === undefined ? {} : { evidence: options.evidence }),
-        ...(options.project === undefined ? {} : { project: options.project }),
+        ...(options.project === undefined ? {} : { project: await canonicalProject(store, options.project) }),
         ...(options.subject === undefined ? {} : { subject: options.subject }),
         ...(options.occurred === undefined ? {} : { occurredAt: options.occurred }),
         ...(options.scope === undefined ? {} : { scope: options.scope }),
@@ -32,29 +30,32 @@ export const factsCommand = (program, streams, env) => {
     })));
     facts
         .command("list")
-        .description("Facts, latest first")
+        .description("facts, latest first")
         .option("--type <type>", FACT_TYPES.join(", "), oneOf(FACT_TYPES))
         .option("--status <status>", FACT_STATUSES.join(", "), oneOf(FACT_STATUSES))
-        .option("--project <ref>", "only this project's, project:<id>")
+        .option("--project <project>", "only this project's: its key or project:<id>")
         .option("--subject <ref>", "only facts about this reference")
         .option("--limit <n>", "most facts, up to 500", positive, 100)
         .option("--json", "print JSON")
-        .action(({ json, ...filters }) => run(json, (store) => pageOf(filters.limit, (limit) => store.facts.list({ ...filters, limit }))));
+        .action(({ json, ...filters }) => run(json, async (store) => {
+        const project = filters.project === undefined ? undefined : await canonicalProject(store, filters.project);
+        return pageOf(filters.limit, (limit) => store.facts.list({ ...filters, ...(project === undefined ? {} : { project }), limit }));
+    }));
     facts
         .command("show")
-        .description("One fact with its evidence")
+        .description("one fact with its evidence")
         .argument("<ref>", "fact:<id>")
         .option("--json", "print JSON")
         .action((ref, options) => run(options.json, (store) => store.facts.get(ref)));
     facts
-        .command("accept")
-        .description("Stand behind a fact an agent proposed; a decision it supersedes stops holding")
+        .command("confirm")
+        .description("stand behind a fact an agent proposed; a decision it supersedes stops holding")
         .argument("<ref>", "fact:<id>")
         .option("--json", "print JSON")
         .action((ref, options) => run(options.json, (store) => store.facts.accept(ref)));
     facts
         .command("reverse")
-        .description("An accepted decision no longer holds, and nothing replaced it")
+        .description("an accepted decision no longer holds, and nothing replaced it")
         .argument("<ref>", "fact:<id>")
         .option("--json", "print JSON")
         .action((ref, options) => run(options.json, (store) => store.facts.reverse(ref)));

package/dist/facts/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/facts/command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/facts/command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAa,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAElG,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAuB3D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAgB,EAAE,OAAgB,EAAE,GAAsB,EAAQ,EAAE;IAC/F,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,gEAAgE,CAAC,CAAA;IAEpH,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,kEAAkE,CAAC,CAAC;SAC3G,QAAQ,CAAC,gBAAgB,EAAE,gCAAgC,CAAC;SAC5D,cAAc,CAAC,eAAe,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;SACzE,MAAM,CAAC,qBAAqB,EAAE,oEAAoE,CAAC;SACnG,MAAM,CAAC,qBAAqB,EAAE,oDAAoD,CAAC;SACnF,MAAM,CAAC,iBAAiB,EAAE,kCAAkC,CAAC;SAC7D,MAAM,CAAC,kBAAkB,EAAE,yCAAyC,CAAC;SACrE,MAAM,CAAC,iBAAiB,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;SAC3E,MAAM,CAAC,oBAAoB,EAAE,iDAAiD,CAAC;SAC/E,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC;SAC9B,MAAM,CAAC,CAAC,KAAe,EAAE,OAAmB,EAAE,EAAE,CAC/C,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAChC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QAC1B,EAAE,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC;QAClC,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrG,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC3E,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;KAChF,CAAC,CACH,CACF,CAAA;IAEH,KAAK;SACF,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,qBAAqB,CAAC;SAClC,MAAM,CAAC,eAAe,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;SACjE,MAAM,CAAC,mBAAmB,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;SAC3E,MAAM,CAAC,qBAAqB,EAAE,8CAA8C,CAAC;SAC7E,MAAM,CAAC,iBAAiB,EAAE,iCAAiC,CAAC;SAC5D,MAAM,CAAC,aAAa,EAAE,uBAAuB,EAAE,QAAQ,EAAE,GAAG,CAAC;SAC7D,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC;SAC9B,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAW,EAAE,EAAE,CACxC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACxB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QAC1G,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACrC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CACvF,CAAA;IACH,CAAC,CAAC,CACH,CAAA;IAEH,KAAK;SACF,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,4BAA4B,CAAC;SACzC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;SAC9B,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC;SAC9B,MAAM,CAAC,CAAC,GAAW,EAAE,OAA2B,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAE3G,KAAK;SACF,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,+EAA+E,CAAC;SAC5F,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;SAC9B,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC;SAC9B,MAAM,CAAC,CAAC,GAAW,EAAE,OAA2B,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAE9G,KAAK;SACF,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,+DAA+D,CAAC;SAC5E,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;SAC9B,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC;SAC9B,MAAM,CAAC,CAAC,GAAW,EAAE,OAA2B,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AACjH,CAAC,CAAA"}

package/dist/install/postinstall.d.ts

@@ -0,0 +1,7 @@
+/** As tg does: a global npm install puts the skill where agents look; MEMO_INSTALL_AGENT picks or skips. */
+export declare const completeGlobalInstall: ({ env, packageRoot, note, }?: {
+    env?: NodeJS.ProcessEnv;
+    packageRoot?: string;
+    note?: (message: string) => void;
+}) => void;
+//# sourceMappingURL=postinstall.d.ts.map

package/dist/install/postinstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.d.ts","sourceRoot":"","sources":["../../src/install/postinstall.ts"],"names":[],"mappings":"AAcA,4GAA4G;AAC5G,eAAO,MAAM,qBAAqB,iCAI/B;IACD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,KAAQ,IAeR,CAAA"}

package/dist/install/postinstall.js

@@ -0,0 +1,28 @@
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { installSkill } from "@wirecat/cli-base/skill";
+import { APP } from "../app.js";
+const root = resolve(dirname(fileURLToPath(import.meta.url)), "../..");
+const TARGETS = {
+    all: ["claude", "agents"],
+    claude: ["claude"],
+    codex: ["agents"],
+    cursor: ["agents"],
+    gemini: ["agents"],
+};
+/** As tg does: a global npm install puts the skill where agents look; MEMO_INSTALL_AGENT picks or skips. */
+export const completeGlobalInstall = ({ env = process.env, packageRoot = root, note = (message) => process.stderr.write(`${message}\n`), } = {}) => {
+    if (env.npm_config_global !== "true")
+        return;
+    const agent = env.MEMO_INSTALL_AGENT ?? "all";
+    if (agent === "none") {
+        note("memo: agent skill skipped by MEMO_INSTALL_AGENT=none; install with memo skill install --for all.");
+        return;
+    }
+    const targets = TARGETS[agent];
+    if (targets === undefined)
+        throw new Error("MEMO_INSTALL_AGENT must be all, codex, cursor, claude, gemini or none");
+    installSkill({ command: APP.command, appName: APP.appName, version: APP.version }, pathToFileURL(join(packageRoot, "skills/cli-memo/SKILL.md")), { env, targets });
+    note("memo: agent skill installed. Agent: read memo skill show before using memo.");
+};
+//# sourceMappingURL=postinstall.js.map

package/dist/install/postinstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../../src/install/postinstall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACvD,OAAO,EAAE,YAAY,EAAoB,MAAM,yBAAyB,CAAA;AACxE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAE/B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;AACtE,MAAM,OAAO,GAA2C;IACtD,GAAG,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACzB,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,KAAK,EAAE,CAAC,QAAQ,CAAC;IACjB,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,CAAC,QAAQ,CAAC;CACnB,CAAA;AAED,4GAA4G;AAC5G,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,EACpC,GAAG,GAAG,OAAO,CAAC,GAAG,EACjB,WAAW,GAAG,IAAI,EAClB,IAAI,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,GACjE,GAIG,EAAE,EAAQ,EAAE;IACd,IAAI,GAAG,CAAC,iBAAiB,KAAK,MAAM;QAAE,OAAM;IAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,kBAAkB,IAAI,KAAK,CAAA;IAC7C,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,IAAI,CAAC,kGAAkG,CAAC,CAAA;QACxG,OAAM;IACR,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAC9B,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAA;IACnH,YAAY,CACV,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,EACpE,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,0BAA0B,CAAC,CAAC,EAC5D,EAAE,GAAG,EAAE,OAAO,EAAE,CACjB,CAAA;IACD,IAAI,CAAC,6EAA6E,CAAC,CAAA;AACrF,CAAC,CAAA"}

package/dist/knowledge/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/knowledge/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAW1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAOxC,eAAO,MAAM,iBAAiB,YAAa,OAAO,WAAW,OAAO,OAAO,MAAM,CAAC,UAAU,SAwQ3F,CAAA"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/knowledge/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAW1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AASxC,eAAO,MAAM,iBAAiB,YAAa,OAAO,WAAW,OAAO,OAAO,MAAM,CAAC,UAAU,SAwU3F,CAAA"}

package/dist/knowledge/command.js

@@ -1,9 +1,11 @@
 import { CliError, createRenderer } from "@wirecat/cli-base";
 import { ORGANIZATION_KINDS, openStore, PROJECT_TYPES, SCOPES, } from "@wirecat/cli-messaging/store";
+import { authorOf, byOption } from "../author.js";
 import { notesAbout } from "../notes/about.js";
 import { accountOptions, oneOf, positive } from "../options.js";
 import { answering } from "../records/run.js";
 import { selectAccount } from "../store/scope.js";
+import { keyDocuments, markKey, projectOf, unmarkKey } from "./key-documents.js";
 import { meetingProjectsCommand } from "./meeting-projects-command.js";
 export const knowledgeCommands = (program, streams, env) => {
     const run = answering(streams, env);
@@ -23,21 +25,26 @@ export const knowledgeCommands = (program, streams, env) => {
         }
     };
     /** What the store knows around an organization or a project: its relations, the notes about it, its tags. */
-    const contextOf = async (store, thing, type, id) => ({
-        [type]: thing ?? null,
-        relationships: (await store.notes.links({ to: `${type}:${id}` }))
-            .concat(await store.notes.links({ from: `${type}:${id}` }))
-            .filter((link) => link.kind !== "about" && link.kind !== "links-to"),
-        notes: await notesAbout(store, { ref: `${type}:${id}` }),
-        tags: await store.knowledge.tags(null, { type, id }),
-    });
+    const contextOf = async (store, thing, type, reference) => {
+        if (thing === undefined)
+            throw new CliError("not_found", `no ${type} ${reference}; memo ${type}s list shows them`);
+        const { id } = thing;
+        return {
+            [type]: thing,
+            relationships: (await store.notes.links({ to: `${type}:${id}` }))
+                .concat(await store.notes.links({ from: `${type}:${id}` }))
+                .filter((link) => link.kind !== "about" && link.kind !== "links-to" && link.role !== "key"),
+            notes: await notesAbout(store, { ref: `${type}:${id}` }),
+            tags: await store.knowledge.tags(null, { type, id }),
+        };
+    };
     const organizations = program
         .command("organizations")
-        .description("Companies, teams, families and communities of yours");
+        .description("companies, teams, families and communities of yours");
     organizations
         .command("add")
-        .description("Add an organization of yours: a company, team, family or community")
-        .argument("<name>")
+        .description("add an organization of yours: a company, team, family or community")
+        .argument("<name>", "the organization's name")
         .requiredOption("--kind <kind>", ORGANIZATION_KINDS.join(", "), oneOf(ORGANIZATION_KINDS))
         .option("--scope <scope>", SCOPES.join(", "), oneOf(SCOPES))
         .option("--json", "print JSON")
@@ -48,88 +55,126 @@ export const knowledgeCommands = (program, streams, env) => {
     })));
     organizations
         .command("list")
-        .description("Your organizations")
+        .description("your organizations")
         .option("--json", "print JSON")
         .action((options) => owned(options, (store) => store.knowledge.organizations()));
     organizations
         .command("context")
-        .description("One organization: its relationships, the notes about or linking it, and its tags")
-        .argument("<id>")
+        .description("one organization by its id or organization:<id>: its relationships, the notes about or linking it, and its tags")
+        .summary("one organization: its relationships, notes and tags")
+        .argument("<organization>", "its id or organization:<id>")
         .option("--json", "print JSON")
-        .action((id, options) => owned(options, async (store) => contextOf(store, (await store.knowledge.organizations()).find((organization) => organization.id === id), "organization", id)));
-    const projects = program.command("projects").description("Projects of yours, each with a short key");
+        .action((reference, options) => owned(options, async (store) => {
+        const wanted = reference.replace(/^organization:/, "");
+        return contextOf(store, (await store.knowledge.organizations()).find((organization) => organization.id === wanted), "organization", reference);
+    }));
+    const projects = program.command("projects").description("projects of yours, each with a short key");
     meetingProjectsCommand(projects, streams, env);
     projects
         .command("add")
-        .description("Add a project of yours, with a short key its tasks use")
-        .argument("<name>")
+        .description("add a project of yours, with a short key its tasks use")
+        .argument("<name>", "the project's name")
         .option("--key <key>", "3–4 letters and digits; made from the name when left out")
         .option("--type <type>", PROJECT_TYPES.join(", "), oneOf(PROJECT_TYPES))
-        .option("--organization <reference>", "organization:<id> it belongs to")
+        .option("--organization <organization>", "the organization it belongs to: its id or organization:<id>")
         .option("--scope <scope>", SCOPES.join(", "), oneOf(SCOPES))
         .option("--json", "print JSON")
         .action((name, options) => owned(options, (store) => store.knowledge.addProject({
         name,
         ...(options.key === undefined ? {} : { key: options.key }),
         ...(options.type === undefined ? {} : { type: options.type }),
-        ...(options.organization === undefined ? {} : { organization: options.organization }),
+        ...(options.organization === undefined
+            ? {}
+            : { organization: `organization:${options.organization.replace(/^organization:/, "")}` }),
         ...(options.scope === undefined ? {} : { scope: options.scope }),
     })));
     projects
         .command("list")
-        .description("Your projects")
+        .description("your projects")
         .option("--json", "print JSON")
         .action((options) => owned(options, (store) => store.knowledge.projects()));
     projects
         .command("context")
-        .description("One project by its id, key or project:<id>: its relationships, the notes about or linking it, and its tags")
-        .argument("<project>")
+        .description("one project by its id, key or project:<id>: its key documents first, then its relationships, the notes " +
+        "about or linking it, and its tags. Start work on a project here")
+        .summary("one project: key documents, relationships, notes and tags; start work here")
+        .argument("<project>", "its id, key or project:<id>")
         .option("--json", "print JSON")
         .action((reference, options) => owned(options, async (store) => {
-        const wanted = reference.replace(/^project:/, "");
-        const project = (await store.knowledge.projects()).find((candidate) => candidate.id === wanted || candidate.key?.toLowerCase() === wanted.toLowerCase());
-        return contextOf(store, project, "project", project?.id ?? wanted);
+        const project = await projectOf(store, reference);
+        return {
+            keyDocuments: await keyDocuments(store, project),
+            ...(await contextOf(store, project, "project", reference)),
+        };
     }));
+    const keys = projects
+        .command("key-documents")
+        .description("the notes, files and messages to read first about a project, each with why");
+    byOption(keys
+        .command("add")
+        .description("mark a note:, document: or msg: reference as a key document of the project")
+        .argument("<project>", "id, key or project:<id>")
+        .argument("<reference>", "note:, document: or msg: reference")
+        .requiredOption("--reason <text>", "why it is key, in a few words")
+        .option("--json", "print JSON")).action((project, reference, options) => owned(options, async (store) => markKey(store, await projectOf(store, project), reference, options.reason, authorOf(env, options.asOwner))));
+    keys
+        .command("remove")
+        .description("unmark a key document; the note, file or message stays")
+        .argument("<project>", "id, key or project:<id>")
+        .argument("<reference>", "the key document's note:, document: or msg: reference")
+        .option("--json", "print JSON")
+        .action((project, reference, options) => owned(options, async (store) => unmarkKey(store, await projectOf(store, project), reference)));
+    keys
+        .command("list")
+        .description("a project's key documents: why, who marked each and whether it is still there")
+        .argument("<project>", "id, key or project:<id>")
+        .option("--json", "print JSON")
+        .action((project, options) => owned(options, async (store) => ({ items: await keyDocuments(store, await projectOf(store, project)) })));
     const relations = program
         .command("relationships")
-        .description("Explicit relations between people, organizations and projects; this never links identities");
-    relations
+        .description("relations between people, organizations and projects; never between identities");
+    byOption(relations
         .command("add")
-        .description("State that a person, organization or project belongs to or relates to another")
-        .argument("<from>")
-        .argument("<to>")
+        .description("state that a person, organization or project belongs to or relates to another; an agent's waits for you to confirm it")
+        .summary("state that a person, organization or project belongs or relates to another"))
+        .argument("<from>", "the person:, organization: or project: that belongs or relates")
+        .argument("<to>", "the person:, organization: or project: it belongs or relates to")
         .option("--json", "print JSON")
         .option("--kind <kind>", "member-of or related-to", "member-of")
-        .option("--role <role>")
-        .option("--evidence <text>")
-        .action((from, to, options) => owned(options, (store) => store.knowledge.relate(null, {
-        from,
-        to,
-        kind: options.kind,
-        ...(options.role === undefined ? {} : { role: options.role }),
-        ...(options.evidence === undefined ? {} : { evidence: options.evidence }),
-    })));
+        .option("--role <role>", "the role it has there, in a few words, such as cto")
+        .option("--reason <text>", "why you think so, in a sentence")
+        .action((from, to, options) => {
+        const author = authorOf(env, options.asOwner);
+        return owned(options, (store) => store.knowledge.relate(null, {
+            from,
+            to,
+            kind: options.kind,
+            ...(author === "owner" ? {} : { confirmed: false, provenance: `agent:${author.bot}` }),
+            ...(options.role === undefined ? {} : { role: options.role }),
+            ...(options.reason === undefined ? {} : { evidence: options.reason }),
+        }));
+    });
     relations
         .command("list")
-        .description("Relationships, all or those of one reference")
-        .option("--reference <reference>")
+        .description("relationships, all or those of one reference")
+        .option("--reference <reference>", "only those of this person:, organization: or project:")
         .option("--json", "print JSON")
         .action((options) => owned(options, (store) => store.knowledge.relations(null, options.reference)));
     relations
         .command("remove")
-        .description("Remove a relationship")
-        .argument("<id>")
+        .description("remove a relationship")
+        .argument("<id>", "the relationship's id, as relationships list gives it")
         .option("--json", "print JSON")
         .action((id, options) => owned(options, (store) => store.knowledge.removeRelation(null, id)));
     relations
         .command("confirm")
-        .description("Accept a suggested relationship")
-        .argument("<id>")
+        .description("confirm a suggested relationship")
+        .argument("<id>", "the relationship's id, as relationships list gives it")
         .option("--json", "print JSON")
         .action((id, options) => owned(options, (store) => store.knowledge.confirmRelation(null, id)));
     accountOptions(relations
         .command("suggest")
-        .description("Store weak shared-domain suggestions for direct email contacts; confirmation is explicit"))
+        .description("suggest relationships between email contacts of one domain; you confirm each"))
         .option("--limit <n>", "most suggestions, at most 100", positive, 20)
         .action((options) => execute(options, async (store, key) => {
         if (key.provider !== "email" || options.limit > 100)
@@ -172,13 +217,13 @@ export const knowledgeCommands = (program, streams, env) => {
     }));
     const reminders = program
         .command("reminders")
-        .description("Durable local reminders; poll leases a delivery and ack confirms it");
-    accountOptions(reminders.command("schedule").description("Schedule a reminder for an open task").argument("<task>"))
-        .requiredOption("--at <timestamp>", "ISO timestamp with UTC offset")
+        .description("durable local reminders; poll hands one out and ack confirms it was shown");
+    accountOptions(reminders.command("add").description("add a reminder for an open task").argument("<task>", "the task's id"))
+        .requiredOption("--at-time <time>", "when to remind: an ISO 8601 time with its UTC offset")
         .option("--timezone <zone>", "IANA timezone", "UTC")
-        .action((task, options) => execute(options, (store, key) => store.knowledge.schedule(key, task, options.at, options.timezone)));
-    accountOptions(reminders.command("list").description("Pending reminders of one account")).action((options) => execute(options, (store, key) => store.knowledge.reminders(key)));
-    accountOptions(reminders.command("poll").description("Hand out due reminders, each with a receipt to acknowledge"))
+        .action((task, options) => execute(options, (store, key) => store.knowledge.schedule(key, task, options.atTime, options.timezone)));
+    accountOptions(reminders.command("list").description("pending reminders of one account")).action((options) => execute(options, (store, key) => store.knowledge.reminders(key)));
+    accountOptions(reminders.command("poll").description("hand out due reminders, each with a receipt to acknowledge"))
         .option("--limit <n>", "most due reminders, at most 500", positive, 100)
         .action((options) => execute(options, async (store, key) => (await store.knowledge.claimReminders(key, { limit: options.limit })).map((reminder) => ({
         ...reminder,
@@ -187,13 +232,13 @@ export const knowledgeCommands = (program, streams, env) => {
     }))));
     accountOptions(reminders
         .command("ack")
-        .description("Confirm that a handed-out reminder was shown")
-        .argument("<id>")
-        .argument("<receipt>")).action((id, receipt, options) => execute(options, (store, key) => store.knowledge.acknowledgeReminder(key, id, receipt)));
-    accountOptions(reminders.command("cancel").description("Cancel a reminder").argument("<id>")).action((id, options) => execute(options, (store, key) => store.knowledge.cancelReminder(key, id)));
-    accountOptions(reminders.command("snooze").description("Move a reminder to a later time").argument("<id>"))
-        .requiredOption("--at <timestamp>")
-        .requiredOption("--revision <n>", "current revision", positive)
-        .action((id, options) => execute(options, (store, key) => store.knowledge.snoozeReminder(key, id, options.at, options.revision)));
+        .description("confirm that a handed-out reminder was shown")
+        .argument("<id>", "the reminder's id")
+        .argument("<receipt>", "the receipt reminders poll handed out with it")).action((id, receipt, options) => execute(options, (store, key) => store.knowledge.acknowledgeReminder(key, id, receipt)));
+    accountOptions(reminders.command("cancel").description("cancel a reminder").argument("<id>", "the reminder's id")).action((id, options) => execute(options, (store, key) => store.knowledge.cancelReminder(key, id)));
+    accountOptions(reminders.command("update").description("move a reminder to another time").argument("<id>", "the reminder's id"))
+        .requiredOption("--at-time <time>", "the new time: an ISO 8601 time with its UTC offset")
+        .requiredOption("--revision <n>", "the reminder's current revision, as reminders list gives it", positive)
+        .action((id, options) => execute(options, (store, key) => store.knowledge.snoozeReminder(key, id, options.atTime, options.revision)));
 };
 //# sourceMappingURL=command.js.map