@software-dlc/cli 0.157.2

package/dist/local/experimental/path-object-store.js

@@ -0,0 +1,135 @@
+/** Local experimental object storage only. No production sync/manifest wiring. */
+import { randomUUID } from 'node:crypto';
+import { constants } from 'node:fs';
+import { link, lstat, mkdir, open, unlink } from 'node:fs/promises';
+import { dirname, isAbsolute, join } from 'node:path';
+import { z } from 'zod';
+import { canonicalGraphSyncBytes, hashGraphSyncObjectSync } from '@software-dlc/graph/schema/canonical';
+import { graph_sync_hash_schema } from '@software-dlc/graph/schema/sync';
+import { experimental_path_object_schema } from '@software-dlc/graph/schema/experimental/path-portable';
+import { hashExperimentalPathRoute } from '@software-dlc/graph/schema/experimental/path-route';
+const supported_versions_schema = z
+    .array(z.union([z.literal(1), z.literal(2), z.literal(3)]))
+    .min(1);
+const MAX_OBJECT_BYTES = 1048576;
+function sameBytes(left, right) {
+    return (left.length === right.length &&
+        left.every((byte, index) => byte === right[index]));
+}
+function verifyObject(bytes, object_hash, versions) {
+    graph_sync_hash_schema.parse(object_hash);
+    if (bytes.length > MAX_OBJECT_BYTES)
+        throw new Error('Path object exceeds the 1 MiB limit.');
+    const value = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes));
+    const object = experimental_path_object_schema.parse(value);
+    if (!versions.includes(object.schema_version))
+        throw new Error(`Unsupported Path schema version ${object.schema_version}.`);
+    if (!sameBytes(bytes, canonicalGraphSyncBytes(object)))
+        throw new Error('Path object bytes are not canonical.');
+    const actual_hash = object.schema_version === 3
+        ? hashExperimentalPathRoute(object)
+        : hashGraphSyncObjectSync(object);
+    if (actual_hash !== object_hash)
+        throw new Error('Path object hash verification failed.');
+    return object;
+}
+async function syncDirectory(directory) {
+    const handle = await open(directory, constants.O_RDONLY);
+    try {
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+/**
+ * Caller owns an existing private root. No live-sidecar default is provided.
+ * Capabilities describe format support, not authorization or graph validity.
+ */
+export class ExperimentalPathObjectStore {
+    directory;
+    supported_versions;
+    constructor(input) {
+        this.directory = join(z
+            .string()
+            .min(1)
+            .refine(isAbsolute, 'An absolute private root is required.')
+            .parse(input.directory), 'experimental-path-objects-v1');
+        this.supported_versions = supported_versions_schema.parse(input.supported_versions);
+    }
+    objectPath(object_hash) {
+        graph_sync_hash_schema.parse(object_hash);
+        const digest = object_hash.slice('sha256:'.length);
+        return join(this.directory, digest.slice(0, 2), digest);
+    }
+    async read(object_hash) {
+        const handle = await open(this.objectPath(object_hash), constants.O_RDONLY | constants.O_NOFOLLOW);
+        let bytes;
+        try {
+            const stat = await handle.stat();
+            if (!stat.isFile() || stat.size > MAX_OBJECT_BYTES)
+                throw new Error('Invalid or oversized Path object file.');
+            // Bound allocation/read even if an external writer grows a corrupt file.
+            const buffer = new Uint8Array(MAX_OBJECT_BYTES + 1);
+            let length = 0;
+            while (length < buffer.length) {
+                const result = await handle.read(buffer, length, buffer.length - length, null);
+                if (result.bytesRead === 0)
+                    break;
+                length += result.bytesRead;
+            }
+            bytes = buffer.slice(0, length);
+        }
+        finally {
+            await handle.close();
+        }
+        const object = verifyObject(bytes, object_hash, this.supported_versions);
+        return { object_hash, object, bytes };
+    }
+    async put(input) {
+        if (input.bytes.byteLength > MAX_OBJECT_BYTES)
+            throw new Error('Path object exceeds the 1 MiB limit.');
+        // Copy before the first await so caller mutation cannot change publication.
+        const bytes = input.bytes.slice();
+        const object_hash = input.object_hash;
+        verifyObject(bytes, object_hash, this.supported_versions);
+        const destination = this.objectPath(object_hash);
+        const directory = dirname(destination);
+        const root = await lstat(dirname(this.directory));
+        if (!root.isDirectory())
+            throw new Error('Path object root must be an existing private directory.');
+        await mkdir(directory, { recursive: true, mode: 0o700 });
+        const temporary = join(directory, `.pending-${randomUUID()}`);
+        const handle = await open(temporary, 'wx', 0o600);
+        try {
+            try {
+                await handle.writeFile(bytes);
+                await handle.sync();
+            }
+            finally {
+                await handle.close();
+            }
+            try {
+                // A hard link publishes complete bytes atomically without replacement.
+                await link(temporary, destination);
+            }
+            catch (error) {
+                if (!(error instanceof Error) ||
+                    !('code' in error) ||
+                    error.code !== 'EEXIST')
+                    throw error;
+                const existing = await this.read(object_hash);
+                if (!sameBytes(existing.bytes, bytes))
+                    throw new Error('Immutable Path object storage mismatch.');
+            }
+            await syncDirectory(directory);
+            await syncDirectory(this.directory);
+            await syncDirectory(dirname(this.directory));
+        }
+        finally {
+            // Only this invocation's staging file is eligible for cleanup.
+            await unlink(temporary);
+        }
+    }
+}
+//# sourceMappingURL=path-object-store.js.map

package/dist/local/experimental/path-object-store.js.map

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

package/dist/local/external-worktree-binding.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export declare const EXTERNAL_WORKTREE_BINDING_FILENAME: "softwaredlc.project.json";
+export declare const external_worktree_remote_id_schema: z.ZodString;
+export declare const external_worktree_binding_schema: z.ZodObject<{
+    schema_version: z.ZodLiteral<"1">;
+    remote: z.ZodObject<{
+        remote_id: z.ZodString;
+    }, z.core.$strict>;
+    binding: z.ZodObject<{
+        worktree_id: z.ZodString;
+        repository_id: z.ZodOptional<z.ZodString>;
+        branch_id: z.ZodOptional<z.ZodString>;
+        expected_source_ref: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    preferences: z.ZodOptional<z.ZodObject<{
+        save_after_coherent_change: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ExternalWorktreeBinding = z.infer<typeof external_worktree_binding_schema>;
+export declare function parseExternalWorktreeBinding(value: unknown): ExternalWorktreeBinding;
+//# sourceMappingURL=external-worktree-binding.d.ts.map

package/dist/local/external-worktree-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-worktree-binding.d.ts","sourceRoot":"","sources":["../../src/local/external-worktree-binding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kCAAkC,EAC7C,0BAAmC,CAAC;AAKtC,eAAO,MAAM,kCAAkC,aAKpB,CAAC;AA4C5B,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;kBAOlC,CAAC;AAEZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,gCAAgC,CACxC,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,uBAAuB,CAEzB"}

package/dist/local/external-worktree-binding.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+export const EXTERNAL_WORKTREE_BINDING_FILENAME = 'softwaredlc.project.json';
+const REMOTE_ID_PATTERN = /^[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?$/i;
+const GIT_REF_PATTERN = /^refs\/[A-Za-z0-9._\/-]+$/;
+export const external_worktree_remote_id_schema = z
+    .string()
+    .trim()
+    .min(1)
+    .max(128)
+    .regex(REMOTE_ID_PATTERN);
+const external_worktree_remote_schema = z
+    .object({
+    remote_id: external_worktree_remote_id_schema
+})
+    .strict();
+const expected_source_ref_schema = z
+    .string()
+    .trim()
+    .min(6)
+    .max(1_024)
+    .regex(GIT_REF_PATTERN)
+    .refine((value) => !value.includes('..'), {
+    message: 'Git refs must not contain consecutive dots.'
+})
+    .refine((value) => !value.includes('//'), {
+    message: 'Git refs must not contain consecutive slashes.'
+})
+    .refine((value) => !value.includes('@{'), {
+    message: 'Git refs must not contain reflog syntax.'
+})
+    .refine((value) => !value.endsWith('/') && !value.endsWith('.') && !value.endsWith('.lock'), { message: 'Git refs must have a valid terminal component.' });
+const external_worktree_binding_identity_schema = z
+    .object({
+    worktree_id: z.string().uuid(),
+    repository_id: z.string().uuid().optional(),
+    branch_id: z.string().uuid().optional(),
+    expected_source_ref: expected_source_ref_schema.optional()
+})
+    .strict();
+const external_worktree_preferences_schema = z
+    .object({
+    save_after_coherent_change: z.boolean()
+})
+    .strict();
+export const external_worktree_binding_schema = z
+    .object({
+    schema_version: z.literal('1'),
+    remote: external_worktree_remote_schema,
+    binding: external_worktree_binding_identity_schema,
+    preferences: external_worktree_preferences_schema.optional()
+})
+    .strict();
+export function parseExternalWorktreeBinding(value) {
+    return external_worktree_binding_schema.parse(value);
+}
+//# sourceMappingURL=external-worktree-binding.js.map

package/dist/local/external-worktree-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-worktree-binding.js","sourceRoot":"","sources":["../../src/local/external-worktree-binding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kCAAkC,GAC7C,0BAAmC,CAAC;AAEtC,MAAM,iBAAiB,GAAG,sCAAsC,CAAC;AACjE,MAAM,eAAe,GAAG,2BAA2B,CAAC;AAEpD,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC;KAChD,MAAM,EAAE;KACR,IAAI,EAAE;KACN,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,CAAC,iBAAiB,CAAC,CAAC;AAE5B,MAAM,+BAA+B,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,SAAS,EAAE,kCAAkC;CAC9C,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,0BAA0B,GAAG,CAAC;KACjC,MAAM,EAAE;KACR,IAAI,EAAE;KACN,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,KAAK,CAAC;KACV,KAAK,CAAC,eAAe,CAAC;KACtB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;IACxC,OAAO,EAAE,6CAA6C;CACvD,CAAC;KACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;IACxC,OAAO,EAAE,gDAAgD;CAC1D,CAAC;KACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;IACxC,OAAO,EAAE,0CAA0C;CACpD,CAAC;KACD,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CACR,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAC1E,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAC9D,CAAC;AAEJ,MAAM,yCAAyC,GAAG,CAAC;KAChD,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC9B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACvC,mBAAmB,EAAE,0BAA0B,CAAC,QAAQ,EAAE;CAC3D,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,oCAAoC,GAAG,CAAC;KAC3C,MAAM,CAAC;IACN,0BAA0B,EAAE,CAAC,CAAC,OAAO,EAAE;CACxC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC;KAC9C,MAAM,CAAC;IACN,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IAC9B,MAAM,EAAE,+BAA+B;IACvC,OAAO,EAAE,yCAAyC;IAClD,WAAW,EAAE,oCAAoC,CAAC,QAAQ,EAAE;CAC7D,CAAC;KACD,MAAM,EAAE,CAAC;AAMZ,MAAM,UAAU,4BAA4B,CAC1C,KAAc;IAEd,OAAO,gCAAgC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC"}

package/dist/local/folder-members.d.ts

@@ -0,0 +1,34 @@
+import type { PortableGraph } from '@software-dlc/graph/types';
+import type { LocalWorkspaceTaskScope } from './workspace-scope.js';
+/**
+ * A folder's members, read as the coordination engine's folder.py reads them:
+ * the home's `sdlc-executions/folder.json` lists each member by a path relative
+ * to the folder, and a member counts only when its own `sdlc-folder.json`
+ * pointer names it and this home, so a membership entry alone joins nothing.
+ */
+export type FolderMember = {
+    name: string;
+    path: string;
+};
+export type SkippedFolderMember = FolderMember & {
+    reason: string;
+};
+export type FolderMembers = {
+    folder: string;
+    home: string;
+    members: FolderMember[];
+    skipped: SkippedFolderMember[];
+};
+/**
+ * The members of the folder whose home holds `git_common_dir`, but the home
+ * itself; refuses when this repository is not a folder's home.
+ */
+export declare function readFolderMembers(git_common_dir: string): Promise<FolderMembers>;
+/**
+ * A repository's whole-repository task scope: every node whose source
+ * references name one of `repository_names` (compared case-insensitively, as
+ * GitHub names are), and every edge touching one of them; null when no node
+ * cites the repository. A reference naming no repository belongs to none.
+ */
+export declare function repositoryTaskScope(graph: PortableGraph, repository_names: readonly string[]): LocalWorkspaceTaskScope | null;
+//# sourceMappingURL=folder-members.d.ts.map

package/dist/local/folder-members.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-members.d.ts","sourceRoot":"","sources":["../../src/local/folder-members.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAC1D,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC,CAAC;AAkGF;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC,CA0DxB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EACpB,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,uBAAuB,GAAG,IAAI,CA8BhC"}

package/dist/local/folder-members.js

@@ -0,0 +1,168 @@
+import { lstat, open, realpath } from 'node:fs/promises';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { sourceFiles } from './blast-radius.js';
+const STATE = 'sdlc-executions';
+const MEMBERSHIP = 'folder.json';
+const POINTER = 'sdlc-folder.json';
+const SCHEMA_VERSION = 1;
+const READ_LIMIT = 64 << 10;
+const NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+/** A folder file's JSON object, or null when it is missing; a link, an oversized or non-object file refuses. */
+async function readFolderFile(path) {
+    let info;
+    try {
+        info = await lstat(path);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+    if (!info.isFile() || info.size > READ_LIMIT) {
+        throw new Error(`${path} is not a regular file of at most ${READ_LIMIT} bytes`);
+    }
+    const handle = await open(path, 'r');
+    let doc;
+    try {
+        doc = JSON.parse(await handle.readFile('utf8'));
+    }
+    catch {
+        throw new Error(`${path} is not valid JSON`);
+    }
+    finally {
+        await handle.close();
+    }
+    if (doc === null ||
+        typeof doc !== 'object' ||
+        Array.isArray(doc) ||
+        doc.schema_version !== SCHEMA_VERSION) {
+        throw new Error(`${path} is not a schema_version ${SCHEMA_VERSION} folder file`);
+    }
+    return doc;
+}
+function relativePath(value, what, path) {
+    if (typeof value !== 'string' ||
+        !value ||
+        value.includes('\\') ||
+        value.includes('\0') ||
+        isAbsolute(value)) {
+        throw new Error(`${path}: ${what} must be a relative path`);
+    }
+    return value;
+}
+/** Why the checkout at `checkout` is not the member `name` of the home at `home`, or null when it is. */
+async function notAMember(checkout, name, home) {
+    const git_dir = join(checkout, '.git');
+    try {
+        if (!(await lstat(git_dir)).isDirectory())
+            return `${checkout} is not a primary checkout`;
+    }
+    catch {
+        return `nothing at ${checkout}`;
+    }
+    let pointer;
+    try {
+        pointer = await readFolderFile(join(git_dir, POINTER));
+    }
+    catch (error) {
+        return error.message;
+    }
+    if (!pointer)
+        return `${checkout} has no folder pointer: it left the folder`;
+    if (pointer.name !== name)
+        return `${join(git_dir, POINTER)} names another repository`;
+    let pointed;
+    try {
+        pointed = await realpath(resolve(checkout, relativePath(pointer.home, 'home', join(git_dir, POINTER))));
+    }
+    catch (error) {
+        return error.message;
+    }
+    return pointed === home
+        ? null
+        : `${join(git_dir, POINTER)} names another home`;
+}
+/**
+ * The members of the folder whose home holds `git_common_dir`, but the home
+ * itself; refuses when this repository is not a folder's home.
+ */
+export async function readFolderMembers(git_common_dir) {
+    const path = join(git_common_dir, STATE, MEMBERSHIP);
+    const doc = await readFolderFile(path);
+    if (!doc) {
+        throw new Error(`This repository is not the home of a folder of repositories (no ${path}): run attach --all-members in the plan coordinator of the folder's home, after sdlc-agents setup in the folder.`);
+    }
+    const { folder, home, members } = doc;
+    if (typeof folder !== 'string' || !isAbsolute(folder)) {
+        throw new Error(`${path}: folder must be an absolute path`);
+    }
+    if (members === null ||
+        typeof members !== 'object' ||
+        Array.isArray(members)) {
+        throw new Error(`${path}: members must name at least the home`);
+    }
+    const listed = Object.entries(members).map(([name, rel]) => {
+        if (!NAME.test(name)) {
+            throw new Error(`${path}: a repository name is 1-64 letters, digits, '.', '_' or '-'`);
+        }
+        return {
+            name,
+            path: resolve(folder, relativePath(rel, `member ${name}`, path))
+        };
+    });
+    if (typeof home !== 'string' ||
+        !listed.some((member) => member.name === home)) {
+        throw new Error(`${path}: the home ${String(home)} is not a member`);
+    }
+    const home_checkout = await realpath(dirname(resolve(git_common_dir)));
+    const recorded = listed.find((member) => member.name === home).path;
+    if ((await realpath(recorded).catch(() => null)) !== home_checkout) {
+        // As folder.py locate refuses: the folder moved since it was recorded
+        throw new Error(`${path} places the home at ${recorded}, not ${home_checkout}: run sdlc-agents folder relocate.`);
+    }
+    const result = { folder, home, members: [], skipped: [] };
+    for (const member of listed.sort((a, b) => a.name.localeCompare(b.name))) {
+        if (member.name === home)
+            continue;
+        const reason = await notAMember(member.path, member.name, home_checkout);
+        if (reason)
+            result.skipped.push({ ...member, reason });
+        else
+            result.members.push(member);
+    }
+    return result;
+}
+/**
+ * A repository's whole-repository task scope: every node whose source
+ * references name one of `repository_names` (compared case-insensitively, as
+ * GitHub names are), and every edge touching one of them; null when no node
+ * cites the repository. A reference naming no repository belongs to none.
+ */
+export function repositoryTaskScope(graph, repository_names) {
+    const names = new Set(repository_names.map((name) => name.toLowerCase()));
+    const nodes = graph.nodes
+        .filter((node) => sourceFiles(node).some((file) => file.repository !== null && names.has(file.repository.toLowerCase())))
+        .map((node) => node.id);
+    if (nodes.length === 0)
+        return null;
+    const cited = new Set(nodes);
+    const edges = graph.edges
+        .filter((edge) => cited.has(edge.source) || cited.has(edge.target))
+        .map((edge) => edge.id);
+    return {
+        version: 1,
+        rules: [
+            ...nodes.sort().map((entity_id) => ({
+                entity_kind: 'node',
+                entity_id,
+                field_path: '/'
+            })),
+            ...edges.sort().map((entity_id) => ({
+                entity_kind: 'edge',
+                entity_id,
+                field_path: '/'
+            }))
+        ]
+    };
+}
+//# sourceMappingURL=folder-members.js.map

package/dist/local/folder-members.js.map

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

package/dist/local/git-ref-authority.d.ts

@@ -0,0 +1,11 @@
+export type GitRefNamespace = 'detached' | 'local_branch' | 'remote_tracking' | 'tag' | 'other';
+export type GitRefAuthority = {
+    version: 1;
+    status: 'mutable_local_ref' | 'read_only_ref' | 'unauthorized_ref';
+    ref_name: string | null;
+    namespace: GitRefNamespace;
+    reason: string;
+};
+export declare function inspectGitRefAuthority(ref_name: string | null): GitRefAuthority;
+export declare function requireMutableLocalBranchRef(ref_name: string, label: string): string;
+//# sourceMappingURL=git-ref-authority.d.ts.map

package/dist/local/git-ref-authority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-ref-authority.d.ts","sourceRoot":"","sources":["../../src/local/git-ref-authority.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,cAAc,GACd,iBAAiB,GACjB,KAAK,GACL,OAAO,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,mBAAmB,GAAG,eAAe,GAAG,kBAAkB,CAAC;IACnE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAiCF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,eAAe,CA0CjB;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,MAAM,CAQR"}

package/dist/local/git-ref-authority.js

@@ -0,0 +1,76 @@
+function gitRefNamespace(ref_name) {
+    if (ref_name === null)
+        return 'detached';
+    if (ref_name.startsWith('refs/heads/'))
+        return 'local_branch';
+    if (ref_name.startsWith('refs/remotes/'))
+        return 'remote_tracking';
+    if (ref_name.startsWith('refs/tags/'))
+        return 'tag';
+    return 'other';
+}
+function validGitRefPath(ref_name) {
+    if (ref_name.length === 0 ||
+        ref_name.startsWith('/') ||
+        ref_name.endsWith('/') ||
+        ref_name.endsWith('.') ||
+        ref_name.includes('..') ||
+        ref_name.includes('@{') ||
+        ref_name.includes('//') ||
+        /[\u0000-\u0020\u007f~^:?*\[\\]/.test(ref_name)) {
+        return false;
+    }
+    return ref_name
+        .split('/')
+        .every((component) => component.length > 0 &&
+        !component.startsWith('.') &&
+        !component.endsWith('.lock'));
+}
+export function inspectGitRefAuthority(ref_name) {
+    const namespace = gitRefNamespace(ref_name);
+    if (namespace === 'detached') {
+        return {
+            version: 1,
+            status: 'read_only_ref',
+            ref_name,
+            namespace,
+            reason: 'Detached Git state has no mutable attached ref.'
+        };
+    }
+    if (namespace === 'remote_tracking' || namespace === 'tag') {
+        return {
+            version: 1,
+            status: 'read_only_ref',
+            ref_name,
+            namespace,
+            reason: 'Remote-tracking refs and tags are immutable inputs.'
+        };
+    }
+    if (namespace === 'local_branch' &&
+        ref_name !== null &&
+        ref_name.length > 'refs/heads/'.length &&
+        validGitRefPath(ref_name)) {
+        return {
+            version: 1,
+            status: 'mutable_local_ref',
+            ref_name,
+            namespace,
+            reason: 'Only this local branch namespace may back a mutable local SDLC ref.'
+        };
+    }
+    return {
+        version: 1,
+        status: 'unauthorized_ref',
+        ref_name,
+        namespace,
+        reason: 'The ref is not a valid mutable local branch ref.'
+    };
+}
+export function requireMutableLocalBranchRef(ref_name, label) {
+    const authority = inspectGitRefAuthority(ref_name);
+    if (authority.status !== 'mutable_local_ref') {
+        throw new Error(`${label} is unauthorized: ${authority.namespace} refs cannot back mutable local workspace history.`);
+    }
+    return ref_name;
+}
+//# sourceMappingURL=git-ref-authority.js.map

package/dist/local/git-ref-authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-ref-authority.js","sourceRoot":"","sources":["../../src/local/git-ref-authority.ts"],"names":[],"mappings":"AAeA,SAAS,eAAe,CAAC,QAAuB;IAC9C,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,UAAU,CAAC;IACzC,IAAI,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,cAAc,CAAC;IAC9D,IAAI,QAAQ,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,iBAAiB,CAAC;IACnE,IAAI,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IACpD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,IACE,QAAQ,CAAC,MAAM,KAAK,CAAC;QACrB,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;QACxB,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QACtB,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QACtB,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QACvB,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QACvB,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QACvB,gCAAgC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAC/C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,QAAQ;SACZ,KAAK,CAAC,GAAG,CAAC;SACV,KAAK,CACJ,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,MAAM,GAAG,CAAC;QACpB,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;QAC1B,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAC/B,CAAC;AACN,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAAuB;IAEvB,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QAC7B,OAAO;YACL,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,eAAe;YACvB,QAAQ;YACR,SAAS;YACT,MAAM,EAAE,iDAAiD;SAC1D,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,KAAK,iBAAiB,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QAC3D,OAAO;YACL,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,eAAe;YACvB,QAAQ;YACR,SAAS;YACT,MAAM,EAAE,qDAAqD;SAC9D,CAAC;IACJ,CAAC;IACD,IACE,SAAS,KAAK,cAAc;QAC5B,QAAQ,KAAK,IAAI;QACjB,QAAQ,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM;QACtC,eAAe,CAAC,QAAQ,CAAC,EACzB,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,mBAAmB;YAC3B,QAAQ;YACR,SAAS;YACT,MAAM,EACJ,qEAAqE;SACxE,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,kBAAkB;QAC1B,QAAQ;QACR,SAAS;QACT,MAAM,EAAE,kDAAkD;KAC3D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAAgB,EAChB,KAAa;IAEb,MAAM,SAAS,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,SAAS,CAAC,MAAM,KAAK,mBAAmB,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,qBAAqB,SAAS,CAAC,SAAS,oDAAoD,CACrG,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/local/git.d.ts

@@ -0,0 +1,88 @@
+export type GitWorktreeContext = {
+    repository_root: string;
+    git_dir: string;
+    git_common_dir: string;
+    ref: string | null;
+    head: string;
+    is_dirty: boolean;
+};
+export type GitRemoteIdentity = {
+    remote_name: string;
+    remote_url: string;
+    repository_identity: string;
+};
+export declare function discoverGitWorktree(cwd?: string): Promise<GitWorktreeContext>;
+export declare function canonicalGitRepositoryIdentity(remote_url: string, cwd?: string): string;
+/**
+ * The project's integration branch (project.py INTEGRATION_BRANCH), from the
+ * coordination engine's project.json where engine_config.py finds it: beside
+ * an engine inside the repository (scripts/agent-coordination/), else in the
+ * worktree's sdlc-coordination/, else in the Git common dir's (a no-footprint
+ * repository's), which a repository the user's setup registered reads first.
+ * A file that is missing, unreadable, or names no valid branch gives main,
+ * the engine's default.
+ */
+export declare function integrationBranch(cwd?: string): Promise<string>;
+/**
+ * The remote a source reference's repository is named from: the one the local
+ * integration branch (integrationBranch), else main, else master tracks, else
+ * the one the current branch tracks, else origin (sources.py tracked_remote).
+ * In a fork setup origin is the developer's fork and the integration branch
+ * tracks upstream. Branch configuration is shared by every worktree, so a
+ * detached child workspace or an untracked thread branch names the repository
+ * as the main checkout does.
+ */
+export declare function trackedRemoteName(cwd?: string): Promise<string>;
+/**
+ * `owner/name` from a hosted remote URL (https or ssh), or null for a local
+ * path or file URL, whose last two directories name no repository
+ * (sources.py owner_name). A hosted URL always has a colon (scheme or
+ * host:path); a relative path has none.
+ */
+export declare function remoteOwnerName(url: string): string | null;
+/**
+ * Every `owner/name` the repository at `cwd` goes by at `commit`, the one
+ * source references record first (sources.py repository_names, the same set).
+ * The remotes, in order, are its tracked remote (trackedRemoteName), origin,
+ * the other remotes a local branch tracks, then any other whose
+ * remote-tracking branches contain `commit` or its first-parent root commit
+ * (they share its history); the first of them naming an `owner/name` whose branches
+ * contain `commit` comes first, else the first naming one; origin, when first,
+ * gives way to a remote named upstream (Git's name for a fork's parent) when
+ * its main line (origin/HEAD, else main, else master) holds nothing past
+ * upstream's branches. A fork (origin, however it is named)
+ * and its upstream are one repository here: a fork whose only branch tracks
+ * the fork while upstream holds the commit, or whose main line sits level
+ * with or behind upstream, pushed feature branches or not, is named from
+ * upstream; a fork whose main line has commits upstream lacks, and a
+ * canonical origin beside a fork of another name, keep their own, and a
+ * commit no remote holds yet names origin first, upstream still one of its
+ * names.
+ * A remote that neither a branch tracks nor shares the commit's history is not.
+ */
+export declare function repositoryNames(cwd?: string, commit?: string): Promise<string[]>;
+/**
+ * The remote whose `owner/name` source references record first
+ * (repositoryNames), or null when no remote names one. A source binding made
+ * with no remote named uses it, so a workspace commit's remote identity names
+ * the repository its references name.
+ */
+export declare function namingRemote(cwd?: string, commit?: string): Promise<string | null>;
+/** The names of the repository's remotes. */
+export declare function gitRemoteNames(cwd?: string): Promise<string[]>;
+export declare function discoverGitRemoteIdentity(cwd?: string, remote_name?: string): Promise<GitRemoteIdentity>;
+export declare function assertLocalWorkspacePathsIgnored(cwd: string): Promise<void>;
+export declare function createDetachedGitWorktree(input: {
+    source_cwd: string;
+    target_path: string;
+    commit_id: string;
+}): Promise<GitWorktreeContext>;
+export declare function removeGitWorktree(input: {
+    repository_cwd: string;
+    target_path: string;
+    force?: boolean;
+}): Promise<void>;
+export declare function listGitWorktreeStatus(cwd: string, input?: {
+    include_ignored?: boolean;
+}): Promise<string[]>;
+//# sourceMappingURL=git.d.ts.map

package/dist/local/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/local/git.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAkCF,wBAAsB,mBAAmB,CACvC,GAAG,SAAgB,GAClB,OAAO,CAAC,kBAAkB,CAAC,CA8B7B;AAED,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,MAAM,EAClB,GAAG,SAAgB,GAClB,MAAM,CAkBR;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqC5E;AAgCD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB5E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI1D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,eAAe,CACnC,GAAG,SAAgB,EACnB,MAAM,SAAS,GACd,OAAO,CAAC,MAAM,EAAE,CAAC,CAKnB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,GAAG,SAAgB,EACnB,MAAM,SAAS,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB;AA2GD,6CAA6C;AAC7C,wBAAsB,cAAc,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAI3E;AAED,wBAAsB,yBAAyB,CAC7C,GAAG,SAAgB,EACnB,WAAW,SAAW,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAmB5B;AAED,wBAAsB,gCAAgC,CACpD,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2B9B;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhB;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,KAAK,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,OAAO,CAAC,MAAM,EAAE,CAAC,CAKnB"}