narai-primitives 2.0.0-rc.1

package/dist/toolkit/hardship/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/toolkit/hardship/scope.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,QAAQ,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACjC;AAED,MAAM,MAAM,SAAS,GAAG,IAAI,EAAE,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,SAAS,CAiCzE"}

package/dist/toolkit/hardship/scope.js

@@ -0,0 +1,56 @@
+/**
+ * scope.ts — tenant-scope hashing + 4-tier path resolution for the
+ * self-improvement loop.
+ *
+ * Paths:
+ *   tier 1 (most specific):  <cwd>/.claude/connectors/<conn>/tenants/<hash>/
+ *   tier 2:                  <cwd>/.claude/connectors/<conn>/global/
+ *   tier 3:                  <home>/.claude/connectors/<conn>/tenants/<hash>/
+ *   tier 4 (least specific): <home>/.claude/connectors/<conn>/global/
+ *
+ * Match walks tier 1 → 4 returning the first hit. Write goes to the
+ * most specific tier that "exists" (has <cwd>/.claude/).
+ */
+import { createHash } from "node:crypto";
+import * as path from "node:path";
+/**
+ * 16-char hex sha256 prefix. Stable across processes, short enough for
+ * filesystem paths, collision probability negligible for O(100) tenants.
+ */
+export function hashScopeKey(key) {
+    return createHash("sha256").update(key).digest("hex").slice(0, 16);
+}
+export function resolveTierPaths(opts) {
+    const { connector, scope, cwd, home } = opts;
+    const tiers = [];
+    const projectRoot = path.join(cwd, ".claude/connectors", connector);
+    const userRoot = path.join(home, ".claude/connectors", connector);
+    if (scope !== null) {
+        const hash = hashScopeKey(scope);
+        tiers.push({
+            name: "project-tenant",
+            dir: path.join(projectRoot, "tenants", hash),
+            scopeLevel: "tenant",
+        });
+    }
+    tiers.push({
+        name: "project-global",
+        dir: path.join(projectRoot, "global"),
+        scopeLevel: "global",
+    });
+    if (scope !== null) {
+        const hash = hashScopeKey(scope);
+        tiers.push({
+            name: "user-tenant",
+            dir: path.join(userRoot, "tenants", hash),
+            scopeLevel: "tenant",
+        });
+    }
+    tiers.push({
+        name: "user-global",
+        dir: path.join(userRoot, "global"),
+        scopeLevel: "global",
+    });
+    return tiers;
+}
+//# sourceMappingURL=scope.js.map

