@jitsusama/agentic-harness.core 0.1.0

package/dist/prose/gate.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The prose gate: a thin adapter over the shared loop breaker in
+ * lib/gate. It supplies the prose-specific block formatting and
+ * relent wording; the block-first, relent-on-repeat mechanism
+ * lives in decideGate so prose and sections share one behaviour.
+ */
+import { type GateDecision, violationSignature } from "../gate/index.js";
+import type { ProseViolation } from "./detect.js";
+/** Re-exported so the prose barrel exposes one signature helper. */
+export { violationSignature };
+/** The gate's verdict on one body of prose. */
+export type ProseGateDecision = GateDecision;
+/** Decide whether to block, relent or allow given prior block signatures. */
+export declare function proseGateDecision(violations: ProseViolation[], priorSignatures: string[], artifact: string): ProseGateDecision;

package/dist/prose/gate.js

@@ -0,0 +1,21 @@
+/**
+ * The prose gate: a thin adapter over the shared loop breaker in
+ * lib/gate. It supplies the prose-specific block formatting and
+ * relent wording; the block-first, relent-on-repeat mechanism
+ * lives in decideGate so prose and sections share one behaviour.
+ */
+import { decideGate, violationSignature, } from "../gate/index.js";
+import { formatProseBlock } from "./block.js";
+/** Re-exported so the prose barrel exposes one signature helper. */
+export { violationSignature };
+const RELENT_PREFIX = [
+    "This text still breaks prose-standard after a previous attempt,",
+    "so it is being let through rather than blocked again. The",
+    "author could not satisfy the rule automatically; review the",
+    "remaining violations yourself:",
+    "",
+].join("\n");
+/** Decide whether to block, relent or allow given prior block signatures. */
+export function proseGateDecision(violations, priorSignatures, artifact) {
+    return decideGate(violations, priorSignatures, formatProseBlock, RELENT_PREFIX, artifact);
+}

package/dist/prose/index.d.ts

@@ -0,0 +1,4 @@
+export { formatProseBlock } from "./block.js";
+export { detectProseViolations, type ProseViolation } from "./detect.js";
+export { type ProseGateDecision, proseGateDecision, violationSignature, } from "./gate.js";
+export { wrapProse } from "./wrap.js";

package/dist/prose/index.js

@@ -0,0 +1,4 @@
+export { formatProseBlock } from "./block.js";
+export { detectProseViolations } from "./detect.js";
+export { proseGateDecision, violationSignature, } from "./gate.js";
+export { wrapProse } from "./wrap.js";

package/dist/prose/wrap.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Wrap prose to the column rule, preserving paragraphs and leaving
+ * alone the lines the rule exempts.
+ *
+ * A word longer than the width still goes on its own line and still
+ * overflows, because breaking it would change what it says. The rule
+ * is about where lines end, not about truncating text.
+ */
+export declare function wrapProse(text: string, width?: number): string;

package/dist/prose/wrap.js

@@ -0,0 +1,47 @@
+/** The column rule prose in this package is held to. */
+const DEFAULT_WIDTH = 80;
+/**
+ * Lines the column rule exempts, which reflowing would damage rather
+ * than tidy. A table row means the pipes, and a fenced block's
+ * contents are code whose line breaks carry meaning.
+ */
+function reflowable(line) {
+    const trimmed = line.trimStart();
+    return !(trimmed.startsWith("|") || trimmed.startsWith("```"));
+}
+/** Greedily fill lines up to `width`, never splitting a word. */
+function fill(paragraph, width) {
+    const lines = [];
+    let current = "";
+    for (const word of paragraph.split(/\s+/).filter(Boolean)) {
+        if (!current) {
+            current = word;
+        }
+        else if (current.length + 1 + word.length <= width) {
+            current = `${current} ${word}`;
+        }
+        else {
+            lines.push(current);
+            current = word;
+        }
+    }
+    if (current)
+        lines.push(current);
+    return lines.join("\n");
+}
+/**
+ * Wrap prose to the column rule, preserving paragraphs and leaving
+ * alone the lines the rule exempts.
+ *
+ * A word longer than the width still goes on its own line and still
+ * overflows, because breaking it would change what it says. The rule
+ * is about where lines end, not about truncating text.
+ */
+export function wrapProse(text, width = DEFAULT_WIDTH) {
+    return text
+        .split(/\n{2,}/)
+        .map((paragraph) => paragraph.split("\n").every(reflowable)
+        ? fill(paragraph, width)
+        : paragraph)
+        .join("\n\n");
+}

