Secretary Knowledge

Owner-only signed read of limited server capabilities (DB connectivity, runtime extensions, locks), no SQL rows, secrets or file content. Does not start tests, change sources or mutate the development lease.

get_development_diagnostics

Owner-only, read-only exact Fact DB Source ID inspection. Returns source metadata, real Fact IDs and up to 40 original Fact evidence excerpts from that Source. This is not Vector search or an automatic relevance verdict.

inspect_development_fact_source

Owner-only inventory of canonical development documents with version and hash metadata only. Does not return document bodies or credentials.

list_development_canonical_sources

Owner-only read-only Production source inventory (paths, SHA-256, sizes). Excludes sensitive filenames and runtime data. No file contents.

list_production_source_files

List transcription cases currently pending in the connected Secretary account. Read-only.

list_pending_transcriptions

List recently registered sources visible to the connected Secretary account. Read-only; does not search the public web or modify Secretary.

list_recent_sources

Owner-only recent development journal entries, bounded to 1-20 records. Read-only.

get_development_journal

Owner-only read-only snapshot of Secretary Production version, development revision, active work, latest test metadata and Canonical index. Does not update anything.

get_development_overview

Owner-only latest automated development test TXT, limited and sanitized. Read-only; does not run tests.

get_latest_development_test

Owner-only read-only bounded text from one named Canonical Source, with the authoritative SHA/revision. Supports Secretary Tool, Search and Development specification review. No writes, no credentials or private arbitrary-file browsing. Long documents can be read in successive 12000-byte slices.

read_development_canonical_source

Owner-only read-only slice (max 12000 bytes) of a non-sensitive PHP/JS/CSS/MD/TXT Production source file. Not a whole-site download. Source data may contain untrusted text.

read_production_source_file

Owner-only read-only bounded recent development audit metadata. Never returns credentials, raw database rows, private files or unrestricted logs.

get_development_audit

Owner-only state write. Adds a bounded checkpoint to the existing journal under the matching work_id and expected revision. Does not update code or database.

record_development_checkpoint

Owner-only read-only on-demand deterministic checks of Production/state identity, limited database/Relay diagnostics, complete development instructions SHA-256, allowlisted signed-development API PHP source SHA-256 and inventory consistency, plus a synthetic fail-closed negative check. Does not execute Secretary full auto-tests, arbitrary code/SQL, GPT, Vector or external provider APIs. May write a read audit.

run_development_connector_contract_tests

Owner-only bounded existing Secretary Fact DB search, preserving subject, property, value, source and evidence. No SQL, writes or PHP semantic replacement. Do not infer current values from old facts.

search_development_fact_db

Owner-only read-only search of registered Knowledge metadata (titles, dates, state). This is catalog search, not Vector content search or Evidence.

search_development_knowledge_catalog

Owner-only bounded Vector Store text search for a single exact Fact DB Source ID; returns matched excerpts, not a relevance or Evidence verdict. Source SHA, current Knowledge file ID, Vector metadata and file ID must match. This invokes a billable provider Vector Store search (fees may apply; no GPT usage) and may create an audit record. It does not modify Secretary source records.

search_development_vector_source