@pome-sh/checks 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @pome-sh/checks
 
+## 0.3.1 — 2026-08-18
+
+**`slackSeedSchema` accepts a `files` key** (F-1509). This package re-exports
+twin-slack's seed schema (`slackSeedSchema` / `parseSlackSeed` /
+`defaultSlackSeed`), and that schema gained
+`files: [{id?, name, title?, filetype?, user?, channels?, content?}]` so a Slack
+world can be seeded with files rather than only acquiring them through a
+`files.upload` mutation.
+
+**No check changed.** `SLACK_CHECKS` is the same tuple, every compiled pattern is
+byte-identical, and `checksDigest` does not move — so a cloud pin does NOT have to
+catch up for this release, unlike 0.3.0 above. The seed schema is a separate export
+from the check vocabulary and only the former widened.
+
+**Patch, not minor.** `files` defaults to `[]`, so every seed that parsed before
+parses to the same value, and no consumer must act. It is a widening of an INPUT
+schema, which is the direction that cannot break a caller.
+
 ## 0.3.0 — 2026-08-14
 
 **`` `add_issue_comment` was called `` binds, and the github tape slot widens

package/dist/_types/twin-slack/src/seed.d.ts

@@ -35,6 +35,15 @@ export declare const seedSchema: z.ZodObject<{
             }, z.core.$strip>>>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>>;
+    files: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        filetype: z.ZodDefault<z.ZodString>;
+        user: z.ZodOptional<z.ZodString>;
+        channels: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        content: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     emoji: z.ZodDefault<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         url: z.ZodOptional<z.ZodString>;

package/dist/_types/twin-slack/src/types.d.ts

@@ -44,10 +44,40 @@ export type SeedEmoji = {
     /** Alias target name → stored as `alias:<name>`. */
     alias?: string;
 };
+/**
+ * A file present in the world before the agent touches it (F-1509).
+ *
+ * Until this existed the `files` table had exactly ONE writer — `filesUpload`,
+ * a mutation — so every read of `files.list` / `files.info` against a freshly
+ * seeded world answered on an empty table. That is not a serializer gap and it
+ * was not a deliberate ruling; it is simply a hole in the seed vocabulary, and
+ * it made `files.list` a surface no read-only comparison could measure.
+ *
+ * `user` and `channels` carry SEED HANDLES (a user `name` / channel `name`), the
+ * same currency `SeedMessage.user` and `SeedChannel.members` use, so a seed never
+ * has to know a minted id. Both also accept an explicit id.
+ */
+export type SeedFile = {
+    /** Explicit stable id (`F…`). Minted from the workspace counter when absent. */
+    id?: string;
+    /** Filename, e.g. `runbook.md`. */
+    name: string;
+    /** Display title. Defaults to `name`, matching `files.upload`. */
+    title?: string;
+    /** Slack filetype (`text`, `markdown`, `javascript`, …). Drives `mimetype`. */
+    filetype?: string;
+    /** Uploader — a seed user handle or id. Defaults to the seed's agent user. */
+    user?: string;
+    /** Channels the file is shared into — seed channel handles or ids. */
+    channels?: string[];
+    /** File body. `size` is derived from it, as `files.upload` derives it. */
+    content?: string;
+};
 export type SlackStateSeed = {
     team?: SeedTeam;
     users?: SeedUser[];
     channels?: SeedChannel[];
+    files?: SeedFile[];
     emoji?: SeedEmoji[];
 };
 export type WorkspaceRow = {

package/dist/{chunk-MJOHK2NI.js → chunk-ZXS3NTSQ.js}

@@ -380,6 +380,18 @@ var seedSchema = z.object({
       reactions: z.array(z.object({ name: z.string(), user: z.string() })).default([])
     })).default([])
   })).default([]),
+  // F-1509. Files present in the world before the agent runs. `user` and
+  // `channels` are seed HANDLES (a user/channel `name`) or ids — the same
+  // currency `channels[].members` and `channels[].messages[].user` already use.
+  files: z.array(z.object({
+    id: z.string().regex(/^F[A-Z0-9_]+$/).optional(),
+    name: z.string().min(1),
+    title: z.string().optional(),
+    filetype: z.string().min(1).default("text"),
+    user: z.string().optional(),
+    channels: z.array(z.string()).default([]),
+    content: z.string().optional()
+  })).default([]),
   emoji: z.array(z.object({
     name: z.string().regex(/^[a-z0-9_+-]{1,100}$/),
     url: z.string().url().optional(),

package/dist/index.js

@@ -5,8 +5,8 @@ import { GMAIL_CHECKS } from './chunk-KTTJCEDH.js';
 export { GMAIL_CHECKS, defaultSeedState as defaultGmailSeed, gmailSeedSchema, parseSeed as parseGmailSeed } from './chunk-KTTJCEDH.js';
 import { LINEAR_CHECKS } from './chunk-THOSO63W.js';
 export { LINEAR_CHECKS, defaultSeedState as defaultLinearSeed, linearSeedSchema, parseSeed as parseLinearSeed } from './chunk-THOSO63W.js';
-import { SLACK_CHECKS } from './chunk-MJOHK2NI.js';
-export { SLACK_CHECKS, defaultSeedState as defaultSlackSeed, parseSeed as parseSlackSeed, seedSchema as slackSeedSchema } from './chunk-MJOHK2NI.js';
+import { SLACK_CHECKS } from './chunk-ZXS3NTSQ.js';
+export { SLACK_CHECKS, defaultSeedState as defaultSlackSeed, parseSeed as parseSlackSeed, seedSchema as slackSeedSchema } from './chunk-ZXS3NTSQ.js';
 import { STRIPE_CHECKS } from './chunk-XOUAZPNB.js';
 export { STRIPE_CHECKS, defaultSeed as defaultStripeSeed, parseSeed as parseStripeSeed, seedSchema as stripeSeedSchema } from './chunk-XOUAZPNB.js';
 export { REDACTION_PLACEHOLDER, VACUITY_SENTINEL, VACUITY_SENTINEL_NUMBER, VACUITY_SENTINEL_SNAKE, checkNearMissPattern, checkPattern, checksDigest, childStatePath, defineCheck, isRedacted, oneOf, parseCheck, probeDiscrimination, probeRedactionSurvival, probeStateCitation, renderCheck, repoRef, resolveStatePath, statePath, templateSlots } from './chunk-W2JNYULF.js';

package/dist/slack.js

@@ -1,2 +1,2 @@
-export { SLACK_CHECKS, defaultSeedState, parseSeed, seedSchema } from './chunk-MJOHK2NI.js';
+export { SLACK_CHECKS, defaultSeedState, parseSeed, seedSchema } from './chunk-ZXS3NTSQ.js';
 import './chunk-W2JNYULF.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pome-sh/checks",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Pome's grading vocabulary — the check declarations, seed schemas and default seeds of all five digital twins, plus the check DSL they are written in. Declarations only: no twin server, no database, no routes, no tools.",
   "private": false,
   "type": "module",