@sdd-method/cli-core 0.1.0

package/dist/repo-kind.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Repo-kind marker file conventions per ADR 0118 (Partner CLI Role
+ * Framework) §6 — every SDD repo carries a `.sdd-repo-kind` marker
+ * naming its profile. Adopter code-CLIs read the marker to choose
+ * profile-conditional verb shapes.
+ */
+export type Profile = "platform" | "application" | "integration";
+export type RepoKind = "platform-product" | "application-product" | "integration-product";
+export declare const REPO_KIND_FILE = ".sdd-repo-kind";
+export declare function profileFromRepoKind(kind: RepoKind): Profile;
+export declare function isRepoKind(value: string): value is RepoKind;
+export declare function readRepoKind(repoRoot: string): Promise<RepoKind | null>;
+//# sourceMappingURL=repo-kind.d.ts.map

package/dist/repo-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-kind.d.ts","sourceRoot":"","sources":["../src/repo-kind.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,aAAa,CAAC;AAEjE,MAAM,MAAM,QAAQ,GAChB,kBAAkB,GAClB,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAQ/C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAE3D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAW7E"}

package/dist/repo-kind.js

@@ -0,0 +1,42 @@
+/**
+ * Repo-kind marker file conventions per ADR 0118 (Partner CLI Role
+ * Framework) §6 — every SDD repo carries a `.sdd-repo-kind` marker
+ * naming its profile. Adopter code-CLIs read the marker to choose
+ * profile-conditional verb shapes.
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+export const REPO_KIND_FILE = ".sdd-repo-kind";
+const PROFILE_BY_REPO_KIND = {
+    "platform-product": "platform",
+    "application-product": "application",
+    "integration-product": "integration",
+};
+export function profileFromRepoKind(kind) {
+    return PROFILE_BY_REPO_KIND[kind];
+}
+export function isRepoKind(value) {
+    return value in PROFILE_BY_REPO_KIND;
+}
+export async function readRepoKind(repoRoot) {
+    const path = join(repoRoot, REPO_KIND_FILE);
+    const raw = await tryReadFile(path);
+    if (raw === null)
+        return null;
+    const value = raw.trim();
+    if (!isRepoKind(value)) {
+        throw new Error(`Unrecognised ${REPO_KIND_FILE} value: ${JSON.stringify(value)} at ${path}`);
+    }
+    return value;
+}
+async function tryReadFile(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+//# sourceMappingURL=repo-kind.js.map

package/dist/repo-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-kind.js","sourceRoot":"","sources":["../src/repo-kind.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAE/C,MAAM,oBAAoB,GAAwC;IAChE,kBAAkB,EAAE,UAAU;IAC9B,qBAAqB,EAAE,aAAa;IACpC,qBAAqB,EAAE,aAAa;CACrC,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,IAAc;IAChD,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,IAAI,oBAAoB,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,gBAAgB,cAAc,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAC5E,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/stability/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Stability-class surfacing surface per ADR 0118 §4.5 + ADR 0127.
+ *
+ * v0.1.0 ships the shape (types + entry point). Runtime implementation
+ * is deferred to a later release — adopters implementing stability-class
+ * gating today should compose against this shape and provide their own
+ * checker until the upstream implementation lands.
+ */
+export interface StabilityContext {
+    tier: string;
+    pinnedArtefacts: ReadonlyArray<{
+        id: string;
+        stabilityClass: "provisional" | "locked";
+    }>;
+    allowProvisional: boolean;
+}
+export interface StabilityCheckResult {
+    status: "pass" | "refuse" | "warn";
+    violations: string[];
+}
+export declare function checkStabilityClass(_context: StabilityContext): Promise<StabilityCheckResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/stability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,aAAa,CAAC;QAC7B,EAAE,EAAE,MAAM,CAAC;QACX,cAAc,EAAE,aAAa,GAAG,QAAQ,CAAC;KAC1C,CAAC,CAAC;IACH,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACnC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAI/B"}

package/dist/stability/index.js