package/dist/quest/actions.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Canonical verb registry for the quest tool.
+ *
+ * One source of truth that the schema description and the
+ * dispatcher's "unknown action" refusal both read from.
+ * Aliases (like `status` for `show`) are listed alongside
+ * the canonical names so an agent who reaches for the
+ * alias gets routed cleanly, and an agent who types a
+ * near-miss gets a Levenshtein-based suggestion.
+ */
+/** Every action name the tool accepts. */
+export declare const QUEST_ACTIONS: readonly ["create", "load", "unload", "show", "status", "config", "list", "tree", "tree-add", "tree-adopt", "tree-list", "tree-prune", "tree-expand", "expand", "focus", "unfocus", "think", "draft", "build", "conclude", "retire", "reopen", "promote", "demote", "drive", "park", "defer", "reclassify", "top", "bottom", "bump", "sink", "before", "after", "renumber", "reparent", "undo", "alias-add", "alias-remove", "session-attach", "session-detach", "session-rename", "spawn-tab", "spawn-pane", "spawn-window", "find", "who", "links", "locate", "ancestors", "workspace", "recent", "restore", "session-audit"];
+/** Static type of any canonical action. */
+export type QuestAction = (typeof QUEST_ACTIONS)[number];
+/**
+ * Suggest the nearest canonical action to a user's typo
+ * using Levenshtein distance. Returns `undefined` when no
+ * candidate is closer than the cap.
+ */
+export declare function suggestAction(typed: string): string | undefined;

package/dist/quest/actions.js

@@ -0,0 +1,107 @@
+/**
+ * Canonical verb registry for the quest tool.
+ *
+ * One source of truth that the schema description and the
+ * dispatcher's "unknown action" refusal both read from.
+ * Aliases (like `status` for `show`) are listed alongside
+ * the canonical names so an agent who reaches for the
+ * alias gets routed cleanly, and an agent who types a
+ * near-miss gets a Levenshtein-based suggestion.
+ */
+/** Every action name the tool accepts. */
+export const QUEST_ACTIONS = [
+    "create",
+    "load",
+    "unload",
+    "show",
+    "status",
+    "config",
+    "list",
+    "tree",
+    "tree-add",
+    "tree-adopt",
+    "tree-list",
+    "tree-prune",
+    "tree-expand",
+    "expand",
+    "focus",
+    "unfocus",
+    "think",
+    "draft",
+    "build",
+    "conclude",
+    "retire",
+    "reopen",
+    "promote",
+    "demote",
+    "drive",
+    "park",
+    "defer",
+    "reclassify",
+    "top",
+    "bottom",
+    "bump",
+    "sink",
+    "before",
+    "after",
+    "renumber",
+    "reparent",
+    "undo",
+    "alias-add",
+    "alias-remove",
+    "session-attach",
+    "session-detach",
+    "session-rename",
+    "spawn-tab",
+    "spawn-pane",
+    "spawn-window",
+    "find",
+    "who",
+    "links",
+    "locate",
+    "ancestors",
+    "workspace",
+    "recent",
+    "restore",
+    "session-audit",
+];
+/**
+ * Suggest the nearest canonical action to a user's typo
+ * using Levenshtein distance. Returns `undefined` when no
+ * candidate is closer than the cap.
+ */
+export function suggestAction(typed) {
+    const cap = Math.max(2, Math.floor(typed.length / 2));
+    let best;
+    for (const action of QUEST_ACTIONS) {
+        const distance = levenshtein(typed, action);
+        if (distance > cap)
+            continue;
+        if (!best || distance < best.distance) {
+            best = { action, distance };
+        }
+    }
+    return best?.action;
+}
+function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    const prev = new Array(b.length + 1);
+    const curr = new Array(b.length + 1);
+    for (let j = 0; j <= b.length; j++)
+        prev[j] = j;
+    for (let i = 1; i <= a.length; i++) {
+        curr[0] = i;
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
+        }
+        for (let j = 0; j <= b.length; j++)
+            prev[j] = curr[j];
+    }
+    return prev[b.length];
+}

