ticlawk 0.1.16-dev.9 → 0.1.17-dev.1

package/README.md

@@ -212,12 +212,16 @@ Usage:
   ticlawk version
 
 Agent CLI (run inside an agent runtime; requires TICLAWK_RUNTIME_AGENT_ID):
-  ticlawk message send --target <t>           # body on stdin
+  ticlawk message send --target <t> --phase progress|final  # body on stdin
   ticlawk message read --target <t> [opts]
   ticlawk task claim --message-id <id>
   ticlawk task update --task-id <id> --status <s>
-  ticlawk task list [--target <t>]
+  ticlawk task list [--target <t>]       # group admins see the full task board
+  ticlawk charter get --target <t>
   ticlawk group members --target <t>
+  ticlawk group list
+  ticlawk agent list
+  ticlawk dashboard get --conversation-id <id>
   ticlawk server info [--refresh]
 
 Commands:
@@ -226,7 +230,17 @@ Commands:
   profile  list or switch saved local identities
   message  send/read chat messages (agent CLI surface)
   task     claim/update/list tasks (agent CLI surface)
-  group    list members of a group conversation (agent CLI surface)
+  goal     report FSM transitions / signal goal changes (agent CLI surface)
+  approval canonical goal-loop approval request/resolve (agent CLI surface)
+  charter  get/set conversation goal and role spec (agent CLI surface)
+  group    create/list/delete groups, manage charters/members (agent CLI surface)
+  dashboard   set/get conversation dashboards (agent CLI surface)
+  briefing    publish/get owner briefings (agent CLI surface)
+  agent       list/create/delete owned agent slots (agent CLI surface)
+  service     publish/list/call shared services (agent CLI surface)
+  credential  request owner-filled credentials (agent CLI surface)
+  reminder    schedule/list/snooze/cancel reminders (agent CLI surface)
+  attachment  view private chat assets (agent CLI surface)
   server   server-info introspection (agent CLI surface)
   install-daemon  install or refresh the background daemon
   update   update the npm package and refresh the daemon

package/bin/ticlawk.mjs

@@ -32,12 +32,36 @@ import {
   AGENT_COMMAND_HELP,
   runAttachmentViewCommand,
   runGroupCreateCommand,
+  runWorkstreamCharterGetCommand,
+  runWorkstreamCharterSetCommand,
+  runWorkstreamCreateCommand,
+  runWorkstreamDeleteCommand,
+  runWorkstreamListCommand,
+  runAgentListCommand,
+  runAgentCreateCommand,
+  runAgentDeleteCommand,
+  runDashboardSetCommand,
+  runDashboardGetCommand,
+  runCredentialRequestCommand,
+  runBriefingPublishCommand,
+  runBriefingGetCommand,
+  runServiceCreateCommand,
+  runServiceUpdateCommand,
+  runServiceDeleteCommand,
+  runServiceListCommand,
+  runServiceInfoCommand,
+  runServiceCallCommand,
   runGroupMembersAddCommand,
   runGroupMembersCommand,
   runGroupMembersRemoveCommand,
   runMessageCheckCommand,
   runMessageReactCommand,
   runMessageReadCommand,
+  runGoalChangedCommand,
+  runGoalReportCommand,
+  runApprovalRequestCommand,
+  runApprovalResolveCommand,
+  runApprovalListCommand,
   runMessageSearchCommand,
   runMessageSendCommand,
   runProfileShowCommand,
@@ -92,12 +116,16 @@ Usage:
   ticlawk version
 
 Agent CLI (run inside an agent runtime; requires TICLAWK_RUNTIME_AGENT_ID):
-  ticlawk message send --target <t>           # body on stdin
+  ticlawk message send --target <t> --phase progress|final  # body on stdin
   ticlawk message read --target <t> [opts]
   ticlawk task claim --message-id <id>
   ticlawk task update --task-id <id> --status <s>
-  ticlawk task list [--target <t>]
+  ticlawk task list [--target <t>]       # group admins see the full task board
+  ticlawk charter get --target <t>
   ticlawk group members --target <t>
+  ticlawk group list
+  ticlawk agent list
+  ticlawk dashboard get --conversation-id <id>
   ticlawk server info [--refresh]
 
 Commands:
@@ -106,7 +134,17 @@ Commands:
   profile  list or switch saved local identities
   message  send/read chat messages (agent CLI surface)
   task     claim/update/list tasks (agent CLI surface)
-  group    list members of a group conversation (agent CLI surface)
+  goal     report FSM transitions / signal goal changes (agent CLI surface)
+  approval canonical goal-loop approval request/resolve (agent CLI surface)
+  charter  get/set conversation goal and role spec (agent CLI surface)
+  group    create/list/delete groups, manage charters/members (agent CLI surface)
+  dashboard   set/get conversation dashboards (agent CLI surface)
+  briefing    publish/get owner briefings (agent CLI surface)
+  agent       list/create/delete owned agent slots (agent CLI surface)
+  service     publish/list/call shared services (agent CLI surface)
+  credential  request owner-filled credentials (agent CLI surface)
+  reminder    schedule/list/snooze/cancel reminders (agent CLI surface)
+  attachment  view private chat assets (agent CLI surface)
   server   server-info introspection (agent CLI surface)
   install-daemon  install or refresh the background daemon
   update   update the npm package and refresh the daemon
@@ -178,6 +216,10 @@ function printHelp(helpPath, args = {}) {
     console.log(getInstallDaemonHelp());
     return;
   }
+  if (AGENT_COMMAND_HELP[head]) {
+    console.log(AGENT_COMMAND_HELP[head]);
+    return;
+  }
   printUsage();
 }
 