package/dist/toolkit/hardship/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../../src/toolkit/hardship/scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAgBlC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC;AASD,MAAM,UAAU,gBAAgB,CAAC,IAA6B;IAC5D,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAC7C,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAoB,EAAE,SAAS,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,oBAAoB,EAAE,SAAS,CAAC,CAAC;IAElE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,gBAAgB;YACtB,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC;YAC5C,UAAU,EAAE,QAAQ;SACrB,CAAC,CAAC;IACL,CAAC;IACD,KAAK,CAAC,IAAI,CAAC;QACT,IAAI,EAAE,gBAAgB;QACtB,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC;QACrC,UAAU,EAAE,QAAQ;KACrB,CAAC,CAAC;IACH,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,aAAa;YACnB,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC;YACzC,UAAU,EAAE,QAAQ;SACrB,CAAC,CAAC;IACL,CAAC;IACD,KAAK,CAAC,IAAI,CAAC;QACT,IAAI,EAAE,aAAa;QACnB,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAClC,UAAU,EAAE,QAAQ;KACrB,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/toolkit/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @narai/connector-toolkit — framework for agent-connector packages.
+ *
+ * Primary API:
+ *   - `createConnector` — build a connector from an action registry with
+ *     built-in CLI harness, approval gate, audit, and hardship logging.
+ *
+ * Secondary helpers (shipped for advanced use and by pre-2.0 consumers):
+ *   - `parseAgentArgs` — raw CLI flag parser.
+ *   - `fetchWithCaps` — size/timeout-capped fetch.
+ *   - `validateUrl`, `checkPathContainment`, `sanitizeLabel` — security primitives.
+ *
+ * Credentials remain external; depend on `@narai/credential-providers` directly.
+ */
+export { EnvelopeOverride, createConnector, defineAction, type ActionSpec, type Connector, type ConnectorConfig, type Context, type Credentials, type DecisionContext, } from "./connector.js";
+export { DECISION_RANK, DEFAULT_POLICY, type ApprovalMode, type Classification, type Decision, type DeniedEnvelope, type Envelope, type ErrorCode, type ErrorEnvelope, type EscalateEnvelope, type ExtendedEnvelope, type Kind, type PolicyRules, type ResolutionHint, type RestrictedRule, type Rule, type SuccessEnvelope, } from "./policy/types.js";
+export { checkPolicy, combineDecisions, type ApprovalState, } from "./policy/gate.js";
+export { deepMerge, discoverConfigPaths, loadPolicyConfig, validatePolicyConfig, type DiscoveredPaths, type LoadedPolicy, type LoadPolicyConfigOptions, } from "./policy/config.js";
+export { ApprovalEngine } from "./policy/approval.js";
+export { createAuditWriter, scrubSecrets, type AuditWriter, type AuditWriterOptions, } from "./audit/writer.js";
+export { type ActionEvent, type AuditEvent, type BaseEvent, type GrantEvent, type HardshipEvent, type PolicyEvent, } from "./audit/events.js";
+export { createHardshipRecorder, resolveHardshipPath, type HardshipEntry, type HardshipInput, type HardshipRecorder, type HardshipWriterOptions, } from "./hardship/record.js";
+export { countRawHardships, readCuratedHardships, readRawHardships, type ReadOptions, } from "./hardship/read.js";
+export { clusterHardships, entriesSinceLastCuration, normalizeContext, readCurationMarker, writeCurationMarker, type CurationMarker, type HardshipCluster, } from "./hardship/curate.js";
+export { DEFAULT_PREFS, prefsPath, readPrefs, setEnabled, setSkipDays, writePrefs, type CurationPrefs, } from "./plugin/prefs.js";
+export { evaluateNudge, printNudgeIfNeeded, type NudgeContext, type NudgeDecision, } from "./plugin/reminder.js";
+export { buildCurateSnapshot, type CurateCommandOptions, type CurateSnapshot, } from "./plugin/curate-cmd.js";
+export { parseAgentArgs, type FlagSpec, type ParsedAgentArgs, } from "./agent_cli.js";
+export { FETCH_MAX_BYTES_DEFAULT, FETCH_TIMEOUT_MS_DEFAULT, FetchCapExceeded, fetchWithCaps, type FetchCapsOptions, } from "./fetch_helper.js";
+export { validateUrl, checkPathContainment, sanitizeLabel, } from "./security_check.js";
+export { importOptional, isBinaryOnPath } from "./_optional.js";
+export { extract as extractBinary, extractPdf, extractDocx, extractPptx, normalizeExtracted, ExtractCapExceeded, FORMAT_MAP, type BinaryFormat, type ExtractOptions, type ExtractResult, } from "./extract_binary.js";
+export { dispatchMultimodal, type MultimodalConfig, type MultimodalFormat, type MultimodalMode, type MultimodalResult, } from "./extract_multimodal.js";
+export { fetchAttachment, type FetchAttachmentOptions, type FetchAttachmentResult, } from "./fetch_attachment.js";
+export { hashScopeKey, resolveTierPaths, type Tier, type TierPaths, type TierName, } from "./hardship/scope.js";
+export { loadPatterns, matchPattern, type Pattern, type PatternsFile, type PatternMatcher, type HardshipFacts, type MatchedPattern, } from "./hardship/patterns.js";
+export { readFirstMatchingPattern, type ReadFirstMatchingPatternOptions, type TierMatch, } from "./hardship/read.js";
+export { renderSkillPreamble, type RenderSkillPreambleOptions, } from "./hardship/preamble.js";
+export * as usage from "./usage/index.js";
+export { resolveAgentCli, type ResolveAgentCliOptions, type ResolvedAgentCli, type ResolutionSource, } from "./agent_resolver.js";
+export { loadGuardrailManifest, findBlockingRule, defaultDenyMessage, type GuardrailRule, type GuardrailManifest, type BlockMatch, } from "./guardrail.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/toolkit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/toolkit/index.ts"],"names":[],"mappings":"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"}

