synomem 0.6.11 → 0.7.0

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,OAAO,EAA0B,MAAM,WAAW,CAAC;AAkB5D,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,eAAe,CAAC;AAOvB,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAA0C,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIhG,OAAO,EAA4C,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE9F,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AASrB,OAAO,KAAK,EACV,aAAa,EASd,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAkB,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1E,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,aAAa,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,eAAe,CAAC;KAClC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAKpB,2BAA2B,CAAC,EAAE,CAAC,OAAO,EAAE;QACtC,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,KAAK,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,mBAAmB,EAAE,CAAA;KAAE,CAAC,CAAC;IAC7E,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7D,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,aAAa,CAAC;QACrB,MAAM,EAAE,YAAY,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAK,OAAO,CAAC,aAAa,GAAG,YAAY,CAAC,CAAC;CAC7C;AAoRD,wBAAgB,SAAS,CACvB,EAAE,GAAE,KAAiB,EACrB,cAAc,GAAE,qBAAgD,EAChE,YAAY,GAAE,eAAoB,EAClC,IAAI,GAAE,MAAM,EAAiB,GAC5B,OAAO,CA4oFT;AAED,wBAAsB,MAAM,CAC1B,IAAI,WAAe,EACnB,EAAE,GAAE,KAAiB,EACrB,cAAc,GAAE,qBAAgD,EAChE,YAAY,GAAE,eAAoB,GACjC,OAAO,CAAC,MAAM,CAAC,CAqBjB"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,OAAO,EAA0B,MAAM,WAAW,CAAC;AAkB5D,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,eAAe,CAAC;AAOvB,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAA0C,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIhG,OAAO,EAA4C,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE9F,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AASrB,OAAO,KAAK,EACV,aAAa,EASd,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAkB,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1E,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,aAAa,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,eAAe,CAAC;KAClC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAKpB,2BAA2B,CAAC,EAAE,CAAC,OAAO,EAAE;QACtC,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,KAAK,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,mBAAmB,EAAE,CAAA;KAAE,CAAC,CAAC;IAC7E,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7D,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,aAAa,CAAC;QACrB,MAAM,EAAE,YAAY,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAK,OAAO,CAAC,aAAa,GAAG,YAAY,CAAC,CAAC;CAC7C;AAuRD,wBAAgB,SAAS,CACvB,EAAE,GAAE,KAAiB,EACrB,cAAc,GAAE,qBAAgD,EAChE,YAAY,GAAE,eAAoB,EAClC,IAAI,GAAE,MAAM,EAAiB,GAC5B,OAAO,CAkyFT;AAED,wBAAsB,MAAM,CAC1B,IAAI,WAAe,EACnB,EAAE,GAAE,KAAiB,EACrB,cAAc,GAAE,qBAAgD,EAChE,YAAY,GAAE,eAAoB,GACjC,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

package/dist/cli.js

