@wirecat/cli-core 0.536.0 → 0.538.0

package/dist/entities/contact-context.d.ts

@@ -1,4 +1,26 @@
 import * as v from "valibot";
+export declare const contextMessage: v.StrictObjectSchema<{
+    readonly locator: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+    readonly provider: v.StringSchema<undefined>;
+    readonly account: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly chat_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly chat_title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly timestamp: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+    readonly sender_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+    readonly sender_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly outgoing: v.NullableSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly text: v.StringSchema<undefined>;
+}, undefined>;
+export declare const contextEvent: v.StrictObjectSchema<{
+    readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+    readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly starts_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+    readonly ends_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+    readonly all_day: v.BooleanSchema<undefined>;
+    readonly location: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly status: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
 export declare const contactMessages: v.StrictObjectSchema<{
     readonly person: v.StrictObjectSchema<{
         readonly uid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -1401,6 +1423,19 @@ export declare const contactContext: v.UnionSchema<[v.StrictObjectSchema<{
         readonly messages: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
     }, undefined>;
 }, undefined>], undefined>;
+export declare const meetingCue: v.StrictObjectSchema<{
+    readonly reference: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+    readonly fingerprint: v.StringSchema<undefined>;
+    readonly transcript_id: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly content_hash: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly position: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly start_ms: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly end_ms: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly speaker_participant_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+    readonly speaker_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly text: v.StringSchema<undefined>;
+    readonly revision: v.PicklistSchema<["current", "superseded"], undefined>;
+}, undefined>;
 export declare const contactPreparation: v.StrictObjectSchema<{
     readonly person: v.StrictObjectSchema<{
         readonly uid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;

package/dist/entities/contact-context.js

@@ -4,7 +4,7 @@ import { linkedPerson } from "./contact-activity.js";
 import { count, id, reference, text, time } from "./fields.js";
 import { message } from "./message.js";
 const contextPerson = v.strictObject({ ...linkedPerson.entries, provider: text, id });
-const contextMessage = v.strictObject({
+export const contextMessage = v.strictObject({
     locator: reference,
     provider: text,
     account: id,
@@ -25,7 +25,7 @@ const sharedChat = v.strictObject({
     kind: chat.entries.kind,
     last_message_at: v.nullable(time),
 });
-const contextEvent = v.strictObject({
+export const contextEvent = v.strictObject({
     ref: reference,
     title: v.nullable(text),
     starts_at: v.nullable(time),
@@ -124,7 +124,7 @@ const coverage = v.strictObject({
     has_more: v.boolean(),
     cut_by: v.nullable(v.picklist(["limit", "bytes"])),
 });
-const meetingCue = v.strictObject({
+export const meetingCue = v.strictObject({
     reference,
     fingerprint: text,
     transcript_id: count,

package/dist/errors/reasons.d.ts

@@ -7,7 +7,7 @@ export declare const REASONS: ErrorReason[];
  * Detail keys an error from this package may carry, until each is registered on its own reason. Not `cause`:
  * that can hold a provider's or SQLite's raw text.
  */
-export declare const DETAILS: readonly ["contracts", "calendars", "allowed", "alternative", "arguments", "at", "available", "batch", "budget", "built", "candidates", "chat", "chat_id", "cli", "complete", "emitted_bytes", "exact", "forum", "guide", "hint", "id", "index", "kind", "limit", "limit_source", "max_bytes", "model", "name", "operation_id", "operation_ids", "text_limit", "store_refused_in", "partial_output", "path", "permission", "person_ids", "previous_chat_id", "profiles", "provider_error", "provider", "recovery", "reference", "remembered", "retry_at", "retry_after_ms", "runtime", "saved", "scheduled_for", "script", "sent", "sent_count", "settlement_failed", "span", "sqlite", "stage", "standing", "state", "stderr", "term", "total", "upgraded", "wanted"];
+export declare const DETAILS: readonly ["contracts", "calendars", "allowed", "alternative", "arguments", "at", "available", "batch", "budget", "built", "candidates", "chat", "chat_id", "cli", "complete", "emitted_bytes", "exact", "forum", "guide", "hint", "id", "index", "kind", "limit", "limit_source", "max_bytes", "model", "name", "operation_id", "operation_ids", "text_limit", "store_refused_in", "subtasks", "partial_output", "parent", "path", "permission", "person_ids", "previous_chat_id", "profiles", "provider_error", "provider", "recovery", "reference", "remembered", "retry_at", "retry_after_ms", "runtime", "saved", "scheduled_for", "script", "sent", "sent_count", "settlement_failed", "span", "sqlite", "stage", "standing", "state", "stderr", "term", "total", "upgraded", "wanted"];
 /** What a CLI adds to the shared registry: its own reasons, and the detail keys its adapters raise. */
 export interface AppErrors {
     reasons?: readonly ErrorReason[];

package/dist/errors/reasons.js

@@ -65,6 +65,9 @@ const OTHERS = [
     ["calendar.read-only", "permission_error", "the calendar takes no new events from this account"],
     ["calendar.unsynced", "not_found", "the calendar account has no synced calendar in the store"],
     ["calendar.sync-incomplete", "not_found", "a synced calendar's sync never finished or is mid-round"],
+    ["calendar.no-upcoming", "not_found", "no upcoming meeting with other attendees is stored for this account"],
+    ["chat.not-read", "not_found", "a chat shared with this person is not held whole in the store"],
+    ["meetings.index-pending", "not_found", "some stored meetings are not indexed by person yet"],
     ["profile.locked", "permission_error", "a profile lock pins this process to its own account"],
     ["busy.offline", "permission_error", "calendars busy asks the provider; --offline was given"],
     validation("busy.no-calendars", "no calendar syncs and no person was named, so there is nobody to ask"),
@@ -134,6 +137,7 @@ const OTHERS = [
     validation("task.column", "the task beside which it moves is in another column than the status asked for"),
     validation("task.dependency-cycle", "the task would depend on itself"),
     validation("task.has-subtasks", "the task has subtasks; move or detach them before it moves to another project"),
+    validation("task.is-subtask", "a subtask moves to another project only when it is detached from its parent in the same write"),
     validation("task.duplicate-candidates", "open tasks may be the same job: attach to one, or add it as new"),
     validation("task.certainty-required", "an agent closes a task with its certainty, 0 to 1"),
     ["task.pair-decided", "permission_error", "the owner already decided the pair; an agent does not change it"],
@@ -210,7 +214,9 @@ export const DETAILS = [
     "operation_ids",
     "text_limit",
     "store_refused_in",
+    "subtasks",
     "partial_output",
+    "parent",
     "path",
     "permission",
     "person_ids",

package/dist/mail/server-search.js

@@ -9,7 +9,8 @@ import { factsOf } from "./facts.js";
 import { mailHeadersOf } from "./headers.js";
 import { parseMail } from "./parse.js";
 import { storedMailRules } from "./rule-stored.js";
-import { decide } from "./rules.js";
+import { ruleTagger, settleRuleTags } from "./rule-tags.js";
+import { decide, tagsOf } from "./rules.js";
 import { mailCriteriaOf } from "./server-query.js";
 const refusal = {
     unsupported: "this mailbox's server cannot be searched — use --backend archive",
@@ -74,6 +75,8 @@ export const searchMailServer = async (store, mailbox, access, request) => {
     };
     const accountId = await store.accounts.saveAccount(mailbox, { name: mailbox.account });
     const fresh = [];
+    let rules = [];
+    const ruled = new Map();
     let raws;
     let opening;
     let openFailure;
@@ -124,7 +127,7 @@ export const searchMailServer = async (store, mailbox, access, request) => {
         if (!open)
             return;
         const unique = [...new Map(listed.map((item) => [item.messageId, item])).values()];
-        const rules = await storedMailRules(store, { address: mailbox.account });
+        rules = await storedMailRules(store, { address: mailbox.account });
         const facts = factsOf(unique, rules);
         for (const item of unique) {
             const held = (await store.mail.email(accountId, item.messageId)) !== null;
@@ -133,8 +136,10 @@ export const searchMailServer = async (store, mailbox, access, request) => {
                 continue;
             report.returned += 1;
             sources.set(sourceKey(item.threadId, item.messageId), held ? "both" : "server");
-            if (!held)
-                fresh.push(item);
+            if (held)
+                continue;
+            fresh.push(item);
+            ruled.set(item, { ruleId: rule?.id ?? null, tags: tagsOf(rules, facts(item)) });
         }
         if (fresh.length)
             raws = await source.fetchRaw(fresh);
@@ -175,6 +180,7 @@ export const searchMailServer = async (store, mailbox, access, request) => {
     }
     const now = Date.now();
     const inputs = [];
+    const saved = [];
     for (const [index, item] of fresh.entries()) {
         const raw = raws?.[index];
         try {
@@ -201,10 +207,12 @@ export const searchMailServer = async (store, mailbox, access, request) => {
                             : { locations: [{ folder, uidvalidity: validity, uid: Number(item.uid) }] }),
                         ...(item.seen === undefined ? {} : { read: item.seen }),
                         ...(item.flagged === undefined ? {} : { flagged: item.flagged }),
+                        mailRuleId: ruled.get(item)?.ruleId ?? null,
                         attachments: files,
                     },
                 ],
             });
+            saved.push(item);
         }
         catch {
             sources.delete(sourceKey(item.threadId, item.messageId));
@@ -213,6 +221,14 @@ export const searchMailServer = async (store, mailbox, access, request) => {
     }
     if (inputs.length)
         await store.mail.saveThreads(inputs);
+    // Sync never reads mail whose place it knows again, so a rule's tags go on here or never.
+    const tagger = ruleTagger(store, mailbox);
+    for (const item of saved) {
+        const tags = ruled.get(item)?.tags ?? [];
+        if (tags.length)
+            await tagger.tag({ type: "message", chatId: item.threadId, messageId: item.messageId }, tags);
+    }
+    await settleRuleTags(store, accountId, rules, tagger.outcome());
     report.new = inputs.length;
     report.returned = sources.size;
     return { report, sources };

package/dist/meetings/mcp/index.d.ts

@@ -38,7 +38,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -54,11 +53,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -76,11 +75,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -102,6 +101,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -188,7 +188,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -204,11 +203,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -226,11 +225,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -252,6 +251,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -338,7 +338,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -354,11 +353,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -376,11 +375,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -402,6 +401,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -488,7 +488,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -504,11 +503,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -526,11 +525,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -552,6 +551,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -638,7 +638,6 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -654,11 +653,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -676,11 +675,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
-            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -702,6 +701,7 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
+            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;

package/dist/oauth/index.d.ts

@@ -1,5 +1,5 @@
 export { type Authorization, type AuthorizeOptions, authorize } from "./authorize.js";
-export { type SignInOptions, type TokenKeeper, type TokenKeeperOptions, tokenKeeper } from "./keeper.js";
+export { type SignInOptions, type TokenKeeper, type TokenKeeperOptions, type TokensOptions, tokenKeeper, } from "./keeper.js";
 export type { ExchangeContext, OAuthClient, OAuthProvider, RequestContext, TokenSet } from "./provider.js";
 export { requestTokens, revokeToken, TOKEN_LOG_ALLOW, TOKEN_LOG_EVENT } from "./requests.js";
 export { type CredentialStorageOptions, credentialStorage, driveSessionCodec, type EncodeInput, oauthAccount, type StoredTokens, standardCodec, type TokenCodec, type TokenStorage, zoomTokenCodec, } from "./storage.js";

package/dist/oauth/index.js

@@ -1,4 +1,4 @@
 export { authorize } from "./authorize.js";
-export { tokenKeeper } from "./keeper.js";
+export { tokenKeeper, } from "./keeper.js";
 export { requestTokens, revokeToken, TOKEN_LOG_ALLOW, TOKEN_LOG_EVENT } from "./requests.js";
 export { credentialStorage, driveSessionCodec, oauthAccount, standardCodec, zoomTokenCodec, } from "./storage.js";

package/dist/oauth/keeper.d.ts

@@ -23,9 +23,16 @@ export type SignInOptions = Omit<AuthorizeOptions, "provider" | "signal"> & {
     /** Runs before anything is saved; it may refuse the account or add fields to the entry (drive's `principal`). */
     accept?: (tokens: TokenSet) => Promise<Record<string, unknown> | undefined> | Record<string, unknown> | undefined;
 };
+export interface TokensOptions {
+    /**
+     * The server refused the access token this keeper last answered, though `expiresAt` called it fresh (a revoked
+     * session): refresh under the lock anyway, unless another process already saved a different fresh one.
+     */
+    refresh?: boolean;
+}
 export interface TokenKeeper {
-    accessToken(): Promise<string>;
-    tokens(): Promise<TokenSet>;
+    accessToken(options?: TokensOptions): Promise<string>;
+    tokens(options?: TokensOptions): Promise<TokenSet>;
     signIn(options: SignInOptions): Promise<{
         scopes: string[];
     }>;

package/dist/oauth/keeper.js

@@ -87,25 +87,39 @@ export const tokenKeeper = (options) => {
         return kept && fresh(kept) && kept.refreshToken === saved.refreshToken ? kept : undefined;
     };
     const forget = () => refreshedInMemory.delete(lockPath);
-    const tokens = async () => {
+    let answered;
+    const answer = (given) => {
+        answered = given;
+        return given;
+    };
+    const tokens = async ({ refresh = false } = {}) => {
         const seen = storage.read();
         if (!seen)
             throw notSignedIn();
-        if (fresh(seen.tokens))
-            return seen.tokens;
-        const kept = remembered(seen.tokens);
-        if (kept)
-            return kept;
-        return shared(async () => {
+        if (!refresh) {
+            const kept = remembered(seen.tokens);
+            if (kept)
+                return answer(kept);
+            if (fresh(seen.tokens))
+                return answer(seen.tokens);
+        }
+        const refused = answered ?? remembered(seen.tokens) ?? seen.tokens;
+        return answer(await shared(async () => {
             const current = storage.read();
             if (!current)
                 throw notSignedIn();
+            const latest = remembered(current.tokens) ?? current.tokens;
             // Another process refreshed while this one waited for the lock: its result is the one to use.
-            if (fresh(current.tokens) || current.tokens.refreshToken !== seen.tokens.refreshToken)
-                return current.tokens;
-            const keptMeanwhile = remembered(current.tokens);
-            if (keptMeanwhile)
-                return keptMeanwhile;
+            if (refresh) {
+                if (latest.accessToken !== refused.accessToken && fresh(latest))
+                    return latest;
+            }
+            else {
+                if (latest !== current.tokens)
+                    return latest;
+                if (fresh(current.tokens) || current.tokens.refreshToken !== seen.tokens.refreshToken)
+                    return current.tokens;
+            }
             const client = clientOf(current);
             const refreshed = await exchange({ grant_type: "refresh_token", refresh_token: current.tokens.refreshToken }, context(client, current.tokens));
             // A rotated refresh token is saved even so: kept only in memory, it would die with the process.
@@ -114,12 +128,12 @@ export const tokenKeeper = (options) => {
             else
                 storage.write({ tokens: refreshed, client });
             return refreshed;
-        });
+        }));
     };
     return {
         tokens,
-        accessToken: async () => {
-            const current = await tokens();
+        accessToken: async (tokensOptions) => {
+            const current = await tokens(tokensOptions);
             if (!current.accessToken)
                 throw notSignedIn();
             return current.accessToken;

package/dist/services/person-context.d.ts

@@ -93,7 +93,12 @@ export declare const readsOf: (record: PersonRecord, asked: AccountKey) => {
  * What the store knows about one person, across every identity linked to them. Reads the store
  * only: nothing is fetched, nothing marked read. Identity is by id, never by name.
  */
-export declare const personContext: (store: MessageStore, asked: AccountKey, reference: string, { messages, bytes, since, now }?: ContextOptions) => Promise<PersonContext>;
+export declare const personContext: (store: MessageStore, asked: AccountKey, reference: string, options?: ContextOptions) => Promise<PersonContext>;
+/** `personContext` of a person already found, read in the identities and accounts `reads` names. */
+export declare const recordContext: (store: MessageStore, record: PersonRecord, reads: {
+    key: AccountKey;
+    identity: LinkedIdentity;
+}[], { messages, bytes, since, now }?: ContextOptions) => Promise<Omit<PersonContext, "person">>;
 /** `max:Ana` names a person in another messenger of this store; a reference with no prefix, this one. */
 export declare const identityIn: (store: MessageStore, asked: AccountKey, reference: string) => Promise<IdentityRef>;
 export declare const CHAT_MESSAGES = 20;

package/dist/services/person-context.js

@@ -92,11 +92,18 @@ export const readsOf = (record, asked) => record.identities.flatMap((identity) =
  * What the store knows about one person, across every identity linked to them. Reads the store
  * only: nothing is fetched, nothing marked read. Identity is by id, never by name.
  */
-export const personContext = async (store, asked, reference, { messages = CONTEXT_MESSAGES, bytes = CONTEXT_BYTES, since, now = Date.now() } = {}) => {
+export const personContext = async (store, asked, reference, options = {}) => {
     const found = pickPerson(reference, await store.people.people(asked.provider, { account: asked.account }));
     const record = await store.people.personOf({ provider: asked.provider, id: found.id });
     if (!record)
         throw new CliError("not_found", `no person ${found.id} in the store`);
+    return {
+        person: { ...record, provider: asked.provider, id: found.id },
+        ...(await recordContext(store, record, readsOf(record, asked), options)),
+    };
+};
+/** `personContext` of a person already found, read in the identities and accounts `reads` names. */
+export const recordContext = async (store, record, reads, { messages = CONTEXT_MESSAGES, bytes = CONTEXT_BYTES, since, now = Date.now() } = {}) => {
     const recent = (message) => since === undefined || Date.parse(message.timestamp) >= since;
     const shared = [];
     const notRead = [];
@@ -106,7 +113,7 @@ export const personContext = async (store, asked, reference, { messages = CONTEX
     const theirs = [];
     const mentions = [];
     let cut = false;
-    for (const { key, identity } of readsOf(record, asked)) {
+    for (const { key, identity } of reads) {
         const chats = await store.chats.chatsWith(key, identity.id);
         for (const chat of chats) {
             shared.push({ ...key, chatId: chat.id, title: chat.title, kind: chat.kind, lastMessageAt: chat.lastMessageAt });
@@ -177,7 +184,6 @@ export const personContext = async (store, asked, reference, { messages = CONTEX
     cut ||= direct.length > messages || groups.length > messages || mentions.length > messages;
     const kept = withinBytes(lists, bytes);
     return {
-        person: { ...record, provider: asked.provider, id: found.id },
         shared: shared.sort((a, b) => Date.parse(b.lastMessageAt ?? "") - Date.parse(a.lastMessageAt ?? "")),
         last: {
             fromThem: each.find((message) => !message.outgoing) ?? null,

package/dist/store/sqlite/evidence-findings.js

@@ -165,7 +165,9 @@ export const evidenceFindingsStoreOver = (context) => {
             }
             const input = proposal.payload;
             // Rejecting creates nothing, so a batch whose evidence changed can still be closed. Accepting needs only the
-            // accepted findings' own project, assignee and evidence unchanged; a batch staged before parts were kept needs all.
+            // accepted findings' own evidence and assignee unchanged. The project is left out: every task a sibling batch
+            // creates moves its row, and the project still has to exist, which citing checks. A batch staged before parts
+            // were kept needs all.
             if (accepted.length) {
                 const parts = input.snapshotParts;
                 if (!parts) {
@@ -175,7 +177,7 @@ export const evidenceFindingsStoreOver = (context) => {
                 else {
                     const chosen = { ...batch.input, findings: batch.input.findings.filter((f) => accepted.includes(f.id)) };
                     const now = core.snapshotParts(chosen, cite());
-                    if (Object.entries(now).some(([key, hash]) => parts[key] !== hash))
+                    if (Object.entries(now).some(([key, hash]) => !key.startsWith("project:") && parts[key] !== hash))
                         return stale();
                 }
             }

package/dist/store/sqlite/task-board.js

@@ -27,6 +27,7 @@ export const PROJECT_TASK_FIELDS = [
         relation: "low, medium, high, critical or none; a range of labels or of the 0–1 number: priority:[high TO critical]",
     }),
     field("agent", "kw", "agent:hermes", { relation: "the agent working on it, by name; none or any" }),
+    field("parent", "kw", "parent:HRB-1", { relation: "the subtasks of a task, by its key; none or any" }),
     field("due", "time", "due:[today TO 2026-12-31]", {
         relation: "the due date; today, tomorrow and yesterday are your calendar days; NOT due:* has none",
     }),
@@ -134,6 +135,20 @@ const agentWhere = (node) => {
         ? { sql: "lower(t.agent) GLOB ?", params: [value] }
         : { sql: "lower(t.agent) = ?", params: [value] };
 };
+/** A key the task had before it moved to another project still names it. */
+const parentWhere = (node) => {
+    const value = node.value.trim();
+    if (value.toLowerCase() === "none")
+        return { sql: "t.parent_id IS NULL", params: [] };
+    if (value.toLowerCase() === "any")
+        return { sql: "t.parent_id IS NOT NULL", params: [] };
+    const key = value.replace(/^task:/, "");
+    return {
+        sql: "t.parent_id IN (SELECT id FROM tasks WHERE key = ? OR package_id = ? UNION SELECT task_id FROM task_events " +
+            "WHERE kind = 'project' AND json_extract(changes, '$.key[0]') = ?)",
+        params: [key.toUpperCase(), key, key.toUpperCase()],
+    };
+};
 const truth = (node, sql) => ({
     sql: node.value.toLowerCase() === "true" ? sql : `NOT (${sql})`,
     params: [],
@@ -166,6 +181,7 @@ export const projectTaskColumns = (now, zone) => ({
     assignee: { where: assigneeWhere },
     priority: { where: priorityWhere },
     agent: { where: agentWhere },
+    parent: { where: parentWhere },
     due: { type: "time", sql: "t.due_at" },
     closed: { type: "time", sql: "t.closed_at" },
     overdue: { where: (node) => truth(node, dueGroups(now, zone).overdue) },

package/dist/store/sqlite/work-tasks.d.ts

@@ -31,7 +31,10 @@ export interface TaskFields {
     reason?: string | null;
     /** A name the caller checked against its category list; every change is a `category` event. */
     category?: string;
-    /** Another owner project, by key or `project:<id>`: the task takes the next key there; its old key still finds it. */
+    /**
+     * Another owner project, by key or `project:<id>`: the task takes the next key there; its old key still finds it.
+     * A subtask moves only with `parent: null` in the same edit.
+     */
     project?: string;
     /** A project task's kind, bug, feature or chore. */
     type?: WorkTaskType;

package/dist/store/sqlite/work-tasks.js

@@ -170,7 +170,7 @@ export const workTaskOperationsOver = (context) => {
     const details = (id) => detailsOf(rowById(id));
     const onBoard = (task) => Boolean(database.prepare(`SELECT 1 FROM tasks t WHERE t.id = ? AND ${BOARD_SCOPE}`).get(task));
     /** The task takes the target's next number and key; the source's counter never goes back, so its old key stays unique. */
-    const moveToProject = (task, before, target, actor, at) => {
+    const moveToProject = (task, before, target, actor, at, detach) => {
         if (target === Number(before.project_id))
             return;
         if (!onBoard(task))
@@ -178,6 +178,10 @@ export const workTaskOperationsOver = (context) => {
         const targetRow = database.prepare("SELECT key FROM projects WHERE id = ?").get(target);
         if (String(targetRow.key).length === INBOX_KEY_LENGTH)
             throw new CliError("validation_error", "a task moves only into one of your projects");
+        if (before.parent_id != null && !detach) {
+            const parent = taskIdOf(database, Number(before.parent_id));
+            throw new CliError("validation_error", `${String(before.key)} is a subtask of ${parent}; detach it in the same write (parent none) to move it alone`, { reason: "task.is-subtask", parent });
+        }
         const children = database
             .prepare("SELECT key FROM tasks WHERE parent_id = ? AND deleted_at IS NULL ORDER BY id")
             .all(task)
@@ -280,7 +284,7 @@ export const workTaskOperationsOver = (context) => {
             bump = true;
         }
         if (fields.project !== undefined)
-            moveToProject(task, before, projectOf(fields.project), actor, at);
+            moveToProject(task, before, projectOf(fields.project), actor, at, fields.parent === null);
         if (set.length === 0) {
             if (bump)
                 database.prepare("UPDATE tasks SET revision = revision + 1 WHERE id = ?").run(task);