01 — Short Command Cheatsheet

Năm lệnh ngắn — đây là toàn bộ giao diện operator. Không có lệnh thứ sáu.

Năm lệnh

MARK file <source_ref> theo quy trình operational-cut-workflow, lưu vào No-Vector Staging Zone
VERIFY MARK staging_id <id>
CUT staging_id <id>, output IU corpus, verify reconstruct + Axis A/B/C
VERIFY CUT run_id <id>
CLEANUP STAGING dry-run older_than 15d

Bảng dịch nhanh: lệnh ngắn → alias SQL

Lệnh ngắn	Alias SQL	Returns
MARK file <ref> theo quy trình operational-cut-workflow, lưu vào No-Vector Staging Zone	SELECT fn_iu_op_mark_file(p_source_text, p_source_ref, p_pieces, p_actor, p_source_kind);	{sid, manifest_digest, source_hash, source_bytes, lifecycle:'pending_review', destination:'No-Vector Staging Zone'}
VERIFY MARK staging_id <id>	SELECT fn_iu_op_verify_mark(<sid>, p_approve, p_approval_doc_id, p_approver, p_actor);	{sid, approve, verdict:'approved'/'rejected'}
CUT staging_id <id>, output IU corpus, verify reconstruct + Axis A/B/C	SELECT fn_iu_op_cut(<sid>, p_apply, p_actor, p_open_composer); rồi SELECT fn_iu_op_verify_cut(<rid>, p_actor);	cut → {applied, pieces_created_count, run_id, refusal_code?}; verify-cut → {run_id, verdict:'verified', axes:{a,b,c}, no_vector_ok}
VERIFY CUT run_id <id>	SELECT fn_iu_op_verify_cut(<rid>, p_actor);	idempotent re-check
CLEANUP STAGING dry-run older_than 15d	SELECT fn_iu_op_cleanup_dry_run(15, p_actor);	{apply:false, older_than_days:15, eligible_count, actions[]}

Resolver bảng

<source_ref> có thể là:

Form	Agent làm gì
knowledge/... (KB path)	mcp__claude_ai_Incomex_KB__get_document_for_rewrite(path) → content → truyền vào p_source_text
https://... (URL)	WebFetch(url) → markdown body → p_source_text
/Users/.../file.md (local file)	Read(path) → text → p_source_text
inline "..."	text từ operator → p_source_text; p_source_ref := 'inline-<timestamp>'

workflow_ref hiện chỉ có 1 giá trị: operational-cut-workflow (= 80000x doctrine package). Mọi giá trị khác → refuse.

destination_ref:

Form	Maps to
No-Vector Staging Zone	iu_core.iu_staging_record + iu_core.iu_staging_payload
IU corpus (chỉ valid cho CUT)	public.information_unit

Cách gọi từ shell

ssh contabo
docker exec -i postgres psql -U workflow_admin -d directus -v ON_ERROR_STOP=1 <<'SQL'
SELECT public.fn_iu_op_mark_file(
  p_source_text  := $$<<source_text>>$$,
  p_source_ref   := 'knowledge/dev/laws/dieu37-governance-organization-law.md',
  p_pieces       := $$[...pieces array...]$$::jsonb,
  p_actor        := 'operator-<name>',
  p_source_kind  := 'user'
);
SQL

Composer gate (chỉ CUT cần)

Truyền p_open_composer:=true cho fn_iu_op_cut — alias sẽ UPDATE dot_config SET value='true' WHERE key='iu_core.composer_enabled' trong cùng TX.

Sau durable cut, đóng gate ngay:

UPDATE dot_config SET value='false' WHERE key='iu_core.composer_enabled';

(BEGIN/ROLLBACK proofs tự động restore qua rollback.)

Refusal codes (G1-G7)

Code	Khi nào	Hành động
not_found	sid sai	check lại id
wrong_kind	row không phải mark_manifest	chỉ CUT mark_manifest staging
not_approved	chưa verify-mark approve	chạy VERIFY MARK trước
incomplete_approval	thiếu approval_doc_id / approved_by	verify-mark với đủ args
digest_changed	manifest bị sửa sau MARK	bug — báo operator
source_changed	source_hash mismatch	MARK lại với source mới
composer_gate_closed	gate=false	truyền p_open_composer:=true

ABSOLUTE NO

• KHÔNG upload pending MARK payload vào KB
• KHÔNG vectorize staging payload
• KHÔNG bypass VERIFY-MARK hoặc VERIFY-CUT
• KHÔNG dùng macro dài cho 1 file
• KHÔNG động production_documents, Qdrant, Nuxt
• KHÔNG enable iu_core.retention_enabled global
• KHÔNG dùng 90000x/91000x làm tham chiếu vận hành