@inharness-ai/claude4spec 1.0.0

package/dist/server/services/references.js.map

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

package/dist/server/services/release.d.ts

@@ -0,0 +1,146 @@
+/**
+ * ReleaseService — public API M17. Single source of truth for release listing,
+ * detail, snapshot, diff, and (Phase 6) restore. All other surfaces
+ * (REST `/api/releases/*`, MCP `release-tools`, UI sidebar) are thin
+ * adapters.
+ *
+ * Spec reference: `modules/m17-snapshots-releases.md` (`m17api001`,
+ * `m17dom001`, `m17dcre01`).
+ */
+import type Database from 'better-sqlite3';
+import type { ChangedBy, RawDelta, Release, ReleaseDetail, SpecSnapshot } from '../../shared/entities.js';
+import type { PluginHost } from '../core/plugin-host/types.js';
+import type { RawEntityReader, RawEntityType } from '../domain/raw-entity-reader.js';
+import type { VersionService } from './versions.js';
+import type { PageVersionService } from './page-version.js';
+import type { PageSerializer } from './page-serializer.js';
+import type { TagsService } from './tags.js';
+import type { PagesService } from './pages.js';
+import type { PagesWatcher } from '../fs/watcher.js';
+import type { RestoreResult } from '../serialization/types.js';
+export interface RestoreEntityInput {
+    type: RawEntityType;
+    slug: string;
+    releaseId: number | string;
+}
+export interface RestorePageInput {
+    path: string;
+    releaseId: number | string;
+}
+export interface RestoreSpecInput {
+    releaseId: number | string;
+}
+export interface RestoreEntityResult {
+    type: RawEntityType;
+    slug: string;
+    op: RestoreResult['op'];
+    warnings?: string[];
+}
+export interface RestorePageResult {
+    path: string;
+    op: 'created' | 'updated' | 'deleted' | 'noop';
+    warnings?: string[];
+}
+export interface RestoreSpecResult {
+    releaseId: number;
+    entityResults: RestoreEntityResult[];
+    pageResults: RestorePageResult[];
+}
+export declare class ReleaseService {
+    private db;
+    private host;
+    private versions;
+    private pageVersions;
+    private pageSerializer;
+    private rawReader;
+    private tagsService;
+    private pagesService;
+    private watcher;
+    constructor(db: Database.Database, host: PluginHost, versions: VersionService, pageVersions: PageVersionService, pageSerializer: PageSerializer, rawReader: RawEntityReader, tagsService: TagsService, pagesService: PagesService, watcher?: PagesWatcher | null);
+    listReleases(): Release[];
+    getRelease(idOrName: number | string): ReleaseDetail;
+    /**
+     * Manual release creation (decyzja 9: zero auto-trigger). Validates
+     * non-empty + UNIQUE name and non-empty description; in a single
+     * transaction inserts spec_release and assigns all unreleased
+     * entity_version + page_version rows.
+     */
+    createRelease(input: {
+        name: string;
+        description: string;
+    }, actor: ChangedBy): ReleaseDetail;
+    /**
+     * Mutate the LATEST release only (decyzja 13: implicit last = mutable).
+     * Older releases are frozen — `id != MAX(id)` ⇒ 409 RELEASE_FROZEN.
+     * Optionally pulls all `release_id IS NULL` rows from entity_version /
+     * page_version into this release (decyzja 14, no untie).
+     */
+    updateRelease(input: {
+        idOrName: number | string;
+        name?: string;
+        description?: string;
+        assignUnreleased?: boolean;
+    }): ReleaseDetail;
+    /**
+     * Cumulative state at the end of a release: per (type, slug), the latest
+     * entity_version row at-or-before `releaseId`. Each row carries
+     * `op` + `data` (snapshot) + `serializer_version`.
+     */
+    getReleaseSnapshot(idOrName: number | string): SpecSnapshot;
+    /**
+     * Structured semantic diff between two releases. For each entity that
+     * differs (or pages that differ), computes per-plugin `host.diff(...)`
+     * (entities) or `pageSerializer.diff(...)` (pages). Falls back to
+     * default deep-diff when plugin doesn't override `diff`.
+     *
+     * `fromIdOrName === null` ⇒ initial brief: synthetic empty `from` snapshot.
+     * Wszystkie encje/strony w `to` widoczne jako `op: 'create'`. Output
+     * `RawDelta.from` jest wtedy `null` (sygnal dla M21 / UI).
+     */
+    getReleaseDiff(fromIdOrName: number | string | null, toIdOrName: number | string): RawDelta;
+    /**
+     * Restore a single entity to its state at the target release. Append-only:
+     * the restore generates a normal mutation through write-API, producing a
+     * new entity_version row with `release_id = NULL`. Idempotent (decyzja 11):
+     * re-running restore on already-matching state yields op='noop'.
+     */
+    restoreEntity(input: RestoreEntityInput, actor?: ChangedBy): RestoreEntityResult;
+    /**
+     * Restore a single page. Looks up the latest page_version snapshot at-or-
+     * before the release and writes its content via PagesService. The watcher
+     * suppresses the resulting chokidar event; the REST capture path then
+     * records a fresh page_version row with `release_id = NULL` and
+     * `changed_by = 'user'`.
+     */
+    restorePage(input: RestorePageInput, _actor?: ChangedBy): Promise<RestorePageResult>;
+    /**
+     * Restore the entire spec to a release. Topological sort: DTO first
+     * (Endpoint references DTO via linked_dtos), then everything else, then
+     * pages. Each step generates normal mutations → all visible in timeline.
+     */
+    restoreSpec(input: RestoreSpecInput, actor?: ChangedBy): Promise<RestoreSpecResult>;
+    private findReleaseRow;
+    private toRelease;
+    private computeCountBreakdown;
+    /**
+     * Find the latest entity_version row matching a slug at-or-before
+     * `releaseId`. Slug lookup is index-by-data-slug since legacy rows may
+     * predate slug presence in `data`. Returns null if no row found.
+     */
+    private latestEntityRowForSlug;
+    /**
+     * For each entity_id seen in the release range, return the latest version
+     * row at-or-before `releaseId`. Rows where the underlying entity table has
+     * since been DELETEd appear as op='delete' tombstones (data carries the
+     * last snapshot before deletion).
+     */
+    private latestEntityRowsAtOrBefore;
+    private latestPageRowsAtOrBefore;
+    /**
+     * Resolve a slug for an entity_version row. Snapshot data carries `slug`
+     * directly (post-M17 rows). For pre-M17 legacy rows, fall back to the
+     * underlying table — but the table may be deleted. Return null in that
+     * case (caller skips the entry).
+     */
+    private resolveSlug;
+}