dorfl 0.0.0 → 0.1.0

package/dist/install-ci.js

@@ -0,0 +1,363 @@
+/**
+ * The `install-ci` orchestrator (prd `runner-in-ci`, task
+ * `install-ci-core-and-github-adapter`): ties the provider-agnostic core
+ * (`install-ci-core.ts`) to a CI-provider adapter (the first being GitHub,
+ * `install-ci-github.ts`) through the {@link CIProviderContext} seam. It drives
+ * three paths from ONE config shape so they cannot diverge:
+ *
+ *   - the interactive WIZARD (prompts via the injectable {@link WizardPrompts}
+ *     seam — production wires readline; tests inject a deterministic stub);
+ *   - the non-interactive `--config <file>` path (loads the same shape, no prompts);
+ *   - `--export-config` (+ `--include-secrets`) which round-trips the gathered
+ *     config back to JSON.
+ *
+ * The artifacts (composite setup action + auth) are assembled by the core and
+ * written under `.fake/` in `--fake` snapshot mode (NEVER `.github/`, NO real
+ * secret), so the SAME inputs produce byte-identical output whether gathered
+ * interactively or from a config file (the equivalence the task pins).
+ */
+import { writeFileSync, readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { DEFAULT_HARNESS, loadCIConfigFile, resolveCIConfig, exportCIConfig, orchestrateSecrets, buildSetupArtifacts, writeArtifacts, } from './install-ci-core.js';
+import { installCIBranchProtectionStep, } from './install-ci-branch-protection.js';
+/**
+ * Run `install-ci`. Resolves the config (config-file path or the wizard), then
+ * either exports it (`--export-config`) or generates the artifacts. In `--fake`
+ * mode it writes to `.fake/` and sets NO real secret; otherwise it orchestrates
+ * the required secrets through the provider seam. Returns a structured result.
+ */
+export async function installCI(options) {
+    const log = options.log ?? ((line) => console.log(line));
+    const fake = options.fake ?? false;
+    // 1. Resolve the config: the config-file path (no prompts) or the wizard.
+    let file;
+    let knownSecrets;
+    if (options.configFile) {
+        file = loadCIConfigFile(options.configFile);
+        knownSecrets = file.secrets;
+    }
+    else {
+        if (!options.prompts) {
+            throw new Error('install-ci: an interactive run needs a prompt seam (or pass --config)');
+        }
+        file = await runWizard(options.prompts);
+    }
+    const config = resolveCIConfig(file);
+    // An EXPLICIT --install-source flag wins over the config file's value and is
+    // folded in BEFORE the export so it round-trips through --export-config. The
+    // package.json AUTO-DETECTION (below) is applied AFTER the export early-return
+    // instead, so it is NOT baked into an exported config (a consumer re-running
+    // from that export must not silently inherit the monorepo's workspace mode).
+    const explicitInstallSource = options.installSource ?? file.installSource ?? undefined;
+    if (options.installSource) {
+        config.installSource = options.installSource;
+    }
+    // An EXPLICIT --max-parallel flag wins over the config file's value and is
+    // folded in BEFORE the export so it round-trips through --export-config.
+    if (options.maxParallel !== undefined) {
+        config.maxParallel = options.maxParallel;
+    }
+    // 2. --export-config: round-trip the gathered config back to JSON and exit.
+    if (options.exportConfig) {
+        let secrets;
+        if (options.includeSecrets) {
+            secrets = await gatherSecretsForExport(file, options.prompts);
+        }
+        writeFileSync(options.exportConfig, exportCIConfig(config, secrets), 'utf8');
+        log(`Config written to ${options.exportConfig}`);
+        return { outcome: 'exported', config, written: [], secrets: [] };
+    }
+    // 2b. Auto-detect the WORKSPACE install source: when no explicit flag/config
+    //     value was given AND <workDir>/package.json is the dorfl monorepo,
+    //     build the CLI from source instead of pulling the (unpublished) registry
+    //     package. A single exact-name check (NOT a fuzzy "dorfl" match, or
+    //     it would wrongly trip in a consumer repo named similarly). A missing or
+    //     unparseable package.json stays `registry` (the error is swallowed). This
+    //     runs AFTER the export early-return so it is never baked into an export.
+    if (!explicitInstallSource) {
+        try {
+            const pkgPath = join(options.ctx.workDir, 'package.json');
+            if (existsSync(pkgPath)) {
+                const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+                if (pkg.name === 'dorfl-monorepo') {
+                    config.installSource = 'workspace';
+                    log('📦 Detected dorfl monorepo — using workspace install mode (build from source)');
+                }
+            }
+        }
+        catch {
+            // Ignore — not the dorfl monorepo (missing/unparseable pkg).
+        }
+    }
+    // 3. Orchestrate secrets — SKIPPED in --fake mode (no real secret touched).
+    let secrets = [];
+    if (fake) {
+        log('--fake: skipping secret setup (no real secret is set)');
+    }
+    else {
+        secrets = await orchestrateSecrets({
+            ctx: options.ctx,
+            config,
+            knownSecrets,
+            prompt: options.prompts
+                ? (name) => options.prompts.password(`Enter the value for secret ${name}:`)
+                : undefined,
+            // The PR-identity token is OPTIONAL: phrase it as such, and Enter-to-skip
+            // leaves the legs on the built-in GITHUB_TOKEN fallback (zero-config).
+            optionalPrompt: options.prompts
+                ? (name) => options.prompts.password(`Optional: GitHub token for the CI legs to open PRs under your ` +
+                    `identity (stored as secret ${name}; a PAT or App token). ` +
+                    `Leave blank to use the built-in GITHUB_TOKEN:`)
+                : undefined,
+        });
+        for (const r of secrets) {
+            if (r.status === 'set')
+                log(`  secret ${r.name}: set`);
+            else if (r.status === 'skipped')
+                log(`  secret ${r.name}: skipped (empty)`);
+            else
+                log(`  secret ${r.name}: FAILED (${r.error})`);
+        }
+    }
+    // 4. Optionally offer the GitHub delete_branch_on_merge repo-setting (the
+    //    capability-F residue): ONLY when offered + confirmed, NEVER silent.
+    if (!fake &&
+        options.prompts &&
+        options.ctx.setRepoSetting &&
+        options.ctx.repo) {
+        const wanted = await options.prompts.confirm("Enable GitHub's 'Automatically delete head branches' (delete_branch_on_merge)?", { default: false });
+        if (wanted) {
+            try {
+                await options.ctx.setRepoSetting('delete_branch_on_merge', true);
+                log('  repo setting delete_branch_on_merge: enabled');
+            }
+            catch (err) {
+                log(`  repo setting delete_branch_on_merge: FAILED (${err instanceof Error ? err.message : String(err)})`);
+            }
+        }
+    }
+    // 5. Assemble + write the artifacts (composite setup action + auth). The
+    // project-setup escape hatch (prd `install-ci-project-provisioning`) lives
+    // on `config.projectSetup` as a PROVIDER-NAMESPACED, OPAQUE map; we look up
+    // THIS provider's payload via the seam (`ctx.providerId`) and ask the
+    // adapter to render it to the FIRST-steps fragment (`ctx.renderProjectSetup`).
+    // Absent payload / missing seam method ⇒ no fragment ⇒ byte-identical to the
+    // no-hook baseline (the load-bearing contract this hook preserves).
+    let projectSetupSteps;
+    const providerId = options.ctx.providerId;
+    const payload = providerId && config.projectSetup
+        ? config.projectSetup[providerId]
+        : undefined;
+    if (payload !== undefined && options.ctx.renderProjectSetup) {
+        projectSetupSteps = options.ctx.renderProjectSetup(payload);
+    }
+    const files = buildSetupArtifacts(config, options.capabilities ?? [], {
+        projectSetupSteps,
+    });
+    const written = writeArtifacts({ workDir: options.ctx.workDir, fake, files });
+    for (const path of written) {
+        log(`  wrote ${path}`);
+    }
+    // 5b. Tier-1 GitHub branch protection (prd land-time-reverify-and-parallel-
+    // merge-ceiling, Story 11). Auto-configures when the credential is admin-
+    // scoped (one `gh api` PUT on the protection endpoint, required check
+    // `verify` + strict: true); prints the exact ready-to-run `gh api` command
+    // + manual UI fallback when not. Skipped in --fake (no real API touched);
+    // skipped on a non-GitHub provider (the seam method is absent there).
+    const branchProtection = await installCIBranchProtectionStep({
+        ctx: options.ctx,
+        fake,
+        log,
+    });
+    // CI-autonomy posture (task `install-ci-emits-no-gate-env-let-config-decide`):
+    // the emitted advance workflow carries NO DORFL_AUTO_BUILD /
+    // DORFL_AUTO_TASK / DORFL_OBSERVATION_TRIAGE /
+    // DORFL_SURFACE_BLOCKERS env line. Gate policy is resolved through the
+    // same `flag > env > per-repo > global > default` chain the engine uses
+    // everywhere, so CI is treated like any other config consumer. A config-less
+    // repo therefore lands on the strict built-in defaults (autoBuild: false,
+    // autoTask: false, observationTriage: 'off', surfaceBlockers: false) and CI
+    // claims nothing until you opt in. Tell the user that loudly so a now-quiet CI
+    // is not a surprise, and how to enable it.
+    log('');
+    log("CI autonomy is OFF by default (the engine's strict default).");
+    log('The emitted advance workflow sets NO DORFL_* gate env, so your\n' +
+        '  committed .dorfl.json wins (precedence: flag > env > per-repo > global > default).');
+    log('To enable CI autonomy, EITHER:');
+    log('  - set the gate(s) in `.dorfl.json` (applies everywhere), e.g.\n' +
+        '      { "autoBuild": true, "autoTask": true }');
+    log("  - OR add the env var(s) to the workflow's `env:` block yourself (CI-only override), e.g.\n" +
+        "      DORFL_AUTO_BUILD: 'true'\n" +
+        "      DORFL_AUTO_TASK: 'true'");
+    // Project-toolchain boundary (task install-ci-document-toolchain-boundary,
+    // PRD install-ci-project-provisioning axis (A)). dorfl declares
+    // engines.node '>=18' and the generated composite action pins Node 22 only
+    // for dorfl's own runtime — it does NOT provision the project's toolchain.
+    // State that boundary explicitly so a maintainer whose project pins a
+    // different Node/pnpm version (or uses rust / system packages) is never
+    // silently broken: the project-setup hook (sibling task
+    // install-ci-project-setup-hook) is the SUPPORTED escape hatch; without
+    // it the conflicting case is unsupported. install-ci does NOT sniff
+    // .nvmrc / packageManager / rust-toolchain.toml — the boundary is
+    // documentation, not detection.
+    log('');
+    log("Project toolchain: the generated composite action provisions ONLY dorfl's own runtime (Node 22 for engines.node '>=18').");
+    log('It does NOT provision your project toolchain (a project-pinned pnpm/Node, rust, system packages, `pnpm install` of your deps).');
+    log('A custom or conflicting project toolchain is supported ONLY via the project-setup hook (task install-ci-project-setup-hook);');
+    log('without that hook the conflicting case is unsupported. install-ci does NOT detect likely conflicts — this is a documented boundary.');
+    return { outcome: 'generated', config, written, secrets, branchProtection };
+}
+/**
+ * Gather the secret values for `--include-secrets` (the export path): take known
+ * values from the loaded file, else prompt. Returns the deduped name→value map.
+ */
+async function gatherSecretsForExport(file, prompts) {
+    const config = resolveCIConfig(file);
+    const secrets = { ...(file.secrets ?? {}) };
+    if (!prompts) {
+        return secrets;
+    }
+    const { requiredSecretNames, optionalSecretNames } = await import('./install-ci-core.js');
+    for (const name of requiredSecretNames(config)) {
+        if (secrets[name] !== undefined)
+            continue;
+        const value = await prompts.password(`Enter the value for secret ${name}:`);
+        if (value)
+            secrets[name] = value;
+    }
+    // The OPTIONAL PR-identity token: offered (blank ⇒ omitted, never an empty
+    // value), so an exported config can carry it without it ever being required.
+    for (const name of optionalSecretNames(config)) {
+        if (secrets[name] !== undefined)
+            continue;
+        const value = await prompts.password(`Optional: GitHub token for CI to open PRs under your identity ` +
+            `(secret ${name}; a PAT or App token). Leave blank to use GITHUB_TOKEN:`);
+        if (value)
+            secrets[name] = value;
+    }
+    return secrets;
+}
+// ─── The interactive wizard ──────────────────────────────────────────────────
+/**
+ * The interactive wizard: gather the auth mode, providers/models (models-json) or
+ * the default provider/model (auth-json), and the harness, into a
+ * {@link CIConfigFile}. Drives the {@link WizardPrompts} seam, so it runs
+ * deterministically in tests and the gathered shape exactly equals a config-file
+ * input — the equivalence the snapshot test pins. Mirrors whitesmith's prompt
+ * flow (provider type → key env var → models → defaults).
+ */
+export async function runWizard(prompts) {
+    const authMode = await prompts.select('Auth mode:', [
+        {
+            name: 'models.json (default — one GitHub secret per provider key)',
+            value: 'models-json',
+        },
+        {
+            name: 'auth.json (single PI_AUTH_JSON + GH_PAT + OAuth refresh — the sharp edge)',
+            value: 'auth-json',
+        },
+    ]);
+    const harness = await prompts.select('Agent harness:', [
+        { name: 'pi (the pi coding agent)', value: 'pi' },
+        { name: 'null (shell out to a configured agentCmd)', value: 'null' },
+    ]);
+    if (authMode === 'auth-json') {
+        // auth.json mode: no per-provider keys, but the harness still needs a
+        // default provider/model for its invocations.
+        const defaultProvider = await prompts.input('Default AI provider:', {
+            default: 'anthropic',
+        });
+        const defaultModel = await prompts.input('Default AI model:', {
+            default: 'claude-sonnet-4-20250514',
+        });
+        return {
+            authMode,
+            providers: [],
+            defaultProvider,
+            defaultModel,
+            harness,
+        };
+    }
+    const providers = await promptProviders(prompts);
+    const { defaultProvider, defaultModel } = await promptDefaults(prompts, providers);
+    return { authMode, providers, defaultProvider, defaultModel, harness };
+}
+/** Prompt for one or more providers (the models-json path). */
+async function promptProviders(prompts) {
+    const providers = [];
+    let addMore = true;
+    while (addMore) {
+        const type = await prompts.select(providers.length === 0 ? 'Add a provider:' : 'Add another provider:', [
+            { name: 'Anthropic (built-in, needs API key)', value: 'anthropic' },
+            { name: 'OpenAI (built-in, needs API key)', value: 'openai' },
+            { name: 'Custom provider', value: 'custom' },
+        ]);
+        providers.push(type === 'custom'
+            ? await promptCustomProvider(prompts)
+            : await promptBuiltinProvider(prompts, type));
+        addMore = await prompts.confirm('Add another provider?', { default: false });
+    }
+    return providers;
+}
+/** Prompt for a built-in provider (`anthropic` / `openai`). */
+async function promptBuiltinProvider(prompts, type) {
+    const defaultEnvVar = type === 'anthropic' ? 'ANTHROPIC_API_KEY' : 'OPENAI_API_KEY';
+    const defaultModel = type === 'anthropic' ? 'claude-sonnet-4-20250514' : 'gpt-4o';
+    const apiKeyEnvVar = await prompts.input('GitHub secret name for the API key:', {
+        default: defaultEnvVar,
+    });
+    const baseUrl = await prompts.input('Custom base URL (blank for default):');
+    const models = await promptModels(prompts, defaultModel);
+    return {
+        name: type,
+        baseUrl: baseUrl || undefined,
+        apiKeyEnvVar,
+        models,
+        builtin: true,
+    };
+}
+/** Prompt for a custom provider. */
+async function promptCustomProvider(prompts) {
+    const name = await prompts.input('Provider name:');
+    const baseUrl = await prompts.input('Base URL:');
+    const api = await prompts.select('API type:', [
+        { name: 'Anthropic Messages API', value: 'anthropic-messages' },
+        { name: 'OpenAI Completions API', value: 'openai-completions' },
+    ]);
+    const apiKeyEnvVar = await prompts.input('GitHub secret name for the API key:');
+    let compat;
+    if (api === 'openai-completions') {
+        const supportsDeveloperRole = await prompts.confirm('Does this provider support the developer role?', { default: true });
+        const supportsReasoningEffort = await prompts.confirm('Does this provider support reasoning effort?', { default: true });
+        if (!supportsDeveloperRole || !supportsReasoningEffort) {
+            compat = { supportsDeveloperRole, supportsReasoningEffort };
+        }
+    }
+    const models = await promptModels(prompts);
+    return { name, baseUrl, api, apiKeyEnvVar, models, builtin: false, compat };
+}
+/** Prompt for one or more model ids. */
+async function promptModels(prompts, firstDefault) {
+    const models = [];
+    let addModel = true;
+    while (addModel) {
+        const id = await prompts.input(models.length === 0 ? 'Model ID:' : 'Another model ID:', models.length === 0 && firstDefault ? { default: firstDefault } : undefined);
+        models.push({ id });
+        addModel = await prompts.confirm('Add another model?', { default: false });
+    }
+    return models;
+}
+/** Prompt for the default provider + model (skips the prompt when only one). */
+async function promptDefaults(prompts, providers) {
+    const defaultProvider = providers.length === 1
+        ? providers[0].name
+        : await prompts.select('Default provider:', providers.map((p) => ({ name: p.name, value: p.name })));
+    const selected = providers.find((p) => p.name === defaultProvider);
+    const defaultModel = selected.models.length === 1
+        ? selected.models[0].id
+        : await prompts.select('Default model:', selected.models.map((m) => ({ name: m.id, value: m.id })));
+    return { defaultProvider, defaultModel };
+}
+/** Re-export the default harness for callers building a config programmatically. */
+export { DEFAULT_HARNESS };
+//# sourceMappingURL=install-ci.js.map

package/dist/install-ci.js.map

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

package/dist/intake-event.d.ts

@@ -0,0 +1,88 @@
+/**
+ * **`intake`'s PURE event-classification** (task `intake-event-classification`, prd
+ * `issue-intake` US #2 — the resume-on-thread-change behaviour).
+ *
+ * `intake` is a CONVERSATION on an issue thread: a run may ASK a clarifying question
+ * and STOP, expecting a LATER run to resume from the updated thread (prd "Loop
+ * closure" / the decision table's ASK row). This module is the PURE CONTROL-PATH
+ * classifier the re-run depends on: given an issue EVENT, it decides whether `intake`
+ * should RE-EVALUATE the whole thread or IGNORE the event.
+ *
+ * THE CANONICAL RULE (from prd `issue-intake`, "The engine shape"): *"The loop
+ * re-runs on a new comment OR an issue-body edit (re-evaluate the whole thread); a
+ * buried prior-comment edit is IGNORED."*
+ *
+ * - a **new comment** → RE-EVALUATE (a genuine new turn on the thread);
+ * - an **issue-body edit** → RE-EVALUATE (the spec the prompt reads changed; re-read
+ *   body + full thread);
+ * - editing a **buried PRIOR comment** → IGNORE (it is NOT a new turn —
+ *   re-triggering on old-comment edits invites loops).
+ *
+ * Edit-vs-reply changes only the comment's FRAMING, not the control path: a NEW
+ * comment re-evaluates whether it is phrased as an edit-of-the-ask or a reply. The
+ * distinction the rule turns on is "a NEW turn vs an edit of a BURIED prior turn",
+ * NOT "edit vs reply".
+ *
+ * SCOPE FENCE (prd "Scope: the engine only"): this is ONLY the pure classifier. It is
+ * NOT CI's TRIGGER POLICY (command/every-issue, maintainer/anyone) — that is
+ * `runner-in-ci`'s. CI's trigger LATER CONSULTS this classifier, but the policy of
+ * WHO/WHAT may trigger lives in CI, not here. This module touches no seam, no git, no
+ * `gh` — it is pure logic over a stubbed event shape (the same discipline
+ * `failure-cause.ts` keeps).
+ */
+/**
+ * The KIND of issue event the classifier decides over. The shapes are STUBBED in
+ * tests (no webhook, no `gh`); a real CI trigger maps its provider event onto one of
+ * these kinds before consulting {@link classifyIntakeEvent}.
+ *
+ * - `issue-comment-created` — a NEW comment was added to the thread (a new turn).
+ * - `issue-body-edited` — the ISSUE BODY itself was edited (the spec changed).
+ * - `issue-comment-edited` — an EXISTING comment was edited (see {@link IntakeEvent}
+ *   for the buried-vs-latest distinction the rule turns on).
+ */
+export type IntakeEventKind = 'issue-comment-created' | 'issue-body-edited' | 'issue-comment-edited';
+/**
+ * The CONTROL-PATH decision the classifier returns:
+ *
+ * - `re-evaluate` — `intake` should RE-READ the issue body + full thread and re-run
+ *   its decision (a new comment or a body edit changed the material the prompt
+ *   judges).
+ * - `ignore` — the event is NOT a new turn; `intake` does nothing (re-triggering on a
+ *   buried old-comment edit would invite loops).
+ */
+export type IntakeEventDecision = 're-evaluate' | 'ignore';
+/**
+ * A STUBBED issue event the classifier decides over. Deliberately MINIMAL — it
+ * carries only what the CONTROL-PATH rule turns on, nothing else (no author, no CI
+ * trigger policy — that is `runner-in-ci`'s).
+ */
+export interface IntakeEvent {
+    /** Which kind of thread change occurred. */
+    kind: IntakeEventKind;
+}
+/**
+ * Classify an issue EVENT into the CONTROL-PATH decision: RE-EVALUATE the whole
+ * thread, or IGNORE the event. The PURE realisation of the prd's canonical rule
+ * (no seam, no git, no `gh`).
+ *
+ * The table (prd `issue-intake` US #2):
+ *
+ * | event kind              | decision      | why                                          |
+ * | ----------------------- | ------------- | -------------------------------------------- |
+ * | `issue-comment-created` | `re-evaluate` | a new comment is a new turn on the thread    |
+ * | `issue-body-edited`     | `re-evaluate` | the issue body (the spec) changed            |
+ * | `issue-comment-edited`  | `ignore`      | editing a buried prior comment is NOT a turn |
+ *
+ * `issue-comment-edited` is IGNORED unconditionally: editing a prior comment is not a
+ * new turn (and re-triggering on old-comment edits invites loops). The "buried" in
+ * the rule is descriptive — the rule does not single out which prior comment was
+ * edited; ANY comment edit is an edit of an already-seen turn, not a new one. (Adding
+ * NEW content is `issue-comment-created`, which DOES re-evaluate.)
+ *
+ * Edit-vs-reply does NOT change this: a new comment is `issue-comment-created`
+ * REGARDLESS of whether it is phrased as an edit-of-the-ask or a reply — both
+ * re-evaluate, because editing-vs-replying changes only the comment's FRAMING, not
+ * whether it is a new turn.
+ */
+export declare function classifyIntakeEvent(event: IntakeEvent): IntakeEventDecision;
+//# sourceMappingURL=intake-event.d.ts.map

package/dist/intake-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake-event.d.ts","sourceRoot":"","sources":["../src/intake-event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GACxB,uBAAuB,GACvB,mBAAmB,GACnB,sBAAsB,CAAC;AAE1B;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,QAAQ,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B,4CAA4C;IAC5C,IAAI,EAAE,eAAe,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,mBAAmB,CAQ3E"}

package/dist/intake-event.js

@@ -0,0 +1,66 @@
+/**
+ * **`intake`'s PURE event-classification** (task `intake-event-classification`, prd
+ * `issue-intake` US #2 — the resume-on-thread-change behaviour).
+ *
+ * `intake` is a CONVERSATION on an issue thread: a run may ASK a clarifying question
+ * and STOP, expecting a LATER run to resume from the updated thread (prd "Loop
+ * closure" / the decision table's ASK row). This module is the PURE CONTROL-PATH
+ * classifier the re-run depends on: given an issue EVENT, it decides whether `intake`
+ * should RE-EVALUATE the whole thread or IGNORE the event.
+ *
+ * THE CANONICAL RULE (from prd `issue-intake`, "The engine shape"): *"The loop
+ * re-runs on a new comment OR an issue-body edit (re-evaluate the whole thread); a
+ * buried prior-comment edit is IGNORED."*
+ *
+ * - a **new comment** → RE-EVALUATE (a genuine new turn on the thread);
+ * - an **issue-body edit** → RE-EVALUATE (the spec the prompt reads changed; re-read
+ *   body + full thread);
+ * - editing a **buried PRIOR comment** → IGNORE (it is NOT a new turn —
+ *   re-triggering on old-comment edits invites loops).
+ *
+ * Edit-vs-reply changes only the comment's FRAMING, not the control path: a NEW
+ * comment re-evaluates whether it is phrased as an edit-of-the-ask or a reply. The
+ * distinction the rule turns on is "a NEW turn vs an edit of a BURIED prior turn",
+ * NOT "edit vs reply".
+ *
+ * SCOPE FENCE (prd "Scope: the engine only"): this is ONLY the pure classifier. It is
+ * NOT CI's TRIGGER POLICY (command/every-issue, maintainer/anyone) — that is
+ * `runner-in-ci`'s. CI's trigger LATER CONSULTS this classifier, but the policy of
+ * WHO/WHAT may trigger lives in CI, not here. This module touches no seam, no git, no
+ * `gh` — it is pure logic over a stubbed event shape (the same discipline
+ * `failure-cause.ts` keeps).
+ */
+/**
+ * Classify an issue EVENT into the CONTROL-PATH decision: RE-EVALUATE the whole
+ * thread, or IGNORE the event. The PURE realisation of the prd's canonical rule
+ * (no seam, no git, no `gh`).
+ *
+ * The table (prd `issue-intake` US #2):
+ *
+ * | event kind              | decision      | why                                          |
+ * | ----------------------- | ------------- | -------------------------------------------- |
+ * | `issue-comment-created` | `re-evaluate` | a new comment is a new turn on the thread    |
+ * | `issue-body-edited`     | `re-evaluate` | the issue body (the spec) changed            |
+ * | `issue-comment-edited`  | `ignore`      | editing a buried prior comment is NOT a turn |
+ *
+ * `issue-comment-edited` is IGNORED unconditionally: editing a prior comment is not a
+ * new turn (and re-triggering on old-comment edits invites loops). The "buried" in
+ * the rule is descriptive — the rule does not single out which prior comment was
+ * edited; ANY comment edit is an edit of an already-seen turn, not a new one. (Adding
+ * NEW content is `issue-comment-created`, which DOES re-evaluate.)
+ *
+ * Edit-vs-reply does NOT change this: a new comment is `issue-comment-created`
+ * REGARDLESS of whether it is phrased as an edit-of-the-ask or a reply — both
+ * re-evaluate, because editing-vs-replying changes only the comment's FRAMING, not
+ * whether it is a new turn.
+ */
+export function classifyIntakeEvent(event) {
+    switch (event.kind) {
+        case 'issue-comment-created':
+        case 'issue-body-edited':
+            return 're-evaluate';
+        case 'issue-comment-edited':
+            return 'ignore';
+    }
+}
+//# sourceMappingURL=intake-event.js.map

package/dist/intake-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake-event.js","sourceRoot":"","sources":["../src/intake-event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAsCH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkB;IACrD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,uBAAuB,CAAC;QAC7B,KAAK,mBAAmB;YACvB,OAAO,aAAa,CAAC;QACtB,KAAK,sBAAsB;YAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;AACF,CAAC"}

package/dist/intake-marker.d.ts

@@ -0,0 +1,95 @@
+import type { IssueComment } from './issue-provider.js';
+/**
+ * **The intake MARKER** (task `intake-self-awareness-resumption-tracking`, prd
+ * `issue-intake` US #2/#10): the ONE primitive the deterministic pre-decision
+ * TRIAGE GATE is built on. A machine-readable HIDDEN HTML comment intake stamps on
+ * EVERY comment it posts, recording a neutral FACT about what intake did:
+ *
+ * - `<!-- dorfl:intake kind=ask seen=412,418 -->`
+ * - `<!-- dorfl:intake kind=bounced seen=503 -->`
+ * - `<!-- dorfl:intake kind=created slug=<slug> seen=601,602 -->`
+ *
+ * (Namespace `${brand.base}:intake` is built from {@link brand} exactly like
+ * `PROCESSING_LOCK_LABEL`, so a rebrand updates it automatically.)
+ *
+ * It is the SOLE recovery signal — no sidecar, no cursor, no bot-identity. Intake
+ * recognises ITS OWN comments by the marker alone (provider-portable, survives
+ * posting under a human's token). Hidden HTML comments render as NOTHING on GitHub
+ * but are present in the raw markdown each comment's `body` carries — so the triage
+ * parses the marker straight out of {@link IssueComment.body}.
+ *
+ * What the marker records (DECIDED 2026-06-10):
+ *
+ * - **`kind`** \u2014 a NEUTRAL fact (`ask` / `bounced` / `created`). Whether a kind is
+ *   TERMINAL is the TRIAGE's interpretation, NEVER data in the marker (no `terminal`
+ *   field): if a kind's terminal-ness ever changes that is a triage change and old
+ *   markers stay valid.
+ * - **`slug`** \u2014 present only on `kind=created` (which task/prd intake produced).
+ * - **`seen=<id>,\u2026`** \u2014 the per-run DELTA of HUMAN comment ids intake READ this run
+ *   (EXCLUDING intake's own marker-comments AND any human id already in a prior
+ *   marker's `seen=`). Ids, not a count, because a count cannot distinguish "a new
+ *   comment appeared" from "an old one was deleted"; ids do both via set arithmetic.
+ *   The full `seenSet` is the UNION of every marker's `seen=` (the CHAIN model).
+ *
+ * The grammar is SHARED so the dependent completion-comment task just stamps a
+ * `created` marker via {@link stampIntakeMarker}, which the triage's
+ * `already-terminal` branch then consumes.
+ */
+/** The neutral KIND a marker records \u2014 a fact about what intake did (NOT terminal-ness). */
+export type IntakeMarkerKind = 'ask' | 'bounced' | 'created';
+/** A parsed intake marker \u2014 `kind` + the human ids it `seen=` + an optional `slug`. */
+export interface IntakeMarker {
+    /** What intake did (a neutral fact; the TRIAGE owns terminal-ness, not this). */
+    kind: IntakeMarkerKind;
+    /** The HUMAN comment ids intake READ this run (the per-run delta; may be empty). */
+    seen: string[];
+    /** The created task/prd slug \u2014 present only on `kind=created`. */
+    slug?: string;
+}
+/**
+ * STAMP the intake marker onto a comment body intake is about to post (the SHARED
+ * producer for ALL of ask / bounced / created). Appends the hidden HTML comment
+ * AFTER the human-readable text, separated by a blank line, so the rendered comment
+ * is just the text (the marker is invisible) yet the raw markdown carries the
+ * marker for the triage to recover.
+ *
+ * `seen` is the per-run DELTA of human comment ids (computed by
+ * {@link computeSeenDelta}); it is emitted even when empty (`seen=`) so the grammar
+ * is uniform and the parser never has to special-case its absence. `slug` is
+ * emitted only for `kind=created`.
+ */
+export declare function stampIntakeMarker(body: string, marker: {
+    kind: IntakeMarkerKind;
+    seen: string[];
+    slug?: string;
+}): string;
+/**
+ * Parse the FIRST intake marker out of a comment body (the SHARED consumer). Returns
+ * `undefined` when the body carries no intake marker \u2014 i.e. it is a HUMAN comment
+ * (the triage ranges its unseen-check over exactly these). A malformed marker (no
+ * `kind`, or an unknown `kind`) is treated as ABSENT rather than throwing: an
+ * unparseable hidden comment must never make the triage crash or misclassify a
+ * human comment as intake's.
+ */
+export declare function parseIntakeMarker(body: string): IntakeMarker | undefined;
+/** True iff the comment carries an intake marker \u2014 i.e. it is INTAKE's OWN comment. */
+export declare function isIntakeComment(comment: IssueComment): boolean;
+/**
+ * Compute the per-run `seen=` DELTA for a marker intake is about to stamp: the ids
+ * of the HUMAN comments in the thread as intake READ it, EXCLUDING (a) intake's own
+ * marker-comments (identified by carrying a marker) and (b) any human id ALREADY
+ * recorded in a prior intake marker's `seen=` (the chain model keeps each marker's
+ * `seen=` a bounded per-run delta; the union reconstructs the whole). Order follows
+ * `listComments`' oldest-first; ids with no value (a provider that omitted one) are
+ * dropped \u2014 the triage only reasons over ids it actually has.
+ */
+export declare function computeSeenDelta(comments: IssueComment[]): string[];
+/**
+ * Build the full `seenSet` for the TRIAGE: the UNION of every intake marker's
+ * `seen=` id-list in the thread (the chain model \u2014 each marker stores a per-run
+ * delta, the union reconstructs the complete set of human comments intake has EVER
+ * read). Ranges over intake's OWN comments (the ones carrying a marker); a human
+ * comment never carries a `seen=`.
+ */
+export declare function seenSetFrom(comments: IssueComment[]): Set<string>;
+//# sourceMappingURL=intake-marker.d.ts.map

package/dist/intake-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake-marker.d.ts","sourceRoot":"","sources":["../src/intake-marker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,iGAAiG;AACjG,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7D,4FAA4F;AAC5F,MAAM,WAAW,YAAY;IAC5B,iFAAiF;IACjF,IAAI,EAAE,gBAAgB,CAAC;IACvB,oFAAoF;IACpF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAiBD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAC,GAC7D,MAAM,CAaR;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAsBxE;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAiBnE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAYjE"}