package/dist/quest/config.d.ts

@@ -0,0 +1,79 @@
+/**
+ * The quest-workflow section of the package configuration.
+ *
+ * The extension owns its own section schema and defaults. Unlike
+ * agentic-harness.pi, this package has no single package-config
+ * envelope of its own to key a section into, so `SectionParse` is
+ * defined locally instead of imported from a config loader -- the
+ * shape is generic enough that duplicating the one-line type is
+ * cheaper than a dependency on a file envelope this package does
+ * not have.
+ */
+/** An extension's parser for its own config section. */
+export type SectionParse<T> = (value: unknown) => {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: string;
+};
+/** Section key for this extension in the package config file. */
+export declare const QUEST_WORKFLOW_SLUG = "quest-workflow";
+/** User-settable quest-workflow configuration. */
+export interface QuestWorkflowConfig {
+    /** Where the quest tree lives; defaults to the data dir. */
+    questsRoot?: string;
+    /**
+     * Whether a fresh session may auto-load a quest from its
+     * working directory at session start. Defaults to true, the
+     * cd-into-a-tree-and-attach flow. Set false to keep fresh
+     * sessions idle until an explicit `quest load`; /reload
+     * restore and spawn hints still work.
+     */
+    autoloadFromCwd?: boolean;
+    /**
+     * How many days a closed session record is kept before being
+     * forgotten. Defaults to {@link DEFAULT_SESSION_RETENTION_DAYS}.
+     * A record still open is never forgotten whatever this says,
+     * since a tab that outlives the window is still a tab.
+     */
+    sessionRetentionDays?: number;
+}
+/**
+ * How long a closed session record is kept by default.
+ *
+ * Long enough to cover coming back from a week away and still find
+ * what was open, with room for the weekend either side. The records
+ * are small and one per session, so the cost of the window is
+ * negligible next to the cost of having pruned something the user
+ * still wanted.
+ */
+export declare const DEFAULT_SESSION_RETENTION_DAYS = 30;
+/** Parse the quest-workflow section, defaulting an absent section to empty. */
+export declare const parseQuestWorkflowConfig: SectionParse<QuestWorkflowConfig>;
+/**
+ * Resolve the on-disk quests root: the configured questsRoot when
+ * set, otherwise a `quests` directory under the extension's data dir.
+ */
+export declare function resolveQuestsRoot(config: QuestWorkflowConfig, dataDir: string): string;
+/** Effective quest-workflow config with provenance for the query verb. */
+export interface QuestConfigSummary {
+    configPath: string;
+    questsRoot: string;
+    questsRootSource: "config" | "default";
+    autoloadFromCwd: boolean;
+    autoloadFromCwdSource: "config" | "default";
+    sessionRetentionDays: number;
+    sessionRetentionDaysSource: "config" | "default";
+}
+/**
+ * Summarize the effective configuration for the config query
+ * verb: the file the values come from, the resolved quests root,
+ * and whether that root was set in the file or fell back to the
+ * built-in default.
+ */
+export declare function summarizeQuestConfig(opts: {
+    config: QuestWorkflowConfig;
+    configPath: string;
+    dataDir: string;
+}): QuestConfigSummary;

package/dist/quest/config.js

