@matteeh/osq 0.2.1 → 0.2.2

package/dist/watcher/blocked.d.ts

@@ -0,0 +1,12 @@
+import type { RunTaskResult } from './outcome.js';
+import type { FailFn } from './task-verify.js';
+/** Dead marker for a blocked task: the reason in frontmatter, then the need. */
+export declare function formatBlockedDeadMarker(need: string): string;
+/**
+ * When the task's result file states a real `## Blocked` section, fail the task
+ * with reason `blocked` and the stated need in the dead marker body. A missing
+ * result file, or a section that is empty or says only `None`, leaves the task
+ * to the checks that follow.
+ */
+export declare function checkBlocked(specFolderPath: string, taskNumber: string, fail: FailFn): Promise<RunTaskResult | null>;
+//# sourceMappingURL=blocked.d.ts.map

package/dist/watcher/blocked.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocked.d.ts","sourceRoot":"","sources":["../../src/watcher/blocked.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAO/B"}

package/dist/watcher/blocked.js

@@ -0,0 +1,24 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { parseResultSections } from '../core/report/result-sections.js';
+/** Dead marker for a blocked task: the reason in frontmatter, then the need. */
+export function formatBlockedDeadMarker(need) {
+    return ['---', 'reason: blocked', '---', need, ''].join('\n');
+}
+/**
+ * When the task's result file states a real `## Blocked` section, fail the task
+ * with reason `blocked` and the stated need in the dead marker body. A missing
+ * result file, or a section that is empty or says only `None`, leaves the task
+ * to the checks that follow.
+ */
+export async function checkBlocked(specFolderPath, taskNumber, fail) {
+    const resultPath = path.join(specFolderPath, '.run', 'results', `${taskNumber}.md`);
+    const content = await fs.readFile(resultPath, 'utf8').catch(() => null);
+    if (content === null)
+        return null;
+    const { blocked } = parseResultSections(content);
+    if (blocked === null)
+        return null;
+    return fail('blocked', formatBlockedDeadMarker(blocked), `Task blocked: ${blocked}`);
+}
+//# sourceMappingURL=blocked.js.map

package/dist/watcher/blocked.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocked.js","sourceRoot":"","sources":["../../src/watcher/blocked.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAIxE,gFAAgF;AAChF,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,cAAsB,EACtB,UAAkB,EAClB,IAAY;IAEZ,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,KAAK,CAAC,CAAC;IACpF,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACxE,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,IAAI,CAAC,SAAS,EAAE,uBAAuB,CAAC,OAAO,CAAC,EAAE,iBAAiB,OAAO,EAAE,CAAC,CAAC;AACvF,CAAC"}

package/dist/watcher/dependencies.d.ts

@@ -0,0 +1,28 @@
+import type { RunTaskResult } from './outcome.js';
+import type { FailFn, TaskVerifyOptions } from './task-verify.js';
+/** One added package and the manifest it was added to. */
+export interface AddedDependency {
+    readonly file: string;
+    readonly name: string;
+}
+/**
+ * The sorted distinct package names a manifest declares across its four
+ * dependency sections. Malformed JSON and non-object sections contribute nothing.
+ */
+export declare function readManifestPackageNames(content: string): string[];
+/**
+ * Resolve `scope` and map each scoped `package.json` path to its sorted package
+ * names. A missing or unreadable manifest maps to an empty list. Without a
+ * scoped manifest the result is empty, and no unscoped file is ever read.
+ */
+export declare function readScopedDependencies(projectRoot: string, scope: readonly string[]): Promise<Record<string, string[]>>;
+/** Dead marker body for a task that added packages an accepted ADR denies. */
+export declare function formatDeniedDependencyMarker(lines: readonly string[]): string;
+/**
+ * After the agent exits, compare each baseline manifest with its current names,
+ * append one `dependencies_added` event for the new pairs, and fail the task
+ * when an accepted ADR denies an added package. Without a baseline the check
+ * does not run; a name moved between sections is not new.
+ */
+export declare function checkDependencies(options: TaskVerifyOptions, fail: FailFn): Promise<RunTaskResult | null>;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/watcher/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/watcher/dependencies.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAUlE,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAQD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAelE;AAOD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CASnC;AA2CD,8EAA8E;AAC9E,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAS7E;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAgC/B"}

