@maycombhq/openspec-adapter 0.0.0-stage → 2.0.0-beta.1

package/dist/results.js.map

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

package/dist/stores.d.ts

@@ -0,0 +1,112 @@
+/**
+ * OpenSpec stores (beta; ADR 0126, an addendum to ADR 0006). A store is an `openspec/` folder in
+ * its own Git repo, marked by `.openspec-store/store.yaml`; a code repo names stores it reads
+ * under `references:` in its `openspec/config.yaml`. Atticus only writes the marker (to make a
+ * metarepo a store, when asked) and adds one `references:` entry (at hand-down, when the org pack
+ * asks); it reads stores read-only. It never registers, clones, pulls or pushes a store.
+ *
+ * The format is beta and may change, so everything about it is in this one file and every read
+ * is tolerant: an unknown version or extra key is a note, never a failure.
+ *
+ * The shape of store.yaml is OpenSpec 1.14.0's (`dist/core/store/foundation.js`,
+ * `MetadataStateSchema`, a strict object): `version: 1`, `id` (kebab-case, the store's name) and
+ * an optional `remote`. Ids follow its `KEBAB_ID_REGEX` (`dist/core/id.js`). A references entry
+ * is a store id, or `{ id, remote }` (`dist/core/project-config.js`, `parseDeclarationList`).
+ */
+/** The marker's folder and file, relative to the store's root (the folder holding openspec/). */
+export declare const STORE_MARKER_DIR = ".openspec-store";
+export declare const STORE_MARKER = ".openspec-store/store.yaml";
+/** The store.yaml version this Atticus writes and fully understands. */
+export declare const STORE_MARKER_VERSION = 1;
+export interface StoreMarker {
+    /** The store's name: kebab-case. */
+    id: string;
+    /** Where teammates clone it from, when known. */
+    remote?: string;
+}
+/** A store id OpenSpec accepts made from a name (an org pack name): undefined when none can be. */
+export declare function storeIdOf(name: string): string | undefined;
+/** store.yaml's text for a marker. Throws on an id OpenSpec would refuse. */
+export declare function storeMarkerText(m: StoreMarker): string;
+/**
+ * Read store.yaml's text, tolerantly: the id and remote of any version, with a note when the
+ * version isn't one this Atticus knows. Never throws.
+ */
+export declare function parseStoreMarker(text: string): {
+    marker?: StoreMarker;
+    notes: string[];
+};
+/** A folder's store.yaml: `missing` when there is none. Never throws. */
+export declare function readStoreMarker(dir: string): Promise<{
+    marker?: StoreMarker;
+    notes: string[];
+    missing: boolean;
+}>;
+/**
+ * Write store.yaml in a folder when it has none. One that is there is never replaced: `present`
+ * when it says the same id, `differs` when it names another (its marker is returned).
+ */
+export declare function writeStoreMarker(dir: string, m: StoreMarker): Promise<{
+    action: "created" | "present" | "differs";
+    marker?: StoreMarker;
+}>;
+/**
+ * Add a store to `references:` in an openspec/config.yaml's text, keeping its comments, order
+ * and every other key. An entry for the id that is there already (plain or with a remote) is
+ * left as it is. A file that isn't a mapping, or whose references isn't a list, is not changed.
+ */
+export declare function addStoreReference(text: string, ref: StoreMarker): {
+    text: string;
+    action: "added" | "present";
+} | {
+    problem: string;
+};
+export interface StoreChangeEntry {
+    id: string;
+    /** The proposal's first heading. */
+    title?: string;
+    /** Ticked and all checkboxes in tasks.md. */
+    tasks?: {
+        done: number;
+        total: number;
+    };
+    dir: string;
+}
+export interface StoreSpecEntry {
+    id: string;
+    /** The first line of the spec's Purpose section. */
+    purpose?: string;
+    file: string;
+}
+/** What Atticus reads from a store: never more than names, titles, task counts and purposes. */
+export interface StoreView {
+    /** The store's root (the folder holding openspec/ and .openspec-store/). */
+    dir: string;
+    /** From store.yaml, when it has one. */
+    id?: string;
+    remote?: string;
+    /** Open changes (not archive/), by id. */
+    changes: StoreChangeEntry[];
+    specs: StoreSpecEntry[];
+    /** What couldn't be read, or was read with a caveat. */
+    notes: string[];
+}
+/**
+ * The first line of a spec's Purpose section: outside code fences, with a heading's closing
+ * hashes allowed (as OpenSpec reads it for its references index).
+ */
+export declare function purposeLine(markdown: string): string | undefined;
+/**
+ * Read a store, read-only: its store.yaml (when there is one), its open changes and its specs.
+ * Never throws and never writes; what can't be read becomes a note.
+ */
+export declare function readStore(dir: string): Promise<StoreView>;
+/**
+ * Whether an OpenSpec CLI has stores (`openspec store --help` runs). The bundled, pinned one by
+ * default. Offline: no telemetry, no update check.
+ */
+export declare function openspecHasStores(o?: {
+    bin?: string;
+    env?: NodeJS.ProcessEnv;
+    timeoutMs?: number;
+}): Promise<boolean>;