@@ -0,0 +1,83 @@
+/**
+ * The quest-workflow section of the package configuration.
+ *
+ * The extension owns its own section schema and defaults. Unlike
+ * agentic-harness.pi, this package has no single package-config
+ * envelope of its own to key a section into, so `SectionParse` is
+ * defined locally instead of imported from a config loader -- the
+ * shape is generic enough that duplicating the one-line type is
+ * cheaper than a dependency on a file envelope this package does
+ * not have.
+ */
+import { join } from "node:path";
+/** Section key for this extension in the package config file. */
+export const QUEST_WORKFLOW_SLUG = "quest-workflow";
+/**
+ * How long a closed session record is kept by default.
+ *
+ * Long enough to cover coming back from a week away and still find
+ * what was open, with room for the weekend either side. The records
+ * are small and one per session, so the cost of the window is
+ * negligible next to the cost of having pruned something the user
+ * still wanted.
+ */
+export const DEFAULT_SESSION_RETENTION_DAYS = 30;
+/** Parse the quest-workflow section, defaulting an absent section to empty. */
+export const parseQuestWorkflowConfig = (value) => {
+    if (value === undefined)
+        return { ok: true, value: {} };
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return { ok: false, error: "quest-workflow config must be an object" };
+    }
+    const record = value;
+    const questsRoot = record.questsRoot;
+    if (questsRoot !== undefined && typeof questsRoot !== "string") {
+        return { ok: false, error: "questsRoot must be a string" };
+    }
+    const autoloadFromCwd = record.autoloadFromCwd;
+    if (autoloadFromCwd !== undefined && typeof autoloadFromCwd !== "boolean") {
+        return { ok: false, error: "autoloadFromCwd must be a boolean" };
+    }
+    const retention = record.sessionRetentionDays;
+    if (retention !== undefined &&
+        (typeof retention !== "number" ||
+            !Number.isFinite(retention) ||
+            retention <= 0)) {
+        return {
+            ok: false,
+            error: "sessionRetentionDays must be a positive number of days",
+        };
+    }
+    const parsed = {};
+    if (questsRoot !== undefined)
+        parsed.questsRoot = questsRoot;
+    if (autoloadFromCwd !== undefined)
+        parsed.autoloadFromCwd = autoloadFromCwd;
+    if (retention !== undefined)
+        parsed.sessionRetentionDays = retention;
+    return { ok: true, value: parsed };
+};
+/**
+ * Resolve the on-disk quests root: the configured questsRoot when
+ * set, otherwise a `quests` directory under the extension's data dir.
+ */
+export function resolveQuestsRoot(config, dataDir) {
+    return config.questsRoot ?? join(dataDir, "quests");
+}
+/**
+ * Summarize the effective configuration for the config query
+ * verb: the file the values come from, the resolved quests root,
+ * and whether that root was set in the file or fell back to the
+ * built-in default.
+ */
+export function summarizeQuestConfig(opts) {
+    return {
+        configPath: opts.configPath,
+        questsRoot: resolveQuestsRoot(opts.config, opts.dataDir),
+        questsRootSource: opts.config.questsRoot !== undefined ? "config" : "default",
+        autoloadFromCwd: opts.config.autoloadFromCwd ?? true,
+        autoloadFromCwdSource: opts.config.autoloadFromCwd !== undefined ? "config" : "default",
+        sessionRetentionDays: opts.config.sessionRetentionDays ?? DEFAULT_SESSION_RETENTION_DAYS,
+        sessionRetentionDaysSource: opts.config.sessionRetentionDays !== undefined ? "config" : "default",
+    };
+}

