@ghostpaw/questlog 0.3.0 → 0.5.0

package/dist/index.cjs

@@ -2002,6 +2002,29 @@ function softDeleteRumor(db, rumorId, now) {
   ).run(deletedAt, deletedAt, rumorId);
 }
 
+// src/rumors/update_rumor.ts
+function updateRumor(db, rumorId, input) {
+  if (input.title == null && input.details == null) {
+    throw new Error("At least one of title or details must be provided to update a rumor.");
+  }
+  const current = getRumorOrThrow(db, rumorId);
+  if (current.settledAt != null) {
+    throw new Error(`Rumor ${rumorId} is already settled and cannot be updated.`);
+  }
+  if (current.dismissedAt != null) {
+    throw new Error(`Rumor ${rumorId} is dismissed and cannot be updated. Reopen it first.`);
+  }
+  const now = resolveNow(input.now);
+  const nextTitle = input.title != null ? assertNonEmpty(input.title, "Rumor title") : current.title;
+  const nextDetails = input.details != null ? input.details.trim() || null : current.details;
+  db.prepare(
+    `UPDATE rumors
+     SET title = ?, details = ?, updated_at = ?
+     WHERE id = ? AND deleted_at IS NULL`
+  ).run(nextTitle, nextDetails, now, rumorId);
+  return getRumorOrThrow(db, rumorId);
+}
+
 // src/search_questlog.ts
 function searchQuestlog(db, query) {
   const trimmed = query.trim();
@@ -5225,6 +5248,27 @@ function shapeWorkToolHandler(db, input) {
           }
         );
       }
