Changelog
All notable changes to SCS and this documentation are recorded here. Format loosely follows Keep a Changelog.
[0.4.0] — 2026-11-02
Added
- Terminal-controlled publishing:
scs wp draft,scs wp publish now,scs wp publish <date>,scs wp publish pending, andscs wp status. - Desired-state publishing from
publishing.csv(wp_status,publish_date) or article front matter viascs wp publish <article.md>. - Live publishing and scheduling require an approved QA snapshot; a live post is never converted back to draft.
parse_publish_dateacceptsYYYY/MM/DDandYYYY-MM-DD.
Changed
- Top-level
scs publishremoved; publishing commands now live underscs wp. scs wp publishcan apply a desired state or an explicit mode/date.- Documentation updated to the new
scs wp draft/publish/statuscommands.
Removed
scs publish --statusin favor ofscs wp status.
[Unreleased] — 2026-11-01
Added
- Documented the minimum data required to create the first article Markdown
file and front matter with
scs brief, across the Front Matter, Brief Gate, and Front Matter & Markers pages. - Converted the CSV Data Model field lists into tables with concise
descriptions for
config/sites.csv, clusters, briefs, links, publishing, and performance CSVs. - Added a
07-cheatsheetcategory with CLI Usage, Workflow & Statuses, Front Matter & Markers, WordPress Publishing, and Troubleshooting quick references; linked it from the docs homepage and Documentation Map. - Single-file brief/article contract with
<!-- scs:brief -->and<!-- scs:article -->markers.scs brief --checkvalidates the brief half;scs publishsends only the article half. scs research --check --require-exportto require a file inresearch/<pid>/exports/.NeuronWriterandOtherasscs import-csv --sourcevalues.- Stable article path resolution: registered
article_path→ singlemd/<pid>--*.md→ title slug. - Documentation: Documentation Map, Quick Start, Front Matter, Command Reference, Plugin Stack, and Troubleshooting.
- Documentation: six-category structure (Start Here, Method, Publishing, Operations, System Reference, Business & Tools) with URL-preserving slugs.
- Documentation: XML Sitemaps page — sitemap XML is generated automatically by SEOPress after content is published; SCS does not create, write, or submit it.
Changed
scs syncnow writesbrief_pathto the article file; the separatebriefs/directory is no longer part of the workspace.- Documentation is tool-agnostic: keyword data can come from any SEO tool.
- Publishing docs describe the terminal-owned state contract
(
draft/pending/future/publish) and WordPress as the visual review surface. - Front matter
content_typeis documented as the article format; the ACFcontent_typeis mapped fromclusters.kc_type. - Model names updated to
deepseek-v4.1-flashanddeepseek-v4-pro. - Performance docs use
<workspace>-performance.csv. - Site documentation points to
config/sites.csvandscs sitesinstead of a hard-coded site table.
Removed
- The legacy 42-column
content-pipeline.csvpage. - SpyFu API endpoints, pricing units, and credential guidance.
content-md/path examples.
[0.3.0] — 2026-10-27
Added
scs wp diffandscs wp pull-contentfor read-only comparison and non-overwriting review snapshots.- Intent provenance/confidence, business value, SERP review/fit, source confidence, and existing-page action fields.
- Cluster coverage planning and query-level GSC history.
Changed
- Corrected the GOS documentation to use raw 0–100 KD.
- Workspaces own five prefixed stage CSVs; rows retain
site_id. - Clarified that creating a workspace does not register a site.
- Documented
scs add-siteand the workspace archive flow.
[0.2.1] — 2026-10-27
Added
--wsas a short alias for--workspace.- Article-path targeting for
scs publish,scs qa pull|check|open,scs wp diff, andscs wp pull-content.
Changed
- Documented the compact, writer-focused front matter and the separation of article body, CSV metadata, and research.
[0.2.0] — 2026-10-23
Added
- Research workspace, brief gate, QA gate, decision model, publish bridge, terminal runbooks, WordPress contract, and field reference pages.
- Pilot status on opshell.dev: review-gate plugin installed; draft publish, QA pull, QA check, and advance-to-Scheduled tested end to end.
Changed
- Rewrote architecture, CSV data model, GOS scoring, and workflow for the v0.2 schema and gates.
- Renamed
prioritytogos_tier; GOS is explicitly supporting. - Renamed
wp_content_typetowp_content_formatto avoid collision with ACFcontent_type.
[0.1.0] — 2026-10-15
Added
- Initial SCS documentation: overview, architecture, CSV model, GOS scoring, workflow, keybindings, and roadmap.
Decisions recorded
- SCS lives in
server-side-program/scs. - Linked CSVs share
pid,title, andkeyword. - Phase 1 is local-first, with manual tool exports.
- GOS and
gos_tierare computed by the system, not typed by hand.