package/dist/toolkit/index.js

@@ -0,0 +1,51 @@
+/**
+ * @narai/connector-toolkit — framework for agent-connector packages.
+ *
+ * Primary API:
+ *   - `createConnector` — build a connector from an action registry with
+ *     built-in CLI harness, approval gate, audit, and hardship logging.
+ *
+ * Secondary helpers (shipped for advanced use and by pre-2.0 consumers):
+ *   - `parseAgentArgs` — raw CLI flag parser.
+ *   - `fetchWithCaps` — size/timeout-capped fetch.
+ *   - `validateUrl`, `checkPathContainment`, `sanitizeLabel` — security primitives.
+ *
+ * Credentials remain external; depend on `@narai/credential-providers` directly.
+ */
+// ─── Primary API ───────────────────────────────────────────────────────────
+export { EnvelopeOverride, createConnector, defineAction, } from "./connector.js";
+// ─── Policy types / engine ─────────────────────────────────────────────────
+export { DECISION_RANK, DEFAULT_POLICY, } from "./policy/types.js";
+export { checkPolicy, combineDecisions, } from "./policy/gate.js";
+export { deepMerge, discoverConfigPaths, loadPolicyConfig, validatePolicyConfig, } from "./policy/config.js";
+export { ApprovalEngine } from "./policy/approval.js";
+// ─── Audit ─────────────────────────────────────────────────────────────────
+export { createAuditWriter, scrubSecrets, } from "./audit/writer.js";
+// ─── Hardship ──────────────────────────────────────────────────────────────
+export { createHardshipRecorder, resolveHardshipPath, } from "./hardship/record.js";
+export { countRawHardships, readCuratedHardships, readRawHardships, } from "./hardship/read.js";
+export { clusterHardships, entriesSinceLastCuration, normalizeContext, readCurationMarker, writeCurationMarker, } from "./hardship/curate.js";
+// ─── Plugin helpers ────────────────────────────────────────────────────────
+export { DEFAULT_PREFS, prefsPath, readPrefs, setEnabled, setSkipDays, writePrefs, } from "./plugin/prefs.js";
+export { evaluateNudge, printNudgeIfNeeded, } from "./plugin/reminder.js";
+export { buildCurateSnapshot, } from "./plugin/curate-cmd.js";
+// ─── Legacy helpers (still exported) ───────────────────────────────────────
+export { parseAgentArgs, } from "./agent_cli.js";
+export { FETCH_MAX_BYTES_DEFAULT, FETCH_TIMEOUT_MS_DEFAULT, FetchCapExceeded, fetchWithCaps, } from "./fetch_helper.js";
+export { validateUrl, checkPathContainment, sanitizeLabel, } from "./security_check.js";
+// ─── Binary + attachment helpers (added in 2.1) ────────────────────────────
+export { importOptional, isBinaryOnPath } from "./_optional.js";
+export { extract as extractBinary, extractPdf, extractDocx, extractPptx, normalizeExtracted, ExtractCapExceeded, FORMAT_MAP, } from "./extract_binary.js";
+export { dispatchMultimodal, } from "./extract_multimodal.js";
+export { fetchAttachment, } from "./fetch_attachment.js";
+// ─── Self-improvement layer (added in 3.0) ───────────────────────────────
+export { hashScopeKey, resolveTierPaths, } from "./hardship/scope.js";
+export { loadPatterns, matchPattern, } from "./hardship/patterns.js";
+export { readFirstMatchingPattern, } from "./hardship/read.js";
+export { renderSkillPreamble, } from "./hardship/preamble.js";
+// ─── Usage tracking (added in 3.1) ───────────────────────────────────────
+export * as usage from "./usage/index.js";
+// ─── Agent CLI resolution + guardrails (added in 3.3) ────────────────────
+export { resolveAgentCli, } from "./agent_resolver.js";
+export { loadGuardrailManifest, findBlockingRule, defaultDenyMessage, } from "./guardrail.js";
+//# sourceMappingURL=index.js.map

