@hraness/sponge 0.3.2 → 0.3.3

package/dist/src/cli/main.js

@@ -8,7 +8,7 @@ import { command, usageOf } from './commands.js';
 import { openLibrary } from '../store/index.js';
 import { defaultCapturePins } from '../acquisition/index.js';
 import { failure } from '../acquisition/errors.js';
-import { SpongeError, codeOf, publicCode, exitFor, hints, debugChain } from '../errors.js';
+import { SpongeError, codeOf, publicCode, exitFor, hints, detailHints, debugChain, } from '../errors.js';
 /** Failures print one categorical JSON line: the public code, its specific `reason` when narrower, and a fixed hint.
  * Causes, details, paths and upstream messages appear only with --debug or SPONGE_DEBUG=1. */
 function report(error, requestId, debug) {
@@ -17,7 +17,7 @@ function report(error, requestId, debug) {
         process.stderr.write(JSON.stringify({ issues }) + '\n');
     const hint = code === 'invalid-input' && typeof usage === 'string' && command(usage)
         ? `Usage: ${usageOf(usage).replace(/\n/g, ' | ')}`
-        : hints[code];
+        : (detailHints[reason] ?? hints[code]);
     process.stderr.write(JSON.stringify({ ...failure(requestId, code), ...(reason !== code ? { reason } : {}), hint }) + '\n');
     if (debug)
         process.stderr.write(debugChain(error));

package/dist/src/digest/pipeline.js

@@ -610,7 +610,7 @@ export async function draftDigest(input) {
         result = await attempt(await call([...messages, { role: 'assistant', content: first }, { role: 'user', content: repairPrompt(result.issues) }], schema));
     }
     if (!result.draft)
-        throw new SpongeError('unavailable', { issues: result.issues });
+        throw new SpongeError('draft-rejected', { issues: result.issues });
     let issues = result.issues;
     if (issues.length) {
         trace.dropped = prune(result.draft, issues, source, options);
@@ -618,7 +618,7 @@ export async function draftDigest(input) {
         if (result.draft.digest.ideas.length < L.minIdeas)
             issues = [...issues.filter((i) => !(i.path === 'ideas' && i.code === 'count')), { path: 'ideas', code: 'count' }];
         if (issues.length)
-            throw new SpongeError('unavailable', { issues });
+            throw new SpongeError('draft-rejected', { issues });
     }
     const producer = {
         pipeline: 'sponge-digest',

package/dist/src/errors.d.ts

@@ -16,6 +16,7 @@ declare const parents: {
     readonly 'not-digest': "unsupported";
     readonly malformed: "invalid-input";
     readonly 'no-capture': "invalid-input";
+    readonly 'draft-rejected': "unavailable";
     readonly 'parent-missing': "invalid-input";
     readonly 'target-exists': "invalid-input";
 };
@@ -27,6 +28,8 @@ export declare const isSpongeCode: (value: unknown) => value is SpongeCode;
 export declare const exitStatus: Readonly<Record<ErrorCode, number>>;
 /** The one code→user-facing hint table. Fixed text only: never paths, sources, credentials or upstream prose. */
 export declare const hints: Readonly<Record<ErrorCode, string>>;
+/** Hints for detail codes whose public code's hint would mislead. Fixed text only, like `hints`. */
+export declare const detailHints: Readonly<Partial<Record<DetailCode, string>>>;
 export interface SpongeErrorOptions {
     detail?: Record<string, unknown>;
     cause?: unknown;

package/dist/src/errors.js

@@ -30,6 +30,7 @@ const parents = {
     'not-digest': 'unsupported',
     malformed: 'invalid-input',
     'no-capture': 'invalid-input',
+    'draft-rejected': 'unavailable',
     'parent-missing': 'invalid-input',
     'target-exists': 'invalid-input',
 };
@@ -77,6 +78,10 @@ export const hints = {
     'schema-newer': 'This library was written by a newer Sponge. Upgrade Sponge.',
     'owner-busy': 'Another Sponge process owns the library. Wait for it, or run `sponge queue recover` after it stops.',
 };
+/** Hints for detail codes whose public code's hint would mislead. Fixed text only, like `hints`. */
+export const detailHints = {
+    'draft-rejected': 'The model draft failed the digest checks listed above, even after one repair. Run it again; drafts vary.',
+};
 /** The one error type. `message` is the code, so bare `String(error)` never carries detail, paths or causes. */
 export class SpongeError extends Error {
     code;

package/native/runtime-manifest.json

@@ -27,14 +27,14 @@
     }
   ],
   "build": {
-    "asrSourceSha256": "8bd77ebffabae786902304eacb983fc950f70c981fb1538696517d85052c9407",
+    "asrSourceSha256": "e2e38c4beb276bf8e625e89f4694dcf6a89526621b0a056b590325bc7fb92314",
     "clangVersion": "Apple clang version 21.0.0 (clang-2100.1.1.101)",
-    "embeddingSourceSha256": "2b0cd2b9c52c9dee578a3be50a443d528d5204d47f3f9ba750f6a1f37a191e78",
+    "embeddingSourceSha256": "38ba64989463d38bf6100636a2b1569e43cc32fbe640da6cc4bf0d8b24409c8a",
     "swiftVersion": "Apple Swift version 6.3.3 (swiftlang-6.3.3.1.3 clang-2100.1.1.101)"
   },
   "minimumMacOS": "26.0",
-  "packageVersion": "0.3.2",
+  "packageVersion": "0.3.3",
   "platform": "darwin",
   "schemaVersion": 1,
-  "sourceCommit": "e9eb0613365859c5809a05e8ad909504ac6e8d66"
+  "sourceCommit": "b1de42fa724be73e352c34357d42a1ca3946d5b5"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hraness/sponge",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "A local library for captured articles and verified offline assets.",
   "repository": {
     "type": "git",