@hasna/instructions 0.6.1 → 0.7.0

package/dist/chunks/index-fpeyzn3n.js

@@ -0,0 +1,186 @@
+// @bun
+// src/lib/raw-store-root.ts
+import { resolve as resolve2 } from "path";
+
+// src/lib/app-home.ts
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join, resolve } from "path";
+import { homedir as pathsResolverHomedir } from "os";
+import { join as pathsResolverJoin } from "path";
+var PATHS_RESOLVER_KIND_ENV = {
+  config: "HASNA_CONFIG_HOME",
+  data: "HASNA_DATA_HOME",
+  state: "HASNA_STATE_HOME",
+  cache: "HASNA_CACHE_HOME"
+};
+var PATHS_RESOLVER_APP_SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function pathsResolverAssertApp(app) {
+  if (typeof app !== "string" || app.length === 0) {
+    throw new TypeError("paths: app must be a non-empty string");
+  }
+  if (!PATHS_RESOLVER_APP_SLUG_RE.test(app)) {
+    throw new TypeError(`paths: invalid app slug "${app}" \u2014 expected lowercase kebab-case ([a-z0-9]+(-[a-z0-9]+)*)`);
+  }
+}
+function pathsResolverAssertKind(kind) {
+  if (!Object.keys(PATHS_RESOLVER_KIND_ENV).includes(kind)) {
+    throw new TypeError(`paths: invalid path kind "${kind}" \u2014 expected one of ${Object.keys(PATHS_RESOLVER_KIND_ENV).join(", ")}`);
+  }
+}
+function pathsResolverBaseDir(kind, options) {
+  pathsResolverAssertKind(kind);
+  const env = options.env ?? process.env;
+  const override = env[PATHS_RESOLVER_KIND_ENV[kind]];
+  if (typeof override === "string" && override.length > 0)
+    return override;
+  const home = options.home ?? pathsResolverHomedir();
+  const platform = options.platform ?? process.platform;
+  if (platform === "darwin") {
+    switch (kind) {
+      case "config":
+      case "data":
+        return pathsResolverJoin(home, "Library", "Application Support", "Hasna");
+      case "cache":
+        return pathsResolverJoin(home, "Library", "Caches", "Hasna");
+      case "state":
+        return pathsResolverJoin(home, "Library", "Logs", "Hasna");
+    }
+  }
+  switch (kind) {
+    case "config":
+      return pathsResolverJoin(home, ".config", "hasna");
+    case "data":
+      return pathsResolverJoin(home, ".local", "share", "hasna");
+    case "state":
+      return pathsResolverJoin(home, ".local", "state", "hasna");
+    case "cache":
+      return pathsResolverJoin(home, ".cache", "hasna");
+  }
+}
+function pathsResolverResolve(kind, options) {
+  pathsResolverAssertApp(options.app);
+  const appSegment = options.internal === true ? pathsResolverJoin("internal", options.app) : options.app;
+  return pathsResolverJoin(pathsResolverBaseDir(kind, options), appSegment);
+}
+function configDir(options) {
+  return pathsResolverResolve("config", options);
+}
+var HASNA_CONFIGS_HOME_ENV = "HASNA_CONFIGS_HOME";
+function homeDir(env = process.env) {
+  return env["HOME"] || env["USERPROFILE"] || homedir();
+}
+function legacyStoreHome(env = process.env) {
+  return resolve(join(homeDir(env), ".hasna", "instructions"));
+}
+function resolverStoreHome(env = process.env) {
+  return configDir({ app: "configs", env, home: env.HOME || env.USERPROFILE || homedir() });
+}
+function adoptResolverStoreHome(resolved, env = process.env) {
+  const override = env.HASNA_CONFIG_HOME;
+  if (typeof override === "string" && override.trim().length > 0)
+    return true;
+  return existsSync(join(resolved, "instructions.db"));
+}
+function exactStoreHome(env = process.env) {
+  const v = env[HASNA_CONFIGS_HOME_ENV];
+  return v && v.trim() ? v.trim() : undefined;
+}
+function getConfigsStoreHome(env = process.env) {
+  const exact = exactStoreHome(env);
+  if (exact)
+    return resolve(exact);
+  const resolved = resolverStoreHome(env);
+  return adoptResolverStoreHome(resolved, env) ? resolve(resolved) : legacyStoreHome(env);
+}
+
+// src/lib/raw-store-root.ts
+function getRawStoreRoot(env = process.env) {
+  return resolve2(getConfigsStoreHome(env));
+}
+
+// ../../node_modules/.bun/@hasna+contracts@1.0.2+e8014c875821e0be/node_modules/@hasna/contracts/dist/client/transport.js
+import { createRequire } from "module";
+function envToken(name) {
+  return name.toUpperCase().replace(/-/g, "_");
+}
+function clientTransportEnvKeys(name) {
+  const envSegment = envToken(name);
+  return {
+    apiUrlKeys: [`HASNA_${envSegment}_API_URL`, `${envSegment}_API_URL`],
+    apiKeyKeys: [`HASNA_${envSegment}_API_KEY`, `${envSegment}_API_KEY`]
+  };
+}
+function credentialOverrideEnvKey(name) {
+  return `HASNA_${envToken(name)}_API_KEY_OVERRIDE`;
+}
+var CREDENTIAL_PROFILE_ENV_KEY = "HASNA_PROFILE";
+function credentialPointerEnvKey(name) {
+  return `HASNA_${envToken(name)}_API_KEY_REF`;
+}
+var MAX_CREDENTIAL_FILE_BYTES = 64 * 1024;
+var INSPECT_CUSTOM = Symbol.for("nodejs.util.inspect.custom");
+var CREDENTIAL_SEAL = Symbol.for("hasna:contracts:sealedCredential");
+var AMBIENT_ENVIRONMENT = Symbol.for("hasna:contracts:ambientClientEnvironment");
+var SECRETS_PACKAGE_SPECIFIER = "@hasna/" + "secrets";
+var requireSecretsSdk = createRequire(import.meta.url);
+var IDEMPOTENT_METHODS = new Set(["GET", "HEAD", "PUT", "DELETE", "OPTIONS"]);
+var AUTHORITY_OVERRIDE_HEADERS = new Set([
+  "host",
+  ":authority",
+  "forwarded",
+  "x-forwarded-host",
+  "x-original-host"
+]);
+
+// src/lib/local-opt-in.ts
+var INSTRUCTIONS_LOCAL_OPT_IN_ENV_KEYS = ["HASNA_INSTRUCTIONS_LOCAL"];
+function instructionsLocalModeNotice() {
+  return `instructions: local mode \u2014 ${INSTRUCTIONS_LOCAL_OPT_IN_ENV_KEYS[0]}=1 selects the on-box SQLite store, ` + `and no hosted authority was configured. Set HASNA_INSTRUCTIONS_API_KEY (or add the Keychain item ` + `hasna.credentials.instructions.api-key, or write ~/.hasna/instructions/config/credentials) to go hosted.`;
+}
+function isInstructionsLocalOptIn(env = process.env) {
+  return INSTRUCTIONS_LOCAL_OPT_IN_ENV_KEYS.some((key) => (env[key] ?? "").trim() === "1");
+}
+function instructionsAuthorityEnvKeys() {
+  const keys = clientTransportEnvKeys("instructions");
+  return [
+    ...keys.apiUrlKeys,
+    ...keys.apiKeyKeys,
+    credentialOverrideEnvKey("instructions"),
+    credentialPointerEnvKey("instructions"),
+    CREDENTIAL_PROFILE_ENV_KEY
+  ];
+}
+function hasInstructionsEnvAuthorityIntent(env = process.env) {
+  return instructionsAuthorityEnvKeys().some((key) => (env[key] ?? "").trim() !== "");
+}
+function selectsInstructionsLocalStore(env = process.env) {
+  return !hasInstructionsEnvAuthorityIntent(env) && isInstructionsLocalOptIn(env);
+}
+function instructionsResolverEnv(env) {
+  const blanks = instructionsAuthorityEnvKeys().filter((key) => (key in env) && (env[key] ?? "").trim() === "");
+  if (blanks.length === 0)
+    return env;
+  const next = { ...env };
+  for (const key of blanks)
+    delete next[key];
+  return next;
+}
+var CONTRACTS_AMBIENT_ENVIRONMENT = Symbol.for("hasna:contracts:ambientClientEnvironment");
+function isAmbientInstructionsEnv(env) {
+  if (typeof process !== "undefined" && env === process.env)
+    return true;
+  return env[CONTRACTS_AMBIENT_ENVIRONMENT] === true;
+}
+function instructionsResolverInputs(env, credentials = {}) {
+  const normalised = instructionsResolverEnv(env);
+  if (normalised === env)
+    return { env: normalised, credentials };
+  const keychain = { ...credentials.keychain };
+  if (keychain.enabled === undefined && keychain.run === undefined) {
+    keychain.enabled = isAmbientInstructionsEnv(env);
+  }
+  return { env: normalised, credentials: { ...credentials, keychain } };
+}
+
+export { getRawStoreRoot, clientTransportEnvKeys, INSTRUCTIONS_LOCAL_OPT_IN_ENV_KEYS, instructionsLocalModeNotice, hasInstructionsEnvAuthorityIntent, selectsInstructionsLocalStore, instructionsResolverInputs };