@@ -125,6 +125,7 @@ function itemListInput(options) {
         ...(typeof options.actor === 'string' ? { actorId: options.actor } : {}),
         ...(typeof options.status === 'string' ? { status: options.status } : {}),
         ...(typeof options.tag === 'string' ? { tag: options.tag } : {}),
+        ...(typeof options.topic === 'string' ? { topicId: options.topic } : {}),
         ...(typeof options.visibility === 'string'
             ? { visibility: options.visibility }
             : {}),
@@ -200,6 +201,7 @@ function addListOptions(command) {
         .option('--actor <id>')
         .option('--actor-kind <kind>', 'human, agent, or system')
         .option('--tag <tag>')
+        .option('--topic <id>', 'only records carrying this topic')
         .option('--status <status>', 'acknowledged or unacknowledged')
         .option('--visibility <visibility>', 'private, local, or public')
         .addOption(new Option('--revoked <state>').choices(['include', 'only', 'exclude']).default('include'))
@@ -215,6 +217,7 @@ function listInput(options) {
         ...(options.actor ? { actorId: options.actor } : {}),
         ...(options.actorKind ? { actorKind: options.actorKind } : {}),
         ...(options.tag ? { tag: options.tag } : {}),
+        ...(options.topic ? { topicId: options.topic } : {}),
         ...(options.status ? { status: options.status } : {}),
         ...(options.visibility
             ? { visibility: options.visibility }
@@ -1081,6 +1084,82 @@ export function createCli(io = defaultIo, serviceFactory = configuredServiceFact
         const profile = await withClient(global.home, defaultActor(env, 'system', 'cli', global.actor), (client) => client.agents.restore(agent));
         output(io, global.json, profile, `Restored ${profile.handle} (${profile.id})`);
     });
+    const topicCommand = program
+        .command('topic')
+        .description('Create and manage topics — a stable, reusable subject any record can carry');
+    topicCommand
+        .command('create <display-name>')
+        .description('Create a topic. Any actor may create one.')
+        .option('--alias <name>', 'alias (repeatable)', collect, [])
+        .action(async (displayName, options, command) => {
+        const global = globals(command);
+        const topic = await withClient(global.home, defaultActor(env, 'system', 'cli', global.actor), (client) => client.topics.create({
+            displayName,
+            ...(options.alias.length ? { aliases: options.alias } : {}),
+        }));
+        output(io, global.json, topic, `Created ${topic.displayName}\n\nTopic ID: ${topic.id}`);
+    });
+    topicCommand
+        .command('list')
+        .description('List known topics')
+        .option('--status <status>', 'active or archived')
+        .action(async (options, command) => {
+        const global = globals(command);
+        const topics = await withClient(global.home, defaultActor(env, 'system', 'cli', global.actor), (client) => client.topics.list(options.status ? { status: options.status } : {}));
+        const human = topics.length
+            ? topics
+                .map((topic) => `${topic.displayName}${topic.status === 'archived' ? '  [archived]' : ''}${topic.aliases?.length ? `  aliases: ${topic.aliases.join(', ')}` : ''}\n  ${topic.id}`)
+                .join('\n')
+            : 'No topics yet.';
+        output(io, global.json, { topics }, human);
+    });
+    topicCommand
+        .command('show <id>')
+        .description('Show one topic, resolving aliases')
+        .action(async (id, _options, command) => {
+        const global = globals(command);
+        const topic = await withClient(global.home, defaultActor(env, 'system', 'cli', global.actor), (client) => client.topics.get(id));
+        output(io, global.json, topic, `${topic.displayName}\n\nTopic ID: ${topic.id}\nStatus:   ${topic.status}\nAliases:  ${topic.aliases?.join(', ') ?? 'none'}`);
+    });
+    topicCommand
+        .command('resolve <name>')
+        .description('Resolve a name or alias to one topic, or list the candidates')
+        .action(async (name, _options, command) => {
+        const global = globals(command);
+        const resolution = await withClient(global.home, defaultActor(env, 'system', 'cli', global.actor), (client) => client.topics.resolve(name));
+        const human = resolution.match
+            ? `${resolution.match.displayName} (${resolution.match.id})`
+            : resolution.candidates.length
+                ? `"${resolution.query}" is ambiguous. Candidates:\n${resolution.candidates
+                    .map((topic) => `  ${topic.id}  ${topic.displayName}`)
+                    .join('\n')}`
+                : `No topic answers to "${resolution.query}".`;
+        output(io, global.json, resolution, human);
+    });
+    topicCommand
+        .command('rename <id> <display-name>')
+        .description("Change a topic's display name. Its ID never changes.")
+        .action(async (id, displayName, _options, command) => {
+        const global = globals(command);
+        const topic = await withClient(global.home, defaultActor(env, 'system', 'cli', global.actor), (client) => client.topics.update(id, { displayName }));
+        output(io, global.json, topic, `Renamed to ${topic.displayName}\nTopic ID: ${topic.id} (unchanged)`);
+    });
+    topicCommand
+        .command('archive <id>')
+        .description('Stop a topic being attached to new records, keeping the ones it already has')
+        .action(async (id, _options, command) => {
+        const global = globals(command);
+        const topic = await withClient(global.home, defaultActor(env, 'system', 'cli', global.actor), (client) => client.topics.archive(id));
+        output(io, global.json, topic, `Archived ${topic.displayName} (${topic.id})`);
+    });
+    topicCommand
+        .command('restore <id>')
+        .description('Let an archived topic be attached to new records again')
+        .action(async (id, _options, command) => {
+        const global = globals(command);
+        const topic = await withClient(global.home, defaultActor(env, 'system', 'cli', global.actor), (client) => client.topics.restore(id));
+        output(io, global.json, topic, `Restored ${topic.displayName} (${topic.id})`);
+    });
     const skillCommand = program
         .command('skill')
         .description('Install and maintain the packaged agent skill');
@@ -1321,6 +1400,7 @@ export function createCli(io = defaultIo, serviceFactory = configuredServiceFact
         .requiredOption('--title <title>')
         .requiredOption('--body <body>')
         .option('--tag <tag>', 'repeatable', collect, [])
+        .option('--topic <id>', 'topic ID (repeatable)', collect, [])
         .option('--reply-to <post-id>')
         .action(async (options, command) => {
         const global = globals(command);
@@ -1328,6 +1408,7 @@ export function createCli(io = defaultIo, serviceFactory = configuredServiceFact
             title: options.title,
             body: options.body,
             ...(options.tag.length ? { tags: options.tag } : {}),
+            ...(options.topic.length ? { topicIds: options.topic } : {}),
             ...(options.replyTo ? { replyTo: options.replyTo } : {}),
         }));
         output(io, global.json, result, `Published ${result.record.event.id}`);
@@ -1421,6 +1502,7 @@ export function createCli(io = defaultIo, serviceFactory = configuredServiceFact
         .requiredOption('--title <title>')
         .requiredOption('--reason <reason>')
         .option('--tag <tag>', 'tag (repeatable)', collect, [])
+        .option('--topic <id>', 'topic ID (repeatable)', collect, [])
         .option('--evidence <kind:value>', 'sanitized evidence (repeatable)', collect, [])
         .option('--visibility <visibility>', 'private, local, or public', 'workspace')
         .option('--idempotency-key <key>')
@@ -1432,6 +1514,7 @@ export function createCli(io = defaultIo, serviceFactory = configuredServiceFact
             reason: options.reason,
             visibility: options.visibility,
             ...(options.tag.length ? { tags: options.tag } : {}),
+            ...(options.topic.length ? { topicIds: options.topic } : {}),
             ...(options.evidence.length ? { evidence: options.evidence.map(parseEvidence) } : {}),
             ...(options.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : {}),
         }));
@@ -1473,6 +1556,7 @@ export function createCli(io = defaultIo, serviceFactory = configuredServiceFact
         .option('--participant <agent>')
         .option('--actor <id>')
         .option('--tag <tag>')
+        .option('--topic <id>', 'only records carrying this topic')
         .option('--status <status>')
         .option('--visibility <visibility>', 'private, workspace, or public')
         .option('--limit <number>', 'maximum results (default 10, maximum 50)', '10')
@@ -1514,6 +1598,7 @@ export function createCli(io = defaultIo, serviceFactory = configuredServiceFact
         .requiredOption('--subject <subject>')
         .requiredOption('--body <body>')
         .option('--tag <tag>', 'tag (repeatable)', collect, [])
+        .option('--topic <id>', 'topic ID (repeatable)', collect, [])
         .option('--visibility <visibility>', 'private, workspace, or public', 'workspace')
         .option('--idempotency-key <key>')
         .action(async (recipient, options, command) => {
@@ -1524,6 +1609,7 @@ export function createCli(io = defaultIo, serviceFactory = configuredServiceFact
             body: options.body,
             visibility: options.visibility,
             ...(options.tag.length ? { tags: options.tag } : {}),
+            ...(options.topic.length ? { topicIds: options.topic } : {}),
             ...(options.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : {}),
         }));
         output(io, global.json, result, `${result.deduplicated ? 'Found existing' : 'Sent'} memo to ${result.record.event.recipientDisplayName}\nSubject: ${result.record.event.subject}\nID: ${result.record.event.id}`);
@@ -1575,6 +1661,7 @@ export function createCli(io = defaultIo, serviceFactory = configuredServiceFact
         .requiredOption('--title <title>')
         .requiredOption('--body <body>')
         .option('--tag <tag>', 'tag (repeatable)', collect, [])
+        .option('--topic <id>', 'topic ID (repeatable)', collect, [])
         .option('--idempotency-key <key>')
         .action(async (options, command) => {
         const global = globals(command);
@@ -1583,6 +1670,7 @@ export function createCli(io = defaultIo, serviceFactory = configuredServiceFact
             title: options.title,
             body: options.body,
             ...(options.tag.length ? { tags: options.tag } : {}),
+            ...(options.topic.length ? { topicIds: options.topic } : {}),
             ...(options.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : {}),
         }));
         output(io, global.json, result, `${result.deduplicated ? 'Found existing' : 'Created'} note\nTitle: ${result.record.current.title}\nID: ${result.record.event.id}`);
@@ -1654,6 +1742,7 @@ export function createCli(io = defaultIo, serviceFactory = configuredServiceFact
         .option('--due-at <datetime>')
         .option('--time-zone <iana-zone>')
         .option('--tag <tag>', 'tag (repeatable)', collect, [])
+        .option('--topic <id>', 'topic ID (repeatable)', collect, [])
         .option('--idempotency-key <key>')
         .action(async (options, command) => {
         const global = globals(command);
@@ -1663,6 +1752,7 @@ export function createCli(io = defaultIo, serviceFactory = configuredServiceFact
             priority: Number(options.priority),
             ...((due) => (due ? { due } : {}))(taskDue(options)),
             ...(options.tag.length ? { tags: options.tag } : {}),
+            ...(options.topic.length ? { topicIds: options.topic } : {}),
             ...(options.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : {}),
         }));
         output(io, global.json, result, `${result.deduplicated ? 'Found existing' : 'Created'} private todo\nTitle: ${result.record.current.title}\nID: ${result.record.event.id}`);
@@ -1744,6 +1834,7 @@ export function createCli(io = defaultIo, serviceFactory = configuredServiceFact
         .option('--due-at <datetime>')
         .option('--time-zone <iana-zone>')
         .option('--tag <tag>', 'tag (repeatable)', collect, [])
+        .option('--topic <id>', 'topic ID (repeatable)', collect, [])
         .option('--visibility <visibility>', 'private, workspace, or public', 'workspace')
         .option('--idempotency-key <key>')
         .action(async (assignee, options, command) => {
@@ -1755,6 +1846,7 @@ export function createCli(io = defaultIo, serviceFactory = configuredServiceFact
             priority: Number(options.priority),
             ...((due) => (due ? { due } : {}))(taskDue(options)),
             ...(options.tag.length ? { tags: options.tag } : {}),
+            ...(options.topic.length ? { topicIds: options.topic } : {}),
             visibility: options.visibility,
             ...(options.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : {}),
         }));