@@ -357,24 +399,6 @@ async function main() {
     process.exit(1);
   }
 
-  if (command === 'profile') {
-    const sub = args._[1];
-    if (args.help || args.h || !sub) {
-      console.log(AGENT_COMMAND_HELP.profile);
-      return;
-    }
-    if (sub === 'show') {
-      process.exitCode = await runProfileShowCommand(args);
-      return;
-    }
-    if (sub === 'update') {
-      process.exitCode = await runProfileUpdateCommand(args);
-      return;
-    }
-    console.error(`unknown profile subcommand: ${sub}`);
-    process.exit(1);
-  }
-
   if (command === 'reminder') {
     const sub = args._[1];
     if (args.help || args.h || !sub) {
@@ -453,6 +477,187 @@ async function main() {
     process.exit(1);
   }
 
+  if (command === 'goal') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.goal);
+      return;
+    }
+    if (sub === 'report') {
+      process.exitCode = await runGoalReportCommand(args);
+      return;
+    }
+    if (sub === 'changed') {
+      process.exitCode = await runGoalChangedCommand(args);
+      return;
+    }
+    console.error(`unknown goal subcommand: ${sub}`);
+    process.exit(1);
+  }
+
+  if (command === 'approval') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.approval);
+      return;
+    }
+    if (sub === 'request') {
+      process.exitCode = await runApprovalRequestCommand(args);
+      return;
+    }
+    if (sub === 'resolve') {
+      process.exitCode = await runApprovalResolveCommand(args);
+      return;
+    }
+    if (sub === 'list') {
+      process.exitCode = await runApprovalListCommand(args);
+      return;
+    }
+    console.error(`unknown approval subcommand: ${sub}`);
+    process.exit(1);
+  }
+
+  if (command === 'workstream') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.workstream);
+      return;
+    }
+    if (sub === 'create') {
+      process.exitCode = await runWorkstreamCreateCommand(args);
+      return;
+    }
+    if (sub === 'delete') {
+      process.exitCode = await runWorkstreamDeleteCommand(args);
+      return;
+    }
+    if (sub === 'list') {
+      process.exitCode = await runWorkstreamListCommand(args);
+      return;
+    }
+    if (sub === 'charter') {
+      const op = args._[2];
+      if (op === 'get') {
+        process.exitCode = await runWorkstreamCharterGetCommand(args);
+        return;
+      }
+      if (op === 'set') {
+        process.exitCode = await runWorkstreamCharterSetCommand(args);
+        return;
+      }
+      console.error(`unknown workstream charter op: ${op}`);
+      process.exit(1);
+    }
+    console.error(`unknown workstream subcommand: ${sub}`);
+    process.exit(1);
+  }
+
+  if (command === 'agent') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.agent);
+      return;
+    }
+    if (sub === 'list') {
+      process.exitCode = await runAgentListCommand(args);
+      return;
+    }
+    if (sub === 'create') {
+      process.exitCode = await runAgentCreateCommand(args);
+      return;
+    }
+    if (sub === 'delete') {
+      process.exitCode = await runAgentDeleteCommand(args);
+      return;
+    }
+    console.error(`unknown agent subcommand: ${sub}`);
+    process.exit(1);
+  }
+
+  if (command === 'service') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.service);
+      return;
+    }
+    if (sub === 'create') { process.exitCode = await runServiceCreateCommand(args); return; }
+    if (sub === 'update') { process.exitCode = await runServiceUpdateCommand(args); return; }
+    if (sub === 'delete') { process.exitCode = await runServiceDeleteCommand(args); return; }
+    if (sub === 'list')   { process.exitCode = await runServiceListCommand(args); return; }
+    if (sub === 'info')   { process.exitCode = await runServiceInfoCommand(args); return; }
+    if (sub === 'call')   { process.exitCode = await runServiceCallCommand(args); return; }
+    console.error(`unknown service subcommand: ${sub}`);
+    process.exit(1);
+  }
+
+  if (command === 'briefing') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.briefing);
+      return;
+    }
+    if (sub === 'publish') {
+      process.exitCode = await runBriefingPublishCommand(args);
+      return;
+    }
+    if (sub === 'get') {
+      process.exitCode = await runBriefingGetCommand(args);
+      return;
+    }
+    console.error(`unknown briefing subcommand: ${sub}`);
+    process.exit(1);
+  }
+
+  if (command === 'credential') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.credential);
+      return;
+    }
+    if (sub === 'request') {
+      process.exitCode = await runCredentialRequestCommand(args);
+      return;
+    }
+    console.error(`unknown credential subcommand: ${sub}`);
+    process.exit(1);
+  }
+
+  if (command === 'dashboard') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.dashboard);
+      return;
+    }
+    if (sub === 'set') {
+      process.exitCode = await runDashboardSetCommand(args);
+      return;
+    }
+    if (sub === 'get') {
+      process.exitCode = await runDashboardGetCommand(args);
+      return;
+    }
+    console.error(`unknown dashboard subcommand: ${sub}`);
+    process.exit(1);
+  }
+
+  if (command === 'charter') {
+    const sub = args._[1];
+    if (args.help || args.h || !sub) {
+      console.log(AGENT_COMMAND_HELP.charter);
+      return;
+    }
+    if (sub === 'get') {
+      process.exitCode = await runWorkstreamCharterGetCommand(args);
+      return;
+    }
+    if (sub === 'set') {
+      process.exitCode = await runWorkstreamCharterSetCommand(args);
+      return;
+    }
+    console.error(`unknown charter subcommand: ${sub}`);
+    process.exit(1);
+  }
+
   if (command === 'group') {
     const sub = args._[1];
     if (args.help || args.h || !sub) {
@@ -463,6 +668,27 @@ async function main() {
       process.exitCode = await runGroupCreateCommand(args);
       return;
     }
+    if (sub === 'list') {
+      process.exitCode = await runWorkstreamListCommand(args);
+      return;
+    }
+    if (sub === 'delete') {
+      process.exitCode = await runWorkstreamDeleteCommand(args);
+      return;
+    }
+    if (sub === 'charter') {
+      const op = args._[2];
+      if (op === 'get') {
+        process.exitCode = await runWorkstreamCharterGetCommand(args);
+        return;
+      }
+      if (op === 'set') {
+        process.exitCode = await runWorkstreamCharterSetCommand(args);
+        return;
+      }
+      console.error(`unknown group charter op: ${op}`);
+      process.exit(1);
+    }
     if (sub === 'members') {
       // Same subcommand handles list / add / remove based on flags.
       if (args.add) {
@@ -605,6 +831,14 @@ async function main() {
       console.log('Restart ticlawk for the daemon to use the selected profile.');
       return;
     }
+    if (subcommand === 'show') {
+      process.exitCode = await runProfileShowCommand(args);
+      return;
+    }
+    if (subcommand === 'update') {
+      process.exitCode = await runProfileUpdateCommand(args);
+      return;
+    }
     console.error(`unknown profile subcommand: ${subcommand}`);
     process.exit(1);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticlawk",
-  "version": "0.1.16-dev.9",
+  "version": "0.1.17-dev.1",
   "description": "Local connector that links agent harnesses (Claude Code, Codex, OpenClaw, opencode, Pi) to the Ticlawk mobile app.",
   "type": "module",
   "main": "ticlawk.mjs",