package/dist/chunks/{index-axhwg61p.js → index-fwbs6tma.js}

@@ -15,7 +15,7 @@ import {
   resolveConfigStore,
   resolveProfileVariables,
   stampCursorGlobalAuthorityMarker
-} from "./index-v7dkb384.js";
+} from "./index-4pfq42t5.js";
 import {
   isSecretVarName,
   redactFormatForTarget,
@@ -24,11 +24,11 @@ import {
 import {
   ConfigApplyError,
   parseTemplateVars
-} from "./index-pkscjnj5.js";
+} from "./index-3djthcm6.js";
 
 // src/lib/apply.ts
 import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, realpathSync, writeFileSync } from "fs";
-import { basename, dirname as dirname2, join as join2, resolve } from "path";
+import { basename, dirname as dirname2, isAbsolute, join as join2, relative as relative2, resolve, sep as sep2 } from "path";
 import { homedir } from "os";
 
 // src/lib/session-render-ownership.ts
@@ -112,6 +112,17 @@ function expandPath(p) {
   }
   return resolve(p);
 }
+function compactPathForConfigHome(p) {
+  const absolute = resolve(p);
+  const configHome = resolve(getConfigHome());
+  const conventionalHome = resolve(process.env["HOME"] || homedir());
+  if (configHome !== conventionalHome)
+    return absolute;
+  const rel = relative2(configHome, absolute);
+  if (!rel || rel === ".." || rel.startsWith(`..${sep2}`) || isAbsolute(rel))
+    return absolute;
+  return `~/${rel}`;
+}
 function normalizeTargetPath(p) {
   const expanded = expandPath(p);
   try {
@@ -520,4 +531,4 @@ function sessionRendererOwnsCanonicalTarget(normalized, opts) {
   return sessionRenderOwnsPath(normalized);
 }
 
-export { getConfigHome, expandPath, normalizeTargetPath, applyConfig, applyConfigs, applyConfigsWithReport, previewConfigs };
+export { getConfigHome, expandPath, compactPathForConfigHome, normalizeTargetPath, applyConfig, applyConfigs, applyConfigsWithReport, previewConfigs };

package/dist/chunks/index-n3fjspr0.js

@@ -0,0 +1,119 @@
+// @bun
+// src/types/index.ts
+var CONFIG_AGENTS = [
+  "claude",
+  "codex",
+  "opencode",
+  "cursor",
+  "codewith",
+  "aicopilot",
+  "antigravity",
+  "qwen",
+  "grok",
+  "copilot",
+  "devin",
+  "windsurf-legacy",
+  "cline",
+  "zsh",
+  "git",
+  "npm",
+  "global"
+];
+var PROFILE_CONFIG_BINDING_SCHEMA = "hasna.instructions.profile-config-binding/v1";
+var INSTRUCTION_ACTIVATION_MODES = ["always", "glob", "model", "manual"];
+var INSTRUCTION_FALLBACKS = ["fail", "flatten", "promote-always", "omit"];
+var PROFILE_ASSET_BINDING_SCHEMA = "hasna.instructions.profile-asset-binding/v1";
+var ASSET_KINDS = ["skill", "workflow", "plugin", "extension", "hook", "custom-agent"];
+var ASSET_DESTINATION_STRATEGIES = ["emit-file", "install-local", "install-marketplace", "unsupported"];
+var ASSET_SCOPES = ["global", "project", "session"];
+var ASSET_UNINSTALL_POLICIES = ["remove-managed", "retain"];
+var ASSET_ROLLBACK_POLICIES = ["snapshot", "installer-receipt", "none"];
+var INSTRUCTIONS_DOMAIN_ARCHIVE_SCHEMA = "hasna.instructions.domain-archive/v2";
+
+class ConfigNotFoundError extends Error {
+  constructor(id) {
+    super(`Config not found: ${id}`);
+    this.name = "ConfigNotFoundError";
+  }
+}
+
+class ProfileNotFoundError extends Error {
+  constructor(id) {
+    super(`Profile not found: ${id}`);
+    this.name = "ProfileNotFoundError";
+  }
+}
+
+class ConfigApplyError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ConfigApplyError";
+  }
+}
+
+class TemplateRenderError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "TemplateRenderError";
+  }
+}
+
+// src/lib/template.ts
+var VAR_PATTERN = /\{\{([A-Z0-9_]+)(?::([^}]*))?\}\}/g;
+function parseTemplateVars(content) {
+  const names = new Set;
+  let match;
+  VAR_PATTERN.lastIndex = 0;
+  while ((match = VAR_PATTERN.exec(content)) !== null) {
+    names.add(match[1]);
+  }
+  return Array.from(names);
+}
+function extractTemplateVars(content) {
+  const vars = new Map;
+  let match;
+  VAR_PATTERN.lastIndex = 0;
+  while ((match = VAR_PATTERN.exec(content)) !== null) {
+    const name = match[1];
+    const description = match[2] ?? null;
+    if (!vars.has(name)) {
+      vars.set(name, { name, description, required: true });
+    }
+  }
+  return Array.from(vars.values());
+}
+function renderTemplate(content, vars) {
+  const missing = [];
+  VAR_PATTERN.lastIndex = 0;
+  let match;
+  while ((match = VAR_PATTERN.exec(content)) !== null) {
+    const name = match[1];
+    if (!(name in vars))
+      missing.push(name);
+  }
+  if (missing.length > 0) {
+    throw new TemplateRenderError(`Missing required template variables: ${missing.join(", ")}`);
+  }
+  VAR_PATTERN.lastIndex = 0;
+  return content.replace(VAR_PATTERN, (_match, name) => vars[name] ?? "");
+}
+function renderTemplatePreview(content, vars) {
+  const unresolved = new Set;
+  VAR_PATTERN.lastIndex = 0;
+  const rendered = content.replace(VAR_PATTERN, (match, name) => {
+    if (name in vars)
+      return vars[name] ?? "";
+    unresolved.add(name);
+    return match;
+  });
+  return {
+    content: rendered,
+    unresolved: [...unresolved].sort()
+  };
+}
+function isTemplate(content) {
+  VAR_PATTERN.lastIndex = 0;
+  return VAR_PATTERN.test(content);
+}
+
+export { CONFIG_AGENTS, PROFILE_CONFIG_BINDING_SCHEMA, INSTRUCTION_ACTIVATION_MODES, INSTRUCTION_FALLBACKS, PROFILE_ASSET_BINDING_SCHEMA, ASSET_KINDS, ASSET_DESTINATION_STRATEGIES, ASSET_SCOPES, ASSET_UNINSTALL_POLICIES, ASSET_ROLLBACK_POLICIES, INSTRUCTIONS_DOMAIN_ARCHIVE_SCHEMA, ConfigNotFoundError, ProfileNotFoundError, ConfigApplyError, parseTemplateVars, extractTemplateVars, renderTemplate, renderTemplatePreview, isTemplate };

