specsmith 0.1.4.dev34__tar.gz → 0.1.4.dev36__tar.gz

{specsmith-0.1.4.dev34/src/specsmith.egg-info → specsmith-0.1.4.dev36}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.1.4.dev34
+Version: 0.1.4.dev36
 Summary: Forge governed project scaffolds from the Agentic AI Development Workflow Specification.
 Author: BitConcepts
 License: MIT
@@ -99,13 +99,14 @@ specsmith doctor --project-dir ./my-project        # Tool check
 
 Each type gets: tool-aware CI (correct lint/test/security/build tools), domain-specific directory structure, governance rules in AGENTS.md, and pre-populated requirements and test stubs.
 
-## 30+ CLI Commands
+## 40+ CLI Commands
 
 | Command | Purpose |
 |---------|---------|
 | `init` | Scaffold a new governed project |
 | `import` | Adopt an existing project (merge mode) |
 | `audit` | Drift detection and health checks (`--fix` to auto-repair) |
+| `architect` | Interactive architecture generation |
 | `validate` | Governance file consistency checks |
 | `compress` | Archive old ledger entries |
 | `upgrade` | Update governance to new spec version |
@@ -113,6 +114,8 @@ Each type gets: tool-aware CI (correct lint/test/security/build tools), domain-s
 | `diff` | Compare governance against templates |
 | `export` | Compliance report with REQ↔TEST coverage |
 | `doctor` | Check if verification tools are installed |
+| `self-update` | Update specsmith (channel-aware) |
+| `credits` | AI credit tracking, analysis, and budgets |
 
 ## 7 Agent Integrations
 

{specsmith-0.1.4.dev34 → specsmith-0.1.4.dev36}/README.md

@@ -56,13 +56,14 @@ specsmith doctor --project-dir ./my-project        # Tool check
 
 Each type gets: tool-aware CI (correct lint/test/security/build tools), domain-specific directory structure, governance rules in AGENTS.md, and pre-populated requirements and test stubs.
 
-## 30+ CLI Commands
+## 40+ CLI Commands
 
 | Command | Purpose |
 |---------|---------|
 | `init` | Scaffold a new governed project |
 | `import` | Adopt an existing project (merge mode) |
 | `audit` | Drift detection and health checks (`--fix` to auto-repair) |
+| `architect` | Interactive architecture generation |
 | `validate` | Governance file consistency checks |
 | `compress` | Archive old ledger entries |
 | `upgrade` | Update governance to new spec version |
@@ -70,6 +71,8 @@ Each type gets: tool-aware CI (correct lint/test/security/build tools), domain-s
 | `diff` | Compare governance against templates |
 | `export` | Compliance report with REQ↔TEST coverage |
 | `doctor` | Check if verification tools are installed |
+| `self-update` | Update specsmith (channel-aware) |
+| `credits` | AI credit tracking, analysis, and budgets |
 
 ## 7 Agent Integrations
 

{specsmith-0.1.4.dev34 → specsmith-0.1.4.dev36}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.1.4.dev34"
+version = "0.1.4.dev36"
 description = "Forge governed project scaffolds from the Agentic AI Development Workflow Specification."
 readme = "README.md"
 license = {text = "MIT"}

{specsmith-0.1.4.dev34 → specsmith-0.1.4.dev36}/src/specsmith/importer.py

@@ -168,6 +168,7 @@ def detect_project(root: Path) -> DetectionResult:
         ".ruff_cache",
         ".mypy_cache",
         ".work",
+        ".specsmith",
         "build",
         "dist",
         "target",
