fluncle 0.265.0 → 0.267.0

package/bin/fluncle.mjs

@@ -386,12 +386,16 @@ __export(exports_env, {
   loadEnv: () => loadEnv,
   readOptionalEnv: () => readOptionalEnv
 });
+import { execFileSync } from "node:child_process";
 import { homedir } from "node:os";
 import { join } from "node:path";
 function loadEnv(keys) {
   loadConfig();
   const result = {};
   const missing = [];
+  if (keys.includes("FLUNCLE_API_TOKEN")) {
+    resolveTokenRef();
+  }
   for (const key of keys) {
     const value = process.env[key];
     if (value === undefined) {
@@ -413,6 +417,21 @@ function getApiBaseUrl() {
   loadConfig();
   return (process.env.FLUNCLE_API_BASE_URL ?? "https://www.fluncle.com").replace(/\/+$/, "");
 }
+function resolveTokenRef() {
+  const ref = process.env.FLUNCLE_API_TOKEN_REF;
+  if (process.env.FLUNCLE_API_TOKEN !== undefined || !ref || false) {
+    return;
+  }
+  try {
+    const secretRef = ref.startsWith("op://") ? ref : `op://${ref}`;
+    process.env.FLUNCLE_API_TOKEN = execFileSync("op", ["read", "--no-newline", secretRef], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+  } catch {
+    throw new Error(`Could not read FLUNCLE_API_TOKEN_REF (${ref}) with op.`);
+  }
+}
 function loadConfig() {
   const profile = getEnvProfile();
   if (loadedProfile === profile) {
@@ -632,7 +651,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.265.0".trim() ? "0.265.0".trim() : "0.1.0";
+  currentVersion = "0.267.0".trim() ? "0.267.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2345,7 +2364,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.265.0".trim() ? "0.265.0".trim() : "0.1.0";
+  currentVersion2 = "0.267.0".trim() ? "0.267.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3725,13 +3744,15 @@ var init_src = __esm(() => {
     },
     {
       command: "fluncle admin labels list --seed-state undecided",
-      exposedContent: ["read the undecided crawl-seed pile and report whether a triage round is due"],
+      exposedContent: [
+        "read the undecided crawl-seed pile and, once a round is due, research it into proposals"
+      ],
       kind: "cron",
       name: "cron.label-triage",
-      operatorNotes: "daily. A PURE trigger — zero model tokens, one countless admin read and a sort. Fires only when 40+ NEVER-LOOKED labels have accumulated; stale ones ride along but never trigger a round. It cannot rule: recording a finding is record_label_triage (agent tier) and ruling is update_label (operator tier), which 403s the box token. The batched research leg is deliberately unwired until the gate proves it reports honestly. Source: docs/agents/hermes/scripts/{label-triage-sweep.ts,label-triage-sweep.sh}.",
+      operatorNotes: "daily. The gate is one countless admin read and a sort; it fires only when 40+ NEVER-LOOKED labels with a MusicBrainz identity and no artist rules have accumulated, and stale ones ride along. A fired round runs one claude -p per batch of 10 labels (capped at 3 batches and 30 labels) whose only fetcher is `fluncle admin labels evidence`; the model holds no Fluncle token, and the script records each verdict with record_label_triage (agent tier). It cannot rule: update_label is operator tier and 403s the box token. Labels a round left unfinished (a failed batch, or past the cap) are carried and fire the next day. The model runs --restricted with dontAsk permissions, confined to its batch directory and the skill. A fired round that records zero proposals, or any failed batch, exits non-zero, reads failed on /status and posts to Discord. Source: docs/agents/hermes/scripts/{label-triage-sweep.ts,label-triage-sweep.sh}.",
       probeConfig: { cadenceMs: 24 * 60 * MINUTE_MS, cronName: "fluncle-label-triage", kind: "cron" },
-      statusDescription: "reports when the label pile needs a round",
-      title: "Label triage gate",
+      statusDescription: "researches the label pile when it needs a round",
+      title: "Label triage",
       weights: { status: "hidden" }
     },
     {
@@ -11190,7 +11211,7 @@ var init_admin_albums = __esm(() => {
 });
 
 // ../../packages/contracts/src/orpc/admin-artifacts.ts
-var ARTIFACT_CHANGE_API_MAX_LIMIT = 500, ARTIFACT_SNAPSHOT_API_MAX_LIMIT = 200, ARTIFACT_COMPACTION_API_MAX_LIMIT = 1000, ARTIFACT_SUPPORTED_CONTRACTS, ArtifactStreamSchema, ArtifactContractSchema, ConsumerIdSchema, DigestSchema, SequenceSchema, ArtifactRebuildCheckpointSchema, ArtifactConsumerStatusSchema, ArtifactChangeEventSchema, ArtifactSnapshotItemSchema, ArtifactSnapshotPageSchema, ArtifactChangePageSchema, ArtifactCompactionResultSchema, registerArtifactConsumer, getArtifactConsumer, listArtifactSnapshot, checkpointArtifactRebuild, activateArtifactConsumer, listArtifactChanges, acknowledgeArtifactChanges, inactivateArtifactConsumer, compactArtifactChanges, adminArtifactsContract;
+var ARTIFACT_CHANGE_API_MAX_LIMIT = 500, ARTIFACT_SNAPSHOT_API_MAX_LIMIT = 200, ARTIFACT_COMPACTION_API_MAX_LIMIT = 1000, ARTIFACT_SUPPORTED_CONTRACTS, ArtifactStreamSchema, ArtifactContractSchema, ConsumerIdSchema, DigestSchema, SequenceSchema, ArtifactRebuildCheckpointSchema, ArtifactConsumerStatusSchema, ArtifactChangeEventSchema, ArtifactSnapshotItemSchema, ArtifactSnapshotPageSchema, ArtifactChangePageSchema, ArtifactCompactionResultSchema, SonarSourceAfterSchema, SonarSourceLimitSchema, SonarSourceIdsSchema, listSonarTrackDigests, listSonarTracks, listSonarCentroidDigests, listSonarCentroids, registerArtifactConsumer, getArtifactConsumer, listArtifactSnapshot, checkpointArtifactRebuild, activateArtifactConsumer, listArtifactChanges, acknowledgeArtifactChanges, inactivateArtifactConsumer, compactArtifactChanges, adminArtifactsContract;
 var init_admin_artifacts = __esm(() => {
   init_dist3();
   init_zod();
@@ -11304,6 +11325,57 @@ var init_admin_artifacts = __esm(() => {
     ok: literal(true),
     reason: _enum(["compacted", "empty", "no_safe_barrier"])
   });
+  SonarSourceAfterSchema = string2().min(1).max(1024).optional();
+  SonarSourceLimitSchema = number3().int().min(1).max(2000).default(1000);
+  SonarSourceIdsSchema = array(string2().min(1).max(1024)).min(1).max(200).refine((ids) => new Set(ids).size === ids.length);
+  listSonarTrackDigests = oc.route({
+    method: "GET",
+    operationId: "listSonarTrackDigests",
+    path: "/admin/sonar/source/tracks",
+    summary: "List source track digests and revisions",
+    tags: ["Admin"]
+  }).input(strictObject({ after: SonarSourceAfterSchema, limit: SonarSourceLimitSchema })).output(strictObject({
+    items: array(strictObject({
+      payloadDigest: DigestSchema,
+      revision: SequenceSchema,
+      subjectId: string2().min(1).max(1024)
+    })),
+    nextAfter: string2().nullable(),
+    ok: literal(true)
+  }));
+  listSonarTracks = oc.route({
+    method: "POST",
+    operationId: "listSonarTracks",
+    path: "/admin/sonar/source/tracks/items",
+    summary: "Read selected source tracks",
+    tags: ["Admin"]
+  }).input(strictObject({ subjectIds: SonarSourceIdsSchema })).output(strictObject({
+    absentIds: array(string2()),
+    items: array(ArtifactSnapshotItemSchema.extend({ revision: SequenceSchema })),
+    ok: literal(true)
+  }));
+  listSonarCentroidDigests = oc.route({
+    method: "GET",
+    operationId: "listSonarCentroidDigests",
+    path: "/admin/sonar/source/centroids",
+    summary: "List source artist centroid digests",
+    tags: ["Admin"]
+  }).input(strictObject({ after: SonarSourceAfterSchema, limit: SonarSourceLimitSchema })).output(strictObject({
+    items: array(strictObject({ artistId: string2(), digest: DigestSchema })),
+    nextAfter: string2().nullable(),
+    ok: literal(true)
+  }));
+  listSonarCentroids = oc.route({
+    method: "POST",
+    operationId: "listSonarCentroids",
+    path: "/admin/sonar/source/centroids/items",
+    summary: "Read selected artist centroids",
+    tags: ["Admin"]
+  }).input(strictObject({ artistIds: SonarSourceIdsSchema })).output(strictObject({
+    absentIds: array(string2()),
+    items: array(strictObject({ artistId: string2(), blobBase64: string2(), digest: DigestSchema })),
+    ok: literal(true)
+  }));
   registerArtifactConsumer = oc.route({
     method: "POST",
     operationId: "registerArtifactConsumer",
@@ -11364,6 +11436,7 @@ var init_admin_artifacts = __esm(() => {
     tags: ["Admin"]
   }).input(strictObject({
     consumerId: ConsumerIdSchema,
+    fromSeq: number3().int().nonnegative().optional(),
     limit: number3().int().min(1).max(ARTIFACT_CHANGE_API_MAX_LIMIT).default(100)
   })).output(ArtifactChangePageSchema);
   acknowledgeArtifactChanges = oc.route({
@@ -11404,6 +11477,10 @@ var init_admin_artifacts = __esm(() => {
     inactivate_artifact_consumer: inactivateArtifactConsumer,
     list_artifact_changes: listArtifactChanges,
     list_artifact_snapshot: listArtifactSnapshot,
+    list_sonar_centroid_digests: listSonarCentroidDigests,
+    list_sonar_centroids: listSonarCentroids,
+    list_sonar_track_digests: listSonarTrackDigests,
+    list_sonar_tracks: listSonarTracks,
     register_artifact_consumer: registerArtifactConsumer
   };
 });
@@ -14033,6 +14110,7 @@ var init_admin_labels = __esm(() => {
   LabelSeedStateSchema = _enum(["disabled", "enabled", "undecided"]).meta({ id: "LabelSeedState" });
   LabelTriageVerdictSchema = _enum(["dnb", "dnb_partial", "not_dnb", "unclear"]).meta({ id: "LabelTriageVerdict" });
   LabelAdminItemSchema = object({
+    carriesArtistRules: boolean2().optional(),
     createdAt: string2(),
     disambiguation: string2().nullable().optional(),
     findingCount: number2(),
@@ -25013,7 +25091,8 @@ JSON field reference:
     }
     for (const label of labels) {
       const looked = label.triageCheckedAt ? label.triageVerdict : "never looked";
-      console.log(`${label.slug}  ${label.seedState}  ${looked ?? ""}`.trimEnd());
+      const rules = label.carriesArtistRules ? "  artist rules" : "";
+      console.log(`${label.slug}  ${label.seedState}  ${looked ?? ""}${rules}`.trimEnd());
     }
   });
   labels.command("evidence").description("Gather a label's MusicBrainz, Discogs, Beatport and Apple evidence for triage (cached, rate-limited)").argument("<label>", "The label's MusicBrainz MBID, slug, or lbl_\u2026 id").option("--census", "Also count FIRST credits per recording over the label's releases", false).option("--census-pages <n>", "MusicBrainz pages the census may read, 1-5", "5").option("--sources <list>", "Comma list of musicbrainz,discogs,beatport,apple (default all)").option("--refresh", "Ignore cached responses and fetch fresh", false).option("--json", "Print JSON", false).action(async (input, options) => {

package/package.json

@@ -31,5 +31,5 @@
     "url": "git+https://github.com/mauricekleine/fluncle.git"
   },
   "type": "module",
-  "version": "0.265.0"
+  "version": "0.267.0"
 }