package/dist/quest/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Public surface of the quest library.
+ *
+ * Pure data model: ID minting, frontmatter parsing,
+ * scaffolding, TOC generation and the pluggable URL-hint
+ * fetchers.
+ *
+ * This used to claim a pr-workflow bridge registration
+ * surface as well, "the one cross-extension hook downstream
+ * packages need". No such thing was exported, and the
+ * extension it named has been deleted; the round writer it
+ * pointed at went with it, having ended up with no reader
+ * but its own test. Both sentences are gone rather than
+ * reworded, because a barrel comment describing exports
+ * that are not there is worse than no comment.
+ *
+ * Discovery, alias indexing and mention indexing live under
+ * `lib/internal/quest/` and are not part of this barrel.
+ * They are consumed by `extensions/quest-workflow`
+ * directly. If a downstream package needs them, promote the
+ * specific function here intentionally.
+ */
+export { documentFrontMatterProblem, parseDocumentFrontMatter, parseQuestFrontMatter, serializeDocumentFrontMatter, serializeQuestFrontMatter, splitFrontMatter, } from "../internal/quest/frontmatter.js";
+export { dateOf, findIds, findIdsWithRelation, ID_PREFIXES, type IdMention, type IdMentionRelation, type IdPrefix, isId, mintId, prefixOf, } from "../internal/quest/id.js";
+export { checkboxProgress, type ExtractedMentions, extractCast, extractJourney, extractMentions, extractSection, extractSectionParagraph, extractTitle, milestoneProgress, parseQuestDoc, projectQuestForShow, type QuestShowProjection, } from "../internal/quest/quest-doc.js";
+export { type DocumentScaffoldInput, defaultsForKind, type QuestScaffoldInput, scaffoldDocument, scaffoldQuestReadme, } from "../internal/quest/scaffold.js";
+export { renderToc } from "../internal/quest/toc.js";
+export { clearUrlFetchers, fetchUrlHints, getUrlFetcher, listUrlFetchers, registerBuiltinUrlFetchers, registerUrlFetcher, type SeedHints, type UrlFetcher, unregisterUrlFetcher, } from "../internal/quest/url-fetchers.js";
+export type { CastEntry, DocumentFrontMatter, DocumentKind, DocumentStage, JourneyEntry, PendingPrune, QuestAlias, QuestDoc, QuestDocumentDoc, QuestFrontMatter, QuestKind, QuestPriority, QuestSession, QuestStatus, QuestTree, SessionStatus, } from "./types.js";

package/dist/quest/index.js

@@ -0,0 +1,28 @@
+/**
+ * Public surface of the quest library.
+ *
+ * Pure data model: ID minting, frontmatter parsing,
+ * scaffolding, TOC generation and the pluggable URL-hint
+ * fetchers.
+ *
+ * This used to claim a pr-workflow bridge registration
+ * surface as well, "the one cross-extension hook downstream
+ * packages need". No such thing was exported, and the
+ * extension it named has been deleted; the round writer it
+ * pointed at went with it, having ended up with no reader
+ * but its own test. Both sentences are gone rather than
+ * reworded, because a barrel comment describing exports
+ * that are not there is worse than no comment.
+ *
+ * Discovery, alias indexing and mention indexing live under
+ * `lib/internal/quest/` and are not part of this barrel.
+ * They are consumed by `extensions/quest-workflow`
+ * directly. If a downstream package needs them, promote the
+ * specific function here intentionally.
+ */
+export { documentFrontMatterProblem, parseDocumentFrontMatter, parseQuestFrontMatter, serializeDocumentFrontMatter, serializeQuestFrontMatter, splitFrontMatter, } from "../internal/quest/frontmatter.js";
+export { dateOf, findIds, findIdsWithRelation, ID_PREFIXES, isId, mintId, prefixOf, } from "../internal/quest/id.js";
+export { checkboxProgress, extractCast, extractJourney, extractMentions, extractSection, extractSectionParagraph, extractTitle, milestoneProgress, parseQuestDoc, projectQuestForShow, } from "../internal/quest/quest-doc.js";
+export { defaultsForKind, scaffoldDocument, scaffoldQuestReadme, } from "../internal/quest/scaffold.js";
+export { renderToc } from "../internal/quest/toc.js";
+export { clearUrlFetchers, fetchUrlHints, getUrlFetcher, listUrlFetchers, registerBuiltinUrlFetchers, registerUrlFetcher, unregisterUrlFetcher, } from "../internal/quest/url-fetchers.js";