@inharness-ai/claude4spec 1.0.0

package/dist/shared/entities.d.ts

@@ -0,0 +1,622 @@
+import type { TodoItem, UsageStats } from '@inharness-ai/agent-adapters';
+export type { TodoItem, UsageStats };
+export type EntityType = 'endpoint' | 'dto' | 'database-table' | 'ui-view' | 'ac' | 'section';
+export type ChangedBy = 'user' | 'agent';
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export type EndpointDtoRelation = 'request' | 'response' | 'error';
+export interface EndpointDtoLink {
+    dtoSlug: string;
+    dtoName: string;
+    relation: EndpointDtoRelation;
+    statusCode: number | null;
+}
+export interface Endpoint {
+    slug: string;
+    method: HttpMethod;
+    path: string;
+    summary: string;
+    description: string | null;
+    tags: string[];
+    dtos: EndpointDtoLink[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface EndpointCreateInput {
+    method: HttpMethod;
+    path: string;
+    summary?: string;
+    description?: string;
+    tags?: string[];
+}
+export interface EndpointUpdateInput {
+    method?: HttpMethod;
+    path?: string;
+    summary?: string;
+    description?: string | null;
+    tags?: string[];
+    newSlug?: string;
+}
+export interface EndpointListQuery {
+    tags?: string[];
+    tagFilter?: 'and' | 'or';
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface EndpointDeleteResult {
+    deleted: true;
+    brokenReferences: BrokenReference[];
+}
+export interface BrokenReference {
+    pagePath: string;
+    tagType: string;
+    line: number;
+    slug?: string;
+    type?: EntityType;
+}
+export interface DtoField {
+    name: string;
+    type: string;
+    required: boolean;
+    description?: string;
+}
+export interface DtoExample {
+    name: string;
+    summary?: string;
+    value: unknown;
+}
+export interface DtoEndpointLink {
+    endpointSlug: string;
+    method: HttpMethod;
+    path: string;
+    relation: EndpointDtoRelation;
+    statusCode: number | null;
+}
+export interface Dto {
+    slug: string;
+    name: string;
+    description: string | null;
+    fields: DtoField[];
+    examples: DtoExample[];
+    tags: string[];
+    endpoints: DtoEndpointLink[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DtoCreateInput {
+    name: string;
+    description?: string;
+    fields?: DtoField[];
+    examples?: DtoExample[];
+    tags?: string[];
+    /** Optional explicit slug — used by M17 restore to preserve identity (decyzja 4). */
+    slug?: string;
+}
+export interface DtoUpdateInput {
+    name?: string;
+    description?: string | null;
+    fields?: DtoField[];
+    examples?: DtoExample[];
+    tags?: string[];
+    newSlug?: string;
+}
+export interface DtoListQuery {
+    tags?: string[];
+    tagFilter?: 'and' | 'or';
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface DtoDeleteResult {
+    deleted: true;
+    brokenReferences: BrokenReference[];
+}
+export interface ReferenceHit {
+    pagePath: string;
+    tagType: string;
+    line: number;
+    raw: string;
+}
+export interface DatabaseTableForeignKey {
+    table: string;
+    column: string;
+}
+export interface DatabaseTableColumn {
+    name: string;
+    type: string;
+    nullable?: boolean;
+    unique?: boolean;
+    pk?: boolean;
+    fk?: DatabaseTableForeignKey;
+    default?: string;
+    enumValues?: string[];
+    description?: string;
+}
+export interface DatabaseTableIndex {
+    columns: string[];
+    unique?: boolean;
+    name?: string;
+}
+export interface DatabaseTable {
+    slug: string;
+    name: string;
+    description: string | null;
+    columns: DatabaseTableColumn[];
+    indexes: DatabaseTableIndex[];
+    tags: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DatabaseTableCreateInput {
+    name: string;
+    description?: string;
+    columns?: DatabaseTableColumn[];
+    indexes?: DatabaseTableIndex[];
+    slug?: string;
+    tags?: string[];
+}
+export interface DatabaseTableUpdateInput {
+    name?: string;
+    description?: string | null;
+    columns?: DatabaseTableColumn[];
+    indexes?: DatabaseTableIndex[];
+    tags?: string[];
+    newSlug?: string;
+}
+export interface DatabaseTableListQuery {
+    tags?: string[];
+    tagFilter?: 'and' | 'or';
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface DatabaseTableDanglingFk {
+    tableSlug: string;
+    columnName: string;
+}
+export interface DatabaseTableDeleteResult {
+    deleted: true;
+    brokenReferences: BrokenReference[];
+    danglingFks: DatabaseTableDanglingFk[];
+}
+export type UiViewParamLocation = 'path' | 'query' | 'hash';
+export interface UiViewParam {
+    name: string;
+    in: UiViewParamLocation;
+    type?: string;
+    required?: boolean;
+    default?: string;
+    description?: string;
+}
+export interface UiView {
+    slug: string;
+    name: string;
+    url: string | null;
+    description: string | null;
+    params: UiViewParam[];
+    tags: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface UiViewCreateInput {
+    name: string;
+    url?: string | null;
+    description?: string;
+    params?: UiViewParam[];
+    slug?: string;
+    tags?: string[];
+}
+export interface UiViewUpdateInput {
+    name?: string;
+    url?: string | null;
+    description?: string | null;
+    params?: UiViewParam[];
+    tags?: string[];
+    newSlug?: string;
+}
+export interface UiViewListQuery {
+    tags?: string[];
+    tagFilter?: 'and' | 'or';
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface UiViewDeleteResult {
+    deleted: true;
+    brokenReferences: BrokenReference[];
+}
+export interface Tag {
+    slug: string;
+    name: string;
+    color: string | null;
+    description: string | null;
+    /** Per-entity-type counts. Keys are plugin types; absent type = 0. */
+    counts: Record<string, number>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TagCreateInput {
+    name: string;
+    color?: string;
+    description?: string;
+}
+export interface TagUpdateInput {
+    name?: string;
+    color?: string | null;
+    description?: string | null;
+}
+export interface VersionListItem {
+    id: number;
+    version: number;
+    changedBy: ChangedBy;
+    changeSummary: string | null;
+    createdAt: string;
+    /** M17: release this version was captured into. Null/absent = unreleased (release_id IS NULL). */
+    releaseId?: number;
+    /** M17: kind of mutation captured. Null/absent for legacy rows. */
+    op?: 'create' | 'update' | 'delete';
+}
+export interface VersionDetail extends VersionListItem {
+    entityType: EntityType;
+    entityId: number;
+    data: unknown;
+}
+export interface Release {
+    id: number;
+    name: string;
+    description: string;
+    createdBy: ChangedBy;
+    createdAt: string;
+}
+export interface ReleaseCountBreakdown {
+    entities: Record<string, number>;
+    pages: number;
+    total: number;
+}
+export interface ReleaseDetail extends Release {
+    countBreakdown: ReleaseCountBreakdown;
+}
+export interface SpecSnapshotEntityRow {
+    type: string;
+    slug: string;
+    op: 'create' | 'update' | 'delete';
+    data: unknown;
+}
+export interface SpecSnapshotPageRow {
+    path: string;
+    op: 'create' | 'update' | 'delete';
+    data: unknown;
+}
+export interface SpecSnapshot {
+    release: Release;
+    serializer_versions: Record<string, string>;
+    entities: SpecSnapshotEntityRow[];
+    pages: SpecSnapshotPageRow[];
+}
+export interface RawDeltaEntityChange {
+    type: string;
+    slug: string;
+    op: 'created' | 'deleted' | 'modified' | 'noop';
+    changes?: Record<string, unknown>;
+    raw?: unknown;
+    _serializerVersionMismatch?: {
+        type: string;
+        from: string | null;
+        to: string | null;
+    };
+}
+export interface PageSectionLite {
+    anchor: string;
+    heading: string;
+    level: number;
+    content: string;
+    position: number;
+}
+export interface LineDiffLineLite {
+    op: 'keep' | 'added' | 'removed';
+    content: string;
+}
+export interface LineDiffLite {
+    lines: LineDiffLineLite[];
+}
+export interface ModifiedSectionLite {
+    anchor: string;
+    heading: string;
+    level: number;
+    /** Mandatory in M17 decyzja 10 wariant C. */
+    line_diff: LineDiffLite;
+}
+export interface MovedSectionLite {
+    anchor: string;
+    from_position: number;
+    to_position: number;
+}
+export interface PageXmlRefLite {
+    tagType: string;
+    attributes: Record<string, string>;
+    position: number;
+}
+export interface FrontmatterDiffLite {
+    added: Record<string, unknown>;
+    removed: Record<string, unknown>;
+    changed: Array<{
+        key: string;
+        from: unknown;
+        to: unknown;
+    }>;
+}
+export interface XmlRefsDiffLite {
+    added: PageXmlRefLite[];
+    removed: PageXmlRefLite[];
+}
+export interface RawDeltaPageChange {
+    path: string;
+    op: 'created' | 'deleted' | 'modified' | 'noop';
+    added_sections: PageSectionLite[];
+    removed_sections: PageSectionLite[];
+    modified_sections: ModifiedSectionLite[];
+    moved_sections: MovedSectionLite[];
+    frontmatter_diff: FrontmatterDiffLite | null;
+    xml_refs_diff: XmlRefsDiffLite | null;
+}
+export interface RawDelta {
+    /** `null` = synthetic empty state (initial brief, comparing against "nothing"). */
+    from: {
+        id: number;
+        name: string;
+    } | null;
+    to: {
+        id: number;
+        name: string;
+    };
+    entities: RawDeltaEntityChange[];
+    pages: RawDeltaPageChange[];
+}
+export type AcKind = 'requirement' | 'edge-case';
+export type AcStatus = 'active' | 'deprecated';
+export interface AcVerifyRef {
+    type: string;
+    slug: string;
+}
+export interface AcBrokenVerify extends AcVerifyRef {
+    reason: 'missing' | 'inactive' | 'unknown';
+}
+export interface Ac {
+    slug: string;
+    text: string;
+    kind: AcKind;
+    status: AcStatus;
+    verifies: AcVerifyRef[];
+    description: string | null;
+    tags: string[];
+    createdAt: string;
+    updatedAt: string;
+    /** Populated by routes when verifies refs do not resolve. */
+    brokenVerifies?: AcBrokenVerify[];
+}
+export interface AcCreateInput {
+    text: string;
+    kind?: AcKind;
+    status?: AcStatus;
+    verifies?: AcVerifyRef[];
+    description?: string | null;
+    tags?: string[];
+    /** Optional explicit slug — used by M17 restore to preserve identity. */
+    slug?: string;
+}
+export interface AcUpdateInput {
+    text?: string;
+    kind?: AcKind;
+    status?: AcStatus;
+    verifies?: AcVerifyRef[];
+    description?: string | null;
+    tags?: string[];
+    newSlug?: string;
+}
+export interface AcListQuery {
+    status?: AcStatus | 'all';
+    kind?: AcKind;
+    tags?: string[];
+    tagFilter?: 'and' | 'or';
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface AcDeleteResult {
+    deleted: true;
+    brokenReferences: BrokenReference[];
+}
+export interface SectionIndexEntry {
+    id: number;
+    anchor: string;
+    pagePath: string;
+    headingPath: string;
+    headingSlug: string;
+    headingLevel: number;
+    headingText: string;
+    contentHash: string;
+    lineStart: number;
+    lineEnd: number;
+    paragraphCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export type ChatRole = 'user' | 'assistant' | 'tool_use' | 'tool_result' | 'user_input_request' | 'user_input_response';
+/**
+ * M21 generic context discriminator. 'chat' = default (full toolset, overlay UI).
+ * 'brief' = brief editorial thread (whitelisted tools, brief-detail chrome,
+ * brief_path points to FS file under briefsDir).
+ */
+export type ChatContextType = 'chat' | 'brief';
+export interface ChatThread {
+    id: string;
+    title: string | null;
+    lastSessionId: string | null;
+    currentTodoItems: TodoItem[] | null;
+    planMode: boolean;
+    usage: UsageStats | null;
+    contextSize: number | null;
+    planId: number | null;
+    lastSeenPlanVersion: number | null;
+    hasSystemPrompt: boolean;
+    contextType: ChatContextType;
+    briefPath: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ChatThreadMeta extends ChatThread {
+    messageCount: number;
+}
+export type ChatMessageStatus = 'streaming' | 'complete';
+export interface ChatMessage {
+    id: number;
+    threadId: string;
+    role: ChatRole;
+    content: string;
+    toolName: string | null;
+    toolId: string | null;
+    subagentTaskId: string | null;
+    planMode: boolean;
+    status: ChatMessageStatus;
+    usage: UsageStats | null;
+    contextSize: number | null;
+    createdAt: string;
+}
+export interface ChatSubagentTask {
+    threadId: string;
+    taskId: string;
+    toolUseId: string | null;
+    description: string;
+    status: string;
+    summary: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Annotation {
+    id: string;
+    text: string;
+    comment: string;
+    page: string;
+    range?: {
+        from: number;
+        to: number;
+    };
+}
+export type PlanExecuteMode = 'new-session' | 'continue';
+export type PlanAction = 'replace' | 'append' | 'insert_after_section' | 'user_edit' | 'system_duplicate';
+export type PlanChangedBy = 'agent' | 'user' | 'system';
+export interface Plan {
+    id: number;
+    title: string | null;
+    content: string;
+    currentVersion: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PlanListItem {
+    id: number;
+    title: string | null;
+    currentVersion: number;
+    threadCount: number;
+    lastThreadId: string | null;
+    updatedAt: string;
+}
+export interface PlanVersion {
+    id: number;
+    planId: number;
+    version: number;
+    content: string;
+    action: PlanAction;
+    actionParams: Record<string, unknown> | null;
+    changeSummary: string | null;
+    changedBy: PlanChangedBy;
+    createdAt: string;
+}
+export interface PlanVersionMeta {
+    version: number;
+    action: PlanAction;
+    actionParams: Record<string, unknown> | null;
+    changeSummary: string | null;
+    changedBy: PlanChangedBy;
+    createdAt: string;
+}
+export interface BlameBlock {
+    blockIndex: number;
+    markdownFragment: string;
+    addedInVersion: number;
+}
+export type PlanExecuteResult = {
+    mode: 'new-session';
+    newThreadId: string;
+    planId: number;
+    firstMessage: string;
+} | {
+    mode: 'continue';
+    threadId: string;
+    firstMessage: string;
+};
+export type BriefChangedBy = 'user' | 'agent' | 'filesystem';
+/** Reserved frontmatter keys agent cannot mutate via update_brief. */
+export declare const BRIEF_IMMUTABLE_FRONTMATTER_KEYS: readonly ["type", "from_release", "to_release", "generated_at", "generator_version"];
+export interface BriefFrontmatter {
+    type: 'brief';
+    /** `null` = initial brief (no previous release; `to_release` opisuje stan startowy projektu). */
+    from_release: string | null;
+    to_release: string;
+    generated_at: string;
+    generator_version: string;
+    implemented?: boolean;
+    [key: string]: unknown;
+}
+export interface Brief {
+    /** Path relative to briefsDir, e.g. "v0-3-to-v0-4.md". */
+    path: string;
+    frontmatter: BriefFrontmatter;
+    body: string;
+    /** Full file content (frontmatter + body, byte-faithful). */
+    content: string;
+    /** sha256 hex of `content` — used for optimistic concurrency. */
+    hash: string;
+}
+export interface BriefListItem {
+    path: string;
+    title: string | null;
+    /** `null` = initial brief. */
+    fromRelease: string | null;
+    toRelease: string;
+    implemented: boolean;
+    generatedAt: string;
+    lastModifiedAt: string | null;
+    threadCount: number;
+}
+export interface BriefCreateRequest {
+    /** `null` = initial brief (no previous release to compare against). */
+    fromReleaseName: string | null;
+    toReleaseName: string;
+    additionalPrompt?: string;
+    suffix?: string;
+}
+export interface BriefCreateResult {
+    briefPath: string;
+    initialThreadId: string;
+}
+export interface BriefFrontmatterUpdateRequest {
+    implemented?: boolean;
+}
+export interface BriefContentUpdateRequest {
+    content: string;
+    expectedHash: string;
+    changeSummary?: string;
+}
+export interface BriefContentUpdateResult {
+    newHash: string;
+}
+export interface BriefThreadCreateRequest {
+    name?: string;
+}
+export interface BriefThreadSummary {
+    id: string;
+    title: string | null;
+    updatedAt: string;
+    messageCount: number;
+}

package/dist/shared/entities.js

@@ -0,0 +1,9 @@
+/** Reserved frontmatter keys agent cannot mutate via update_brief. */
+export const BRIEF_IMMUTABLE_FRONTMATTER_KEYS = [
+    'type',
+    'from_release',
+    'to_release',
+    'generated_at',
+    'generator_version',
+];
+//# sourceMappingURL=entities.js.map

package/dist/shared/entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/shared/entities.ts"],"names":[],"mappings":"AA6oBA,sEAAsE;AACtE,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,MAAM;IACN,cAAc;IACd,YAAY;IACZ,cAAc;IACd,mBAAmB;CACX,CAAC"}

package/dist/shared/page-links.d.ts

@@ -0,0 +1,40 @@
+export interface FileMeta {
+    path: string;
+    title: string;
+    anchors: string[];
+}
+export type PageLinkSyntax = 'at' | 'backticks' | 'link';
+export interface PageLink {
+    syntax: PageLinkSyntax;
+    rawToken: string;
+    targetPath: string;
+    anchor?: string;
+    line: number;
+    col: number;
+}
+export interface UnresolvedMention {
+    syntax: 'at' | 'link';
+    rawToken: string;
+    candidatePath: string;
+    line: number;
+    col: number;
+}
+export interface PageLinkAutocompleteItem {
+    path: string;
+    title: string;
+    matchScore: number;
+}
+export interface PageLinksCounts {
+    brokenLinkCount: number;
+    unresolvedMentionCount: number;
+    totalLinks: number;
+}
+export interface PageLinksListResponse {
+    links: Record<string, PageLink[]>;
+    reverseLinks: Record<string, string[]>;
+    unresolved: Record<string, UnresolvedMention[]>;
+    counts: PageLinksCounts;
+}
+export interface PageLinksAutocompleteResponse {
+    suggestions: PageLinkAutocompleteItem[];
+}

package/dist/shared/page-links.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=page-links.js.map

package/dist/shared/page-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-links.js","sourceRoot":"","sources":["../../src/shared/page-links.ts"],"names":[],"mappings":""}