package/dist/stores.js

@@ -0,0 +1,249 @@
+import { execFile } from "node:child_process";
+import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { isMap, isScalar, isSeq, parse, parseDocument, stringify } from "yaml";
+import { bundledOpenSpecBin, openspecEnv } from "./adapter.js";
+/**
+ * OpenSpec stores (beta; ADR 0126, an addendum to ADR 0006). A store is an `openspec/` folder in
+ * its own Git repo, marked by `.openspec-store/store.yaml`; a code repo names stores it reads
+ * under `references:` in its `openspec/config.yaml`. Atticus only writes the marker (to make a
+ * metarepo a store, when asked) and adds one `references:` entry (at hand-down, when the org pack
+ * asks); it reads stores read-only. It never registers, clones, pulls or pushes a store.
+ *
+ * The format is beta and may change, so everything about it is in this one file and every read
+ * is tolerant: an unknown version or extra key is a note, never a failure.
+ *
+ * The shape of store.yaml is OpenSpec 1.14.0's (`dist/core/store/foundation.js`,
+ * `MetadataStateSchema`, a strict object): `version: 1`, `id` (kebab-case, the store's name) and
+ * an optional `remote`. Ids follow its `KEBAB_ID_REGEX` (`dist/core/id.js`). A references entry
+ * is a store id, or `{ id, remote }` (`dist/core/project-config.js`, `parseDeclarationList`).
+ */
+/** The marker's folder and file, relative to the store's root (the folder holding openspec/). */
+export const STORE_MARKER_DIR = ".openspec-store";
+export const STORE_MARKER = `${STORE_MARKER_DIR}/store.yaml`;
+/** The store.yaml version this Atticus writes and fully understands. */
+export const STORE_MARKER_VERSION = 1;
+const KEBAB = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** A store id OpenSpec accepts made from a name (an org pack name): undefined when none can be. */
+export function storeIdOf(name) {
+    const id = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return id && KEBAB.test(id) ? id : undefined;
+}
+/** store.yaml's text for a marker. Throws on an id OpenSpec would refuse. */
+export function storeMarkerText(m) {
+    if (!KEBAB.test(m.id))
+        throw new Error(`"${m.id}" can't be an OpenSpec store id: it must be kebab-case (lowercase letters, numbers, single hyphens)`);
+    return stringify({
+        version: STORE_MARKER_VERSION,
+        id: m.id,
+        ...(m.remote ? { remote: m.remote } : {}),
+    });
+}
+/**
+ * Read store.yaml's text, tolerantly: the id and remote of any version, with a note when the
+ * version isn't one this Atticus knows. Never throws.
+ */
+export function parseStoreMarker(text) {
+    let raw;
+    try {
+        raw = parse(text);
+    }
+    catch (e) {
+        return { notes: [`store.yaml isn't YAML: ${e.message.split("\n")[0]}`] };
+    }
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return { notes: ["store.yaml isn't a mapping"] };
+    const o = raw;
+    const notes = [];
+    if (o.version !== STORE_MARKER_VERSION)
+        notes.push(`store.yaml is version ${String(o.version ?? "(none)")}, newer than the version ${STORE_MARKER_VERSION} Atticus knows; read its id and remote only (the store format is beta)`);
+    if (typeof o.id !== "string" || !o.id)
+        return { notes: [...notes, "store.yaml has no id"] };
+    return {
+        marker: {
+            id: o.id,
+            ...(typeof o.remote === "string" && o.remote ? { remote: o.remote } : {}),
+        },
+        notes,
+    };
+}
+/** A folder's store.yaml: `missing` when there is none. Never throws. */
+export async function readStoreMarker(dir) {
+    let text;
+    try {
+        text = await readFile(join(dir, STORE_MARKER_DIR, "store.yaml"), "utf8");
+    }
+    catch {
+        return { missing: true, notes: [] };
+    }
+    return { ...parseStoreMarker(text), missing: false };
+}
+/**
+ * Write store.yaml in a folder when it has none. One that is there is never replaced: `present`
+ * when it says the same id, `differs` when it names another (its marker is returned).
+ */
+export async function writeStoreMarker(dir, m) {
+    const text = storeMarkerText(m);
+    const have = await readStoreMarker(dir);
+    if (!have.missing)
+        return {
+            action: have.marker?.id === m.id ? "present" : "differs",
+            ...(have.marker ? { marker: have.marker } : {}),
+        };
+    await mkdir(join(dir, STORE_MARKER_DIR), { recursive: true });
+    await writeFile(join(dir, STORE_MARKER_DIR, "store.yaml"), text, {
+        encoding: "utf8",
+        flag: "wx",
+    });
+    return { action: "created", marker: { id: m.id, ...(m.remote ? { remote: m.remote } : {}) } };
+}
+/**
+ * Add a store to `references:` in an openspec/config.yaml's text, keeping its comments, order
+ * and every other key. An entry for the id that is there already (plain or with a remote) is
+ * left as it is. A file that isn't a mapping, or whose references isn't a list, is not changed.
+ */
+export function addStoreReference(text, ref) {
+    const parsed = parseDocument(text);
+    if (parsed.errors.length)
+        return {
+            problem: `openspec/config.yaml isn't YAML: ${parsed.errors[0].message.split("\n")[0]}`,
+        };
+    // An empty file is an empty mapping; the document is edited as a plain one from here.
+    const doc = parsed;
+    if (doc.contents === null || doc.contents === undefined)
+        doc.contents = doc.createNode({});
+    if (!isMap(doc.contents))
+        return { problem: "openspec/config.yaml isn't a mapping; left as it is" };
+    const entry = ref.remote ? { id: ref.id, remote: ref.remote } : ref.id;
+    const list = doc.get("references", true);
+    if (list === undefined || list === null || (isScalar(list) && list.value === null)) {
+        doc.set("references", doc.createNode([entry]));
+        return { text: doc.toString(), action: "added" };
+    }
+    if (!isSeq(list))
+        return { problem: "references: in openspec/config.yaml isn't a list; left as it is" };
+    const idOf = (item) => isScalar(item) ? item.value : isMap(item) ? item.get("id") : undefined;
+    if (list.items.some((i) => idOf(i) === ref.id))
+        return { text, action: "present" };
+    list.add(doc.createNode(entry));
+    return { text: doc.toString(), action: "added" };
+}
+const isDir = (p) => stat(p).then((s) => s.isDirectory(), () => false);
+async function subdirs(dir) {
+    try {
+        return (await readdir(dir, { withFileTypes: true }))
+            .filter((d) => d.isDirectory() && !d.name.startsWith("."))
+            .map((d) => d.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * The first line of a spec's Purpose section: outside code fences, with a heading's closing
+ * hashes allowed (as OpenSpec reads it for its references index).
+ */
+export function purposeLine(markdown) {
+    let fence;
+    let inPurpose = false;
+    for (const line of markdown.split(/\r?\n/)) {
+        const f = /^\s*(```|~~~)/.exec(line);
+        if (f) {
+            if (fence === undefined)
+                fence = f[1];
+            else if (f[1] === fence)
+                fence = undefined;
+            continue;
+        }
+        if (fence !== undefined)
+            continue;
+        const h = /^#{1,6}\s+(.*?)(?:\s+#+)?\s*$/.exec(line);
+        if (h) {
+            if (inPurpose)
+                return undefined;
+            inPurpose = h[1].trim().toLowerCase() === "purpose";
+            continue;
+        }
+        if (inPurpose && line.trim())
+            return line.trim();
+    }
+    return undefined;
+}
+/**
+ * Read a store, read-only: its store.yaml (when there is one), its open changes and its specs.
+ * Never throws and never writes; what can't be read becomes a note.
+ */
+export async function readStore(dir) {
+    const view = { dir, changes: [], specs: [], notes: [] };
+    if (!(await isDir(dir))) {
+        view.notes.push(`${dir} isn't there`);
+        return view;
+    }
+    const m = await readStoreMarker(dir);
+    if (m.missing)
+        view.notes.push(`no ${STORE_MARKER}: read as a plain OpenSpec folder`);
+    view.notes.push(...m.notes);
+    if (m.marker) {
+        view.id = m.marker.id;
+        if (m.marker.remote)
+            view.remote = m.marker.remote;
+    }
+    const os = join(dir, "openspec");
+    if (!(await isDir(os))) {
+        view.notes.push("no openspec/ folder: nothing to read");
+        return view;
+    }
+    for (const id of await subdirs(join(os, "changes"))) {
+        if (id === "archive")
+            continue;
+        const cdir = join(os, "changes", id);
+        const proposal = await readFile(join(cdir, "proposal.md"), "utf8").catch(() => "");
+        const title = /^#\s+(.+?)\s*#*\s*$/m.exec(proposal)?.[1];
+        const tasks = await readFile(join(cdir, "tasks.md"), "utf8").catch(() => undefined);
+        const boxes = tasks ? [...tasks.matchAll(/^\s*[-*]\s+\[([ xX])\]/gm)].map((x) => x[1]) : [];
+        view.changes.push({
+            id,
+            ...(title ? { title } : {}),
+            ...(boxes.length
+                ? { tasks: { done: boxes.filter((b) => b !== " ").length, total: boxes.length } }
+                : {}),
+            dir: cdir,
+        });
+    }
+    for (const id of await subdirs(join(os, "specs"))) {
+        const file = join(os, "specs", id, "spec.md");
+        const text = await readFile(file, "utf8").catch(() => undefined);
+        if (text === undefined)
+            continue;
+        const purpose = purposeLine(text);
+        view.specs.push({ id, ...(purpose ? { purpose } : {}), file });
+    }
+    return view;
+}
+/**
+ * Whether an OpenSpec CLI has stores (`openspec store --help` runs). The bundled, pinned one by
+ * default. Offline: no telemetry, no update check.
+ */
+export function openspecHasStores(o = {}) {
+    return new Promise((done) => {
+        let bin;
+        try {
+            bin = o.bin ?? bundledOpenSpecBin();
+        }
+        catch {
+            done(false);
+            return;
+        }
+        execFile(process.execPath, [bin, "store", "--help"], {
+            env: openspecEnv(o.env),
+            timeout: o.timeoutMs ?? 30_000,
+            windowsHide: true,
+            encoding: "utf8",
+        }, (err, stdout) => done(!err && /\bregister\b/.test(stdout)));
+    });
+}
+//# sourceMappingURL=stores.js.map

package/dist/stores.js.map

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

package/package.json

@@ -1,6 +1,31 @@
 {
   "name": "@maycombhq/openspec-adapter",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "2.0.0-beta.1",
+  "description": "Atticus's only door to OpenSpec: a wrapper over OpenSpec's stable CLI, the org-flow workflow schema, and contract tests.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@fission-ai/openspec": "1.14.0",
+    "yaml": "^2.9.1",
+    "zod": "^4.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --config ../../vitest.shared.mjs --fsModuleCachePath=node_modules/.vitest-cache --testTimeout=30000 --hookTimeout=60000"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.