package/dist/toolkit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/toolkit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,8EAA8E;AAE9E,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,YAAY,GAOb,MAAM,gBAAgB,CAAC;AAExB,8EAA8E;AAE9E,OAAO,EACL,aAAa,EACb,cAAc,GAgBf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,gBAAgB,GAEjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GAIrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,8EAA8E;AAE9E,OAAO,EACL,iBAAiB,EACjB,YAAY,GAGb,MAAM,mBAAmB,CAAC;AAW3B,8EAA8E;AAE9E,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GAKpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,GAEjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GAGpB,MAAM,sBAAsB,CAAC;AAE9B,8EAA8E;AAE9E,OAAO,EACL,aAAa,EACb,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,UAAU,GAEX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,aAAa,EACb,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,mBAAmB,GAGpB,MAAM,wBAAwB,CAAC;AAEhC,8EAA8E;AAE9E,OAAO,EACL,cAAc,GAGf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,aAAa,GAEd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,8EAA8E;AAE9E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EACL,OAAO,IAAI,aAAa,EACxB,UAAU,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,GAIX,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,GAKnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,GAGhB,MAAM,uBAAuB,CAAC;AAE/B,4EAA4E;AAE5E,OAAO,EACL,YAAY,EACZ,gBAAgB,GAIjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,YAAY,GAMb,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,wBAAwB,GAGzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,mBAAmB,GAEpB,MAAM,wBAAwB,CAAC;AAEhC,4EAA4E;AAE5E,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,4EAA4E;AAE5E,OAAO,EACL,eAAe,GAIhB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GAInB,MAAM,gBAAgB,CAAC"}

package/dist/toolkit/plugin/curate-cmd.d.ts

@@ -0,0 +1,22 @@
+import { type HardshipCluster, type CurationMarker } from "../hardship/curate.js";
+export interface CurateSnapshot {
+    connector: string;
+    total_entries: number;
+    new_entries: number;
+    marker: CurationMarker;
+    clusters: HardshipCluster[];
+    curated_md: string;
+    paths: {
+        /** Absolute path to the MD file that the slash command should edit. */
+        target_md: string;
+        /** Absolute paths to every JSONL file read (project-local, user-global). */
+        read_from: string[];
+    };
+}
+export interface CurateCommandOptions {
+    connector: string;
+    cwd?: string;
+    home?: string;
+}
+export declare function buildCurateSnapshot(opts: CurateCommandOptions): CurateSnapshot;
+//# sourceMappingURL=curate-cmd.d.ts.map

package/dist/toolkit/plugin/curate-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curate-cmd.d.ts","sourceRoot":"","sources":["../../../src/toolkit/plugin/curate-cmd.ts"],"names":[],"mappings":"AAiBA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAI/B,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QACL,uEAAuE;QACvE,SAAS,EAAE,MAAM,CAAC;QAClB,4EAA4E;QAC5E,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,oBAAoB,GACzB,cAAc,CAsDhB"}

package/dist/toolkit/plugin/curate-cmd.js