@@ -1117,6 +1118,14 @@ def generate_overlay(
             agents_path.write_text(hub, encoding="utf-8")
             created.append(agents_path)
 
+    # Initialize credit tracking with unlimited budget
+    specsmith_dir = target / ".specsmith"
+    if not specsmith_dir.exists():
+        from specsmith.credits import CreditBudget, save_budget
+
+        save_budget(target, CreditBudget())  # unlimited by default
+        created.append(target / ".specsmith" / "credit-budget.json")
+
     # --- CI config (merge: only create if no CI detected) ---
     if not result.existing_ci and result.vcs_platform:
         try:

{specsmith-0.1.4.dev34 → specsmith-0.1.4.dev36}/src/specsmith/integrations/claude_code.py

@@ -78,4 +78,10 @@ When user says `sync`: run `specsmith sync --project-dir .`
 When user says `pr`: run `specsmith pr --project-dir .`
 When user says `audit`: run `specsmith audit --project-dir .`
 When user says `session-end`: run `specsmith session-end --project-dir .`
+
+## Credit Tracking
+At session end, record token usage:
+`specsmith credits record --model <model> --provider anthropic \
+  --tokens-in <N> --tokens-out <N> --task "<desc>"`
+Check budget: `specsmith credits summary`
 """

{specsmith-0.1.4.dev34 → specsmith-0.1.4.dev36}/src/specsmith/integrations/warp.py

@@ -84,10 +84,19 @@ When user says `session-end`: run `specsmith session-end --project-dir .`
 ## Verification
 Before marking any task complete, run: {verify_line}
 
+## Credit Tracking
+After completing tasks, record token usage:
+```
+specsmith credits record --model <model> --provider <provider> \
+  --tokens-in <N> --tokens-out <N> --task "<desc>"
+```
+Check budget: `specsmith credits summary`
+
 ## Rules
 - Proposals before changes (no exceptions)
 - Verify before recording completion
 - Use execution shims (`scripts/exec.cmd` / `scripts/exec.sh`) for external commands
 - Keep AGENTS.md under 200 lines
 - Record every session in the ledger
+- Record credit usage at session end
 """

{specsmith-0.1.4.dev34 → specsmith-0.1.4.dev36}/src/specsmith/scaffolder.py

@@ -80,6 +80,12 @@ def scaffold_project(config: ProjectConfig, target: Path) -> list[Path]:
         except ValueError:
             pass  # Unknown platform — skip silently
 
+    # Initialize credit tracking with unlimited budget
+    from specsmith.credits import CreditBudget, save_budget
+
+    save_budget(target, CreditBudget())  # unlimited by default
+    created.append(target / ".specsmith" / "credit-budget.json")
+
     # Git init
     if config.git_init:
         subprocess.run(  # noqa: S603

{specsmith-0.1.4.dev34 → specsmith-0.1.4.dev36}/src/specsmith/session.py

@@ -127,4 +127,27 @@ def run_session_end(root: Path) -> SessionReport:
             SessionCheck(name="audit", status="warn", message="Could not run audit")
         )
 
+    # Credit spend summary for this session
+    try:
+        from specsmith.credits import get_summary
+
+        cs = get_summary(root)
+        if cs.entry_count > 0:
+            report.checks.append(
+                SessionCheck(
+                    name="credits",
+                    status="ok",
+                    message=(
+                        f"Credits: ${cs.total_cost_usd:.4f} total, "
+                        f"{cs.session_count} session(s)"
+                    ),
+                )
+            )
+            for alert in cs.alerts:
+                report.checks.append(
+                    SessionCheck(name="credit-alert", status="warn", message=alert)
+                )
+    except Exception:  # noqa: BLE001
+        pass  # Credits not configured — skip silently
+
     return report

{specsmith-0.1.4.dev34 → specsmith-0.1.4.dev36}/src/specsmith/templates/gitignore.j2

@@ -36,6 +36,9 @@ htmlcov/
 # Build artifacts
 .work/
 *.log
+
+# specsmith local data (credits, config)
+.specsmith/
 {% if project.type.value in ('cli-rust', 'library-rust') %}
 
 # Rust

{specsmith-0.1.4.dev34 → specsmith-0.1.4.dev36}/src/specsmith/templates/governance/context-budget.md.j2

@@ -48,3 +48,14 @@ If a cheaper check fails, fix that before running more expensive checks.
 - **low** — docs-only, single-file edits, small scaffolds
 - **medium** — multi-file implementation, routine refactors, standard test runs
 - **high** — architecture changes, large builds, broad audits
+
+## Credit tracking
+
+This project tracks AI credit spend automatically. At the end of each session:
+
+1. Record usage: `specsmith credits record --model <model> --provider <provider> --tokens-in <N> --tokens-out <N> --task "<description>"`
+2. Check budget: `specsmith credits summary`
+3. If budget alerts appear, review with: `specsmith credits analyze`
+
+Budget configuration: `specsmith credits budget --cap <USD> --alert-pct 80`
+Credit data stored in `.specsmith/credits.json` (gitignored).

{specsmith-0.1.4.dev34 → specsmith-0.1.4.dev36}/src/specsmith/upgrader.py

@@ -110,6 +110,14 @@ def run_upgrade(
         yaml.dump(raw, f, default_flow_style=False, sort_keys=False)
     result.updated_files.append("scaffold.yml")
 
+    # Initialize credit tracking if not present
+    specsmith_dir = root / ".specsmith"
+    if not specsmith_dir.exists():
+        from specsmith.credits import CreditBudget, save_budget
+
+        save_budget(root, CreditBudget())
+        result.updated_files.append(".specsmith/credit-budget.json")
+
     result.message = (
         f"Upgraded from {old_version} to {new_version}. "
         f"{len(result.updated_files)} files updated, {len(result.skipped_files)} skipped."

{specsmith-0.1.4.dev34 → specsmith-0.1.4.dev36/src/specsmith.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.1.4.dev34
+Version: 0.1.4.dev36
 Summary: Forge governed project scaffolds from the Agentic AI Development Workflow Specification.
 Author: BitConcepts
 License: MIT
@@ -99,13 +99,14 @@ specsmith doctor --project-dir ./my-project        # Tool check
 
 Each type gets: tool-aware CI (correct lint/test/security/build tools), domain-specific directory structure, governance rules in AGENTS.md, and pre-populated requirements and test stubs.
 
-## 30+ CLI Commands
+## 40+ CLI Commands
 
 | Command | Purpose |
 |---------|---------|
 | `init` | Scaffold a new governed project |
 | `import` | Adopt an existing project (merge mode) |
 | `audit` | Drift detection and health checks (`--fix` to auto-repair) |
+| `architect` | Interactive architecture generation |
 | `validate` | Governance file consistency checks |
 | `compress` | Archive old ledger entries |
 | `upgrade` | Update governance to new spec version |
@@ -113,6 +114,8 @@ Each type gets: tool-aware CI (correct lint/test/security/build tools), domain-s
 | `diff` | Compare governance against templates |
 | `export` | Compliance report with REQ↔TEST coverage |
 | `doctor` | Check if verification tools are installed |
+| `self-update` | Update specsmith (channel-aware) |
+| `credits` | AI credit tracking, analysis, and budgets |
 
 ## 7 Agent Integrations