@@ -0,0 +1,12 @@
+/**
+ * Stability-class surfacing surface per ADR 0118 §4.5 + ADR 0127.
+ *
+ * v0.1.0 ships the shape (types + entry point). Runtime implementation
+ * is deferred to a later release — adopters implementing stability-class
+ * gating today should compose against this shape and provide their own
+ * checker until the upstream implementation lands.
+ */
+export async function checkStabilityClass(_context) {
+    throw new Error("checkStabilityClass: not implemented in v0.1.0. The stability-class shape is documented per ADR 0118 §4.5 + ADR 0127; runtime implementation lands in a later release.");
+}
+//# sourceMappingURL=index.js.map

package/dist/stability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAA0B;IAE1B,MAAM,IAAI,KAAK,CACb,wKAAwK,CACzK,CAAC;AACJ,CAAC"}

package/dist/validate/archetype-metadata-check.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Archetype-metadata validator — checks that an archetype-rendered
+ * service repo carries the files an adopter expects to find after
+ * scaffolding. The default expected-file list covers the common
+ * Node + TypeScript shape; adopters with archetypes that produce
+ * different layouts (Python services, Go services, etc.) can pass
+ * their own `expectedFiles` list.
+ */
+export interface ArchetypeMetadataCheckIssue {
+    level: "error" | "warn" | "info";
+    message: string;
+}
+export interface ArchetypeMetadataCheckResult {
+    serviceRepoPath: string;
+    present: boolean;
+    ok: boolean;
+    issues: ArchetypeMetadataCheckIssue[];
+}
+export interface ArchetypeMetadataCheckOptions {
+    /** Files (or directories) expected to exist under the service repo. Defaults to a Node + TypeScript scaffold shape. */
+    readonly expectedFiles?: readonly string[];
+}
+export declare function checkArchetypeMetadata(serviceRepoPath: string, options?: ArchetypeMetadataCheckOptions): Promise<ArchetypeMetadataCheckResult>;
+//# sourceMappingURL=archetype-metadata-check.d.ts.map

package/dist/validate/archetype-metadata-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archetype-metadata-check.d.ts","sourceRoot":"","sources":["../../src/validate/archetype-metadata-check.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,2BAA2B,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,6BAA6B;IAC5C,uHAAuH;IACvH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAQD,wBAAsB,sBAAsB,CAC1C,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,4BAA4B,CAAC,CAoBvC"}

package/dist/validate/archetype-metadata-check.js

@@ -0,0 +1,44 @@
+/**
+ * Archetype-metadata validator — checks that an archetype-rendered
+ * service repo carries the files an adopter expects to find after
+ * scaffolding. The default expected-file list covers the common
+ * Node + TypeScript shape; adopters with archetypes that produce
+ * different layouts (Python services, Go services, etc.) can pass
+ * their own `expectedFiles` list.
+ */
+import { access } from "node:fs/promises";
+import { join } from "node:path";
+const DEFAULT_EXPECTED_FILES = [
+    "package.json",
+    "tsconfig.json",
+    "src",
+];
+export async function checkArchetypeMetadata(serviceRepoPath, options = {}) {
+    const expected = options.expectedFiles ?? DEFAULT_EXPECTED_FILES;
+    const issues = [];
+    const present = await exists(serviceRepoPath);
+    if (!present) {
+        issues.push({
+            level: "info",
+            message: "service repo directory not present (normal if not yet scaffolded)",
+        });
+        return { serviceRepoPath, present: false, ok: true, issues };
+    }
+    for (const file of expected) {
+        if (!(await exists(join(serviceRepoPath, file)))) {
+            issues.push({ level: "warn", message: `missing expected ${file}` });
+        }
+    }
+    const ok = !issues.some((i) => i.level === "error");
+    return { serviceRepoPath, present: true, ok, issues };
+}
+async function exists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=archetype-metadata-check.js.map

package/dist/validate/archetype-metadata-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archetype-metadata-check.js","sourceRoot":"","sources":["../../src/validate/archetype-metadata-check.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAmBjC,MAAM,sBAAsB,GAAsB;IAChD,cAAc;IACd,eAAe;IACf,KAAK;CACN,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,eAAuB,EACvB,UAAyC,EAAE;IAE3C,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,IAAI,sBAAsB,CAAC;IACjE,MAAM,MAAM,GAAkC,EAAE,CAAC;IACjD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,mEAAmE;SAC7E,CAAC,CAAC;QACH,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC/D,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,IAAI,EAAE,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC;IACpD,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;AACxD,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,CAAS;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/validate/index.d.ts