@@ -0,0 +1,72 @@
+/**
+ * `/connector-curate` helper.
+ *
+ * Each connector CLI accepts a `--curate` flag (wired by the factory). When
+ * set, the CLI prints a JSON snapshot of uncurated hardship clusters plus
+ * the current curation marker to stdout and exits 0. The slash command's
+ * prompt text reads that JSON, proposes promotions into MD sections, asks
+ * the user to approve, and then edits the MD directly via Claude Code's
+ * Edit tool.
+ *
+ * The write-back (promoting approved clusters into semantic sections) is
+ * handled by Claude via Edit — NOT by this module. This keeps the curation
+ * logic in prompt-space where judgement and diffing are legible.
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { clusterHardships, entriesSinceLastCuration, readCurationMarker, } from "../hardship/curate.js";
+import { readCuratedHardships, readRawHardships } from "../hardship/read.js";
+import { resolveTierPaths } from "../hardship/scope.js";
+export function buildCurateSnapshot(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const home = opts.home ?? os.homedir();
+    const raw = readRawHardships(opts.connector, { cwd, home });
+    const curatedMd = readCuratedHardships(opts.connector, { cwd, home });
+    // Null-scope tier walk: project-global, user-global (most specific first).
+    const tiers = resolveTierPaths({
+        connector: opts.connector,
+        scope: null,
+        cwd,
+        home,
+    });
+    // Target MD = most-specific tier that's writable. project-global if
+    // <cwd>/.claude/ exists; else user-global.
+    const hasProject = fs.existsSync(path.join(cwd, ".claude"));
+    const targetTier = tiers.find((t) => (hasProject ? true : !t.name.startsWith("project-"))) ??
+        tiers[tiers.length - 1];
+    const targetMd = path.join(targetTier.dir, "hardships.md");
+    // Read the marker from the target file directly — `curatedMd` from
+    // `readCuratedHardships` prepends HTML comments which break frontmatter
+    // parsing. The target is where the next curation will write, so it's
+    // the authoritative source for the marker.
+    let targetMdRaw = "";
+    try {
+        targetMdRaw = fs.readFileSync(targetMd, "utf-8");
+    }
+    catch {
+        // Target doesn't exist yet; marker defaults apply.
+    }
+    const marker = readCurationMarker(targetMdRaw);
+    const since = entriesSinceLastCuration(raw, marker);
+    const clusters = clusterHardships(since);
+    const readFrom = [];
+    for (const t of tiers) {
+        const jsonl = path.join(t.dir, "hardships.jsonl");
+        if (fs.existsSync(jsonl))
+            readFrom.push(jsonl);
+    }
+    return {
+        connector: opts.connector,
+        total_entries: raw.length,
+        new_entries: since.length,
+        marker,
+        clusters,
+        curated_md: curatedMd,
+        paths: {
+            target_md: targetMd,
+            read_from: readFrom,
+        },
+    };
+}
+//# sourceMappingURL=curate-cmd.js.map

package/dist/toolkit/plugin/curate-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curate-cmd.js","sourceRoot":"","sources":["../../../src/toolkit/plugin/curate-cmd.ts"],"names":[],"mappings":"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"}

package/dist/toolkit/plugin/prefs.d.ts

@@ -0,0 +1,15 @@
+export interface CurationPrefs {
+    enabled: boolean;
+    min_new_entries: number;
+    max_days_since_curate: number;
+    /** ISO-8601 timestamp; banners are suppressed until `now > skip_until_ts`. */
+    skip_until_ts: string | null;
+}
+export declare const DEFAULT_PREFS: CurationPrefs;
+export declare function prefsPath(home?: string): string;
+export declare function readPrefs(home?: string): CurationPrefs;
+export declare function writePrefs(prefs: CurationPrefs, home?: string): void;
+/** Set `skip_until_ts` to `now + days` (or revert to `null` if `days <= 0`). */
+export declare function setSkipDays(days: number, now?: Date, home?: string): void;
+export declare function setEnabled(enabled: boolean, home?: string): void;
+//# sourceMappingURL=prefs.d.ts.map

package/dist/toolkit/plugin/prefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefs.d.ts","sourceRoot":"","sources":["../../../src/toolkit/plugin/prefs.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,8EAA8E;IAC9E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,aAAa,EAAE,aAK3B,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAqB,GAAG,MAAM,CAE7D;AAaD,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAqB,GAAG,aAAa,CAepE;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,MAAqB,GAC1B,IAAI,CAWN;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,IAAiB,EACtB,IAAI,GAAE,MAAqB,GAC1B,IAAI,CASN;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,MAAqB,GAC1B,IAAI,CAIN"}

package/dist/toolkit/plugin/prefs.js