+      case "update_rumor": {
+        updateRumor(db, input.rumorId, {
+          ...input.title != null && { title: input.title },
+          ...input.details != null && { details: input.details },
+          ...input.now != null && { now: input.now }
+        });
+        const detail = getRumorDetail(db, input.rumorId);
+        return toolSuccess(
+          `Updated rumor \`${detail.title}\`.`,
+          {
+            action: input.action,
+            primary: toRumorRef(detail),
+            updated: [toRumorRef(detail)],
+            rumor: detail
+          },
+          {
+            entities: [toRumorRef(detail)],
+            next: [inspectItemNext(toRumorRef(detail))]
+          }
+        );
+      }
     }
   } catch (error) {
     return translateToolError(error, {
@@ -5234,8 +5278,8 @@ function shapeWorkToolHandler(db, input) {
 }
 var shapeWorkTool = defineQuestlogTool({
   name: shapeWorkToolName,
-  description: "Shape real work structure by settling rumors, creating quests or questlines, and attaching or detaching quests from questlines.",
-  whenToUse: "Use this when deciding what real work exists and how it should be grouped before or around execution.",
+  description: "Create a quest (with timing, tags, and objective in one call), create a questline, settle a rumor into concrete work, or manage quest-questline membership. Use create_quest for clear commitments \u2014 include tags and timing directly to avoid follow-up calls.",
+  whenToUse: "Use this when deciding what real work exists and how it should be grouped before or around execution. Prefer a single create_quest call with all fields over separate create + plan_quest + tag_work calls.",
   whenNotToUse: "Do not use this for quest execution steps like starting, finishing, abandoning, or logging effort.",
   sideEffects: "writes_state",
   readOnly: false,
@@ -5244,14 +5288,16 @@ var shapeWorkTool = defineQuestlogTool({
   inputDescriptions: {
     action: "Which structure-shaping action to perform, such as settling a rumor, creating a quest, or attaching a quest to a questline.",
     rumorId: "The rumor to dismiss, reopen, or settle when the action targets intake.",
-    questline: "Questline creation data used when creating a questline directly or as part of rumor settlement.",
-    quests: "Concrete quest creation inputs used when settling a rumor into real work.",
+    questline: "Questline creation data used when creating a questline directly or as part of rumor settlement. Include description for context.",
+    quests: "Concrete quest creation inputs when settling a rumor into real work. Each quest supports the same fields as the quest property \u2014 include timing and tags directly.",
     settledAt: "Optional settlement timestamp for rumor settlement.",
-    quest: "Quest creation input used when directly creating one concrete quest.",
+    quest: "Quest creation input when directly creating one concrete quest. Include timing fields (dueAt, scheduledStartAt, etc.), tags, and rewards to create a fully specified quest in one call.",
     questId: "The concrete quest being attached to or detached from a questline.",
     questlineId: "The questline that should receive the quest for attach actions.",
     dismissedAt: "Optional dismissal timestamp for dismissing a rumor.",
-    now: "Optional timestamp for reopen or questline membership changes."
+    now: "Optional timestamp for reopen, questline membership, or rumor update.",
+    title: "New title for the update_rumor action.",
+    details: "New or enriched context for the update_rumor action. Append evidence as rumors accumulate information across conversations."
   },
   outputDescription: "Returns the changed or created rumor, quest, questline, or created quest set for the selected shape-work action, plus purpose-shaped primary and created or updated refs. Repeated safe actions return structured no-op results, and rumor settlement can ask for missing structure instead of failing.",
   inputSchema: objectSchema(
@@ -5263,20 +5309,40 @@ var shapeWorkTool = defineQuestlogTool({
         "detach_quest_from_questline",
         "dismiss_rumor",
         "reopen_rumor",
-        "settle_rumor"
+        "settle_rumor",
+        "update_rumor"
       ]),
       questId: integerSchema("Quest to attach or detach."),
       questlineId: integerSchema("Questline that should receive the quest."),
       quest: objectSchema(
         {
           title: stringSchema("Title for the new quest."),
-          objective: stringSchema("Objective for the new quest.")
+          objective: stringSchema("Objective for the new quest."),
+          questlineId: integerSchema("Optional questline to place the quest in."),
+          tags: arraySchema(stringSchema("Tag name."), "Optional tags to apply at creation."),
+          rewards: arraySchema(
+            objectSchema(
+              {
+                kind: stringSchema("Reward kind."),
+                name: stringSchema("Reward name.")
+              },
+              ["kind", "name"]
+            ),
+            "Optional rewards to attach at creation."
+          ),
+          dueAt: integerSchema("Optional latest acceptable completion timestamp."),
+          notBeforeAt: integerSchema("Optional earliest actionable timestamp."),
+          scheduledStartAt: integerSchema("Optional planned schedule window start."),
+          scheduledEndAt: integerSchema("Optional planned schedule window end."),
+          allDay: booleanSchema("Whether the scheduled window is all-day."),
+          estimateSeconds: integerSchema("Optional active-effort estimate in seconds.")
         },
         ["title", "objective"]
       ),
       questline: objectSchema(
         {
-          title: stringSchema("Questline title.")
+          title: stringSchema("Questline title."),
+          description: stringSchema("Optional questline description.")
         },
         []
       ),
@@ -5287,16 +5353,35 @@ var shapeWorkTool = defineQuestlogTool({
         objectSchema(
           {
             title: stringSchema("Title for a created quest."),
-            objective: stringSchema("Objective for a created quest.")
+            objective: stringSchema("Objective for a created quest."),
+            tags: arraySchema(stringSchema("Tag name."), "Optional tags to apply at creation."),
+            rewards: arraySchema(
+              objectSchema(
+                {
+                  kind: stringSchema("Reward kind."),
+                  name: stringSchema("Reward name.")
+                },
+                ["kind", "name"]
+              ),
+              "Optional rewards to attach at creation."
+            ),
+            dueAt: integerSchema("Optional latest acceptable completion timestamp."),
+            notBeforeAt: integerSchema("Optional earliest actionable timestamp."),
+            scheduledStartAt: integerSchema("Optional planned schedule window start."),
+            scheduledEndAt: integerSchema("Optional planned schedule window end."),
+            allDay: booleanSchema("Whether the scheduled window is all-day."),
+            estimateSeconds: integerSchema("Optional active-effort estimate in seconds.")
           },
           ["title", "objective"]
         ),
-        "Quests to create during rumor settlement."
+        "Quests to create during rumor settlement. Include timing and tags directly."
       ),
-      now: integerSchema("Optional timestamp for membership or reopen changes.")
+      now: integerSchema("Optional timestamp for membership, reopen, or rumor update."),
+      title: stringSchema("New title for the update_rumor action."),
+      details: stringSchema("New or enriched context text for the update_rumor action.")
     },
     ["action"],
-    "Shape the work graph by settling rumors, creating work, or moving quests into questlines."
+    "Create quests with timing and tags, create questlines, settle rumors into work, manage quest-questline membership, or enrich open rumors with new context."
   ),
   handler: shapeWorkToolHandler
 });
@@ -5674,7 +5759,8 @@ __export(write_exports, {
   untagQuest: () => untagQuest,
   updateQuestReward: () => updateQuestReward,
   updateQuestline: () => updateQuestline,
-  updateRepeatableQuest: () => updateRepeatableQuest
+  updateRepeatableQuest: () => updateRepeatableQuest,
+  updateRumor: () => updateRumor
 });
 
 exports.initQuestlogTables = initQuestlogTables;

package/dist/index.d.cts

@@ -268,6 +268,15 @@ interface CaptureRumorInput {
     details?: string | null;
     now?: number;
 }
+/**
+ * Input for enriching an existing open rumor with new title or details.
+ * At least one of title or details must be provided.
+ */
+interface UpdateRumorInput {
+    title?: string;
+    details?: string;
+    now?: number;
+}
 /**
  * A downstream artifact created from rumor settlement.
  */
@@ -653,6 +662,13 @@ declare function settleRumor(db: QuestlogDb, rumorId: number, input: SettleRumor
  */
 declare function softDeleteRumor(db: QuestlogDb, rumorId: number, now?: number): void;
 
+/**
+ * Enriches an existing open rumor with a new title and/or details.
+ * Advances updatedAt so downstream consumers can detect enrichment.
+ * Throws if the rumor is settled, dismissed, or deleted.
+ */
+declare function updateRumor(db: QuestlogDb, rumorId: number, input: UpdateRumorInput): Rumor;
+
 /**
  * Search result across questlog content.
  */
@@ -1474,7 +1490,13 @@ type ShapeWorkToolInput = {
 } | ({
     action: 'settle_rumor';
     rumorId: number;
-} & SettleRumorInput);
+} & SettleRumorInput) | {
+    action: 'update_rumor';
+    rumorId: number;
+    title?: string;
+    details?: string;
+    now?: number;
+};
 interface ShapeWorkToolData {
     action: ShapeWorkToolInput['action'];
     primary?: ToolEntityRef | undefined;
@@ -1693,8 +1715,9 @@ declare const write_untagQuest: typeof untagQuest;
 declare const write_updateQuestReward: typeof updateQuestReward;
 declare const write_updateQuestline: typeof updateQuestline;
 declare const write_updateRepeatableQuest: typeof updateRepeatableQuest;
+declare const write_updateRumor: typeof updateRumor;
 declare namespace write {
-  export { write_abandonQuest as abandonQuest, write_abandonQuestAndSpawnFollowups as abandonQuestAndSpawnFollowups, write_addQuestReward as addQuestReward, write_addUnlock as addUnlock, write_archiveQuestline as archiveQuestline, write_archiveRepeatableQuest as archiveRepeatableQuest, write_captureRumor as captureRumor, write_claimQuestReward as claimQuestReward, write_createQuest as createQuest, write_createQuestline as createQuestline, write_createRepeatableQuest as createRepeatableQuest, write_detachQuestFromQuestline as detachQuestFromQuestline, write_dismissRumor as dismissRumor, write_finishQuest as finishQuest, write_logQuestEffort as logQuestEffort, write_moveQuestToQuestline as moveQuestToQuestline, write_planQuestTime as planQuestTime, write_removeQuestReward as removeQuestReward, write_removeUnlock as removeUnlock, write_reopenRumor as reopenRumor, write_replaceQuestTags as replaceQuestTags, write_replaceRepeatableQuestRewards as replaceRepeatableQuestRewards, write_replaceRepeatableQuestTags as replaceRepeatableQuestTags, write_replaceUnlocks as replaceUnlocks, write_reviseQuestObjective as reviseQuestObjective, write_settleRumor as settleRumor, write_softDeleteQuest as softDeleteQuest, write_softDeleteQuestline as softDeleteQuestline, write_softDeleteRepeatableQuest as softDeleteRepeatableQuest, write_softDeleteRumor as softDeleteRumor, write_spawnDueRepeatableQuests as spawnDueRepeatableQuests, write_startQuest as startQuest, write_tagQuest as tagQuest, write_untagQuest as untagQuest, write_updateQuestReward as updateQuestReward, write_updateQuestline as updateQuestline, write_updateRepeatableQuest as updateRepeatableQuest };
+  export { write_abandonQuest as abandonQuest, write_abandonQuestAndSpawnFollowups as abandonQuestAndSpawnFollowups, write_addQuestReward as addQuestReward, write_addUnlock as addUnlock, write_archiveQuestline as archiveQuestline, write_archiveRepeatableQuest as archiveRepeatableQuest, write_captureRumor as captureRumor, write_claimQuestReward as claimQuestReward, write_createQuest as createQuest, write_createQuestline as createQuestline, write_createRepeatableQuest as createRepeatableQuest, write_detachQuestFromQuestline as detachQuestFromQuestline, write_dismissRumor as dismissRumor, write_finishQuest as finishQuest, write_logQuestEffort as logQuestEffort, write_moveQuestToQuestline as moveQuestToQuestline, write_planQuestTime as planQuestTime, write_removeQuestReward as removeQuestReward, write_removeUnlock as removeUnlock, write_reopenRumor as reopenRumor, write_replaceQuestTags as replaceQuestTags, write_replaceRepeatableQuestRewards as replaceRepeatableQuestRewards, write_replaceRepeatableQuestTags as replaceRepeatableQuestTags, write_replaceUnlocks as replaceUnlocks, write_reviseQuestObjective as reviseQuestObjective, write_settleRumor as settleRumor, write_softDeleteQuest as softDeleteQuest, write_softDeleteQuestline as softDeleteQuestline, write_softDeleteRepeatableQuest as softDeleteRepeatableQuest, write_softDeleteRumor as softDeleteRumor, write_spawnDueRepeatableQuests as spawnDueRepeatableQuests, write_startQuest as startQuest, write_tagQuest as tagQuest, write_untagQuest as untagQuest, write_updateQuestReward as updateQuestReward, write_updateQuestline as updateQuestline, write_updateRepeatableQuest as updateRepeatableQuest, write_updateRumor as updateRumor };
 }
 
-export { type AbandonQuestResult, type CaptureRumorInput, type CreateQuestInput, type CreateQuestlineInput, type CreateRepeatableQuestInput, type DueRepeatableAnchor, type FollowupQuestInput, type JsonSchema, type JsonSchemaType, type MarkerDefinition, type MarkerId, type PlanQuestTimeInput, type Quest, type QuestDetail, type QuestListFilters, type QuestReward, type QuestRewardInput, type QuestState, type QuestUnlock, type Questline, type QuestlineDetail, type QuestlogDb, type QuestlogSearchResult, type QuestlogSkill, type QuestlogSkillRegistry, type QuestlogSoul, type QuestlogSoulTrait, type QuestlogToolDefinition, type QuestlogToolMapping, type RepeatableQuest, type RepeatableQuestReward, type RepeatableQuestRewardInput, type Rumor, type RumorDetail, type RumorOutput, type RumorState, type SettleRumorInput, type SettleRumorResult, type Tag, type ToolClarificationCode, type ToolDefinitionRegistry, type ToolEntityKind, type ToolEntityRef, type ToolErrorCode, type ToolErrorKind, type ToolFailure, type ToolInputDescriptions, type ToolListItem, type ToolNeedsClarification, type ToolNextStepHint, type ToolNextStepHintKind, type ToolOutcomeKind, type ToolOutputDescription, type ToolResult, type ToolSideEffects, type ToolSuccess, type ToolWarning, type ToolWarningCode, type UpdateQuestlineInput, type UpdateRepeatableQuestInput, abandonQuest, abandonQuestAndSpawnFollowups, addQuestReward, addUnlock, archiveDeleteAndPruneSkill, archiveQuestline, archiveRepeatableQuest, arraySchema, booleanSchema, captureRumor, captureRumorTool, captureRumorToolHandler, captureRumorToolName, chooseWorkShapeSkill, claimQuestReward, clarifyAmbiguousRequestsSkill, closeWorkAndClaimOutcomesSkill, createConcreteQuestSkill, createQuest, createQuestline, createRepeatableQuest, defineQuestlogSkill, defineQuestlogTool, detachQuestFromQuestline, detectSlipsAndStalenessSkill, dismissRumor, enumSchema, escalateAndUnblockSkill, finishQuest, frameInitiativeQuestlineSkill, getQuestDetail, getQuestlineDetail, getQuestlogSkillByName, getQuestlogToolByName, getRumorDetail, getRumorOutputs, handleExceptionsAndWeirdCasesSkill, initQuestlogTables, inspectQuestlogItemTool, inspectQuestlogItemToolHandler, inspectQuestlogItemToolName, intakeTriageSkill, integerSchema, listActiveQuests, listAvailableQuests, listBlockedQuests, listDeferredQuests, listDueRepeatableQuestAnchors, listDueSoonQuests, listInProgressQuests, listMissedScheduledQuests, listOpenQuests, listOverdueQuests, listQuestlines, listQuestlogSkills, listQuestlogToolDefinitions, listResolvedQuests, listRumors, listScheduledForDay, listScheduledNow, literalSchema, logQuestEffort, maintainClearOwnershipSkill, manageApprovalsAndPromisesSkill, manageRepeatableTool, manageRepeatableToolHandler, manageRepeatableToolName, index$2 as markers, moveQuestToQuestline, numberSchema, objectSchema, oneOfSchema, organizeWorkTool, organizeWorkToolHandler, organizeWorkToolName, planQuestTime, planQuestTool, planQuestToolHandler, planQuestToolName, planSuccessorWorkSkill, planTimeCorrectlySkill, prioritizeAcrossStreamsSkill, protectCapacityAndFocusSkill, questlogSkills, questlogToolMappings, questlogTools, read, recoverFromModelingMistakesSkill, removeQuestReward, removeUnlock, reopenRumor, replaceQuestTags, replaceRepeatableQuestRewards, replaceRepeatableQuestTags, replaceUnlocks, reportStatusAndManageExpectationsSkill, retireWorkTool, retireWorkToolHandler, retireWorkToolName, reviewQuestlogTool, reviewQuestlogToolHandler, reviewQuestlogToolName, reviseOrReshapeCommitmentSkill, reviseQuestObjective, rewardWorkTool, rewardWorkToolHandler, rewardWorkToolName, runOperationalReviewSkill, runQuestTool, runQuestToolHandler, runQuestToolName, runRecurringRhythmsSkill, searchAndRetrieveContextSkill, searchQuestlogTool, searchQuestlogToolHandler, searchQuestlogToolName, sequenceWithUnlocksSkill, settleRumor, settleRumorIntoStructureSkill, shapeWorkTool, shapeWorkToolHandler, shapeWorkToolName, index$1 as skills, softDeleteQuest, softDeleteQuestline, softDeleteRepeatableQuest, softDeleteRumor, soul, spawnDueRepeatableQuests, startQuest, stringSchema, tagAndFilterPortfoliosSkill, tagQuest, tagWorkTool, tagWorkToolHandler, tagWorkToolName, toolFailure, toolNeedsClarification, toolNoOp, toolSuccess, toolWarning, index as tools, untagQuest, updateQuestReward, updateQuestline, updateRepeatableQuest, write };
+export { type AbandonQuestResult, type CaptureRumorInput, type CreateQuestInput, type CreateQuestlineInput, type CreateRepeatableQuestInput, type DueRepeatableAnchor, type FollowupQuestInput, type JsonSchema, type JsonSchemaType, type MarkerDefinition, type MarkerId, type PlanQuestTimeInput, type Quest, type QuestDetail, type QuestListFilters, type QuestReward, type QuestRewardInput, type QuestState, type QuestUnlock, type Questline, type QuestlineDetail, type QuestlogDb, type QuestlogSearchResult, type QuestlogSkill, type QuestlogSkillRegistry, type QuestlogSoul, type QuestlogSoulTrait, type QuestlogToolDefinition, type QuestlogToolMapping, type RepeatableQuest, type RepeatableQuestReward, type RepeatableQuestRewardInput, type Rumor, type RumorDetail, type RumorOutput, type RumorState, type SettleRumorInput, type SettleRumorResult, type Tag, type ToolClarificationCode, type ToolDefinitionRegistry, type ToolEntityKind, type ToolEntityRef, type ToolErrorCode, type ToolErrorKind, type ToolFailure, type ToolInputDescriptions, type ToolListItem, type ToolNeedsClarification, type ToolNextStepHint, type ToolNextStepHintKind, type ToolOutcomeKind, type ToolOutputDescription, type ToolResult, type ToolSideEffects, type ToolSuccess, type ToolWarning, type ToolWarningCode, type UpdateQuestlineInput, type UpdateRepeatableQuestInput, type UpdateRumorInput, abandonQuest, abandonQuestAndSpawnFollowups, addQuestReward, addUnlock, archiveDeleteAndPruneSkill, archiveQuestline, archiveRepeatableQuest, arraySchema, booleanSchema, captureRumor, captureRumorTool, captureRumorToolHandler, captureRumorToolName, chooseWorkShapeSkill, claimQuestReward, clarifyAmbiguousRequestsSkill, closeWorkAndClaimOutcomesSkill, createConcreteQuestSkill, createQuest, createQuestline, createRepeatableQuest, defineQuestlogSkill, defineQuestlogTool, detachQuestFromQuestline, detectSlipsAndStalenessSkill, dismissRumor, enumSchema, escalateAndUnblockSkill, finishQuest, frameInitiativeQuestlineSkill, getQuestDetail, getQuestlineDetail, getQuestlogSkillByName, getQuestlogToolByName, getRumorDetail, getRumorOutputs, handleExceptionsAndWeirdCasesSkill, initQuestlogTables, inspectQuestlogItemTool, inspectQuestlogItemToolHandler, inspectQuestlogItemToolName, intakeTriageSkill, integerSchema, listActiveQuests, listAvailableQuests, listBlockedQuests, listDeferredQuests, listDueRepeatableQuestAnchors, listDueSoonQuests, listInProgressQuests, listMissedScheduledQuests, listOpenQuests, listOverdueQuests, listQuestlines, listQuestlogSkills, listQuestlogToolDefinitions, listResolvedQuests, listRumors, listScheduledForDay, listScheduledNow, literalSchema, logQuestEffort, maintainClearOwnershipSkill, manageApprovalsAndPromisesSkill, manageRepeatableTool, manageRepeatableToolHandler, manageRepeatableToolName, index$2 as markers, moveQuestToQuestline, numberSchema, objectSchema, oneOfSchema, organizeWorkTool, organizeWorkToolHandler, organizeWorkToolName, planQuestTime, planQuestTool, planQuestToolHandler, planQuestToolName, planSuccessorWorkSkill, planTimeCorrectlySkill, prioritizeAcrossStreamsSkill, protectCapacityAndFocusSkill, questlogSkills, questlogToolMappings, questlogTools, read, recoverFromModelingMistakesSkill, removeQuestReward, removeUnlock, reopenRumor, replaceQuestTags, replaceRepeatableQuestRewards, replaceRepeatableQuestTags, replaceUnlocks, reportStatusAndManageExpectationsSkill, retireWorkTool, retireWorkToolHandler, retireWorkToolName, reviewQuestlogTool, reviewQuestlogToolHandler, reviewQuestlogToolName, reviseOrReshapeCommitmentSkill, reviseQuestObjective, rewardWorkTool, rewardWorkToolHandler, rewardWorkToolName, runOperationalReviewSkill, runQuestTool, runQuestToolHandler, runQuestToolName, runRecurringRhythmsSkill, searchAndRetrieveContextSkill, searchQuestlogTool, searchQuestlogToolHandler, searchQuestlogToolName, sequenceWithUnlocksSkill, settleRumor, settleRumorIntoStructureSkill, shapeWorkTool, shapeWorkToolHandler, shapeWorkToolName, index$1 as skills, softDeleteQuest, softDeleteQuestline, softDeleteRepeatableQuest, softDeleteRumor, soul, spawnDueRepeatableQuests, startQuest, stringSchema, tagAndFilterPortfoliosSkill, tagQuest, tagWorkTool, tagWorkToolHandler, tagWorkToolName, toolFailure, toolNeedsClarification, toolNoOp, toolSuccess, toolWarning, index as tools, untagQuest, updateQuestReward, updateQuestline, updateRepeatableQuest, updateRumor, write };

package/dist/index.d.ts

@@ -268,6 +268,15 @@ interface CaptureRumorInput {
     details?: string | null;
     now?: number;
 }
+/**
+ * Input for enriching an existing open rumor with new title or details.
+ * At least one of title or details must be provided.
+ */
+interface UpdateRumorInput {
+    title?: string;
+    details?: string;
+    now?: number;
+}
 /**
  * A downstream artifact created from rumor settlement.
  */
@@ -653,6 +662,13 @@ declare function settleRumor(db: QuestlogDb, rumorId: number, input: SettleRumor
  */
 declare function softDeleteRumor(db: QuestlogDb, rumorId: number, now?: number): void;
 
+/**
+ * Enriches an existing open rumor with a new title and/or details.
+ * Advances updatedAt so downstream consumers can detect enrichment.
+ * Throws if the rumor is settled, dismissed, or deleted.
+ */
+declare function updateRumor(db: QuestlogDb, rumorId: number, input: UpdateRumorInput): Rumor;
+
 /**
  * Search result across questlog content.
  */
@@ -1474,7 +1490,13 @@ type ShapeWorkToolInput = {
 } | ({
     action: 'settle_rumor';
     rumorId: number;
-} & SettleRumorInput);
+} & SettleRumorInput) | {
+    action: 'update_rumor';
+    rumorId: number;
+    title?: string;
+    details?: string;
+    now?: number;
+};
 interface ShapeWorkToolData {
     action: ShapeWorkToolInput['action'];
     primary?: ToolEntityRef | undefined;
@@ -1693,8 +1715,9 @@ declare const write_untagQuest: typeof untagQuest;
 declare const write_updateQuestReward: typeof updateQuestReward;
 declare const write_updateQuestline: typeof updateQuestline;
 declare const write_updateRepeatableQuest: typeof updateRepeatableQuest;
+declare const write_updateRumor: typeof updateRumor;
 declare namespace write {
-  export { write_abandonQuest as abandonQuest, write_abandonQuestAndSpawnFollowups as abandonQuestAndSpawnFollowups, write_addQuestReward as addQuestReward, write_addUnlock as addUnlock, write_archiveQuestline as archiveQuestline, write_archiveRepeatableQuest as archiveRepeatableQuest, write_captureRumor as captureRumor, write_claimQuestReward as claimQuestReward, write_createQuest as createQuest, write_createQuestline as createQuestline, write_createRepeatableQuest as createRepeatableQuest, write_detachQuestFromQuestline as detachQuestFromQuestline, write_dismissRumor as dismissRumor, write_finishQuest as finishQuest, write_logQuestEffort as logQuestEffort, write_moveQuestToQuestline as moveQuestToQuestline, write_planQuestTime as planQuestTime, write_removeQuestReward as removeQuestReward, write_removeUnlock as removeUnlock, write_reopenRumor as reopenRumor, write_replaceQuestTags as replaceQuestTags, write_replaceRepeatableQuestRewards as replaceRepeatableQuestRewards, write_replaceRepeatableQuestTags as replaceRepeatableQuestTags, write_replaceUnlocks as replaceUnlocks, write_reviseQuestObjective as reviseQuestObjective, write_settleRumor as settleRumor, write_softDeleteQuest as softDeleteQuest, write_softDeleteQuestline as softDeleteQuestline, write_softDeleteRepeatableQuest as softDeleteRepeatableQuest, write_softDeleteRumor as softDeleteRumor, write_spawnDueRepeatableQuests as spawnDueRepeatableQuests, write_startQuest as startQuest, write_tagQuest as tagQuest, write_untagQuest as untagQuest, write_updateQuestReward as updateQuestReward, write_updateQuestline as updateQuestline, write_updateRepeatableQuest as updateRepeatableQuest };
+  export { write_abandonQuest as abandonQuest, write_abandonQuestAndSpawnFollowups as abandonQuestAndSpawnFollowups, write_addQuestReward as addQuestReward, write_addUnlock as addUnlock, write_archiveQuestline as archiveQuestline, write_archiveRepeatableQuest as archiveRepeatableQuest, write_captureRumor as captureRumor, write_claimQuestReward as claimQuestReward, write_createQuest as createQuest, write_createQuestline as createQuestline, write_createRepeatableQuest as createRepeatableQuest, write_detachQuestFromQuestline as detachQuestFromQuestline, write_dismissRumor as dismissRumor, write_finishQuest as finishQuest, write_logQuestEffort as logQuestEffort, write_moveQuestToQuestline as moveQuestToQuestline, write_planQuestTime as planQuestTime, write_removeQuestReward as removeQuestReward, write_removeUnlock as removeUnlock, write_reopenRumor as reopenRumor, write_replaceQuestTags as replaceQuestTags, write_replaceRepeatableQuestRewards as replaceRepeatableQuestRewards, write_replaceRepeatableQuestTags as replaceRepeatableQuestTags, write_replaceUnlocks as replaceUnlocks, write_reviseQuestObjective as reviseQuestObjective, write_settleRumor as settleRumor, write_softDeleteQuest as softDeleteQuest, write_softDeleteQuestline as softDeleteQuestline, write_softDeleteRepeatableQuest as softDeleteRepeatableQuest, write_softDeleteRumor as softDeleteRumor, write_spawnDueRepeatableQuests as spawnDueRepeatableQuests, write_startQuest as startQuest, write_tagQuest as tagQuest, write_untagQuest as untagQuest, write_updateQuestReward as updateQuestReward, write_updateQuestline as updateQuestline, write_updateRepeatableQuest as updateRepeatableQuest, write_updateRumor as updateRumor };
 }
 
-export { type AbandonQuestResult, type CaptureRumorInput, type CreateQuestInput, type CreateQuestlineInput, type CreateRepeatableQuestInput, type DueRepeatableAnchor, type FollowupQuestInput, type JsonSchema, type JsonSchemaType, type MarkerDefinition, type MarkerId, type PlanQuestTimeInput, type Quest, type QuestDetail, type QuestListFilters, type QuestReward, type QuestRewardInput, type QuestState, type QuestUnlock, type Questline, type QuestlineDetail, type QuestlogDb, type QuestlogSearchResult, type QuestlogSkill, type QuestlogSkillRegistry, type QuestlogSoul, type QuestlogSoulTrait, type QuestlogToolDefinition, type QuestlogToolMapping, type RepeatableQuest, type RepeatableQuestReward, type RepeatableQuestRewardInput, type Rumor, type RumorDetail, type RumorOutput, type RumorState, type SettleRumorInput, type SettleRumorResult, type Tag, type ToolClarificationCode, type ToolDefinitionRegistry, type ToolEntityKind, type ToolEntityRef, type ToolErrorCode, type ToolErrorKind, type ToolFailure, type ToolInputDescriptions, type ToolListItem, type ToolNeedsClarification, type ToolNextStepHint, type ToolNextStepHintKind, type ToolOutcomeKind, type ToolOutputDescription, type ToolResult, type ToolSideEffects, type ToolSuccess, type ToolWarning, type ToolWarningCode, type UpdateQuestlineInput, type UpdateRepeatableQuestInput, abandonQuest, abandonQuestAndSpawnFollowups, addQuestReward, addUnlock, archiveDeleteAndPruneSkill, archiveQuestline, archiveRepeatableQuest, arraySchema, booleanSchema, captureRumor, captureRumorTool, captureRumorToolHandler, captureRumorToolName, chooseWorkShapeSkill, claimQuestReward, clarifyAmbiguousRequestsSkill, closeWorkAndClaimOutcomesSkill, createConcreteQuestSkill, createQuest, createQuestline, createRepeatableQuest, defineQuestlogSkill, defineQuestlogTool, detachQuestFromQuestline, detectSlipsAndStalenessSkill, dismissRumor, enumSchema, escalateAndUnblockSkill, finishQuest, frameInitiativeQuestlineSkill, getQuestDetail, getQuestlineDetail, getQuestlogSkillByName, getQuestlogToolByName, getRumorDetail, getRumorOutputs, handleExceptionsAndWeirdCasesSkill, initQuestlogTables, inspectQuestlogItemTool, inspectQuestlogItemToolHandler, inspectQuestlogItemToolName, intakeTriageSkill, integerSchema, listActiveQuests, listAvailableQuests, listBlockedQuests, listDeferredQuests, listDueRepeatableQuestAnchors, listDueSoonQuests, listInProgressQuests, listMissedScheduledQuests, listOpenQuests, listOverdueQuests, listQuestlines, listQuestlogSkills, listQuestlogToolDefinitions, listResolvedQuests, listRumors, listScheduledForDay, listScheduledNow, literalSchema, logQuestEffort, maintainClearOwnershipSkill, manageApprovalsAndPromisesSkill, manageRepeatableTool, manageRepeatableToolHandler, manageRepeatableToolName, index$2 as markers, moveQuestToQuestline, numberSchema, objectSchema, oneOfSchema, organizeWorkTool, organizeWorkToolHandler, organizeWorkToolName, planQuestTime, planQuestTool, planQuestToolHandler, planQuestToolName, planSuccessorWorkSkill, planTimeCorrectlySkill, prioritizeAcrossStreamsSkill, protectCapacityAndFocusSkill, questlogSkills, questlogToolMappings, questlogTools, read, recoverFromModelingMistakesSkill, removeQuestReward, removeUnlock, reopenRumor, replaceQuestTags, replaceRepeatableQuestRewards, replaceRepeatableQuestTags, replaceUnlocks, reportStatusAndManageExpectationsSkill, retireWorkTool, retireWorkToolHandler, retireWorkToolName, reviewQuestlogTool, reviewQuestlogToolHandler, reviewQuestlogToolName, reviseOrReshapeCommitmentSkill, reviseQuestObjective, rewardWorkTool, rewardWorkToolHandler, rewardWorkToolName, runOperationalReviewSkill, runQuestTool, runQuestToolHandler, runQuestToolName, runRecurringRhythmsSkill, searchAndRetrieveContextSkill, searchQuestlogTool, searchQuestlogToolHandler, searchQuestlogToolName, sequenceWithUnlocksSkill, settleRumor, settleRumorIntoStructureSkill, shapeWorkTool, shapeWorkToolHandler, shapeWorkToolName, index$1 as skills, softDeleteQuest, softDeleteQuestline, softDeleteRepeatableQuest, softDeleteRumor, soul, spawnDueRepeatableQuests, startQuest, stringSchema, tagAndFilterPortfoliosSkill, tagQuest, tagWorkTool, tagWorkToolHandler, tagWorkToolName, toolFailure, toolNeedsClarification, toolNoOp, toolSuccess, toolWarning, index as tools, untagQuest, updateQuestReward, updateQuestline, updateRepeatableQuest, write };
+export { type AbandonQuestResult, type CaptureRumorInput, type CreateQuestInput, type CreateQuestlineInput, type CreateRepeatableQuestInput, type DueRepeatableAnchor, type FollowupQuestInput, type JsonSchema, type JsonSchemaType, type MarkerDefinition, type MarkerId, type PlanQuestTimeInput, type Quest, type QuestDetail, type QuestListFilters, type QuestReward, type QuestRewardInput, type QuestState, type QuestUnlock, type Questline, type QuestlineDetail, type QuestlogDb, type QuestlogSearchResult, type QuestlogSkill, type QuestlogSkillRegistry, type QuestlogSoul, type QuestlogSoulTrait, type QuestlogToolDefinition, type QuestlogToolMapping, type RepeatableQuest, type RepeatableQuestReward, type RepeatableQuestRewardInput, type Rumor, type RumorDetail, type RumorOutput, type RumorState, type SettleRumorInput, type SettleRumorResult, type Tag, type ToolClarificationCode, type ToolDefinitionRegistry, type ToolEntityKind, type ToolEntityRef, type ToolErrorCode, type ToolErrorKind, type ToolFailure, type ToolInputDescriptions, type ToolListItem, type ToolNeedsClarification, type ToolNextStepHint, type ToolNextStepHintKind, type ToolOutcomeKind, type ToolOutputDescription, type ToolResult, type ToolSideEffects, type ToolSuccess, type ToolWarning, type ToolWarningCode, type UpdateQuestlineInput, type UpdateRepeatableQuestInput, type UpdateRumorInput, abandonQuest, abandonQuestAndSpawnFollowups, addQuestReward, addUnlock, archiveDeleteAndPruneSkill, archiveQuestline, archiveRepeatableQuest, arraySchema, booleanSchema, captureRumor, captureRumorTool, captureRumorToolHandler, captureRumorToolName, chooseWorkShapeSkill, claimQuestReward, clarifyAmbiguousRequestsSkill, closeWorkAndClaimOutcomesSkill, createConcreteQuestSkill, createQuest, createQuestline, createRepeatableQuest, defineQuestlogSkill, defineQuestlogTool, detachQuestFromQuestline, detectSlipsAndStalenessSkill, dismissRumor, enumSchema, escalateAndUnblockSkill, finishQuest, frameInitiativeQuestlineSkill, getQuestDetail, getQuestlineDetail, getQuestlogSkillByName, getQuestlogToolByName, getRumorDetail, getRumorOutputs, handleExceptionsAndWeirdCasesSkill, initQuestlogTables, inspectQuestlogItemTool, inspectQuestlogItemToolHandler, inspectQuestlogItemToolName, intakeTriageSkill, integerSchema, listActiveQuests, listAvailableQuests, listBlockedQuests, listDeferredQuests, listDueRepeatableQuestAnchors, listDueSoonQuests, listInProgressQuests, listMissedScheduledQuests, listOpenQuests, listOverdueQuests, listQuestlines, listQuestlogSkills, listQuestlogToolDefinitions, listResolvedQuests, listRumors, listScheduledForDay, listScheduledNow, literalSchema, logQuestEffort, maintainClearOwnershipSkill, manageApprovalsAndPromisesSkill, manageRepeatableTool, manageRepeatableToolHandler, manageRepeatableToolName, index$2 as markers, moveQuestToQuestline, numberSchema, objectSchema, oneOfSchema, organizeWorkTool, organizeWorkToolHandler, organizeWorkToolName, planQuestTime, planQuestTool, planQuestToolHandler, planQuestToolName, planSuccessorWorkSkill, planTimeCorrectlySkill, prioritizeAcrossStreamsSkill, protectCapacityAndFocusSkill, questlogSkills, questlogToolMappings, questlogTools, read, recoverFromModelingMistakesSkill, removeQuestReward, removeUnlock, reopenRumor, replaceQuestTags, replaceRepeatableQuestRewards, replaceRepeatableQuestTags, replaceUnlocks, reportStatusAndManageExpectationsSkill, retireWorkTool, retireWorkToolHandler, retireWorkToolName, reviewQuestlogTool, reviewQuestlogToolHandler, reviewQuestlogToolName, reviseOrReshapeCommitmentSkill, reviseQuestObjective, rewardWorkTool, rewardWorkToolHandler, rewardWorkToolName, runOperationalReviewSkill, runQuestTool, runQuestToolHandler, runQuestToolName, runRecurringRhythmsSkill, searchAndRetrieveContextSkill, searchQuestlogTool, searchQuestlogToolHandler, searchQuestlogToolName, sequenceWithUnlocksSkill, settleRumor, settleRumorIntoStructureSkill, shapeWorkTool, shapeWorkToolHandler, shapeWorkToolName, index$1 as skills, softDeleteQuest, softDeleteQuestline, softDeleteRepeatableQuest, softDeleteRumor, soul, spawnDueRepeatableQuests, startQuest, stringSchema, tagAndFilterPortfoliosSkill, tagQuest, tagWorkTool, tagWorkToolHandler, tagWorkToolName, toolFailure, toolNeedsClarification, toolNoOp, toolSuccess, toolWarning, index as tools, untagQuest, updateQuestReward, updateQuestline, updateRepeatableQuest, updateRumor, write };

package/dist/index.js

@@ -2000,6 +2000,29 @@ function softDeleteRumor(db, rumorId, now) {
   ).run(deletedAt, deletedAt, rumorId);
 }
 
+// src/rumors/update_rumor.ts
+function updateRumor(db, rumorId, input) {
+  if (input.title == null && input.details == null) {
+    throw new Error("At least one of title or details must be provided to update a rumor.");
+  }
+  const current = getRumorOrThrow(db, rumorId);
+  if (current.settledAt != null) {
+    throw new Error(`Rumor ${rumorId} is already settled and cannot be updated.`);
+  }
+  if (current.dismissedAt != null) {
+    throw new Error(`Rumor ${rumorId} is dismissed and cannot be updated. Reopen it first.`);
+  }
+  const now = resolveNow(input.now);
+  const nextTitle = input.title != null ? assertNonEmpty(input.title, "Rumor title") : current.title;
+  const nextDetails = input.details != null ? input.details.trim() || null : current.details;
+  db.prepare(
+    `UPDATE rumors
+     SET title = ?, details = ?, updated_at = ?
+     WHERE id = ? AND deleted_at IS NULL`
+  ).run(nextTitle, nextDetails, now, rumorId);
+  return getRumorOrThrow(db, rumorId);
+}
+
 // src/search_questlog.ts
 function searchQuestlog(db, query) {
   const trimmed = query.trim();
@@ -5223,6 +5246,27 @@ function shapeWorkToolHandler(db, input) {
           }
         );
       }
+      case "update_rumor": {
+        updateRumor(db, input.rumorId, {
+          ...input.title != null && { title: input.title },
+          ...input.details != null && { details: input.details },
+          ...input.now != null && { now: input.now }
+        });
+        const detail = getRumorDetail(db, input.rumorId);
+        return toolSuccess(
+          `Updated rumor \`${detail.title}\`.`,
+          {
+            action: input.action,
+            primary: toRumorRef(detail),
+            updated: [toRumorRef(detail)],
+            rumor: detail
+          },
+          {
+            entities: [toRumorRef(detail)],
+            next: [inspectItemNext(toRumorRef(detail))]
+          }
+        );
+      }
     }
   } catch (error) {
     return translateToolError(error, {
@@ -5232,8 +5276,8 @@ function shapeWorkToolHandler(db, input) {
 }
 var shapeWorkTool = defineQuestlogTool({
   name: shapeWorkToolName,
-  description: "Shape real work structure by settling rumors, creating quests or questlines, and attaching or detaching quests from questlines.",
-  whenToUse: "Use this when deciding what real work exists and how it should be grouped before or around execution.",
+  description: "Create a quest (with timing, tags, and objective in one call), create a questline, settle a rumor into concrete work, or manage quest-questline membership. Use create_quest for clear commitments \u2014 include tags and timing directly to avoid follow-up calls.",
+  whenToUse: "Use this when deciding what real work exists and how it should be grouped before or around execution. Prefer a single create_quest call with all fields over separate create + plan_quest + tag_work calls.",
   whenNotToUse: "Do not use this for quest execution steps like starting, finishing, abandoning, or logging effort.",
   sideEffects: "writes_state",
   readOnly: false,
@@ -5242,14 +5286,16 @@ var shapeWorkTool = defineQuestlogTool({
   inputDescriptions: {
     action: "Which structure-shaping action to perform, such as settling a rumor, creating a quest, or attaching a quest to a questline.",
     rumorId: "The rumor to dismiss, reopen, or settle when the action targets intake.",
-    questline: "Questline creation data used when creating a questline directly or as part of rumor settlement.",
-    quests: "Concrete quest creation inputs used when settling a rumor into real work.",
+    questline: "Questline creation data used when creating a questline directly or as part of rumor settlement. Include description for context.",
+    quests: "Concrete quest creation inputs when settling a rumor into real work. Each quest supports the same fields as the quest property \u2014 include timing and tags directly.",
     settledAt: "Optional settlement timestamp for rumor settlement.",
-    quest: "Quest creation input used when directly creating one concrete quest.",
+    quest: "Quest creation input when directly creating one concrete quest. Include timing fields (dueAt, scheduledStartAt, etc.), tags, and rewards to create a fully specified quest in one call.",
     questId: "The concrete quest being attached to or detached from a questline.",
     questlineId: "The questline that should receive the quest for attach actions.",
     dismissedAt: "Optional dismissal timestamp for dismissing a rumor.",
-    now: "Optional timestamp for reopen or questline membership changes."
+    now: "Optional timestamp for reopen, questline membership, or rumor update.",
+    title: "New title for the update_rumor action.",
+    details: "New or enriched context for the update_rumor action. Append evidence as rumors accumulate information across conversations."
   },
   outputDescription: "Returns the changed or created rumor, quest, questline, or created quest set for the selected shape-work action, plus purpose-shaped primary and created or updated refs. Repeated safe actions return structured no-op results, and rumor settlement can ask for missing structure instead of failing.",
   inputSchema: objectSchema(
@@ -5261,20 +5307,40 @@ var shapeWorkTool = defineQuestlogTool({
         "detach_quest_from_questline",
         "dismiss_rumor",
         "reopen_rumor",
-        "settle_rumor"
+        "settle_rumor",
+        "update_rumor"
       ]),
       questId: integerSchema("Quest to attach or detach."),
       questlineId: integerSchema("Questline that should receive the quest."),
       quest: objectSchema(
         {
           title: stringSchema("Title for the new quest."),
-          objective: stringSchema("Objective for the new quest.")
+          objective: stringSchema("Objective for the new quest."),
+          questlineId: integerSchema("Optional questline to place the quest in."),
+          tags: arraySchema(stringSchema("Tag name."), "Optional tags to apply at creation."),
+          rewards: arraySchema(
+            objectSchema(
+              {
+                kind: stringSchema("Reward kind."),
+                name: stringSchema("Reward name.")
+              },
+              ["kind", "name"]
+            ),
+            "Optional rewards to attach at creation."
+          ),
+          dueAt: integerSchema("Optional latest acceptable completion timestamp."),
+          notBeforeAt: integerSchema("Optional earliest actionable timestamp."),
+          scheduledStartAt: integerSchema("Optional planned schedule window start."),
+          scheduledEndAt: integerSchema("Optional planned schedule window end."),
+          allDay: booleanSchema("Whether the scheduled window is all-day."),
+          estimateSeconds: integerSchema("Optional active-effort estimate in seconds.")
         },
         ["title", "objective"]
       ),
       questline: objectSchema(
         {
-          title: stringSchema("Questline title.")
+          title: stringSchema("Questline title."),
+          description: stringSchema("Optional questline description.")
         },
         []
       ),
@@ -5285,16 +5351,35 @@ var shapeWorkTool = defineQuestlogTool({
         objectSchema(
           {
             title: stringSchema("Title for a created quest."),
-            objective: stringSchema("Objective for a created quest.")
+            objective: stringSchema("Objective for a created quest."),
+            tags: arraySchema(stringSchema("Tag name."), "Optional tags to apply at creation."),
+            rewards: arraySchema(
+              objectSchema(
+                {
+                  kind: stringSchema("Reward kind."),
+                  name: stringSchema("Reward name.")
+                },
+                ["kind", "name"]
+              ),
+              "Optional rewards to attach at creation."
+            ),
+            dueAt: integerSchema("Optional latest acceptable completion timestamp."),
+            notBeforeAt: integerSchema("Optional earliest actionable timestamp."),
+            scheduledStartAt: integerSchema("Optional planned schedule window start."),
+            scheduledEndAt: integerSchema("Optional planned schedule window end."),
+            allDay: booleanSchema("Whether the scheduled window is all-day."),
+            estimateSeconds: integerSchema("Optional active-effort estimate in seconds.")
           },
           ["title", "objective"]
         ),
-        "Quests to create during rumor settlement."
+        "Quests to create during rumor settlement. Include timing and tags directly."
       ),
-      now: integerSchema("Optional timestamp for membership or reopen changes.")
+      now: integerSchema("Optional timestamp for membership, reopen, or rumor update."),
+      title: stringSchema("New title for the update_rumor action."),
+      details: stringSchema("New or enriched context text for the update_rumor action.")
     },
     ["action"],
-    "Shape the work graph by settling rumors, creating work, or moving quests into questlines."
+    "Create quests with timing and tags, create questlines, settle rumors into work, manage quest-questline membership, or enrich open rumors with new context."
   ),
   handler: shapeWorkToolHandler
 });
@@ -5672,7 +5757,8 @@ __export(write_exports, {
   untagQuest: () => untagQuest,
   updateQuestReward: () => updateQuestReward,
   updateQuestline: () => updateQuestline,
-  updateRepeatableQuest: () => updateRepeatableQuest
+  updateRepeatableQuest: () => updateRepeatableQuest,
+  updateRumor: () => updateRumor
 });
 
 export { initQuestlogTables, markers_exports as markers, read_exports as read, skills_exports as skills, soul_exports as soul, tools_exports as tools, write_exports as write };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ghostpaw/questlog",
-	"version": "0.3.0",
+	"version": "0.5.0",
 	"description": "Unified task and calendar model for Node.js — SQLite, zero dependencies, with a built-in LLM tool facade",
 	"type": "module",
 	"exports": {