ticlawk 0.1.16-dev.16 → 0.1.16-dev.17

package/package.json

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

package/src/cli/agent-commands.mjs

@@ -1242,9 +1242,10 @@ export const AGENT_COMMAND_HELP = {
       unless --allow-cross-target is passed deliberately.
     --kind <kind> tags this message via metadata.kind.
     Targets:
-      dm:@<user>         private message
-      #<group>           group conversation
-      #<group>:<msgid>   replies under a top-level message in that group
+      dm:<conversation-id>  private message by conversation id
+      dm:@<user>            private message by user/agent handle
+      #<group>              group conversation by name or id
+      #<group>:<msgid>      replies under a top-level message in that group
     --attach <file> uploads a local file and attaches it to the message
       (repeatable; max 10 attachments per message).
   ticlawk message read --target "<target>" [--around <msg-id>] [--before-seq N] [--limit N]

package/src/core/agent-cli-handlers.mjs

@@ -7,7 +7,8 @@
  * and forwards to the ticlawk backend using the connector API key.
  *
  * Targets are parsed in the daemon (not on the wire to backend) so the
- * CLI can speak `#<group>` / `dm:@<user>` / `#<group>:<short-msg-id>`
+ * CLI can speak `#<group>` / `dm:<conversation-id>` / `dm:@<user>` /
+ * `#<group>:<short-msg-id>`
  * while backend keeps a flat conversation_id contract.
  */
 

package/src/runtimes/_shared/goal-task-protocol.mjs

@@ -71,18 +71,32 @@ Core concepts:
 - Quote: context showing which message, briefing, or dashboard the user is responding to.
 - Task board: the persistent group task list managed through \`ticlawk task list/create/claim/unclaim/update\`.
 - Claimable task: a task assigned to you or an unclaimed task you are about to execute.
-- Dashboard: an owner-facing HTML report for the conversation goal. It is the visual presentation of the key information associated with the level of achievement of the goal, like a report sent to a CEO for review.
-- Briefing: an active notification to the owner. It tells the owner what happened, why it matters to the goal, and what owner action is needed, if any.
+- Dashboard: an owner-facing HTML report for the conversation goal. It is the visual presentation of the key information associated with the level of achievement of the goal, like a report sent to a CEO for review. It is published or updated with \`ticlawk dashboard set\` as an \`html_template\` plus optional structured \`data_json\`.
+- Briefing: an active notification to the owner. It tells the owner what happened, why it matters to the goal, and what owner action is needed, if any. It is published with \`ticlawk briefing publish --text "..."\`, optionally with one image, video, or HTML attachment when visual context matters.
 `);
 }
 
 function buildStateSurfaceRules() {
   return promptBlock(`
 Dashboard and briefing rules:
-- Dashboard is a visual report for the level of achievement of the conversation goal.
-- Briefing is normally a short owner-facing text update of 140 characters or fewer.
-- A briefing may include one image, video, or HTML attachment only when visual context is important to understand the update or make a decision.
-- For pretty HTML artifacts, it is recommended to use /vibeshare to generate them. If /vibeshare is not available, install it into your skill directory using the setup instructions at https://vibeshare.page/skill. For ${BRAND_NAME} dashboards and briefing HTML attachments, generate the HTML locally, then publish it through ${BRAND_NAME} dashboard or briefing commands instead of /vibeshare publish.
+- Create the initial dashboard during goal setup, publish it, and explicitly ask the owner whether the dashboard layout, basic style, and decision view are satisfactory.
+- After the owner accepts the initial dashboard direction, treat its layout and basic style as stable. Routine dashboard updates should update content/data inside that design, not redesign the page.
+- Redesign the dashboard layout or basic style only when the goal, success metrics, or main owner focus changes materially; summarize the change and confirm it before replacing the dashboard design.
+- Keep briefings for active owner notifications: milestone reached, important change, blocker, request for owner input/resources/permission/confirmation/decision, or final result.
+- When creating or materially updating a polished HTML artifact for any ${BRAND_NAME} surface, use \`/vibeshare generate\`. If \`/vibeshare\` is not installed or available in your skills, install it first using the setup instructions at https://vibeshare.page/skill.
+- For ${BRAND_NAME} dashboards and briefing HTML attachments, \`/vibeshare\` is the HTML generation path only. Publish the generated dashboard HTML with \`ticlawk dashboard set\`, and publish briefing text/attachments with \`ticlawk briefing publish\`; do not use \`/vibeshare publish\` for these ${BRAND_NAME} surfaces.
+`);
+}
+
+function buildGoalSetupRules() {
+  return promptBlock(`
+Goal setup when no chartered goal exists:
+- Do not turn every one-off request into a durable goal. Answer direct asks normally unless the owner expresses a lasting aspiration, ongoing objective, tracking need, reminder cadence, multi-step roadmap, or resource/coordinator need.
+- When durable intent is visible and no suitable chartered goal exists, propose making it a conversation goal. Clarify whether it belongs in the current DM, an existing group/workstream, or a new workstream before writing state.
+- Clarify only the details needed to proceed: goal definition, success/completion criteria, time range, constraints/boundaries, rough approach or roadmap, the agent's deliverables, owner responsibilities, required files/repos/accounts/credentials/budget/resources, dashboard decision view and metrics, and briefing triggers/cadence.
+- Before setting a charter, summarize the proposed short charter and ask for confirmation. Keep charters to the local goal, roles, success criteria, and boundaries; do not put shared workflow law, dashboard state, task status, or long playbooks in the charter.
+- After confirmation, write the charter if you have scope authority. Then create and publish the initial dashboard as part of goal setup, push it to the owner for review, and ask whether the layout/style/decision view are satisfactory. Create reminders/resources only when useful, and seed group tasks only in group/workstream scope. Then enter the normal goal loop.
+- Treat goal setup as revisable. If the owner changes the goal, metrics, cadence, scope, or boundaries later, summarize the change, confirm if it materially changes the agreement, then update the charter and related surfaces.
 `);
 }
 