package/dist/chunks/{index-e9epbsvs.js → index-z3ma4aqk.js}

@@ -18,15 +18,15 @@ import {
   resolveProfileVariables,
   scanSecrets,
   stampCursorGlobalAuthorityMarker
-} from "./index-1hpwskwd.js";
+} from "./index-7m4j8a33.js";
 import {
   ConfigApplyError,
   parseTemplateVars
-} from "./index-pkscjnj5.js";
+} from "./index-n3fjspr0.js";
 
 // src/lib/apply.ts
 import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, realpathSync, writeFileSync } from "fs";
-import { basename, dirname as dirname2, join as join2, resolve } from "path";
+import { basename, dirname as dirname2, isAbsolute, join as join2, relative as relative2, resolve, sep as sep2 } from "path";
 import { homedir } from "os";
 
 // src/lib/session-render-ownership.ts
@@ -110,6 +110,17 @@ function expandPath(p) {
   }
   return resolve(p);
 }
+function compactPathForConfigHome(p) {
+  const absolute = resolve(p);
+  const configHome = resolve(getConfigHome());
+  const conventionalHome = resolve(process.env["HOME"] || homedir());
+  if (configHome !== conventionalHome)
+    return absolute;
+  const rel = relative2(configHome, absolute);
+  if (!rel || rel === ".." || rel.startsWith(`..${sep2}`) || isAbsolute(rel))
+    return absolute;
+  return `~/${rel}`;
+}
 function normalizeTargetPath(p) {
   const expanded = expandPath(p);
   try {
@@ -518,4 +529,4 @@ function sessionRendererOwnsCanonicalTarget(normalized, opts) {
   return sessionRenderOwnsPath(normalized);
 }
 
-export { getConfigHome, expandPath, normalizeTargetPath, applyConfig, applyConfigs, applyConfigsWithReport, previewConfigs };
+export { getConfigHome, expandPath, compactPathForConfigHome, normalizeTargetPath, applyConfig, applyConfigs, applyConfigsWithReport, previewConfigs };