@@ -0,0 +1,5 @@
+export { checkManifest } from "./manifest-check.js";
+export type { ManifestCheckIssue, ManifestCheckResult, ManifestVocabulary, } from "./manifest-check.js";
+export { checkArchetypeMetadata } from "./archetype-metadata-check.js";
+export type { ArchetypeMetadataCheckIssue, ArchetypeMetadataCheckResult, ArchetypeMetadataCheckOptions, } from "./archetype-metadata-check.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/validate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,YAAY,EACV,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,+BAA+B,CAAC"}

package/dist/validate/index.js

@@ -0,0 +1,3 @@
+export { checkManifest } from "./manifest-check.js";
+export { checkArchetypeMetadata } from "./archetype-metadata-check.js";
+//# sourceMappingURL=index.js.map

package/dist/validate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/validate/manifest-check.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Manifest schema validator — checks an SDD repo's `manifest.yaml` (or
+ * equivalent) for the canonical fields and shape per ADR 0143 – ADR 0147.
+ *
+ * The shape checks (string typing, repo pattern `{org}/{repo}`,
+ * description length window) are method-defined and universal. The
+ * domain + service_type *vocabularies* are adopter-defined — every
+ * adopter ships its own controlled vocabulary. To validate against an
+ * adopter vocabulary, pass `ManifestVocabulary` with the allowed values;
+ * to validate shape only, omit it.
+ */
+export interface ManifestCheckIssue {
+    level: "error" | "warn";
+    field: string;
+    message: string;
+}
+export interface ManifestCheckResult {
+    path: string;
+    ok: boolean;
+    issues: ManifestCheckIssue[];
+}
+export interface ManifestVocabulary {
+    /** Allowed values for the `domain` field. If absent, only string typing is checked. */
+    readonly domains?: readonly string[];
+    /** Allowed values for the `service_type` field. If absent, only string typing is checked. */
+    readonly serviceTypes?: readonly string[];
+}
+export declare function checkManifest(manifestPath: string, vocabulary?: ManifestVocabulary): Promise<ManifestCheckResult>;
+//# sourceMappingURL=manifest-check.d.ts.map

package/dist/validate/manifest-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-check.d.ts","sourceRoot":"","sources":["../../src/validate/manifest-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,6FAA6F;IAC7F,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,UAAU,GAAE,kBAAuB,GAClC,OAAO,CAAC,mBAAmB,CAAC,CAkE9B"}

package/dist/validate/manifest-check.js

