@hasna/skills 0.10.48 → 0.10.50

package/dist/lib/agent-discovery.d.ts

@@ -7,7 +7,7 @@ export { captureDiscoveryDirectories, type DiscoveryDirectory } from "./agent-di
 export interface DiscoverySource {
     path: string;
     sha256: string | null;
-    hashMode?: "bytes" | "path-bytes" | "claude-plugin-manifest-v1" | "claude-plugin-registry" | "claude-marketplace-registry" | "claude-settings-v1" | "claude-settings-v2" | "claude-settings-v3" | "claude-marketplace-registry-v2" | "codex-settings-v1" | "codex-settings-v2" | "codex-settings-v3" | "codex-settings-v4" | "sumi-settings-v1";
+    hashMode?: "bytes" | "path-bytes" | "claude-plugin-manifest-v1" | "claude-plugin-registry" | "claude-marketplace-registry" | "claude-settings-v1" | "claude-settings-v2" | "claude-settings-v3" | "claude-settings-v4" | "claude-marketplace-registry-v2" | "codex-settings-v1" | "codex-settings-v2" | "codex-settings-v3" | "codex-settings-v4" | "sumi-settings-v1";
     managedPlugins?: ManagedPluginRegistrationWitness[];
     format?: "json" | "toml" | "yaml";
     fields?: string[];

package/dist/lib/agent-integration.d.ts

@@ -190,6 +190,7 @@ export declare function planClaudeHookEventsUpdate(options: ClaudeHookUpdateOpti
 export declare function planAgentSettingsWitnessUpgrade(options: {
     agent: "claude" | "codex" | "sumi";
     targetCodexVersion?: 2 | 3 | 4;
+    targetClaudeVersion?: 3 | 4;
     reviewedPreimage: string;
     home?: string;
     dataDir?: string;

package/dist/lib/claude-settings-witness.d.ts

@@ -10,6 +10,7 @@ export interface ClaudeSettingsWitnessBudget {
     remaining: number;
 }
 export declare function readNativeSettingsWitnessFile(path: string, budget: ClaudeSettingsWitnessBudget, filename?: "settings.json" | "config.toml" | "sumi.json"): string;
+export declare const CLAUDE_BUILTIN_THEMES: readonly ["auto", "dark", "light", "dark-daltonized", "light-daltonized", "dark-ansi", "light-ansi"];
 /** Cooperating installers may replace only their explicitly selected event. Compare the strict syntax
  * trees, not JSON.parse values or the preference-tolerant witness digest: all
  * other hooks, discovery settings, unknown values and number spellings remain
@@ -51,6 +52,24 @@ export declare function upgradeClaudeSettingsWitness(previous: {
     hashMode?: "bytes" | "claude-settings-v1" | "claude-settings-v2";
     sha256: string;
 }, reviewedSettingsPath: string): ReturnType<typeof captureClaudeSettingsV3>;
+/** Explicit review that additionally permits a built-in top-level theme.
+ * v1/v2/v3 witnesses keep their meaning; nothing selects v4 implicitly. */
+export declare function captureClaudeSettingsV4(path: string, budget?: ClaudeSettingsWitnessBudget): {
+    path: string;
+    hashMode: "claude-settings-v4";
+    sha256: string;
+};
+export declare function hashClaudeSettingsReplacementV4(text: string, budget: ClaudeSettingsWitnessBudget): string;
+/** Explicit opt-in upgrade to v4 with an exact preserved preimage of the prior
+ * review (raw bytes, v1, v2 or v3). It proves that every setting v4 binds is
+ * unchanged; any other drift, including skipDangerousModePermissionPrompt,
+ * refuses. A stored witness is never rewritten without this call.
+ */
+export declare function upgradeClaudeSettingsWitnessV4(previous: {
+    path: string;
+    hashMode?: "bytes" | "claude-settings-v1" | "claude-settings-v2" | "claude-settings-v3";
+    sha256: string;
+}, reviewedSettingsPath: string): ReturnType<typeof captureClaudeSettingsV4>;
 /** Strict bounded JSON control witness; metadata exclusion must be explicit. */
 export declare function hashNativeJsonControls(text: string, excludedMetadata?: "version"): string;
 /** Sumi's versioned review uses the same strict JSON parser and bounded syntax

package/dist/lib/launch-cwd-apply.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/launch-cwd.d.ts

@@ -0,0 +1,5 @@
+export declare const LAUNCH_CWD_VARIABLE = "HASNA_SKILLS_LAUNCH_CWD";
+export declare function restoreLaunchCwd(env?: Record<string, string | undefined>): {
+    restored: boolean;
+    cwd: string;
+};

package/dist/lib/self-spawn.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The trusted directory for a child of `entry`: the copyfile runtime version
+ * root that holds `node_modules/@hasna/skills` (what the pinned launcher uses),
+ * or the entry's own directory for a build or source checkout.
+ */
+export declare function selfSpawnRoot(entry: string): string;
+export interface SelfSpawnCommand {
+    command: string[];
+    cwd: string;
+    env: Record<string, string>;
+}
+/**
+ * Argv, working directory and environment to run this Skills entry again with
+ * `args`. Pass the result to Bun.spawn as `cmd`, `cwd` and `env`.
+ */
+export declare function selfSpawnCommand(args: readonly string[], options?: {
+    entry?: string;
+    runtime?: string;
+    env?: Record<string, string | undefined>;
+    callerCwd?: string;
+}): SelfSpawnCommand;

package/dist/mcp/index.d.ts

@@ -8,6 +8,7 @@
  *   skills-mcp          # Direct binary
  *   skills-mcp --http   # Streamable HTTP on 127.0.0.1:8836
  */
+import "../lib/launch-cwd-apply.js";
 /**
  * FAIL CLOSED AT STARTUP (owner ruling 2026-09-04, hasna/apps#1720; #1720
  * validation, round 1): the MCP process resolves the fleet ladder BEFORE it