stego-cli 0.3.3 → 0.4.0

package/projects/stego-docs/spine/commands.md

@@ -1,71 +0,0 @@
-# Commands
-
-## CMD-INIT
-label: stego init [--force]
-
-- `stego init [--force]`
-- Initialize a Stego workspace in the current directory.
-- Related workflows: FLOW-INIT-WORKSPACE.
-- Related concepts: CON-WORKSPACE, CON-PROJECT.
-- Related integrations: INT-VSCODE.
-
-## CMD-LIST-PROJECTS
-label: stego list-projects [--root <path>]
-
-- `stego list-projects [--root <path>]`
-- List projects found in the current workspace.
-- Related workflows: FLOW-INIT-WORKSPACE, FLOW-DAILY-WRITING.
-- Related concepts: CON-WORKSPACE, CON-PROJECT.
-
-## CMD-NEW-PROJECT
-label: stego new-project --project <project-id> [--title <title>] [--root <path>]
-
-- `stego new-project --project <project-id> [--title <title>] [--root <path>]`
-- Scaffold a new project under `projects/`.
-- Related workflows: FLOW-NEW-PROJECT.
-- Related concepts: CON-PROJECT, CON-MANUSCRIPT, CON-NOTES, CON-DIST.
-
-## CMD-NEW
-label: stego new --project <project-id> [--i <prefix>|-i <prefix>] [--filename <name>] [--root <path>]
-
-- `stego new --project <project-id> [--i <prefix>|-i <prefix>] [--filename <name>] [--root <path>]`
-- Create a new manuscript file with an inferred numeric prefix and draft frontmatter.
-- Related workflows: FLOW-DAILY-WRITING.
-- Related concepts: CON-MANUSCRIPT, CON-METADATA.
-- Related configuration: CFG-REQUIRED-METADATA.
-
-## CMD-VALIDATE
-label: stego validate --project <project-id> [--file <project-relative-manuscript-path>] [--root <path>]
-
-- `stego validate --project <project-id> [--file <project-relative-manuscript-path>] [--root <path>]`
-- Validate project configuration, manuscript structure, metadata, and references.
-- Related workflows: FLOW-DAILY-WRITING, FLOW-STAGE-PROMOTION.
-- Related concepts: CON-METADATA, CON-SPINE.
-- Related configuration: CFG-REQUIRED-METADATA, CFG-SPINE-CATEGORIES.
-
-## CMD-BUILD
-label: stego build --project <project-id> [--root <path>]
-
-- `stego build --project <project-id> [--root <path>]`
-- Compile manuscript files into one generated markdown output.
-- Related workflows: FLOW-BUILD-EXPORT, FLOW-DAILY-WRITING.
-- Related concepts: CON-MANUSCRIPT, CON-DIST, CON-COMPILE-STRUCTURE.
-- Related configuration: CFG-COMPILE-STRUCTURE, CFG-COMPILE-LEVELS.
-
-## CMD-CHECK-STAGE
-label: stego check-stage --project <project-id> --stage <draft|revise|line-edit|proof|final> [--file <project-relative-manuscript-path>] [--root <path>]
-
-- `stego check-stage --project <project-id> --stage <draft|revise|line-edit|proof|final> [--file <project-relative-manuscript-path>] [--root <path>]`
-- Run stage-aware checks for a requested editorial stage.
-- Related workflows: FLOW-STAGE-PROMOTION, FLOW-PROOF-RELEASE.
-- Related concepts: CON-STAGE-GATE, CON-METADATA.
-- Related configuration: CFG-STAGE-POLICIES, CFG-ALLOWED-STATUSES.
-
-## CMD-EXPORT
-label: stego export --project <project-id> --format <md|docx|pdf|epub> [--output <path>] [--root <path>]
-
-- `stego export --project <project-id> --format <md|docx|pdf|epub> [--output <path>] [--root <path>]`
-- Export compiled output to target formats.
-- Related workflows: FLOW-BUILD-EXPORT, FLOW-PROOF-RELEASE.
-- Related concepts: CON-DIST.
-- Related integrations: INT-PANDOC.

package/projects/stego-docs/spine/concepts.md

