fluncle 0.226.0 → 0.228.0

package/bin/fluncle.mjs

@@ -612,7 +612,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.226.0".trim() ? "0.226.0".trim() : "0.1.0";
+  currentVersion = "0.228.0".trim() ? "0.228.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2454,7 +2454,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.226.0".trim() ? "0.226.0".trim() : "0.1.0";
+  currentVersion2 = "0.228.0".trim() ? "0.228.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2468,7 +2468,9 @@ var init_src = __esm(() => {
   MINUTE_MS = 60 * 1000;
   SURFACES = [
     {
-      exposedContent: ["the archive — every certified finding, newest first, cover-led"],
+      exposedContent: [
+        "the front door — search with real example queries, one edited lead finding, the newest findings, what just came out, and the four routes into the wider archive"
+      ],
       kind: "web_route",
       name: "web.home",
       operatorNotes: "The Worker root. galaxy./radio. rewrite their root to /galaxy and /radio.",
@@ -2477,6 +2479,16 @@ var init_src = __esm(() => {
       url: `${SITE}/`,
       weights: { web: "primary" }
     },
+    {
+      exposedContent: ["the archive — every certified finding, newest first, cover-led"],
+      kind: "web_route",
+      name: "web.findings",
+      operatorNotes: "The cover-led archive page the root used to be. Carries the Stories viewer (?story=<logId>, masked to /log/<id>); /?story= 301s to /log/<id>.",
+      probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
+      route: "/findings",
+      url: `${SITE}/findings`,
+      weights: { web: "primary" }
+    },
     {
       exposedContent: [
         "the log index — every finding's coordinate page",
@@ -2657,11 +2669,26 @@ var init_src = __esm(() => {
     {
       discoveryUrl: `${SITE}/llms.txt`,
       exposedContent: [
-        "/tracks — the whole list: every track Fluncle holds (certified findings + the wider catalogue), newest release first, filterable by release year, tempo, key, label, and galaxy"
+        "/search — the persistent, linkable search surface: one `?q=` carries a coordinate, an entity name, a natural-language filter, or a sonic reference, and the answer is server-rendered from the URL",
+        "/search?q=<query> — a shareable, reload-safe result set over the whole archive (findings and the wider catalogue)"
+      ],
+      kind: "web_route",
+      name: "web.search",
+      operatorNotes: "The PERSISTENT half of search — the addressable counterpart to the ⌘K palette, which stays the accelerator and hands off here (components/search/search-command.tsx). It calls the SAME primitive, `searchArchive` (lib/server/search.ts), through a serverFn, so all four resolution tiers, the certified-first ranking, the catalogue rule, and the degradation contract are the ones docs/search.md already specifies; nothing is re-resolved. THE WHOLE QUERY STATE IS ONE PARAM, because the resolver takes one string — a coordinate, a name, a sentence, and a sonic reference all arrive as `q`. A coordinate/entity `redirect` is deliberately NOT followed here (the palette may; a persistent URL that bounced would be un-shareable and a back-button trap): the resolved row is rendered as the first result instead. The field commits on SUBMIT, never per keystroke, so history holds one entry per real query. It is a real `<form method=get action=/search>`, so search works with no JS. The BARE surface is indexable, in the sitemap, and carries the WebSite SearchAction; ANY `?q=` view is noindex, follow with its canonical collapsed onto the bare page (the /tracks filtered-view rule, and the standard posture for an internal results page). The INDEX is always-200, so it is HTTP-probeable.",
+      probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
+      route: "/search",
+      url: `${SITE}/search`,
+      weights: { web: "primary" }
+    },
+    {
+      discoveryUrl: `${SITE}/llms.txt`,
+      exposedContent: [
+        "/tracks — the whole list: every track Fluncle holds (certified findings + the wider catalogue), newest release first, filterable by release year, tempo, key, label, and galaxy",
+        "/track/:trackId — one archive recording: its artists, record, imprint, release date, tempo and key, a bounded preview, every service that carries it, and what sits close to it in sound"
       ],
       kind: "web_route",
       name: "web.tracks",
-      operatorNotes: "The top-level track index — the whole archive as one browse list, findings in full voice and the catalogue rows in the unlit register (DESIGN.md). Ordered by tracks.release_date (what came out), never findings.added_at (the Found Rule), numbered-paginated (?page=N) over the tracks_release_date_track_id_idx btree with a quiet YEAR fast lane, so a crawler with no JS walks the whole list (lib/server/tracks-hub.ts). The filter params MIRROR the search vocabulary verbatim (yearMin/yearMax, bpmMin/bpmMax, key, label; galaxy is the one extension). The bare HUB is always indexable + in the sitemap, each page self-canonical; ANY filter param present flips it to noindex, and paged bare URLs stay out of the sitemap. The INDEX is always-200, so it is HTTP-probeable.",
+      operatorNotes: "The top-level track index — the whole archive as one browse list, findings in full voice and the catalogue rows in the unlit register (DESIGN.md). Ordered by tracks.release_date (what came out), never findings.added_at (the Found Rule), numbered-paginated (?page=N) over the tracks_release_date_track_id_idx btree with a quiet YEAR fast lane, so a crawler with no JS walks the whole list (lib/server/tracks-hub.ts). The filter params MIRROR the search vocabulary verbatim (yearMin/yearMax, bpmMin/bpmMax, key, label; galaxy is the one extension). The bare HUB is always indexable + in the sitemap, each page self-canonical; ANY filter param present flips it to noindex, and paged bare URLs stay out of the sitemap. The INDEX is always-200, so it is HTTP-probeable. The DETAIL page /track/:trackId is the archive recording's own destination, keyed on the row's permanent primary key; a CERTIFIED track 301s to /log/<coordinate> (that URL and its meaning are unchanged) and a stamped duplicate 301s to its principal. It carries its own EVIDENCE gate: one SQL expression (TRACK_PAGE_INDEXABLE_WHERE) drives both the page's robots directive and its sitemap membership, so a low-evidence page serves 200 + noindex,follow and stays out of the tracks sitemap child by construction. See docs/track-destination.md.",
       probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
       route: "/tracks",
       url: `${SITE}/tracks`,
@@ -3978,6 +4005,23 @@ var init_src = __esm(() => {
       title: "Count check",
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin projections advance --target <public_aggregates|artist_qualification> --action repair --limit 500 --max-steps 4",
+      exposedContent: [
+        "keep the two public projection families converged after cutover with status-gated, bounded repair (--no-agent)"
+      ],
+      kind: "cron",
+      name: "cron.projection-maintenance",
+      operatorNotes: "every 5m with per-firing jitter, run by a rave-02 host systemd timer (docs/agents/hermes/projection-maintenance-timer/). Reads bounded projection status first. A dark shared cutover issues zero repair calls; an open idle cutover also writes nothing. Each affected public family gets at most four sequential repair pages of 500 subjects, with independent failure handling. Public aggregate repair also advances the bounded anchor cursor after marker debt drains. Rebuild, audit, track/crawl repair, and every cutover mutation remain operator-only. Zero LLM tokens; no new secret.",
+      probeConfig: {
+        cadenceMs: 5 * MINUTE_MS,
+        cronName: "fluncle-projection-maintenance",
+        kind: "cron"
+      },
+      statusDescription: "keeps the public catalogue projections caught up",
+      title: "Projection upkeep",
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin reach collect",
       exposedContent: [
@@ -4223,7 +4267,7 @@ function checkBundleCompleteness(files) {
     uploadingFootage
   };
 }
-async function trackVideoCommand(idOrLogId, files, onProgress, options = {}) {
+function validateBundleCompleteness(files, onProgress, options) {
   const completeness = checkBundleCompleteness(files);
   if (completeness.uploadingFootage && completeness.missingContract.length > 0 && !options.allowPartial) {
     throw new CliError2("bundle_incomplete", `Refusing to upload a PARTIAL bundle: footage is being uploaded but the re-render contract is missing ${completeness.missingContract.join(", ")}. ` + `A footage-only upload leaves composition.tsx/props.json/render.json stale on R2 and desyncs the render.json from the DB ledger. ` + `Ship the complete bundle (re-run \`ship\` and upload with --dir), or pass --allow-partial for a deliberate partial refresh (e.g. poster-only).`);
@@ -4239,6 +4283,9 @@ async function trackVideoCommand(idOrLogId, files, onProgress, options = {}) {
   for (const warning of completeness.plateWarnings) {
     onProgress?.(`warning: ${warning}`);
   }
+}
+async function trackVideoCommand(idOrLogId, files, onProgress, options = {}) {
+  validateBundleCompleteness(files, onProgress, options);
   const present = VIDEO_FIELDS.map((spec) => ({
     field: spec.field,
     path: files[spec.option]
@@ -12493,6 +12540,7 @@ var init_admin_projections = __esm(() => {
     tags: ["Admin"]
   }).input(object({
     action: ProjectionStepActionSchema,
+    includeStatus: boolean2().default(true),
     limit: number2().int().min(1).max(PROJECTION_STEP_LIMIT_MAX),
     target: ProjectionTargetSchema
   })).output(object({
@@ -12501,7 +12549,7 @@ var init_admin_projections = __esm(() => {
     ok: literal(true),
     processed: CountSchema,
     scheduled: CountSchema,
-    status: ProjectionStatusSchema,
+    status: ProjectionStatusSchema.optional(),
     target: ProjectionTargetSchema
   }));
   setProjectionCutover = oc.route({
@@ -12781,7 +12829,9 @@ var init__shared = __esm(() => {
     logId: string2().optional(),
     releaseDate: string2().optional(),
     spotifyUrl: string2().optional(),
-    title: string2()
+    title: string2(),
+    trackId: string2(),
+    url: string2().optional()
   }).meta({ id: "CatalogueTrackListItem" });
   FreshAlbumSchema = object({
     artists: array(string2()),
@@ -16578,17 +16628,19 @@ async function getProjectionStatusCommand() {
 }
 async function advanceProjectionCommand(input) {
   const { maxSteps = 1, target, ...body } = input;
-  let response = await adminApiPost(`/api/v1/admin/projections/${target}/advance`, body);
+  const stepBody = maxSteps > 1 ? { ...body, includeStatus: false } : body;
+  let response = await adminApiPost(`/api/v1/admin/projections/${target}/advance`, stepBody);
   let steps = 1;
   let processed = response.processed;
   let scheduled = response.scheduled;
   while (!response.complete && steps < maxSteps) {
-    response = await adminApiPost(`/api/v1/admin/projections/${target}/advance`, body);
+    response = await adminApiPost(`/api/v1/admin/projections/${target}/advance`, stepBody);
     steps += 1;
     processed += response.processed;
     scheduled += response.scheduled;
   }
-  return { ...response, processed, scheduled, steps };
+  const status = response.status ?? (await getProjectionStatusCommand()).status;
+  return { ...response, processed, scheduled, status, steps };
 }
 async function setProjectionCutoverCommand(input) {
   const { enabled, target } = input;

package/package.json

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