package/dist/watcher/dependencies.js

@@ -0,0 +1,152 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { readDecisions } from '../core/foundation/decisions.js';
+import { resolveScope } from '../core/run/scope.js';
+import { appendHarnessEvent } from '../harness/types.js';
+/** The four manifest sections whose package names count as dependencies. */
+const PACKAGE_SECTIONS = [
+    'dependencies',
+    'devDependencies',
+    'peerDependencies',
+    'optionalDependencies',
+];
+const MANIFEST_FILE_NAME = 'package.json';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * The sorted distinct package names a manifest declares across its four
+ * dependency sections. Malformed JSON and non-object sections contribute nothing.
+ */
+export function readManifestPackageNames(content) {
+    let data;
+    try {
+        data = JSON.parse(content);
+    }
+    catch {
+        return [];
+    }
+    if (!isRecord(data))
+        return [];
+    const names = new Set();
+    for (const section of PACKAGE_SECTIONS) {
+        const record = data[section];
+        if (!isRecord(record))
+            continue;
+        for (const name of Object.keys(record))
+            names.add(name);
+    }
+    return [...names].sort();
+}
+async function readNamesAt(projectRoot, relativeFile) {
+    const content = await fs.readFile(path.join(projectRoot, relativeFile), 'utf8').catch(() => null);
+    return content === null ? [] : readManifestPackageNames(content);
+}
+/**
+ * Resolve `scope` and map each scoped `package.json` path to its sorted package
+ * names. A missing or unreadable manifest maps to an empty list. Without a
+ * scoped manifest the result is empty, and no unscoped file is ever read.
+ */
+export async function readScopedDependencies(projectRoot, scope) {
+    const dependencies = {};
+    for (const entry of await resolveScope(projectRoot, scope)) {
+        if (path.posix.basename(entry.relativePath) !== MANIFEST_FILE_NAME)
+            continue;
+        dependencies[entry.relativePath] = entry.absolutePath
+            ? readManifestPackageNames(await fs.readFile(entry.absolutePath, 'utf8').catch(() => ''))
+            : [];
+    }
+    return dependencies;
+}
+/** The `dependencies` of the latest `measures` start event, or null without one. */
+async function latestDependencyBaseline(specFolderPath, taskNumber) {
+    const raw = await fs
+        .readFile(path.join(specFolderPath, '.run', 'events', `${taskNumber}.jsonl`), 'utf8')
+        .catch(() => '');
+    let baseline = null;
+    for (const line of raw.split('\n')) {
+        if (!line.trim())
+            continue;
+        let event;
+        try {
+            event = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const data = event.data;
+        if (event.type !== 'measures' || !isRecord(data) || data.phase !== 'start')
+            continue;
+        if (!isRecord(data.dependencies))
+            continue;
+        const record = {};
+        for (const [file, names] of Object.entries(data.dependencies)) {
+            if (Array.isArray(names))
+                record[file] = names.filter((n) => typeof n === 'string');
+        }
+        baseline = record;
+    }
+    return baseline;
+}
+function compareAdded(a, b) {
+    if (a.file !== b.file)
+        return a.file < b.file ? -1 : 1;
+    if (a.name === b.name)
+        return 0;
+    return a.name < b.name ? -1 : 1;
+}
+/** Accepted ADRs that deny one added package, in number order. */
+function denyingAdrs(adrs, name) {
+    return adrs.filter((adr) => adr.status === 'accepted' && adr.denies.includes(name));
+}
+/** Dead marker body for a task that added packages an accepted ADR denies. */
+export function formatDeniedDependencyMarker(lines) {
+    return [
+        '---',
+        'reason: denied_dependency',
+        '---',
+        'The task added packages an accepted ADR denies:',
+        ...lines,
+        '',
+    ].join('\n');
+}
+/**
+ * After the agent exits, compare each baseline manifest with its current names,
+ * append one `dependencies_added` event for the new pairs, and fail the task
+ * when an accepted ADR denies an added package. Without a baseline the check
+ * does not run; a name moved between sections is not new.
+ */
+export async function checkDependencies(options, fail) {
+    const { projectRoot, specFolderPath, taskNumber, config } = options;
+    const baseline = await latestDependencyBaseline(specFolderPath, taskNumber);
+    if (baseline === null)
+        return null;
+    const added = [];
+    for (const file of Object.keys(baseline).sort()) {
+        const previous = new Set(baseline[file] ?? []);
+        for (const name of await readNamesAt(projectRoot, file)) {
+            if (!previous.has(name))
+                added.push({ file, name });
+        }
+    }
+    if (added.length === 0)
+        return null;
+    added.sort(compareAdded);
+    await appendHarnessEvent(specFolderPath, taskNumber, {
+        type: 'dependencies_added',
+        timestamp: new Date().toISOString(),
+        data: { added },
+    });
+    const records = await readDecisions(projectRoot, config);
+    const lines = [];
+    for (const pair of added) {
+        for (const adr of denyingAdrs(records.adrs, pair.name)) {
+            lines.push(`- ${pair.name} in ${pair.file}: ADR ${adr.number}: ${adr.rule}`);
+        }
+    }
+    if (lines.length === 0)
+        return null;
+    const error = `Added packages an accepted ADR denies: ${added.map((pair) => pair.name).join(', ')}`;
+    return fail('denied_dependency', formatDeniedDependencyMarker(lines), error);
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/watcher/dependencies.js.map

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

package/dist/watcher/done-metadata.d.ts

@@ -0,0 +1,4 @@
+import type { DoneMarkerMetadata } from './outcome.js';
+/** Resolve the metadata written to the done marker after a passing task. */
+export declare function buildDoneMetadata(projectRoot: string, scope: string[]): Promise<DoneMarkerMetadata>;
+//# sourceMappingURL=done-metadata.d.ts.map

package/dist/watcher/done-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"done-metadata.d.ts","sourceRoot":"","sources":["../../src/watcher/done-metadata.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,4EAA4E;AAC5E,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,kBAAkB,CAAC,CAc7B"}

package/dist/watcher/done-metadata.js

@@ -0,0 +1,20 @@
+import { SCOPE_RESOLVER_VERSION, computeTaskScopeHash } from '../core/run/scope-hash.js';
+import { resolveProjectCommit } from './build-project.js';
+import { resolveBuildInfo } from './build.js';
+/** Resolve the metadata written to the done marker after a passing task. */
+export async function buildDoneMetadata(projectRoot, scope) {
+    const [scopeHash, buildInfo, projectCommit] = await Promise.all([
+        computeTaskScopeHash(projectRoot, scope),
+        resolveBuildInfo(),
+        resolveProjectCommit(projectRoot),
+    ]);
+    return {
+        scopeHash: scopeHash.hash,
+        buildStamp: buildInfo.commit,
+        projectCommit,
+        exitCode: 0,
+        fileHashes: scopeHash.fileHashes,
+        scopeResolver: SCOPE_RESOLVER_VERSION,
+    };
+}
+//# sourceMappingURL=done-metadata.js.map

package/dist/watcher/done-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"done-metadata.js","sourceRoot":"","sources":["../../src/watcher/done-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAmB,EACnB,KAAe;IAEf,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9D,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC;QACxC,gBAAgB,EAAE;QAClB,oBAAoB,CAAC,WAAW,CAAC;KAClC,CAAC,CAAC;IACH,OAAO;QACL,SAAS,EAAE,SAAS,CAAC,IAAI;QACzB,UAAU,EAAE,SAAS,CAAC,MAAM;QAC5B,aAAa;QACb,QAAQ,EAAE,CAAC;QACX,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,aAAa,EAAE,sBAAsB;KACtC,CAAC;AACJ,CAAC"}

package/dist/watcher/failure-reason.d.ts

@@ -3,5 +3,5 @@
  * its own module so `outcome.ts` stays within the strict runner line budget as
  * the reason set grows.
  */
-export type RunTaskFailureReason = 'spec_conflict' | 'already_running' | 'no_result' | 'verify_red' | 'verify_precondition' | 'verify_path_missing' | 'change_verify_red' | 'crashed' | 'timeout' | 'undeclared_test_change' | 'regressed';
+export type RunTaskFailureReason = 'spec_conflict' | 'already_running' | 'no_result' | 'verify_red' | 'verify_precondition' | 'verify_path_missing' | 'denied_dependency' | 'change_verify_red' | 'crashed' | 'timeout' | 'undeclared_test_change' | 'blocked' | 'baseline_red' | 'regressed';
 //# sourceMappingURL=failure-reason.d.ts.map

package/dist/watcher/failure-reason.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"failure-reason.d.ts","sourceRoot":"","sources":["../../src/watcher/failure-reason.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,iBAAiB,GACjB,WAAW,GACX,YAAY,GACZ,qBAAqB,GACrB,qBAAqB,GACrB,mBAAmB,GACnB,SAAS,GACT,SAAS,GACT,wBAAwB,GACxB,WAAW,CAAC"}
+{"version":3,"file":"failure-reason.d.ts","sourceRoot":"","sources":["../../src/watcher/failure-reason.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,iBAAiB,GACjB,WAAW,GACX,YAAY,GACZ,qBAAqB,GACrB,qBAAqB,GACrB,mBAAmB,GACnB,mBAAmB,GACnB,SAAS,GACT,SAAS,GACT,wBAAwB,GACxB,SAAS,GACT,cAAc,GACd,WAAW,CAAC"}

package/dist/watcher/focused-verify.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The focused scenario-test run the watcher makes after an agent exits and
+ * before the task verify. A failing collected scenario ends the attempt as a
+ * `verify_red` death; anything else lets the full verify decide completion.
+ */
+import type { RunTaskResult } from './outcome.js';
+import type { FailFn, TaskVerifyOptions } from './task-verify.js';
+/**
+ * The last check of `checkBlockedFirst`. Collects the task's focused scenarios
+ * and files, runs the configured command through `runFocusedTests`, and appends
+ * one `focused_ran` event with the run's command, inputs, outcome, and output.
+ * Returns the `verify_red` death when a collected scenario test failed, and
+ * null when there is nothing to run or the run passed or was a problem, so the
+ * verify still runs and alone decides the task.
+ */
+export declare function checkFocusedTests(options: TaskVerifyOptions, fail: FailFn): Promise<RunTaskResult | null>;
+//# sourceMappingURL=focused-verify.d.ts.map

package/dist/watcher/focused-verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focused-verify.d.ts","sourceRoot":"","sources":["../../src/watcher/focused-verify.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAgBlE;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAwB/B"}

package/dist/watcher/focused-verify.js

@@ -0,0 +1,54 @@
+/**
+ * The focused scenario-test run the watcher makes after an agent exits and
+ * before the task verify. A failing collected scenario ends the attempt as a
+ * `verify_red` death; anything else lets the full verify decide completion.
+ */
+import { collectFocusedTests, runFocusedTests } from '../core/run/focused-tests.js';
+import { appendHarnessEvent } from '../harness/types.js';
+/** Dead marker for a task whose focused scenario tests failed: reason, flag, command, output. */
+function formatFocusedDeadMarker(command, output) {
+    const body = output === '' || output.endsWith('\n') ? output : `${output}\n`;
+    return [
+        '---',
+        'reason: verify_red',
+        'focused: true',
+        `command: "${command}"`,
+        '---',
+        'Watcher focused scenario tests failed:',
+        body,
+    ].join('\n');
+}
+/**
+ * The last check of `checkBlockedFirst`. Collects the task's focused scenarios
+ * and files, runs the configured command through `runFocusedTests`, and appends
+ * one `focused_ran` event with the run's command, inputs, outcome, and output.
+ * Returns the `verify_red` death when a collected scenario test failed, and
+ * null when there is nothing to run or the run passed or was a problem, so the
+ * verify still runs and alone decides the task.
+ */
+export async function checkFocusedTests(options, fail) {
+    const { projectRoot, specFolderPath, taskNumber, taskData, config } = options;
+    const collection = await collectFocusedTests(projectRoot, config, taskData.scope);
+    const run = await runFocusedTests(collection, projectRoot, specFolderPath, config);
+    if (run === null)
+        return null;
+    await appendHarnessEvent(specFolderPath, taskNumber, {
+        type: 'focused_ran',
+        timestamp: new Date().toISOString(),
+        data: {
+            command: run.command,
+            files: [...run.files],
+            scenarios: [...run.scenarios],
+            outcome: run.outcome,
+            exitCode: run.exitCode,
+            duration: run.duration,
+            timedOut: run.timedOut,
+            output: run.output,
+        },
+    });
+    if (run.outcome !== 'failed')
+        return null;
+    const error = 'Watcher focused scenario tests failed';
+    return fail('verify_red', formatFocusedDeadMarker(run.command, run.output), error);
+}
+//# sourceMappingURL=focused-verify.js.map

package/dist/watcher/focused-verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focused-verify.js","sourceRoot":"","sources":["../../src/watcher/focused-verify.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAIzD,iGAAiG;AACjG,SAAS,uBAAuB,CAAC,OAAe,EAAE,MAAc;IAC9D,MAAM,IAAI,GAAG,MAAM,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;IAC7E,OAAO;QACL,KAAK;QACL,oBAAoB;QACpB,eAAe;QACf,aAAa,OAAO,GAAG;QACvB,KAAK;QACL,wCAAwC;QACxC,IAAI;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAA0B,EAC1B,IAAY;IAEZ,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC9E,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClF,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IACnF,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAE9B,MAAM,kBAAkB,CAAC,cAAc,EAAE,UAAU,EAAE;QACnD,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,IAAI,EAAE;YACJ,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;YACrB,SAAS,EAAE,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC;YAC7B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB;KACF,CAAC,CAAC;IAEH,IAAI,GAAG,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,KAAK,GAAG,uCAAuC,CAAC;IACtD,OAAO,IAAI,CAAC,YAAY,EAAE,uBAAuB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;AACrF,CAAC"}

package/dist/watcher/git-guard.d.ts

@@ -0,0 +1,24 @@
+import type { OsqConfig } from '../core/foundation/config.js';
+import type { Logger } from '../core/foundation/logger.js';
+import { type VcsMovedField } from '../core/vcs/snapshot.js';
+export interface GitGuardOptions {
+    readonly projectRoot: string;
+    readonly specFolderPath: string;
+    readonly taskNumber: string;
+    readonly scope: readonly string[];
+    readonly config: OsqConfig;
+    readonly logger?: Logger;
+}
+/** The per-task guard `runTask` opens before spawn and checks after exit. */
+export interface GitGuard {
+    check(): Promise<void>;
+}
+/** A warning naming what moved, how to put each back, and the human-edit caveat. */
+export declare function formatVcsViolationWarning(moved: readonly VcsMovedField[]): string;
+/**
+ * Select through `selectVcs` and capture the git state before the agent spawns.
+ * Returns null when `NoVcs` is selected or a git read fails; a failed read logs
+ * a warning and records nothing.
+ */
+export declare function beginGitGuard(options: GitGuardOptions): Promise<GitGuard | null>;
+//# sourceMappingURL=git-guard.d.ts.map

package/dist/watcher/git-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-guard.d.ts","sourceRoot":"","sources":["../../src/watcher/git-guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAG3D,OAAO,EAEL,KAAK,aAAa,EAKnB,MAAM,yBAAyB,CAAC;AAIjC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,6EAA6E;AAC7E,MAAM,WAAW,QAAQ;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAkBD,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAGjF;AA2ED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAUtF"}

package/dist/watcher/git-guard.js

@@ -0,0 +1,95 @@
+import path from 'node:path';
+import { resolveScope } from '../core/run/scope.js';
+import { selectVcs } from '../core/vcs/select.js';
+import { captureSnapshot, compareSnapshots, } from '../core/vcs/snapshot.js';
+import { appendHarnessEvent } from '../harness/types.js';
+/** The recovery text for each moved field; osq only prints it, never runs git. */
+const PUT_BACK = {
+    head: 'git reset --soft <before>',
+    branch: 'git switch <before>',
+    index: 'git restore --staged <paths>',
+    stash: 'git stash pop',
+};
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function warn(options, message) {
+    options.logger?.warn(message);
+}
+/** A warning naming what moved, how to put each back, and the human-edit caveat. */
+export function formatVcsViolationWarning(moved) {
+    const parts = moved.map((field) => `${field} moved (put it back with \`${PUT_BACK[field]}\`)`);
+    return `git state changed during the task: ${parts.join('; ')}. A human using git in this checkout during the task causes the same result.`;
+}
+/** The sorted changed files that are outside the resolved scope and change folder. */
+async function scopeViolations(options, changedFiles) {
+    const changePrefix = path
+        .relative(options.projectRoot, options.specFolderPath)
+        .split(path.sep)
+        .join('/');
+    const resolved = await resolveScope(options.projectRoot, options.scope);
+    const inScope = new Set(resolved.filter((entry) => entry.absolutePath !== null).map((entry) => entry.relativePath));
+    return changedFiles
+        .filter((file) => !inScope.has(file))
+        .filter((file) => file !== changePrefix && !file.startsWith(`${changePrefix}/`))
+        .sort();
+}
+async function appendVcsViolation(options, before, after, moved) {
+    await appendHarnessEvent(options.specFolderPath, options.taskNumber, {
+        type: 'vcs_violation',
+        timestamp: new Date().toISOString(),
+        data: { moved, before, after },
+    });
+    warn(options, formatVcsViolationWarning(moved));
+}
+async function appendScopeViolation(options, files) {
+    await appendHarnessEvent(options.specFolderPath, options.taskNumber, {
+        type: 'scope_violation',
+        timestamp: new Date().toISOString(),
+        data: { files },
+    });
+    warn(options, `files changed outside the task's scope: ${files.join(', ')}`);
+}
+async function checkGitGuard(vcs, before, options) {
+    let after;
+    let comparison;
+    try {
+        after = await captureSnapshot(vcs, options.projectRoot);
+        comparison = compareSnapshots(before, after);
+    }
+    catch (err) {
+        warn(options, `git state not recorded: ${errorMessage(err)}`);
+        return;
+    }
+    try {
+        if (comparison.moved.length > 0) {
+            await appendVcsViolation(options, before.values, after.values, comparison.moved);
+        }
+        const files = await scopeViolations(options, comparison.changedFiles);
+        if (files.length > 0) {
+            await appendScopeViolation(options, files);
+        }
+    }
+    catch (err) {
+        warn(options, `git state not recorded: ${errorMessage(err)}`);
+    }
+}
+/**
+ * Select through `selectVcs` and capture the git state before the agent spawns.
+ * Returns null when `NoVcs` is selected or a git read fails; a failed read logs
+ * a warning and records nothing.
+ */
+export async function beginGitGuard(options) {
+    try {
+        const vcs = await selectVcs(options.projectRoot, options.config);
+        if (vcs.kind !== 'git')
+            return null;
+        const before = await captureSnapshot(vcs, options.projectRoot);
+        return { check: () => checkGitGuard(vcs, before, options) };
+    }
+    catch (err) {
+        warn(options, `git checks off: ${errorMessage(err)}`);
+        return null;
+    }
+}
+//# sourceMappingURL=git-guard.js.map

package/dist/watcher/git-guard.js.map

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

package/dist/watcher/instructions-drift.d.ts

@@ -0,0 +1,21 @@
+import type { OsqConfig } from '../core/foundation/config.js';
+import type { Logger } from '../core/foundation/logger.js';
+export interface InstructionsDriftOptions {
+    readonly projectRoot: string;
+    readonly specFolderPath: string;
+    readonly taskNumber: string;
+    readonly config: OsqConfig;
+    readonly logger?: Logger;
+    /** Target-wide execution attempt; the check runs only for attempt 1. */
+    readonly attempt: number;
+}
+/**
+ * Before a task's first attempt, compares the instruction inputs pinned at
+ * approval with the current tree: AGENTS.md and, when the manifest recorded
+ * them, the governing ADRs. When anything differs it appends one
+ * `instructions_changed` event and prints one warning. The task still runs.
+ * Later attempts, an unapproved manifest, and a stream that already recorded
+ * drift do nothing.
+ */
+export declare function checkInstructionsDrift(opts: InstructionsDriftOptions): Promise<void>;
+//# sourceMappingURL=instructions-drift.d.ts.map

package/dist/watcher/instructions-drift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions-drift.d.ts","sourceRoot":"","sources":["../../src/watcher/instructions-drift.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAI3D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AA8FD;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B1F"}