@@ -0,0 +1,78 @@
+/**
+ * Curation preferences — user-global JSON at `~/.claude/connectors/curation-prefs.json`.
+ *
+ * Persists the throttle + enabled state for the curation-reminder banner.
+ * Writes are best-effort (ENOENT auto-creates parent dirs; any other error
+ * is swallowed so the SessionStart hook never blocks session startup).
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+export const DEFAULT_PREFS = {
+    enabled: true,
+    min_new_entries: 5,
+    max_days_since_curate: 7,
+    skip_until_ts: null,
+};
+export function prefsPath(home = os.homedir()) {
+    return path.join(home, ".claude", "connectors", "curation-prefs.json");
+}
+function isValidPrefs(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const o = v;
+    return (typeof o["enabled"] === "boolean" &&
+        typeof o["min_new_entries"] === "number" &&
+        typeof o["max_days_since_curate"] === "number" &&
+        (o["skip_until_ts"] === null || typeof o["skip_until_ts"] === "string"));
+}
+export function readPrefs(home = os.homedir()) {
+    const p = prefsPath(home);
+    let raw;
+    try {
+        raw = fs.readFileSync(p, "utf-8");
+    }
+    catch {
+        return { ...DEFAULT_PREFS };
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (isValidPrefs(parsed))
+            return parsed;
+    }
+    catch {
+        // fall through to defaults on parse error
+    }
+    return { ...DEFAULT_PREFS };
+}
+export function writePrefs(prefs, home = os.homedir()) {
+    const p = prefsPath(home);
+    try {
+        fs.mkdirSync(path.dirname(p), { recursive: true });
+        // Atomic write: write to sibling tmp file then rename.
+        const tmp = `${p}.${process.pid}.tmp`;
+        fs.writeFileSync(tmp, JSON.stringify(prefs, null, 2) + "\n", "utf-8");
+        fs.renameSync(tmp, p);
+    }
+    catch {
+        // best-effort
+    }
+}
+/** Set `skip_until_ts` to `now + days` (or revert to `null` if `days <= 0`). */
+export function setSkipDays(days, now = new Date(), home = os.homedir()) {
+    const prefs = readPrefs(home);
+    if (days <= 0) {
+        prefs.skip_until_ts = null;
+    }
+    else {
+        const target = new Date(now.getTime() + days * 24 * 60 * 60 * 1000);
+        prefs.skip_until_ts = target.toISOString();
+    }
+    writePrefs(prefs, home);
+}
+export function setEnabled(enabled, home = os.homedir()) {
+    const prefs = readPrefs(home);
+    prefs.enabled = enabled;
+    writePrefs(prefs, home);
+}
+//# sourceMappingURL=prefs.js.map

package/dist/toolkit/plugin/prefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefs.js","sourceRoot":"","sources":["../../../src/toolkit/plugin/prefs.ts"],"names":[],"mappings":"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"}

package/dist/toolkit/plugin/reminder.d.ts

@@ -0,0 +1,28 @@
+export interface NudgeContext {
+    /** Connector names to consider. */
+    connectors: readonly string[];
+    /** Override home (tests). */
+    home?: string;
+    /** Override cwd (tests). */
+    cwd?: string;
+    /** Override now (tests). */
+    now?: Date;
+}
+export interface NudgeDecision {
+    nudge: boolean;
+    banner: string;
+    reason: string;
+    triggered_by: Array<{
+        connector: string;
+        new_entries: number;
+        days_since_curate: number | null;
+    }>;
+}
+/**
+ * Pure-function evaluation. Returns a decision; caller prints the banner
+ * when `nudge` is true. Writes nothing.
+ */
+export declare function evaluateNudge(ctx: NudgeContext): NudgeDecision;
+/** Print the banner to stdout if the nudge fires. Used directly by hooks. */
+export declare function printNudgeIfNeeded(ctx: NudgeContext): void;
+//# sourceMappingURL=reminder.d.ts.map

package/dist/toolkit/plugin/reminder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder.d.ts","sourceRoot":"","sources":["../../../src/toolkit/plugin/reminder.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,KAAK,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;KAClC,CAAC,CAAC;CACJ;AAsBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,aAAa,CA+D9D;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAM1D"}

package/dist/toolkit/plugin/reminder.js