@@ -0,0 +1,96 @@
+/**
+ * Manifest schema validator — checks an SDD repo's `manifest.yaml` (or
+ * equivalent) for the canonical fields and shape per ADR 0143 – ADR 0147.
+ *
+ * The shape checks (string typing, repo pattern `{org}/{repo}`,
+ * description length window) are method-defined and universal. The
+ * domain + service_type *vocabularies* are adopter-defined — every
+ * adopter ships its own controlled vocabulary. To validate against an
+ * adopter vocabulary, pass `ManifestVocabulary` with the allowed values;
+ * to validate shape only, omit it.
+ */
+import { readFile } from "node:fs/promises";
+import { parse as parseYaml } from "yaml";
+const REPO_PATTERN = /^[a-zA-Z0-9_-]+\/[a-zA-Z0-9_-]+$/;
+export async function checkManifest(manifestPath, vocabulary = {}) {
+    const issues = [];
+    let raw;
+    try {
+        raw = await readFile(manifestPath, "utf8");
+    }
+    catch (err) {
+        issues.push({
+            level: "error",
+            field: "<file>",
+            message: `cannot read manifest: ${err.message}`,
+        });
+        return { path: manifestPath, ok: false, issues };
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (err) {
+        issues.push({
+            level: "error",
+            field: "<yaml>",
+            message: `YAML parse error: ${err.message}`,
+        });
+        return { path: manifestPath, ok: false, issues };
+    }
+    if (!parsed || typeof parsed !== "object") {
+        issues.push({
+            level: "error",
+            field: "<root>",
+            message: "manifest must be an object",
+        });
+        return { path: manifestPath, ok: false, issues };
+    }
+    const doc = parsed;
+    check(doc, "repo", issues, (value) => {
+        if (typeof value !== "string")
+            return "must be a string";
+        if (!REPO_PATTERN.test(value))
+            return "must match {org}/{repo} pattern";
+        return null;
+    });
+    check(doc, "domain", issues, (value) => {
+        if (typeof value !== "string")
+            return "must be a string";
+        if (vocabulary.domains && !vocabulary.domains.includes(value)) {
+            return `unknown domain; expected one of: ${vocabulary.domains.join(", ")}`;
+        }
+        return null;
+    });
+    check(doc, "service_type", issues, (value) => {
+        if (typeof value !== "string")
+            return "must be a string";
+        if (vocabulary.serviceTypes &&
+            !vocabulary.serviceTypes.includes(value)) {
+            return `unknown service_type; expected one of: ${vocabulary.serviceTypes.join(", ")}`;
+        }
+        return null;
+    });
+    check(doc, "description", issues, (value) => {
+        if (typeof value !== "string")
+            return "must be a string";
+        if (value.length < 10)
+            return "must be at least 10 characters";
+        if (value.length > 500)
+            return "must be at most 500 characters";
+        return null;
+    });
+    const ok = !issues.some((i) => i.level === "error");
+    return { path: manifestPath, ok, issues };
+}
+function check(doc, field, issues, validator) {
+    if (!(field in doc)) {
+        issues.push({ level: "error", field, message: "required field missing" });
+        return;
+    }
+    const err = validator(doc[field]);
+    if (err) {
+        issues.push({ level: "error", field, message: err });
+    }
+}
+//# sourceMappingURL=manifest-check.js.map

package/dist/validate/manifest-check.js.map

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

package/dist/workspace.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Workspace-root discovery — walks up from a starting directory to find
+ * the nearest SDD repo (one carrying the `.sdd-repo-kind` marker).
+ * Implements the sibling-SDD layout convention from ADR 0045.
+ */
+export declare function findSddRoot(startDir: string): Promise<string | null>;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAY1E"}

package/dist/workspace.js

@@ -0,0 +1,31 @@
+/**
+ * Workspace-root discovery — walks up from a starting directory to find
+ * the nearest SDD repo (one carrying the `.sdd-repo-kind` marker).
+ * Implements the sibling-SDD layout convention from ADR 0045.
+ */
+import { access } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { REPO_KIND_FILE } from "./repo-kind.js";
+export async function findSddRoot(startDir) {
+    let current = resolve(startDir);
+    while (true) {
+        if (await markerExists(current)) {
+            return current;
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+async function markerExists(dir) {
+    try {
+        await access(join(dir, REPO_KIND_FILE));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,IAAI,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,MAAM,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,GAAW;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@sdd-method/cli-core",
+  "version": "0.1.0",
+  "description": "Upstream shared TypeScript/Node core for SDD adopter partner-cli and platform-cli binaries. Implements the method-defined surfaces (archetypes, stability, pins, MCP envelope/lifecycle/sdd-client, workspace/repo-kind discovery, manifest + archetype-metadata validation) that recur across every SDD adopter's code-CLI pair per ADR 0118 + ADR 0120 + ADR 0127. Scope locked in ADR 0152.",
+  "keywords": [
+    "sdd-method",
+    "sdd",
+    "spec-driven-development",
+    "cli-core",
+    "partner-cli",
+    "platform-cli"
+  ],
+  "homepage": "https://github.com/tomfosteruk/sdd-cli-core#readme",
+  "bugs": {
+    "url": "https://github.com/tomfosteruk/sdd-cli-core/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tomfosteruk/sdd-cli-core.git"
+  },
+  "license": "Apache-2.0",
+  "author": "Tom Foster",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./archetypes": "./dist/archetypes/index.js",
+    "./stability": "./dist/stability/index.js",
+    "./pins": "./dist/pins/index.js",
+    "./pins/contracts": "./dist/pins/contracts.js",
+    "./pins/artifacts": "./dist/pins/artifacts.js",
+    "./mcp": "./dist/mcp/index.js",
+    "./validate": "./dist/validate/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LIBRARY_SPEC.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "yaml": "^2.5.0",
+    "zod": "^4.3.6"
+  }
+}