@@ -1,72 +0,0 @@
-# Concepts
-
-## CON-WORKSPACE
-label: A Stego workspace is the root directory containing `stego.config.json` and `projects/`.
-
-- A Stego workspace is the root directory containing `stego.config.json` and `projects/`.
-- Related commands: CMD-INIT, CMD-LIST-PROJECTS.
-- Related workflows: FLOW-INIT-WORKSPACE.
-
-## CON-PROJECT
-label: A project is one writing unit inside `projects/<project-id>/` with its own `stego-project.json` and manuscript files in `/projects/<project-id>/manuscripts`.
-
-- A project is one writing unit inside `projects/<project-id>/` with its own `stego-project.json` and manuscript files in `/projects/<project-id>/manuscripts`.
-- Related commands: CMD-NEW-PROJECT, CMD-VALIDATE, CMD-BUILD.
-- Related workflows: FLOW-NEW-PROJECT, FLOW-DAILY-WRITING.
-
-## CON-MANUSCRIPT
-label: `manuscript/` contains canonical source writing files ordered by filename prefix.
-
-- `manuscript/` contains canonical source writing files ordered by filename prefix.
-- Related commands: CMD-VALIDATE, CMD-BUILD.
-- Related configuration: CFG-REQUIRED-METADATA, CFG-COMPILE-STRUCTURE.
-
-## CON-SPINE
-label: `spine/` stores canonical entities used for continuity and navigation.
-
-- `spine/` stores canonical entities used for continuity and navigation.
-- Related configuration: CFG-SPINE-CATEGORIES.
-- Related integrations: INT-STEGO-EXTENSION.
-
-## CON-NOTES
-label: `notes/` contains supporting material that is not part of compiled manuscript output.
-
-- `notes/` contains supporting material that is not part of compiled manuscript output.
-- Related commands: CMD-NEW-PROJECT.
-- Related workflows: FLOW-DAILY-WRITING.
-
-## CON-DIST
-label: `dist/` is generated output only and can be rebuilt from sources.
-
-- `dist/` is generated output only and can be rebuilt from sources.
-- Related commands: CMD-BUILD, CMD-EXPORT.
-- Related workflows: FLOW-BUILD-EXPORT, FLOW-PROOF-RELEASE.
-
-## CON-METADATA
-label: "Frontmatter metadata drives validation, stage checks, grouping, and continuity references."
-
-- Frontmatter metadata drives validation, stage checks, grouping, and continuity references.
-- Related commands: CMD-VALIDATE, CMD-CHECK-STAGE.
-- Related configuration: CFG-REQUIRED-METADATA, CFG-ALLOWED-STATUSES.
-
-## CON-STAGE-GATE
-label: Stage gates apply stricter checks as work moves from drafting to release.
-
-- Stage gates apply stricter checks as work moves from drafting to release.
-- Related commands: CMD-CHECK-STAGE.
-- Related workflows: FLOW-STAGE-PROMOTION, FLOW-PROOF-RELEASE.
-- Related configuration: CFG-STAGE-POLICIES.
-
-## CON-COMPILE-STRUCTURE
-label: Compile structure groups ordered files into larger sections during build.
-
-- Compile structure groups ordered files into larger sections during build.
-- Related commands: CMD-BUILD.
-- Related configuration: CFG-COMPILE-STRUCTURE, CFG-COMPILE-LEVELS.
-
-## CON-SPINE-CATEGORY
-label: "A spine category defines a metadata key, ID prefix, and canonical notes file."
-
-- A spine category defines a metadata key, ID prefix, and canonical notes file.
-- Related concepts: CON-SPINE, CON-METADATA.
-- Related configuration: CFG-SPINE-CATEGORIES.

package/projects/stego-docs/spine/configuration.md

@@ -1,57 +0,0 @@
-# Configuration
-
-## CFG-STEGO-CONFIG
-label: Workspace-level configuration in `stego.config.json` defines shared directories and stage policies.
-
-- Workspace-level configuration in `stego.config.json` defines shared directories and stage policies.
-- Related concepts: CON-WORKSPACE.
-- Related commands: CMD-LIST-PROJECTS, CMD-CHECK-STAGE.
-
-## CFG-STEGO-PROJECT
-label: "Project-level configuration in `stego-project.json` defines metadata rules, grouping, and spine categories."
-
-- Project-level configuration in `stego-project.json` defines metadata rules, grouping, and spine categories.
-- Related concepts: CON-PROJECT, CON-METADATA, CON-SPINE.
-- Related commands: CMD-VALIDATE, CMD-BUILD.
-
-## CFG-REQUIRED-METADATA
-label: Advisory list of frontmatter keys expected in manuscript files.
-
-- Advisory list of frontmatter keys expected in manuscript files.
-- Related concepts: CON-METADATA.
-- Related commands: CMD-VALIDATE.
-
-## CFG-COMPILE-STRUCTURE
-label: Build grouping configuration that defines structural levels and heading behavior.
-
-- Build grouping configuration that defines structural levels and heading behavior.
-- Related concepts: CON-COMPILE-STRUCTURE.
-- Related commands: CMD-BUILD.
-
-## CFG-COMPILE-LEVELS
-label: "The ordered `levels` array inside compile structure, with keys, labels, title keys, and page break options."
-
-- The ordered `levels` array inside compile structure, with keys, labels, title keys, and page break options.
-- Related configuration: CFG-COMPILE-STRUCTURE.
-- Related concepts: CON-COMPILE-STRUCTURE.
-
-## CFG-SPINE-CATEGORIES
-label: Per-project category definitions mapping metadata keys to ID prefixes and spine files.
-
-- Per-project category definitions mapping metadata keys to ID prefixes and spine files.
-- Related concepts: CON-SPINE, CON-SPINE-CATEGORY.
-- Related commands: CMD-VALIDATE.
-
-## CFG-STAGE-POLICIES
-label: Stage policy settings determine which checks are enforced at each stage.
-
-- Stage policy settings determine which checks are enforced at each stage.
-- Related concepts: CON-STAGE-GATE.
-- Related commands: CMD-CHECK-STAGE.
-
-## CFG-ALLOWED-STATUSES
-label: Workspace-level list of allowed manuscript statuses.
-
-- Workspace-level list of allowed manuscript statuses.
-- Related concepts: CON-METADATA, CON-STAGE-GATE.
-- Related commands: CMD-VALIDATE, CMD-CHECK-STAGE.