@@ -0,0 +1,103 @@
+/**
+ * SessionStart reminder. Checks thresholds + skip-state, emits one banner
+ * line if a nudge is warranted. Designed to be called from a connector's
+ * `plugin/hooks/hooks.json` SessionStart handler.
+ *
+ * Throttle: at most one banner per `skip_until_ts` window per user. The
+ * window updates only when the user invokes `/connector-curate skip`;
+ * reading this function repeatedly in-session is safe (idempotent).
+ */
+import { countRawHardships } from "../hardship/read.js";
+import { readCurationMarker } from "../hardship/curate.js";
+import { resolveTierPaths } from "../hardship/scope.js";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { readPrefs } from "./prefs.js";
+function daysBetween(a, b) {
+    return Math.abs(b.getTime() - a.getTime()) / (1000 * 60 * 60 * 24);
+}
+function readMdMarker(connector, cwd, home) {
+    // Walk global tiers (project-global, user-global) — curation writes to the
+    // same tier the writer routes null-scope entries into.
+    const tiers = resolveTierPaths({ connector, scope: null, cwd, home });
+    for (const t of tiers) {
+        const md = path.join(t.dir, "hardships.md");
+        try {
+            const contents = fs.readFileSync(md, "utf-8");
+            return readCurationMarker(contents);
+        }
+        catch {
+            // try next tier
+        }
+    }
+    return { last_curated_ts: null, last_curated_count: 0 };
+}
+/**
+ * Pure-function evaluation. Returns a decision; caller prints the banner
+ * when `nudge` is true. Writes nothing.
+ */
+export function evaluateNudge(ctx) {
+    const home = ctx.home ?? os.homedir();
+    const cwd = ctx.cwd ?? process.cwd();
+    const now = ctx.now ?? new Date();
+    const prefs = readPrefs(home);
+    if (!prefs.enabled) {
+        return { nudge: false, banner: "", reason: "disabled", triggered_by: [] };
+    }
+    if (prefs.skip_until_ts !== null) {
+        const skipUntil = new Date(prefs.skip_until_ts);
+        if (!Number.isNaN(skipUntil.getTime()) && now < skipUntil) {
+            return {
+                nudge: false,
+                banner: "",
+                reason: `skipped until ${prefs.skip_until_ts}`,
+                triggered_by: [],
+            };
+        }
+    }
+    const triggered = [];
+    let totalNew = 0;
+    for (const connector of ctx.connectors) {
+        const total = countRawHardships(connector, { cwd, home });
+        const marker = readMdMarker(connector, cwd, home);
+        const newCount = Math.max(0, total - marker.last_curated_count);
+        const days = marker.last_curated_ts !== null
+            ? daysBetween(new Date(marker.last_curated_ts), now)
+            : null;
+        const hitCount = newCount >= prefs.min_new_entries;
+        const hitDays = days !== null && days >= prefs.max_days_since_curate;
+        if (hitCount || hitDays) {
+            triggered.push({
+                connector,
+                new_entries: newCount,
+                days_since_curate: days,
+            });
+            totalNew += newCount;
+        }
+    }
+    if (triggered.length === 0) {
+        return {
+            nudge: false,
+            banner: "",
+            reason: "no connector met threshold",
+            triggered_by: [],
+        };
+    }
+    const connList = triggered.map((t) => t.connector).join(", ");
+    const banner = [
+        `[connectors] ${totalNew} uncurated hardships in ${connList}.`,
+        `            /connector-curate to review, /connector-curate skip for 1d,`,
+        `            skip --week for 7d, off to disable.`,
+    ].join("\n");
+    return { nudge: true, banner, reason: "threshold met", triggered_by: triggered };
+}
+/** Print the banner to stdout if the nudge fires. Used directly by hooks. */
+export function printNudgeIfNeeded(ctx) {
+    const d = evaluateNudge(ctx);
+    if (d.nudge) {
+        // eslint-disable-next-line no-console
+        console.log(d.banner);
+    }
+}
+//# sourceMappingURL=reminder.js.map

package/dist/toolkit/plugin/reminder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder.js","sourceRoot":"","sources":["../../../src/toolkit/plugin/reminder.ts"],"names":[],"mappings":"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"}

package/dist/toolkit/policy/approval.d.ts

