create-thally-docs 0.8.0 → 0.9.0

package/dist/release.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Immutable source and runtime identity for every newly scaffolded Thally site.
+ *
+ * A release is promoted only after the source snapshot and its compiled runtime
+ * have passed the scaffold, build, and identity-safety gates. Consumers must
+ * use the whole record: independently resolving "latest template" and "latest
+ * runtime" recreates the drift this contract exists to prevent.
+ */
+interface ScaffoldSourceRelease {
+    repository: string;
+    commitSha: string;
+    treeSha: string;
+    archiveUrl: string;
+}
+interface ScaffoldRuntimeRelease {
+    repository: string;
+    commitSha: string;
+    treeSha: string;
+    contentSource: 'assets';
+    identityContractVersion: number;
+}
+interface ScaffoldRelease {
+    schemaVersion: 1;
+    id: string;
+    source: ScaffoldSourceRelease;
+    runtime: ScaffoldRuntimeRelease;
+    starterVersion: number;
+}
+/**
+ * Current stable scaffold release.
+ *
+ * The source commit is the refreshed public docs template and the runtime
+ * commit is the matching engine change. `create-thally-docs`, the CLI, MCP,
+ * and Thally Cloud all import this exact record rather than following a moving
+ * branch independently.
+ */
+declare const STABLE_SCAFFOLD_RELEASE: {
+    readonly schemaVersion: 1;
+    readonly id: "2026-08-04.b0094de4.e36d2bcf";
+    readonly source: {
+        readonly repository: "thallylabs/docs";
+        readonly commitSha: "b0094de4fea84567eb12c39c6783fdae6820bb98";
+        readonly treeSha: "ffd0a6fda07341ddd1ba164cb40acef796f89e2d";
+        readonly archiveUrl: "https://codeload.github.com/thallylabs/docs/tar.gz/b0094de4fea84567eb12c39c6783fdae6820bb98";
+    };
+    readonly runtime: {
+        readonly repository: "thallylabs/thally";
+        readonly commitSha: "e36d2bcff38f7638a77369e12773a7cab4d5d9ce";
+        readonly treeSha: "1c8b0358d78d8caa14ed039bff6ab47c98b685d8";
+        readonly contentSource: "assets";
+        readonly identityContractVersion: 1;
+    };
+    readonly starterVersion: 1;
+};
+/** True only when an unknown record is the currently supported release. */
+declare function isStableScaffoldRelease(value: unknown): value is ScaffoldRelease;
+
+export { STABLE_SCAFFOLD_RELEASE, type ScaffoldRelease, type ScaffoldRuntimeRelease, type ScaffoldSourceRelease, isStableScaffoldRelease };

package/dist/release.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import {
+  STABLE_SCAFFOLD_RELEASE,
+  isStableScaffoldRelease
+} from "./chunk-PJW4JJIT.js";
+export {
+  STABLE_SCAFFOLD_RELEASE,
+  isStableScaffoldRelease
+};

package/dist/scaffold.d.ts

@@ -0,0 +1,38 @@
+export { STABLE_SCAFFOLD_RELEASE } from './release.js';
+
+/**
+ * The live Thally documentation site is also the canonical standalone site
+ * source. Keeping one source means a runtime or UI improvement shipped to the
+ * docs is available to every subsequent scaffold without maintaining a second
+ * template repository.
+ */
+declare const TEMPLATE_REPOSITORY: "thallylabs/docs";
+declare const TEMPLATE_COMMIT_SHA: "b0094de4fea84567eb12c39c6783fdae6820bb98";
+declare const EXCLUDE_PATHS: string[];
+/** True if a tarball entry should land in the scaffold (see EXCLUDE_PATHS). */
+declare function shouldInclude(path: string): boolean;
+
+interface ScaffoldOptions {
+    projectDir: string;
+    projectName: string;
+    description: string;
+    brandPreset: string;
+    repoUrl: string;
+    doInstall: boolean;
+    enableAiChat?: boolean;
+    i18nLocales?: Array<{
+        code: string;
+        label: string;
+    }>;
+    /** Repos to pre-register for Thally Track (opt-in). Empty/undefined = Track off. */
+    trackRepos?: Array<{
+        owner: string;
+        repo: string;
+    }>;
+}
+interface ScaffoldResult {
+    projectDir: string;
+}
+declare function scaffold(options: ScaffoldOptions): Promise<ScaffoldResult>;
+
+export { EXCLUDE_PATHS, type ScaffoldOptions, type ScaffoldResult, TEMPLATE_COMMIT_SHA, TEMPLATE_REPOSITORY, scaffold, shouldInclude };

package/dist/scaffold.js

@@ -1,7 +1,20 @@
 #!/usr/bin/env node
 import {
-  scaffold
-} from "./chunk-5GIGIHI5.js";
+  EXCLUDE_PATHS,
+  TEMPLATE_COMMIT_SHA,
+  TEMPLATE_REPOSITORY,
+  scaffold,
+  shouldInclude
+} from "./chunk-JNDRCCJV.js";
+import "./chunk-BW7J7DJV.js";
+import {
+  STABLE_SCAFFOLD_RELEASE
+} from "./chunk-PJW4JJIT.js";
 export {
-  scaffold
+  EXCLUDE_PATHS,
+  STABLE_SCAFFOLD_RELEASE,
+  TEMPLATE_COMMIT_SHA,
+  TEMPLATE_REPOSITORY,
+  scaffold,
+  shouldInclude
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-thally-docs",
-  "version": "0.8.0",
-  "description": "Scaffold a new Thally documentation project",
+  "version": "0.9.0",
+  "description": "Scaffold the first documentation surface in a Thally product-knowledge pipeline.",
   "type": "module",
   "engines": {
     "node": ">=18"
@@ -12,6 +12,14 @@
   "exports": {
     ".": "./dist/index.js",
     "./scaffold": "./dist/scaffold.js",
+    "./starter": {
+      "types": "./dist/customize.d.ts",
+      "import": "./dist/customize.js"
+    },
+    "./release": {
+      "types": "./dist/release.d.ts",
+      "import": "./dist/release.js"
+    },
     "./migrate": "./dist/migrate/index.js",
     "./package.json": "./package.json"
   },
@@ -31,12 +39,11 @@
     "@thallylabs/migrate": "0.2.0",
     "gray-matter": "^4.0.3",
     "p-limit": "^6.1.0",
-    "tar": "^6.2.0",
+    "tar": "^7.5.22",
     "yaml": "^2.6.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "@types/tar": "^6.1.13",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0"
   },