@@ -91,6 +105,7 @@ function buildGoalLoopOverlay() {
 Goal authority overlay: responsible for this conversation's goal and tasks
 - You are responsible for driving the conversation toward its goal, not only replying to isolated messages.
 - Maintain or infer the current goal from the direct ask, charter, dashboard/briefing quote, task board, and conversation context.
+${buildGoalSetupRules()}
 - Run the goal loop:
   1. Evaluate current facts against the goal.
   2. Identify the concrete gap, if any.

package/src/runtimes/_shared/standing-prompt.mjs

@@ -37,7 +37,7 @@ private activity text; it is not sent to users or groups.
 ## Per-Turn Routine
 
 1. Read \`MEMORY.md\` in your cwd, then only the files/context needed for
-   the current turn.
+   the current turn. Follow linked notes only when they are relevant.
 2. If there is no concrete inbound message or reminder to handle, stop.
 3. If the message includes \`[charter]\`, treat it as the local
    conversation goal and role spec.
@@ -56,6 +56,12 @@ private activity text; it is not sent to users or groups.
 - \`ticlawk charter get/set\`: inspect or update the current conversation's
   goal and role spec. DM agents may write their DM charter; group charter
   writes require admin/owner role.
+- \`ticlawk dashboard set/get\`: publish or read owner-facing HTML
+  dashboards. \`set\` reads JSON from stdin: \`{ html_template, data_json }\`.
+  Allowed from DMs, or from groups where this agent is admin/owner.
+- \`ticlawk briefing publish/get\`: publish or read owner-facing briefings.
+  Use \`publish --text "..."\` with an optional \`--attach <image|video|html>\`.
+  Allowed from DMs, or from groups where this agent is admin/owner.
 - \`ticlawk task list/create/claim/unclaim/update\`: use only as allowed by
   the goal/task protocol and backend errors.
 - \`ticlawk reminder schedule/snooze/update/cancel\`: use for future
@@ -105,7 +111,8 @@ private activity text; it is not sent to users or groups.
 
 If a new message arrives while you are busy, finish the current step before
 pivoting unless the new message clearly supersedes the current work. The
-daemon will wake or notify you again; you do not need to poll for messages.`;
+daemon wakes agents for new messages and reminders; you do not need to poll.
+When future self-resume is needed, schedule a reminder.`;
 
 export function buildStandingPrompt(_ctx = {}) {
   return promptBlock(`

package/src/runtimes/_shared/wake-prompt.mjs

@@ -105,7 +105,7 @@ ${charter}
 // `messages.metadata.quote = { kind, ref, snippet }`. We render a
 // short, prefix-cache-friendly block and tell the agent how to fetch
 // the full content if needed.
-export function buildQuoteBlock(msg) {
+export function buildQuoteBlock(msg, target = '') {
   const meta = msg.message_metadata || msg.metadata || null;
   const quote = meta && typeof meta === 'object' ? meta.quote : null;
   if (!quote || typeof quote !== 'object') return '';
@@ -116,9 +116,9 @@ export function buildQuoteBlock(msg) {
   const fetchHint = kind === 'briefing'
     ? `ticlawk briefing get ${ref}`
     : kind === 'dashboard'
-      ? `ticlawk dashboard get --target "#${ref}"`
+      ? `ticlawk dashboard get --conversation-id ${ref}`
       : kind === 'message'
-        ? `ticlawk message read --around ${ref}`
+        ? `ticlawk message read --target ${JSON.stringify(target)} --around ${ref}`
         : '';
   const snippetLine = snippet ? `\n  "${snippet.replace(/"/g, '\\"')}"` : '';
   const fetchLine = fetchHint ? `\n  fetch: ${fetchHint}` : '';
@@ -160,7 +160,7 @@ export function buildInboundWakePrompt(msg) {
   const target = buildEnvelopeTarget(msg);
   const groupContext = buildGroupContextBlock(msg);
   const charterBlock = buildCharterBlock(msg);
-  const quoteBlock = buildQuoteBlock(msg);
+  const quoteBlock = buildQuoteBlock(msg, target);
   const text = header
     ? buildWakePromptText({ envelopeHeader: header, target, rawText, groupContext, charterBlock, quoteBlock })
     : rawText;