@@ -0,0 +1,24 @@
+import type { ApprovalState } from "./gate.js";
+export declare class ApprovalEngine implements ApprovalState {
+    private _sessionApproved;
+    private readonly _grants;
+    private readonly _expiryLogged;
+    private readonly _onExpired;
+    constructor(opts?: {
+        onGrantExpired?: (grantType: string) => void;
+    });
+    get sessionApproved(): boolean;
+    /** Mark the session as approved (used by `confirm_once` mode). */
+    approveSession(): void;
+    /** Issue a time-limited grant, expiring `ttlSeconds` from now. */
+    addGrant(grantType: string, ttlSeconds?: number): void;
+    /** Revoke a grant if it exists. */
+    revokeGrant(grantType: string): void;
+    /**
+     * Is `grantType` currently active? Returns false for unknown or expired
+     * grants. On first observation that a grant has expired, invokes the
+     * `onGrantExpired` callback once (subsequent checks are silent).
+     */
+    hasActiveGrant(grantType: string): boolean;
+}
+//# sourceMappingURL=approval.d.ts.map

package/dist/toolkit/policy/approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../../src/toolkit/policy/approval.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,qBAAa,cAAe,YAAW,aAAa;IAClD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4C;gBAE3D,IAAI,GAAE;QAAE,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;KAAO;IAIvE,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,kEAAkE;IAClE,cAAc,IAAI,IAAI;IAItB,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,GAAG,IAAI;IAI3D,mCAAmC;IACnC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKpC;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAU3C"}

package/dist/toolkit/policy/approval.js

@@ -0,0 +1,56 @@
+/**
+ * Grant + session approval state machine.
+ *
+ * Lives in-process only: both session approval and grants are stored on the
+ * `ApprovalEngine` instance. A fresh CLI invocation always starts with no
+ * approvals, so `approval_mode: confirm_once` / `grant_required` are
+ * single-invocation gates — suitable for the agent-connector CLI's
+ * short-lived process model.
+ *
+ * Uses `performance.now()` (monotonic, process-relative) for grant expiry —
+ * not wall-clock, so DST jumps and clock skew don't affect active grants.
+ */
+import { performance } from "node:perf_hooks";
+export class ApprovalEngine {
+    _sessionApproved = false;
+    _grants = new Map(); // grantType → expiry (performance.now ms)
+    _expiryLogged = new Set(); // dedup log spam
+    _onExpired;
+    constructor(opts = {}) {
+        this._onExpired = opts.onGrantExpired;
+    }
+    get sessionApproved() {
+        return this._sessionApproved;
+    }
+    /** Mark the session as approved (used by `confirm_once` mode). */
+    approveSession() {
+        this._sessionApproved = true;
+    }
+    /** Issue a time-limited grant, expiring `ttlSeconds` from now. */
+    addGrant(grantType, ttlSeconds = 300) {
+        this._grants.set(grantType, performance.now() + ttlSeconds * 1000);
+    }
+    /** Revoke a grant if it exists. */
+    revokeGrant(grantType) {
+        this._grants.delete(grantType);
+        this._expiryLogged.delete(grantType);
+    }
+    /**
+     * Is `grantType` currently active? Returns false for unknown or expired
+     * grants. On first observation that a grant has expired, invokes the
+     * `onGrantExpired` callback once (subsequent checks are silent).
+     */
+    hasActiveGrant(grantType) {
+        const expiry = this._grants.get(grantType);
+        if (expiry === undefined)
+            return false;
+        if (performance.now() < expiry)
+            return true;
+        if (!this._expiryLogged.has(grantType)) {
+            this._expiryLogged.add(grantType);
+            this._onExpired?.(grantType);
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=approval.js.map

package/dist/toolkit/policy/approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../../src/toolkit/policy/approval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,MAAM,OAAO,cAAc;IACjB,gBAAgB,GAAG,KAAK,CAAC;IAChB,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,0CAA0C;IAC/E,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC,CAAG,iBAAiB;IACtD,UAAU,CAA4C;IAEvE,YAAY,OAAyD,EAAE;QACrE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC;IACxC,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,kEAAkE;IAClE,cAAc;QACZ,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC/B,CAAC;IAED,kEAAkE;IAClE,QAAQ,CAAC,SAAiB,EAAE,aAAqB,GAAG;QAClD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,IAAI,CAAC,CAAC;IACrE,CAAC;IAED,mCAAmC;IACnC,WAAW,CAAC,SAAiB;QAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,SAAiB;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACvC,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,MAAM;YAAE,OAAO,IAAI,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAClC,IAAI,CAAC,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}