package/projects/stego-docs/spine/integrations.md

@@ -1,43 +0,0 @@
-# Integrations
-
-## INT-VSCODE
-label: VS Code is the primary editor environment for Stego projects.
-
-- VS Code is the primary editor environment for Stego projects.
-- Related workflows: FLOW-INIT-WORKSPACE, FLOW-DAILY-WRITING.
-- Related commands: CMD-INIT.
-
-## INT-STEGO-EXTENSION
-label: "The Stego VS Code extension is the official UI for Stego projects, including status controls, checks, and Spine Browser navigation."
-
-- The Stego VS Code extension is the official UI for Stego projects, including status controls, checks, and Spine Browser navigation.
-- Related concepts: CON-SPINE, CON-STAGE-GATE.
-- Related workflows: FLOW-DAILY-WRITING, FLOW-STAGE-PROMOTION.
-
-## INT-SAURUS-EXTENSION
-label: The Saurus extension complements prose editing and research workflows in project folders.
-
-- The Saurus extension complements prose editing and research workflows in project folders.
-- Related integrations: INT-VSCODE.
-- Related workflows: FLOW-DAILY-WRITING.
-
-## INT-PANDOC
-label: "Pandoc is used for optional export formats such as docx, pdf, and epub."
-
-- Pandoc is used for optional export formats such as docx, pdf, and epub.
-- Related commands: CMD-EXPORT.
-- Related workflows: FLOW-BUILD-EXPORT.
-
-## INT-MARKDOWNLINT
-label: Markdownlint is used in stricter proofreading and release stages.
-
-- Markdownlint is used in stricter proofreading and release stages.
-- Related concepts: CON-STAGE-GATE.
-- Related workflows: FLOW-PROOF-RELEASE.
-
-## INT-CSPELL
-label: CSpell supports spelling and terminology checks during later-stage quality passes.
-
-- CSpell supports spelling and terminology checks during later-stage quality passes.
-- Related concepts: CON-STAGE-GATE.
-- Related workflows: FLOW-PROOF-RELEASE.

package/projects/stego-docs/spine/workflows.md

@@ -1,48 +0,0 @@
-# Workflows
-
-## FLOW-INIT-WORKSPACE
-label: "Install the CLI, initialize a workspace, install local dev tools, and inspect scaffolded projects."
-
-- Install the CLI, initialize a workspace, install local dev tools, and inspect scaffolded projects.
-- Related commands: CMD-INIT, CMD-LIST-PROJECTS.
-- Related concepts: CON-WORKSPACE, CON-PROJECT.
-
-## FLOW-DAILY-WRITING
-label: "Open one project, write in manuscript files, validate, build, and commit progress."
-
-- Open one project, write in manuscript files, validate, build, and commit progress.
-- Related commands: CMD-VALIDATE, CMD-BUILD.
-- Related concepts: CON-MANUSCRIPT, CON-METADATA, CON-DIST.
-- Related integrations: INT-VSCODE.
-
-## FLOW-NEW-PROJECT
-label: "Create a new project, review generated folders, and configure project metadata rules."
-
-- Create a new project, review generated folders, and configure project metadata rules.
-- Related commands: CMD-NEW-PROJECT, CMD-VALIDATE.
-- Related concepts: CON-PROJECT, CON-MANUSCRIPT, CON-SPINE.
-- Related configuration: CFG-STEGO-PROJECT.
-
-## FLOW-STAGE-PROMOTION
-label: Move files through statuses and verify readiness with stage checks.
-
-- Move files through statuses and verify readiness with stage checks.
-- Related commands: CMD-CHECK-STAGE, CMD-VALIDATE.
-- Related concepts: CON-STAGE-GATE, CON-METADATA.
-- Related configuration: CFG-STAGE-POLICIES, CFG-ALLOWED-STATUSES.
-
-## FLOW-BUILD-EXPORT
-label: Build a compiled markdown manuscript and export distribution formats.
-
-- Build a compiled markdown manuscript and export distribution formats.
-- Related commands: CMD-BUILD, CMD-EXPORT.
-- Related concepts: CON-DIST, CON-COMPILE-STRUCTURE.
-- Related integrations: INT-PANDOC.
-
-## FLOW-PROOF-RELEASE
-label: "Run strict checks, build outputs, export artifacts, and archive release files."
-
-- Run strict checks, build outputs, export artifacts, and archive release files.
-- Related commands: CMD-CHECK-STAGE, CMD-BUILD, CMD-EXPORT.
-- Related concepts: CON-STAGE-GATE, CON-DIST.
-- Related integrations: INT-MARKDOWNLINT, INT-CSPELL.